前言¶
DeepSeek Harness（DSH）启动后直接进入主界面，没有「开机画面」这一层。若你希望每次打开 DSH 时先播一段固定视频或动图，再淡出进入工作区，需要自己挂前端槽位、处理媒体路径与流式读取。社区插件 dsh-welcome-boot（维护者 MJH520）把这件事做成「装上即用」：默认带一段鲸鱼女仆开屏视频，也可以在设置里换成本机文件，或完全关闭。
这是什么¶
dsh-welcome-boot 是 DSH 的开屏动画插件，在 SkillHub 分类为「趣味换装」。它向 shell.overlay 注册开屏页，并在 设置 → 内置插件 → 开屏动画 提供配置界面；索引侧提供配置读写与媒体流式路由。项目采用 MIT 许可，代码派生自 KDDKBD/DeepSeek-splash-animation（上游版权声明保留在 LICENSE 中）。
- 目录页：https://www.skillhub.cn/plugins/MJH520/dsh-welcome-boot
- 源码：https://github.com/MJH520/dsh-welcome-boot
核心功能¶
以下能力均来自插件 README 与 package.json 说明。
- 装上即用：自带
assets/default.mp4，安装后无需额外配置；两个勾选项默认均为勾选（内置视频、播放声音）。 - 两种视频来源：勾选「内置视频」播放插件自带片段；取消后播放「视频 / 动图路径」中的绝对路径（也可通过「选择文件…」挑选）。
- 声音可开关：桌面端 Electron 默认允许有声自动播放；勾选「播放声音」即时保存，无需点「保存」。
- 播完渐隐：视频结束后停留一帧，再淡出露出界面（默认淡出 0.3 秒，可通过
cordis.patch.yml调整fadeOutMs等）。 - 可完全关闭：取消「内置视频」且清空路径时，插件不注册开屏页面，DSH 行为与未安装时一致。
- 格式宽松：视频支持
mp4 / m4v / webm / mov / mkv / ogv / ogm / mpg / mpeg / ts；动图与静图支持gif / apng / webp / avif / png / jpg / jpeg / svg / bmp / ico。 - 大文件友好：媒体通过支持
Range的路由流式返回，可拖动进度，不会一次性读完整文件。
设置页还可配合 profile 中的 cordis.patch.yml 覆盖 fit（cover / contain / fill）、skip（button / click / auto / never）、duration、playbackRate 等字段；写错会退回默认值，不会导致 DSH 启动失败。
安装与启用¶
从 GitHub 安装需要本机已安装 git（pnpm 解析 github: 依赖时会调用它）。将 <profile> 换成你实际使用的 DSH profile：
dsh plugin --profile <profile> add github:<你的用户名>/dsh-welcome-boot
安装 MJH520 维护的这份仓库时，spec 为 github:MJH520/dsh-welcome-boot。也可以在 DSH 内让 agent 通过 plugin_manager 的 install_bundle，target 填同一 spec。
安装后重启 DSH（索引是 Node 模块，需要重新加载）。
环境要求：DSH Desktop 与 dsh web；Node.js >= 20。
典型用法¶
使用默认开屏¶
安装并重启后，保持设置里「内置视频」「播放声音」为默认勾选即可，下次启动或刷新页面时会播放自带开屏。
换成自己的视频¶
- 打开 设置 → 内置插件 → 开屏动画。
- 取消「内置视频」，在「视频 / 动图路径」填写绝对路径，或点「选择文件…」（Windows 上走 PowerShell 原生对话框；不可用时需手填路径）。
- 点「保存」。路径无效会在页面上显示原因，不会静默失效。
- 按需勾选或取消「播放声音」。
- 下次启动 DSH 或刷新页面后生效——开屏只在页面加载时读一次配置。
若点「清除」清空路径但仍勾选「内置视频」，会继续播内置视频。
用配置文件固定策略¶
设置页写入的状态文件（优先级最高）：
$DSH_HOME/dsh-welcome-boot/config.json
示例：
{
"src": "C:\\Users\\me\\Videos\\opening.mp4",
"muted": false,
"builtin": true,
"volume": 0.8
}
也可在 profile 的 cordis.patch.yml 里为 dsh-welcome-boot 写 config 块（优先级次之），例如调节 volume、fit、skip、fadeInMs、fadeOutMs、duration、playbackRate 等，字段缺省回落到默认值。
适用场景与注意¶
适合谁：希望在 DSH 启动时增加品牌感、个人仪式感，或统一团队开机画面的开发者；分类「趣味换装」也适合想换默认鲸鱼女仆素材、用本地 MP4/WebM 等替换的用户。
运行与权限：插件以当前 DSH 进程权限运行，会读取你配置的本机媒体路径并在本机提供流式路由。安装前建议浏览 GitHub 仓库 源码与 MIT 许可；README 注明 assets/default.mp4 等为自有素材，不在 MIT 对素材的覆盖范围内。
生态说明：DSH 奉行「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-welcome-boot 把开屏动画从自研前端逻辑收敛成可安装插件：默认鲸鱼女仆、设置页改路径与声音、必要时一键「关掉开屏」。需要细节时查 SkillHub 目录页 与 GitHub README。
