深海下潜开屏 holy-ovo/dsh-startup

dsh-startup

给 DeepSeek Harness 做的一次深海下潜式启动动画：深度尺与探测器、鲸鱼娘出场视频、海底地形与珊瑚礁、气泡与生物荧光。

dsh-startup 开屏

给 DeepSeek Harness 做的深海下潜开屏动画 —— 深度尺、探测器、角色出场视频、海底地形、珊瑚礁、生物荧光粒子。纯 HTML/CSS/JS，不用构建，不用框架。

它长什么样

整段约 9.4 秒，然后自动消失：

0.0s 黑场淡出，海底背景亮起 1.0s 主标题「下潜到能思考的深度」以字距收紧 + 模糊对焦浮出 1.6s 第一行读数：声呐阵列校准 · 波束 48 通道收敛 2.4s 金色细线扫开 2.55s 她的出场视频切到无缝循环段 —— 之后一直在动 2.6s 第二行读数：相位锁定 · 采样率 96 kHz 3.6s 第三行读数：全部就绪 · 开始下潜 4.6s 深度走到 1000m，探测器停在尺底 9.4s 收尾

深度是有意义的：左侧深度尺的读数决定出现什么生物。

| 深度带 | 生物 |
| 0–250m 光合带 | 海龟（远处的影子） |
| 250–600m 微光带 | 鱼群 |
| 600–1000m 深渊带 | 海马 |

珊瑚礁、气泡、浮游、海雪、体积光则一直在。

安装

适用于 DSH Desktop（Windows），不需要 Node、npm 或 git。
前提：DSH Desktop 已经安装过、并且至少启动过一次（这样 profile 目录才存在）。

第 1 步：把插件文件放到本地

A. 下载 ZIP（推荐，不用命令行）

1. 打开 <https://github.com/holy-ovo/dsh-startup>
2. 点右上角绿色的 Code → Download ZIP
3. 解压到任何一个长期保留的目录 —— 盘符随意（C/D/E 都行），例如：

D:\dsh-startup
E:\apps\dsh-startup
C:\Users\<你的用户名>\dsh-startup

⚠️ 别放在「下载」「桌面」「Temp」这类会被清理的地方。
安装只是建一个指向这份代码的链接，这份目录被删掉或挪走，插件就失效了。
路径里最好别带空格和中文，能少一类麻烦。

B. 用 git（如果你已经装了 git）

git clone https://github.com/holy-ovo/dsh-startup.git D:\dsh-startup

下面所有命令里的 D:\dsh-startup 都只是示例，换成你自己的实际路径即可。

解压/克隆完成后，打开这个文件夹，你应该能看到：

install.ps1 uninstall.ps1 package.json splash.html client.js index.js assets\

看不到 install.ps1 说明解压层级错了（有的解压工具会多套一层 dsh-startup-master），进到真正含 package.json 的那一层再继续。

第 2 步：运行安装脚本

方法 A：在文件夹里开终端

1. 打开你解压出来的那个文件夹（例如 D:\dsh-startup）
2. 在地址栏里输入 powershell 回车（会在当前目录开一个 PowerShell 窗口）
3. 粘贴下面这行并回车：

powershell -ExecutionPolicy Bypass -File .\install.ps1

方法 B：已经在 PowerShell 里

cd D:\dsh-startup # 换成你的实际目录
powershell -ExecutionPolicy Bypass -File .\install.ps1

看到下面三行就是成功了：

✓ 链接已建立: ...\profiles\web\node_modules\@klasjdfkl\dsh-startup ✓ 已登记到 package.json（备份: package.json.bak-install）装好了。完全退出 DSH Desktop 再打开

脚本具体做了三件事（都可以撤销）：

| 动作 | 位置 |
| 建一个目录链接，指向你解压的这份代码 | %APPDATA%\dsh-desktop\harness\profiles\web\node_modules\@klasjdfkl\dsh-startup |
| 登记依赖 | 同目录 package.json 的 dependencies |
| 加入加载列表 | 同目录 package.json 的 dsh.profile.bundles |

改 package.json 之前会自动备份成 package.json.bak-install。

第 3 步：完全退出 DSH Desktop，再重新打开

这一步不能跳过，也不能用“刷新页面”代替。

- 关闭主窗口后，检查右下角系统托盘还有没有 DSH 图标 → 右键 → 退出 / Quit
- 或者在任务管理器里结束 DSH Desktop

原因：插件的清单只在客户端启动时读取一次；只刷新网页不会重新读 bundles。

第 4 步：确认装上了

两个验证点，任一个成立就说明成功：

1. 打开客户端时能看到深海下潜的开屏动画；
2. 设置 → 插件 → 已安装 列表里有 @klasjdfkl/dsh-startup 0.1.0。

开屏只在启动时出现一次，持续约 9.4 秒；右下角有「跳过」按钮。

卸载

cd D:\dsh-startup
powershell -ExecutionPolicy Bypass -File .\uninstall.ps1

