开屏动画补丁 BuildWithAIHub/dsh-splash-patch

DSH 开屏补丁

在 DeepSeek Harness（DSH）桌面界面出现之前，先播一段全屏开场视频，DSH 在视频后面启动；DSH 自动更新后，这个效果依然保留。

中文简介：给 DSH 桌面版加一个「开机先播全屏视频、DSH 在后台加载、视频播完（或按 Esc/点击）再进 DSH」的开屏效果；DSH 更新会替换 app.asar，本工具用「自动补丁器 + 看门狗 + 启动器」在更新后自动把补丁补回来。

Splash illustration

示意图：开屏播放时整个屏幕都是视频，DSH 在后台加载。图片由 docs/images/generate.py 用代码绘制，不是截图，也不含任何真实画面或隐私数据。

Startup flow

示意图：快捷方式 → 启动器（必要时先补丁）→ 开屏窗口播放视频，同时隐藏的主窗口加载 DSH → 视频播完 / 按 Esc 后无缝进入工作区。

开场片段（真实预览）

开屏实际播放的就是动画插件里的这两段视频（在插件片库里选哪段就播哪段）：

| DeepSeek 赛博朋克片头 | DeepSeek 数字角色苏醒 |
| Cyberpunk intro | Awakening intro |

以上 GIF 是 dsh-boot-animation 插件自带片段的短节选预览，仅用于说明效果；版权归各自权利人所有，不属于本项目代码，若权利人要求会立即移除。

环境要求

- Windows 10/11
- 已安装 DeepSeek Harness 桌面版（开发时基于 0.2.1-rc.3）
- Node.js，或 DSH 自带的 node 运行时（%USERPROFILE%\.dsh\dsh-runtimes\...）

安装

1. 把这个文件夹放到任意位置（例如 %USERPROFILE%\dsh-splash-patch）。
2. 运行：

powershell -NoProfile -ExecutionPolicy Bypass -File .\setup\install.ps1

安装器会自动找到 DSH。如果找不到，手动传入可执行文件：

powershell -NoProfile -ExecutionPolicy Bypass -File .\setup\install.ps1 -Exe "D:\Apps\DeepSeek Harness\DeepSeek Harness.exe"

3. 从桌面或开始菜单的快捷方式启动 DSH。如果 DSH 已经在运行，重启一次，让打过补丁的 app.asar 生效。

安装器改了什么（全部在本地，可回滚）

| 位置 | 改动 |
| <DSH install>\resources\app.asar | 加入全屏开屏窗口 + IPC。首次写入前，原始归档会备份到 state\app.asar.unpatched.bak。 |
| 现有 DSH 快捷方式 | 指向 launch\launch-dsh.vbs。原文件备份为 .lnk.dsh-patch-backup。 |
| 任务计划程序 | 每用户任务 DSH-SplashPatch-Watchdog（登录时 + 每 5 分钟）。通过 wscript.exe 垫片（watchdog\run-watchdog.vbs）启动，不会闪出控制台窗口。 |

DSH 配置档和数据文件夹里不会添加任何东西。

启动时做什么

启动时做什么

Animated illustration

1. 如果 DSH 更新替换了 app.asar，启动器会静默重新打补丁（仅在 DSH 未运行时）。
2. 打过补丁的 DSH 创建一个无边框全屏开屏窗口，播放本地视频，同时隐藏的主窗口并行加载真正的应用。
3. 片段播完（或用户按 Esc / 点击）后，开屏关闭，显示已经加载好的工作区。安全定时器保证它绝不会卡住。

本仓库所有图片都由 docs/images/generate.py 从零生成。它们是示意图，不是截图，也不含任何个人数据、聊天内容或 DSH 资产。

DSH 自动更新之后

- 更新器自身的重启可能一次显示正常（未打补丁）的界面——更新在 DSH 运行时替换了归档文件。
- 从快捷方式打开 DSH，会在启动之前修复补丁。
- 如果通过其他方式打开 DSH，看门狗会在 DSH 退出后几分钟内修复补丁，下次启动时又是打过补丁的状态。

如果未来的 DSH 版本改动了被打补丁的代码，打补丁工具会拒绝写入，并把原因记录到 state\status.json / state\PATCH-UNSUPPORTED.txt。DSH 仍能正常工作（只是没有启动画面）。

视频来源

启动画面播放 DSH 资源目录下的本地文件：resources\boot-intro-.mp4。如果 %DSH_HOME%\boot-animation\selection.json 存在，就从它里面选文件名，否则用 boot-intro-awakening.mp4。本仓库不再分发任何视频或 DSH 资产——这些文件必须已经存在于你的安装目录中。

如果把 boot-intro-*.mp4 文件放在打补丁工具旁边（例如 auto/ 里），每次打补丁都会把缺失的片段复制到 app.asar 旁边的 resources/。这在 DSH 更新后很重要：安装程序会替换整个安装目录并删除这些片段，导致启动画面收到 404 并立刻关闭（看起来像启动画面「一闪就退」。把片段放在打补丁工具旁边，启动器/看门狗就会自动恢复它们。

下面的命令只在你机器上存在片段源文件时才有效。

不碰 DSH 测试打补丁工具

copy an unpatched app.asar from a fresh DSH install first
node patcher\apply-patch.mjs --selftest --base .\test\app.asar.pristine

自测会构建一次性测试夹具：给原始归档打补丁，验证操作幂等，并验证改动过的锚点会被拒绝且不写入任何内容。

卸载

powershell -NoProfile -ExecutionPolicy Bypass -File .\setup\uninstall.ps1
also restore app.asar from the backup:
powershell -NoProfile -ExecutionPolicy Bypass -File .\setup\uninstall.ps1 -RestoreAsar

隐私与安全

- 不访问网络，不做遥测，不做分析，本工具不自动更新。
- 只读写上面列出的本地 DSH 文件；日志留在 state\。
- config.json、日志、备份和测试归档都已加入 gitignore。

免责声明

非官方本地集成辅助工具。与 DeepSeek 无关联，未获其认可或支持。它会修改你自己安装目录中的文件，可能破坏 DSH 更新或违反其条款；使用风险自负。见 NOTICE.md。

许可证

MIT