启动动画 www02310/dsh-go

dsh-splash

DeepSeek Harness 的启动画面：亮白跑马灯点亮 → 一笔写出「DeepSeek Harness」→ 下划线扫过 → 鱼形 logo 淡入 → 进度条与版本号，全程约 7 秒，播完自行淡出。

以 DSH 插件形态实现：不改宿主任何文件，随 DSH 升级存活，卸载即干净。

想要连「进程启动到主窗口出现」那段空窗期也覆盖的版本？那是改 app.asar 的原生补丁版，见 native/（两者二选一，插件默认会检测到它并让位）。

启动画面书写中

安装

从 GitHub 直接安装（推荐）
dsh plugin --profile desktop add https://github.com/www02310/dsh-go

从本地目录安装（开发调试）
dsh plugin --profile desktop add link:D:\path\to\dsh-go

装完重启 DeepSeek Harness，下次启动就会看到开场动画。

桌面客户端的 desktop profile 由 Electron 应用独占管理，命令行 dsh plugin 会拒绝改它。
这种情况按下面「手动挂载」做，一条即可。

手动挂载（desktop profile）

1. 把本仓库放到任意目录（例如 D:\dsh-go），在 C:\Users\<你>\.dsh\profiles\desktop\ 下建软链接：

New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-splash" -Target "D:\dsh-go"

2. 编辑 ~/.dsh/profiles/desktop/package.json：

{
"dependencies": { "dsh-splash": "link:D:/dsh-go" },
"dsh": { "profile": { "bundles": [ /* …原来的… */, "dsh-splash" ] } }
}

3. 重启 DSH。

配置

设置文件：~/.dsh/splash/config.json（首次启动后自动生成）

{
"enabled": true, // 总开关 "oncePerSession": true, // 每个窗口只播一次（热重载/刷新不重复） "clickToSkip": true, // 点击画面立即淡出 "skipIfNative": true // 检测到「原生补丁版」时自动让位，避免两层叠加 }

图形面板：DSH 运行后打开 http://127.0.0.1:<端口>/dsh-splash/panel（端口在 DSH 日志/进程里，桌面端是随机端口）。
面板里可以开关各项、预览动画、看当前状态。

也可以走路由：

| 路由 | 方法 | 说明 |
| /dsh-splash/status | GET | 插件版本、宿主版本、配置、原生补丁检测结果 |
| /dsh-splash/config | POST | 改配置，body 为 {"enabled":false} 这样的补丁对象 |
| /dsh-splash/panel | GET | 图形面板 |
| /dsh-splash/preview | GET | 全屏预览动画（不装插件也能看效果） |

注入表在宿主启动时收集一次，改完配置要重启 DSH 才生效。写接口只接受本机（回环）请求。

卸载

dsh plugin --profile desktop remove dsh-splash

手动挂载的，删掉软链接与 package.json 里那两处即可。插件不写宿主文件、不驻留进程，删完即彻底消失。
想连配置一起清掉，再删 ~/.dsh/splash/。

和「原生补丁版」的区别

| | 插件版（本仓库根目录） | 原生补丁版（native/ 目录，v2.0 发布物） |
| 实现 | webServer 的 index-inject 注入覆盖层 | 改 Electron 主进程 app.asar，开独立启动窗 |
| 从点图标到出画面 | 5–10 秒：注入表要等宿主 boot 完成才下发，插件越多的机器越晚（本机实测 5.5 / 9.9 秒） | 约 1 秒：主进程一起来就开窗，不等宿主 boot |
| 覆盖范围 | 主窗口内容区（窗口一显示就是动画） | 进程启动到主窗口就绪之间的完整空窗期 |
| DSH 升级 | 不受影响，自动存活 | 升级替换 app.asar 后失效，需重装 |
| 安装 | 一条 dsh plugin add | 关闭 DSH → 跑安装脚本 |
| 卸载 | 删插件即可 | 从备份还原 app.asar |
| 风险 | 零文件改动 | 改动宿主二进制（有逐字节自校验与备份） |

想要「点图标就有画面」，用原生补丁版；只接受「打开后一秒内看到动画」、不在意开头那段空窗，插件版更省心。两者可共存，插件会自动让位。

两者默认不会同时出画面：插件检测到 app.asar 里有原生补丁时会自动让位（skipIfNative）。

实现要点

- 注入三件事：一条 global 行（__DSH_SPLASH_META__：版本与配置）+ 一条内联 script 行（覆盖层本体）。
用内联 script 而不是 script-src：内联行不会加载失败，也就不可能把 __DSH_BOOT_READY__ 卡死（那是 script-src 失败时的宿主级故障）。
- 覆盖层挂在 closed shadow DOM 里，宿主样式进不来、覆盖层样式也污染不到宿主。
- 动画在「窗口真正可见」时才起跑：优先等 focus 事件，其次等 React 挂载出 #root 内容，最后 4 秒兜底； 20 秒硬保险无论如何都收掉，绝不挡界面。
- assets/splash-overlay.js 由 assets/splash.html 生成：改画面只改 html，然后

node tools/build-overlay.mjs

兼容性

- 实测于 DSH 0.2.1-rc.2（Electron 44.7.0）。
- 依赖宿主提供 webserver/index-inject 注入表（并支持 global / script 行）。
宿主不提供时插件只是静默不生效，不会影响 DSH 启动。
- tools/harness.html 是不依赖 DSH 的本地预览页：起个静态服务打开即可调试动画。

License

MIT