开机动画 Kyenix/dsh-boot-animation

dsh-boot-animation

给 DSH（DeepSeek Harness） 换一段开机动画：打开页面先铺满窗口把短片放完，再淡入进界面。

不改 DSH 本体源码，升级 DSH 不受影响；装、卸都只要一条命令，动画素材直接换成你自己的视频。

启动画面

实测于 DSH 0.2.0-rc.2。DSH 在这一版换过「插件怎么提供设置」的接法，更旧的版本要用旧版插件。
浏览器要 Chromium 内核（Chrome / Edge）。

它长什么样

1. 深海底背景 + 一条短片铺满窗口，assets\videos\ 里的片子按文件名顺序连着放（1.mp4 → 2.mp4 → 3.mp4）
2. 底部一条细进度条，跟着 DSH 真实的启动进度走
3. 最后一段的片尾开始交叉溶解——淡入正好在最后一段放完那一刻结束
4. 想早点进：点一下画面，或按 Esc / 空格 / 回车
5. 短片默认静音，点一下画面才开声音（浏览器的硬规矩：没有点击不许自动出声）

安装

方式 1：单文件安装程序（最省事）

到本仓库的 Releases 页面下载 dsh-boot-animation-setup.exe，双击。

它会解包到 %LOCALAPPDATA%\dsh-boot-animation\ 并自动完成安装。装完刷新 dsh 页面即可，不用重启。

首次运行 Windows 可能弹 SmartScreen（「未知发布者」）：点更多信息 → 仍要运行。
这个 exe 没有数字签名，而且是自己编译的，谁编都一样。

那个 %LOCALAPPDATA%\dsh-boot-animation\ 就是插件本体，别删也别移——DSH 里是目录链接指过去的。

方式 2：压缩包，双击 .bat

到 Releases 下载 .zip，解压后双击 一键安装.bat。同样不用重启，撤销就双击 一键卸载.bat。

方式 3：命令行

官方命令：装完重启一次 DSH
dsh plugin --profile web add <解压出来的目录>

或者不重启（自己找 profile、自己补依赖） powershell -ExecutionPolicy Bypass -File tools\one-click.ps1

三种方式做的是同一件事：在 DSH 的 profile 里建一个目录链接，往 cordis.patch.yml 尾部追加一行，再把设置卡片需要的 @deepseek-ai/schemastery 补到插件旁边。不碰 package.json，不跑 pnpm，装之前自动备份那个 yml。

最后那步不是可选的：entry.js 会静态 import 那份 schema 库，而打包版 DSH 里它只存在于 resources\app.asar 内部，磁盘上没有现成副本。少了它动画照放，但设置卡片会整张不出现（只在控制台留一条 boot-animation: 开头的黄字）。安装脚本会就地把它取出来。

杀毒软件 / SmartScreen 会拦我吗？

可能会。原因很直白：setup.exe 没有数字签名（个人项目拿不到代码签名证书），而它的行为恰好是启发式规则最盯的那一类——未签名程序读自己尾部、解出一个压缩包、再调用命令行脚本。一键安装.bat 同理（批处理调 PowerShell）。这不代表它做了什么见不得人的事，但规则就是这么定的。

它实际只做四件事，脚本全在仓库里，可以自己读（tools/sfx/Setup.cs、tools/one-click.ps1、tools/install.ps1）：

1. 把自己尾部附带的 zip 解到 %LOCALAPPDATA%\dsh-boot-animation\
2. 找 DSH 装在哪、该装进哪个 profile
3. 在 profile 里建一个目录链接，往 cordis.patch.yml 追加一行（装之前自动备份）
4. 从 DSH 自己的 resources\app.asar 里取出 @deepseek-ai/schemastery 放到插件旁边

不联网、不写注册表、不装服务、不改 DSH 本体源码。

| 情况 | 怎么办 |
| SmartScreen：「Windows 已保护你的电脑」 | 点更多信息 → 仍要运行 |
| 杀软报「木马／行为可疑」并隔离了文件 | 加排除后重试；不放心可以先把它丢给 VirusTotal 看——未签名的自解压包通常有 1~5 家引擎误报，重点看 Microsoft / Kaspersky / Bitdefender 这几家的结论 |
| 公司电脑禁止运行脚本 | 走最干净的官方命令：dsh plugin --profile web add <解压出来的目录>，不经过任何 PowerShell 脚本（代价是装完要重启一次 DSH） |
| 想确认下载有没有被人动过 | Release 页面里附了 SHA256 |

顺带一提：走 .zip + 双击 一键安装.bat 这条路，杀软角度并不比 exe 干净，两者最终跑的是同一套 PowerShell 脚本。

用它

| 想要 | 怎么做 |
| 跳过动画 | 点一下画面 / Esc / 空格 / 回车 |
| 开声音 | 点一下画面（第一下只开声音，不会退出） |
| 改设置 | 设置 → 插件 → 插件配置 →「启动动画」（是收起的一行，点开） |
| 换自己的视频 | 把 mp4 丢进 assets\videos\，刷新页面 |
| 暂时不要动画 | 设置卡片里关掉「开启启动动画」，刷新 |
| 卸载 | 双击 一键卸载.bat（或 tools\one-click.ps1 -Action uninstall），然后重启一次 DSH |

设置里有四样：总开关 / 淡入时长（1~4 秒）/ 进入方式 / 素材池。改完刷新页面生效。

换自己的视频

放进 assets\videos\ 就行（认 .mp4 .webm .m4v .mov，推荐 H.264 + AAC 的 mp4），刷新页面自动发现，不用重启、不用重新构建。片子按文件名顺序连播；只留一个文件就是单段开机动画。

