前言¶

在 DeepSeek Harness（DSH）里做智能体或日常用 DSH Desktop 时，启动阶段往往只有默认的加载页，和官方客户端里那段「描边 → 点灯 → 成形 → 落款」的鲸鱼片头没有视觉上的延续。若想在 Harness 侧复用同一套动效，通常得自己改桌面资源或写浮层，还要处理深浅主题、减弱动效偏好，以及「启动播一次、进界面又播一次」的体验问题。

下面介绍社区插件 dsh-deepseek-splash（维护者 zmr234234-jpg）：把同一段鲸鱼开屏动画接到 DSH Desktop 自带的启动画面，并可选地在 Web 客户端以全屏浮层再播一遍。插件归类为 SkillHub 目录下的「趣味换装」，当前 GitHub 星标为 0；许可证为 MIT（© 2026 zmr234234-jpg）。

这是什么¶

dsh-deepseek-splash 是一个面向 DSH 的 Web 客户端插件（dsh.client.platform=web），宿主侧为空实现；客户端通过 shell.overlay 注册插槽，但 界面开屏浮层默认静音（不渲染），避免启动画面刚播完、进 GUI 又播一遍的「卡带感」。桌面版启动画面需单独用构建脚本写入 resources/splash.html，与浮层共用 src/splash.css 与 assets/whale.svg。

兼容声明（来自 package.json）：DSH >=0.1.0-rc.5；Node >=20；支持 darwin / linux / win32。

核心功能¶

两套落点，一份视觉源码¶

动画四拍（README 表述为五步，其中「散场」仅界面开屏）：描边自绘 → 头顶三颗信号点依次点亮并脉动 → 填充成形与白光扫过 → DeepSeek / 深度求索 字标 → 浮层模式下整幕淡出。

深浅主题跟随外壳（<html data-theme>）；尊重 prefers-reduced-motion（仅保留极简淡入）。

交互差异¶

界面浮层（开启后）

• 点击、触摸或任意键可立刻跳过。
• CSS 约 2.9 秒后淡出浮层，脚本异常也不挡界面。
• 同一标签页内后续路由不再播放；窗口可见即播，不要求窗口焦点。

桌面启动画面

• 不可跳过（背后尚无主界面可交还）。
• 成形后长驻终态，信号点持续脉动，直至切到主界面。
• 启动进度写入 #progress；标题副标题沿用官方文案并随系统语言切中文。

插件运行时行为¶

README 说明：插件本身不改动宿主、不写文件、不联网；仅注册 shell.overlay，浮层默认不渲染时客户端开销为零。唯一会改磁盘的是 显式执行 python tools/build_splash.py --apply 时对 splash.html 的替换（会留备份，--restore 可还原）。

安装与启用¶

安装客户端插件¶

插件装进某个 profile 即可，官方 README 给出的命令如下：

dsh plugin --profile web add "github:zmr234234-jpg/dsh-deepseek-splash"

若使用本地目录（README 亦给出 clone 后 link 的方式）：

git clone https://github.com/zmr234234-jpg/dsh-deepseek-splash
dsh plugin --profile web add "link:/绝对/路径/dsh-deepseek-splash"

DSH Desktop 也可在插件管理里直接装本地目录。装完后 刷新界面 即可加载客户端 bundle。

写入桌面启动画面（可选但常用）¶

仅装插件不会替换 DSH Desktop 的启动 HTML，需要额外执行：

python tools/build_splash.py --apply

查看当前是否已应用本插件版本：

python tools/build_splash.py --status

还原官方启动页：

python tools/build_splash.py --restore

说明要点：

• 首次 --apply 会把官方页备份为 splash.html.dsh-deepseek-splash.bak，之后不覆盖该备份。
• 应用更新可能覆盖 splash.html，更新后需重跑 --apply；--status 中 ours: True/False 可确认。
• 默认目标路径为 D:\deepseek\Data\DSH Desktop\resources\splash.html；其他机器或目录用 --target <路径>。

启动页为自包含 HTML（内联样式与 SVG，无外链图、无联网）。

典型用法¶

在 GUI 里再播一遍界面开屏¶

默认浮层不渲染。若要在浏览器打开界面或刻意再看一次，在页面里 opt in：

window.__DSS_SPLASH__ = { overlay: true };   // 或 { disabled: false }

运行时覆盖参数¶

控制台或预先设置 window.__DSS_SPLASH__：

window.__DSS_SPLASH__ = {
  overlay: true,           // 界面开屏也播放（默认仅在桌面启动画面播放）
  disabled: true,          // 本次加载不播放
  holdMs: 2760,            // 定格时长
  title: "DeepSeek",
  subtitle: "深度求索",     // 空串则隐藏副标
  hint: "点击任意位置跳过"
};

诊断：动画状态在 <html data-dss-splash>（waiting / playing / done / skipped）；样式为 <style id="dss-splash-style">。启动画面侧对应 window.__DSS_LAUNCH_SPLASH__。

免安装预览¶

• 用浏览器打开仓库内 assets/preview.html；地址栏 #t=1300 可停在第 1300 ms。
• dist/splash.html 为启动画面渲染产物；?theme=light 可看浅色主题。

维护者提供的自检命令¶

node tools/smoke_client.mjs
python tools/build_splash.py

适用场景与注意¶

适合谁

• 使用 DSH Desktop，希望启动瞬间与 DeepSeek 官方客户端视觉一致的用户。
• 在 Web 客户端或普通浏览器里调试界面，且愿意 opt in 浮层开屏的开发者。

安装前建议

• 插件以 当前 DSH 进程权限 运行；安装前应阅读 GitHub 源码 与 MIT 许可证，自行判断是否信任维护者。
• 桌面启动画面修改的是本地 splash.html；团队或 CI 环境需约定是否 --apply 以及如何 --restore。
• SkillHub 目录（插件页）为社区生态站点，与 DeepSeek / 幻方无官方从属关系；星标与版本以仓库为准（当前 package 版本 1.0.0）。

结尾¶

经过上面的步骤，你可以只装客户端插件保持零浮层开销，或再配合 build_splash.py --apply 让 DSH Desktop 启动即播鲸鱼片头；需要时在页面一行配置打开界面开屏。更多细节见仓库 README 与目录页：

• SkillHub：https://www.skillhub.cn/plugins/zmr234234-jpg/dsh-deepseek-splash
• GitHub：https://github.com/zmr234234-jpg/dsh-deepseek-splash