深潜开机动画 20dice-0023/dsh-sonar-boot

dsh-sonar-boot · 深潜

给 DeepSeek Harness（DSH）做的开机动画插件。打开 DSH，先被一座深海设施盘问身份，再沉下去，最后浮上来，落回你的工作台。

深潜：六个阶段

不装也能先看效果：用浏览器打开 preview/index.html，点击开始（建议开声音）。

它会做什么

整段约 20 秒，第一次启动会多几秒用来登记身份。

0. 访问身份：第一次使用时，设施先问你是谁。输入名字（中文输入法可用），回车登记，以后每次启动都直接显示这个名字。按 Esc，或者 20 秒没有打字，屏幕会变红：「陌生的操作者，你被受信任的设备特赦了。希望下一次，你仍有这种好运气。」这一次以「未登记」身份进入，下次启动还会再问。
1. 积水：浅蓝色的代码雨落下，在屏幕底部积成水面，一路涨过镜头。落下来的是这段动画自己的源代码。
2. 下潜：声呐一圈圈扫出去，右侧深度计跳向 11034 m（马里亚纳海沟的深度）。
3. 汇聚：水里的代码被抽向中心，拼成 DSH 徽记；多余的代码变白，化成气泡上浮。
4. 解密：机密档案逐行涂黑再解密：访问身份、档案编号、工作区、会话数与总轮数、最近会话、权限模式。都是从本机读出来的真实信息。
5. 上浮：深度计倒数回 0，一条水线从屏幕顶端往下退。徽记化作光点飞回左上角的 logo，工作区名和最近会话的标题落进侧栏对应的那一行，最后露出 DSH 本来的界面。

Esc 或点击任意处可以直接跳到上浮，M 静音。声音全部由 Web Audio 现场合成，不含任何采样。

对 DSH 的影响

- 不改 DSH 的任何文件。 插件只读 $DSH_HOME/storages 里的工作区列表和会话缓存（只读标题和轮数），不读凭据，不读会话正文，不联网。唯一会写入的文件是它自己的 $DSH_HOME/dsh-sonar.json，用来存你登记的名字；保存请求只接受来自本页面、带令牌的本机请求。
- 播完就走。 动画是盖在最上层的一张画布，不改界面元素和样式。退潮一开始，鼠标就能操作下面的界面；播完后画布、遮罩、输入框和监听全部移除。
- 每次启动只播一次。 刷新页面、切换会话都不会重播。
- 出错不挡路。 动画脚本加载失败时，遮罩立刻撤掉；8 秒内动画没有跑起来也会撤掉；播放中途报错，同样立即撤掉。

安装

需要 DSH 0.2.x。先把整个仓库放到一个以后不会移动的位置，例如 D:\Plugins\dsh-sonar-boot。插件以 link: 方式安装，DSH 每次启动都直接读这个文件夹：不要移动、改名或删除它，也不要放在「下载」「桌面」这类迟早会清理的地方。

官方桌面端（DSH NEXT）

桌面端的配置档在 %USERPROFILE%\.dsh\profiles\desktop，dsh plugin 命令行不能直接装。最省事的办法，是让 DSH 会话里的助手照下面四步来做。把这段话发给它（路径换成你自己的）：

在 C:\Users\<你的用户名>\.dsh\profiles\desktop 里安装 dsh-sonar-boot：
1. 先把 package.json 备份成 package.json.bak-sonar；
2. 在这个目录里，用 DSH 自带的 pnpm（DSH NEXT\resources\app.asar.unpacked\node_modules\pnpm\bin\pnpm.cjs）运行 pnpm add link:D:\Plugins\dsh-sonar-boot；
3. 在 package.json 的 dsh.profile.bundles 末尾加上 "dsh-sonar-boot"，以 UTF-8（无 BOM）保存；
4. 确认 node_modules\dsh-sonar-boot 存在、package.json 能被 JSON.parse 解析。不要重启。

然后完全退出客户端（包括系统托盘里的图标），再重新打开。桌面端只在启动时收集一次页面注入，所以装完必须重开一次。

第 3 步特别注意编码：package.json 开头如果多了 BOM（EF BB BF），DSH 读配置会报错。Windows 自带的 PowerShell 5 写文件时默认会加上 BOM。

网页版（dsh web）

dsh plugin --profile web add link:<本目录的绝对路径>

重启 dsh web，再刷新页面。

设置

设置写在 $DSH_HOME/dsh-sonar.json（Windows 默认是 C:\Users\<你的用户名>\.dsh\dsh-sonar.json）。文件不存在时全部用默认值：