设置卡片里每段素材会实际播放一遍再给结论：时长，外加只在有问题时才出现的徽章——

| 徽章 | 意思 | 要做什么 |
| 黄色 未优化 | 索引表 moov 在文件末尾，要整段下完才出画面 | 双击 tools\apply-faststart.bat 无损重排（原片自动备份） |
| 黄色 一直没有画面 | 能开始播，但 8 秒内一帧都没出 | 换一段，或重新导出 |
| 红色 浏览器播不了 | 浏览器拒绝解码这一段 | 用剪映等重新导出成 H.264 mp4 |

它是怎么做到的

不碰 DSH 源码，全靠两个事实：

1. webserver/index-inject 是唯一足够早的时机。 推进那张表的 行会渲染在 shell 模块之前；而 DSH 自己的启动页是在 shell 模块里同步构造的——只有这里能抢在它前面拿下视口。
2. 一个设置命名空间就是一个插件条目。 Host 侧声明一份 Config，命名空间就是它在 profile 补丁里的条目 id（boot-animation）；浏览器侧的设置卡片按同一个字符串找到它。

要看细节（包括每一个踩过的坑和为什么）读 AGENTS.md，完整排查记录在 DEVLOG.md。

目录结构

entry.js Host 半侧：素材路由 + 注入 （改它要重启 DSH） src\boot-screen.js 开机画面本体（改成刷新页面即可，每次请求实时读盘） src\client.js 设置卡片源码 lib\client.js 设置卡片的构建产物（改 src 后跑 node build-client.mjs） assets\videos\ 素材池 —— 你的视频放这里 cordis.patch.yml 让 DSH 认识这个插件的那一行一键安装.bat / 一键卸载.bat 双击入口安装说明.txt 给拿到压缩包的人看的快速上手 tools\one-click.ps1 两个 .bat 背后的脚本：认 profile、补依赖、调下面两个 tools\install.ps1 安装引擎（命令行版，默认 web profile） tools\uninstall.ps1 卸载 tools\extract-schemastery.mjs 从 DSH 的 app.asar 里取出 schema 依赖 tools\build-sfx.mjs 把自己编译成单文件安装程序（只用 Windows 自带的 csc.exe） tools\pack.mjs 打发布压缩包（自己写 zip，路径分隔符与中文名都规范） tools\preview.mjs 本地预览开机画面，不用装进 DSH tools\apply-faststart.mjs 无损重排素材的索引表 verify\ 离线自检套件，见下 README.md 本文件 INSTALL.md 安装说明 MANUAL.md 使用手册 AGENTS.md 维护简令（改代码前先读） DEVLOG.md 开发记录（很长，出怪问题时再翻）

自己构建 / 自检

node build-client.mjs # 改了 src/client.js 之后重建卡片产物
node verify/verify-entry.mjs # Host 半侧：路由、注入、设置 schema 投影
node verify/verify-degraded.mjs # 旧版 schema 库时：动画仍在，只是没有设置卡片
node verify/verify-sequence.mjs # 顺序连播：段间不淡出、只有最后一段溶解、坏片段被跳过

三套都是离线的：不开浏览器、不占端口、不联网、不写用户目录。

单文件安装程序和发布压缩包都是自己构建的，不需要第三方打包器（Windows 自带 csc.exe）：

node tools/pack.mjs --out dist\dsh-boot-animation.zip
node tools/build-sfx.mjs --payload dist\dsh-boot-animation.zip --out dist\dsh-boot-animation-setup.exe

已验证

| 检查 | 结果 |
| verify-entry / verify-degraded / verify-sequence | 90/90 · 10/10 · 18/18 |
| 在真实 desktop profile 上重复安装 | 幂等：不重复写配置行，素材路由仍正常应答 |
| 从零开始的解压副本，双击 一键安装.bat | 成功，并自动补上 @deepseek-ai/schemastery@3.18.4 |
| 自带三段素材 | 1280×720、H.264(AVC)+AAC、moov 已在文件头，无需重排 |

来源、许可与致谢

MIT，见 LICENSE。

这个插件从头到尾是 lxj5820 的作品，本仓库只是在他的程序上做的二次修改，并已得到他本人授权：

| 原作者 | |
| GitHub | @LXJ5820 —— 原项目 <https://github.com/lxj5820/dsh-boot-animation> |
| B 站 | 情灬颠沛流离 |

| 本仓库（二次修改） | |
| GitHub | @Kyenix |
| B 站 | Kyenix |

属于他的部分，都原样保留（LICENSE 一字未动，package.json 的 author 仍是 lxj5820）：
- 代码：entry.js、src\boot-screen.js、src\client.js、cordis.patch.yml
- 工具：tools\ 里的素材重排、诊断、预览、安装/卸载脚本
- 文档：INSTALL.md、MANUAL.md、AGENTS.md，以及 DEVLOG.md——那就是他原来的 README.md，一字未删，只改了文件名
- 素材：assets\videos\ 里随包分发的三段动画（LICENSE 末尾注明是他的作品）

本仓库在他之上做的改动：

- 播放顺序：assets\videos\ 按文件名顺序连播，放完最后一段才溶解进界面（原来是每次随机抽一条）
- 安装：新增单文件安装程序与双击 一键安装.bat / 一键卸载.bat；安装时自动从 resources\app.asar 取出 schema 依赖（打包版 DSH 磁盘上没有那份库）
- 新增 verify/verify-sequence.mjs；修正设置卡片里两处已经过时的文案（「随机轮播」等）
- 把他原来的 README.md 改名为 DEVLOG.md，另写了这份面向使用者的首页

题图取自素材 1.mp4。