前言¶
DeepSeek Harness（DSH）桌面版冷启动时，默认会先出现内置启动屏，主界面在后台加载。若希望双击启动后先播放一段自定义视频（可带音频），播完再进入主界面，又不想自己改宿主或写注入脚本，可以在插件生态里找专门做「开机美化」的扩展。下面介绍维护者 hkhlpj 发布的 dsh-boot-theme：全屏播放本地 mp4 / webm，HARNESS 同步加载；播完按设定转场进入主界面；若主界面尚未就绪，则保持最后一帧淡出后交回默认启动屏继续等待。
这是什么¶
dsh-boot-theme 是 DSH 的 Host 插件，在 SkillHub 插件目录 中归类为「趣味换装」。它在宿主启动时向 boot 页注入运行时脚本，用全屏 overlay 播放你指定的媒体，不阻塞后台加载；配置与试播集中在右侧栏「开机美化」面板。README 标明适用于 DeepSeek Harness 桌面版（Windows），在 0.2.1-rc.3 上开发与验证；package.json 要求 dsh 引擎 >=0.2.0-rc.1。许可证为 MIT。
核心功能¶
视频与音频¶
- 支持 mp4 / webm，建议 1080p、单文件 ≤30MB，播放上限 1–10 秒（可截断或按全长，全长仍 ≤10s）。
- 声音可来自视频音轨，或单独指定音频文件；音量档位为 high / medium / low / custom，并支持淡入淡出（
fadeInMs/fadeOutMs）。
播放模式与转场¶
- 播放模式：
everyColdStart（每次冷启动）、dailyFirst（每天首次）、firstLaunch（仅首次启动）；默认dailyFirst。 - 转场：
fade（淡出）、zoomBlur（缩放模糊）、shatter（镜片破碎，README 描述为 HARNESS 破镜而出）。
跳过与面板¶
- 可跳过：左键双击、空格连按两次、Esc；可整体关闭跳过；跳过时音频行为可设为 fade / stop / custom。
- 右侧栏提供媒体选择、参数调整、小窗预览与「全屏试播」（试播不计入播放额度）。
安全兜底¶
文件缺失、解码失败或超出上限时回退默认启动屏，避免黑屏。
安装与启用¶
在 PowerShell 中执行官方安装命令：
dsh plugin --profile desktop add github:hkhlpj/dsh-boot-theme
从本地开发目录安装时使用：
dsh plugin --profile desktop add link:<本目录绝对路径>
安装后完全退出并重启 DeepSeek Harness，插件才会生效。
插件以当前 DSH 进程权限运行；安装前可在 GitHub 仓库 查看源码与 MIT 许可证，自行判断是否满足环境与安全要求。
典型用法¶
- 打开右侧栏 → 引导页 / 「＋」→ 开机美化。
- 视频：选择 mp4 / webm（建议 1080p、≤30MB）。
- 声音：选择独立音频，或使用视频自带音轨。
- 播放：总开关、播放模式、时长（1–10 秒）。
- 转场与跳过：选择转场效果、跳过手势与跳过时的音频行为。
- 预览：小窗看画面，点「全屏试播」走完整效果。
保存后下次冷启动生效；试播立即生效。
配置持久化在 ~/.dsh/storage/boot-theme/settings.json，也可只在面板里改。常用字段包括：enabled（总开关，默认 true）、playMode、maxSeconds（默认 3）、durationMode（cap / full）、videoPath、audioPath、transition、skipEnabled、fit（cover / contain）等；完整表格见仓库 README。
适用场景与注意¶
适合谁：在 Windows 上使用 DSH 桌面版、希望冷启动有自定义片头、且愿意自己准备短视频资源的用户。
务必知晓的限制（来自 README「已知限制」）：
- 仅桌面端生效；用浏览器打开
127.0.0.1:端口不会播放。 - 仅 Windows：选文件走系统原生对话框。
- 桌面版单实例：运行时再次双击只会聚焦窗口，不会重播开机动画。
- 视频建议 H.264、faststart；无碎屏音效，声音只来自视频或所选音频。
- 卸载插件不会自动删除
~/.dsh下的设置与存储。
DSH 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装第三方插件前请自行审阅代码与权限。
结尾¶
dsh-boot-theme 把冷启动开机动画做成可配置插件：媒体、模式、转场与跳过都在 DSH 内完成，加载与播放并行，并有失败回退。需要详情与 issue 时，可访问目录页 skillhub.cn/plugins/hkhlpj/dsh-boot-theme 与源码 github.com/hkhlpj/dsh-boot-theme。
