前言¶

用 DeepSeek Harness（DSH）做智能体或日常对话时，桌面版会先出现一段启动画面，再进入 Web 界面。官方页面偏实用，少了一点「点开软件」时的品牌仪式感。若你希望在 DSH Desktop 启动时看到与 DeepSeek 相近的鲸鱼描边、点灯、成形与字标动画，又不想改宿主核心代码，社区插件 dsh-deepseek-splash 提供了一条可还原的路径：同一套视觉源码分别落在桌面 splash.html 与可选的客户端全屏浮层上。下面介绍它做什么、怎么装、以及默认为何「界面里不再自动播第二遍」。

这是什么¶

dsh-deepseek-splash 是 DSH 的 Web 客户端插件包（dsh.client.platform=web），维护者在社区目录中以 zhang-23x 收录，分类为「趣味换装」。插件自述目标很明确：把 DeepSeek 风格的开屏动画（鲸鱼线稿描边、信号点、填充与字标）渲染为 DSH Desktop 自带的启动画面，并可选地在 GUI 里以全屏浮层再播一次。

实现上插件本体不改动宿主、不写文件、不联网；它注册 shell.overlay 插槽，但浮层默认不渲染（避免启动画面刚播完、进界面又播一遍的「卡带感」）。唯一会动磁盘的是你在显式执行 tools/build_splash.py --apply 时，对桌面版 resources/splash.html 的替换（会留备份，可用 --restore 还原）。

版本 1.0.0，许可证 MIT，声明兼容 dsh >= 0.1.0-rc.5，Node >= 20，支持 darwin / linux / win32。

核心功能¶

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

动画样式与时间轴集中在 src/splash.css 与 assets/whale.svg，两个载体共用同一套逻辑（src/splash.js 等）：

动画节拍（README 归纳）¶

1. 描边：蓝色高光沿鲸鱼轮廓逐段画出（pathLength=1 + stroke-dashoffset）。
2. 点灯：头顶三颗信号点依次亮起并回弹，随后呼吸式脉动。
3. 成形：填充自左向右涌入，白光扫过，描边淡出，鲸鱼落定。
4. 落款：DeepSeek 字标上浮、「深度求索」副标淡入。
5. 散场（仅界面浮层）：整幕淡出并卸载。

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

交互差异¶

界面浮层（开启后）

• 点击 / 触摸任意位置或按任意键可立刻跳过。
• CSS 约在 2.9 秒后淡出浮层，脚本异常也不应长期挡住界面。
• 同一标签页内后续路由不再重复播放；窗口可见即播，不要求窗口拿到焦点。

桌面启动画面

• 不可跳过（背后尚无主界面可交还）。
• 成形后长驻终态，信号点继续脉动，直到应用切换窗口。
• 桌面版把启动步骤写入 #progress（写一行淡入一行），标题与副标题沿用官方文案并随系统语言切中文。

安装与启用¶

插件按普通 DSH 客户端包装进某个 profile。README 给出的安装命令如下（勿自行改仓库名拼接）：

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

也可在 DSH Desktop 的插件管理里安装本地目录（不依赖 CLI）。装完后刷新界面即可加载客户端 bundle。

桌面启动画面是另一半能力：装插件不会自动改 splash.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 <路径>。

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

典型用法¶

在 GUI 里 opt in 界面开屏¶

默认浮层静音。若要在浏览器里打开界面或刻意再看一遍，在页面里设置一次：

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

覆盖动画参数¶

可在控制台或上述对象里调整：

window.__DSS_SPLASH__ = {
  overlay: true,
  disabled: true,
  holdMs: 2760,
  title: "DeepSeek",
  subtitle: "深度求索",
  hint: "点击任意位置跳过"
};

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

免安装预览¶

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

适用场景与注意¶

适合谁

• 使用 DSH Desktop，希望在启动瞬间看到统一、可识别的 DeepSeek 鲸鱼开屏，并愿意在更新后偶尔重跑 --apply。
• 需要在纯 Web 环境演示同一段动画时，通过 overlay: true 打开界面浮层。

使用前请知悉

• 插件以当前 DSH 进程权限运行；安装前请阅读仓库源码与 MIT 许可证，确认接受对 splash.html 的显式替换行为。
• README 中安装规格指向 github:zmr234234-jpg/dsh-deepseek-splash，与社区目录 zhang-23x/dsh-deepseek-splash 的收录路径可能不一致，以你实际添加的 git 源为准。
• 社区目录（如 SkillHub）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；星标等元数据以各站点当时展示为准。

结尾¶

dsh-deepseek-splash 把同一段鲸鱼片头接到 DSH Desktop 启动画面，并以零默认开销的客户端浮层提供可选的第二遍播放；需要桌面效果时记住 build_splash.py --apply，需要界面内播放时用 window.__DSS_SPLASH__.overlay 即可。

• 社区目录：https://www.skillhub.cn/plugins/zhang-23x/dsh-deepseek-splash
• GitHub：https://github.com/zhang-23x/dsh-deepseek-splash