然后同样退出客户端再打开。
它会删掉那个目录链接，并把包名从 dependencies 和 dsh.profile.bundles 里移除。
不会删除你解压的代码目录。

常见问题

| 现象 | 原因与解决 |
| 无法加载文件 ...install.ps1，因为在此系统上禁止运行脚本 | 少了 -ExecutionPolicy Bypass。用文档里完整的命令，不要直接双击 |
| 找不到 profile 目录：... | DSH Desktop 从没启动过，或装的不是 Windows 桌面版。先正常打开一次客户端再试 |
| 在 ... 里找不到 package.json | 你在错误的目录执行了脚本。cd 到含 package.json 的那一层 |
| 脚本成功，但打开客户端没反应 | 没有完全退出再打开（只刷新页面无效），或托盘里还有旧进程 |
| 插件列表里没有它 | 同上；也可能被杀毒软件删掉了目录链接，重跑一次脚本 |
| 想立刻撤销 | 跑 uninstall.ps1，或用 package.json.bak-install 覆盖回 package.json 再重启 |

手动安装（不想运行脚本时）

如果你想自己看清楚每一步，等价于脚本所做的三件事：

1. 建目录链接
mkdir "%APPDATA%\dsh-desktop\harness\profiles\web\node_modules\@klasjdfkl"
mklink /J "%APPDATA%\dsh-desktop\harness\profiles\web\node_modules\@klasjdfkl\dsh-startup" "D:\dsh-startup"

2. 编辑 %APPDATA%\dsh-desktop\harness\profiles\web\package.json a) dependencies 里加： "@klasjdfkl/dsh-startup": "link:D:/dsh-startup" b) dsh.profile.bundles 里加："@klasjdfkl/dsh-startup"

3. 退出并重开 DSH Desktop

它怎么工作（给改代码的人）

DSH 的插件是宿主半边：通过 webServer 注册路由，再往首页注入两行。

// index.js
export default {
name: 'dsh-startup',
inject: ['webServer'],
apply(ctx) {
// 1) 视频路由（带 Range， 才能 seek）
ctx.webServer.register({ kind: 'exact', path: '/dsh-startup/intro', handler: createVideoHandler(ASSET) })
ctx.webServer.register({ kind: 'exact', path: '/dsh-startup/idle', handler: createVideoHandler(ASSET_IDLE) })

// 2) 首页注入：一行 html（结构 + 样式）+ 一行 script（驱动）
ctx.on('webserver/index-inject', (table) => {
table.push({ kind: 'html', placement: 'body', html: readText('splash.html') })
table.push({ kind: 'script', placement: 'body', text: readText('client.js') })
})
},
}

三个刻意的设计：

1. 必须发生的事全部由纯 CSS 完成。 开屏的消失是一条 CSS 动画（@keyframes dsh-sp-hide），脚本挂了、视频挂了，它照样在 9.4 秒后收掉。
脚本只做增强。
2. 每次渲染首页时重读 splash.html / client.js。 改样式只要刷新页面，不用重启宿主（只有 index.js 的改动才需要重启）。
3. 时间锚点 kill switch。 一旦 被打上 dsh-splash-done，之后任何重复注入的副本都会直接不可见，不会再播一遍。

可调参数

| 项 | 位置 | 当前值 |
| 开屏时长 | splash.html 的 animation: dsh-sp-hide 9.4s | 9.4s |
| 切到循环段的时刻 | client.js 的 SWITCH_AT | 2.55s |
| 深度带阈值 | client.js 的 setZone()（0.25 / 0.6） | 250m / 600m |
| 深度推进节奏 | client.js 的 DROPS | 4 个落点，每行 250m |
| 气泡数量 | splash.html 的 .sp-bubbles | 28 颗 |
| 鲸鱼线稿 | splash.html 的 .sp-mark | 19vw / 6% |

已知限制

- 视频分辨率：538×646，在 2K 屏上会被放大近 2 倍，边缘偏软。
要更清晰需要重出 1080×1296 的素材，改 assets/ 即可，代码不用动。
- 生物是手绘路径：海龟、海马、鱼群是手写的 SVG 曲线，做了模糊 + 降透明度的 "远处影子"处理。近看仍然能看出是手绘。
- Windows 合成层：视频和文字层都加了 translateZ(0)，否则 Electron 里硬件解码的视频可能跑到 overlay 平面、盖住文字。
- 每次刷新都会播：目前没有"每次启动只播一次"的节流。

开发

index.js 宿主半边：两条路由 + 注入行 splash.html 结构与全部样式（单文件，无构建） client.js 切段 / 深度尺 / 深度带 / 收尾 assets/ intro.webm（出场 4.04s）· idle.webm（循环 2.92s）

改完 splash.html 或 client.js → 刷新页面即可看到。
改 index.js → 需要重启宿主。

License

MIT，见 LICENSE。第三方素材说明见 NOTICE。