{ "name": "OPERATOR", "enabled": true, "sound": true }

| 字段 | 作用 |
| name | 档案里的「访问身份」。第一次启动时输入的名字就存在这里；没有这一项时，启动时会询问。 |
| enabled | 设为 false 就不再播放。临时关闭也可以设环境变量 DSH_SONAR=off。 |
| sound | 设为 false 静音播放。 |

改完之后，下一次启动 DSH 生效（桌面端需要完全退出再打开）。

改名字，或者重新输入一次

- 直接改：用记事本打开 dsh-sonar.json，把 "name" 后面的名字改掉，以 UTF-8 保存。
- 重新输入：删掉 "name" 这一行（只剩 {} 也可以），或者把整个 dsh-sonar.json 删掉。下次启动时，设施会重新询问你的身份。

和其他插件一起用

- DeepSeek-Balance-Whale-Widget（小鲸鱼余额挂件）：互不影响。动画期间盖在挂件上面，退潮时挂件照常露出来。挂件的提示音如果恰好在动画期间响起，会和动画的声音叠在一起。
- dsh-chat-wallpaper（聊天底图 / 大字横幅 / 开场视频）：
- 底图和大字横幅直接兼容：它们在界面下面，退潮时一起露出来。落进侧栏的文字取的是界面自己的字色，透明底和深色主题都对得上。
- 开场视频（placement: "front", mode: "once"）会等开机动画收场再播。在 ~/.dsh/chat-wallpaper.json 里把本插件加进它等待的名单：

{
"bootOverlaySelectors": ["#dsh-startup-root", ".dsh-sonar-root"],
"bootLeaveClasses": ["dsu-handoff", "dsu-gone", "dsh-sonar-leaving"]
}

顺序就变成：深潜 → 退潮露出开场视频 → 视频淡出 → 聊天界面与底图。检测到后面排着开场视频时，徽记和档案文字不再飞向侧栏，而是随水退去。不加这两行的话，视频会在动画开始 3 秒后，在动画下面先播掉。

本插件对外留了两个信号，方便其他插件衔接：动画画布带有 class dsh-sonar-root，上浮开始时会加上 dsh-sonar-leaving；播完会在 window 上派发 dsh-sonar:done 事件。

卸载

1. 从 profiles\desktop\package.json 的 dependencies 和 dsh.profile.bundles 里去掉 dsh-sonar-boot（或者用安装时备份的 package.json.bak-sonar 换回去），再删掉 node_modules\dsh-sonar-boot 这个链接；
2. 完全退出并重开客户端；
3. dsh-sonar.json 可以一并删掉。

网页版：dsh plugin --profile web remove dsh-sonar-boot。

目录

dsh-sonar-boot/
├── package.json # DSH bundle 元数据（dsh.bundle.patch → cordis.patch.yml） ├── cordis.patch.yml # 把插件挂进当前 profile ├── lib/index.js # 宿主侧：页面注入行、本机路由、只读的档案数据、保存名字 ├── assets/sonar.js # 动画本体（Canvas 2D + Web Audio，无依赖） ├── preview/index.html # 独立预览页（示意布局 + 示例数据） ├── scripts/build-preview.mjs # 改了 sonar.js 之后，用它刷新预览页 └── docs/preview.png

工作方式

- 桌面端的 index.html 是从安装包里直接读盘的，宿主改写 HTML 的接口在桌面端不生效；唯一的注入通道是 webserver/index-inject，而且这张表只在宿主启动时收集一次。所以插件在 apply() 一开头就登记注入行，不等任何服务就绪。
- 注入的是一段内联脚本：先盖一层深色遮罩，再加载 /dsh-sonar/boot.js，加载失败就撤掉遮罩。用内联而不是外链脚本，是因为外链脚本加载失败会让整个桌面端启动失败。
- 飞向侧栏的目标位置不靠写死的坐标或类名：插件在页面里按文字找到显示工作区名、会话标题和 HARNESS 徽标的元素，读出它们的实际位置、字号、字体和颜色。

致谢

- 灵感来自 deepseek-harness-rust-optimize 的开机动画。本插件没有使用其中的代码与素材。
- 桌面端注入的几条关键经验（注入表只收集一次、必须用内联脚本、profile 的写法），来自 DeepSeek-Balance-Whale-Widget 文档里记录的实测结论。
- 徽记来自作者的手绘草图：H 是塔，横放的 D 是碗，S 是穿过它们的波浪。

许可

MIT