前言¶

DeepSeek Harness（DSH）桌面端冷启动时，默认会先经过加载界面再进入聊天。若你希望启动阶段有固定叙事、进入会话后背景不再是一片纯色，通常需要分别找启动类插件和背景类插件，配置分散，某一侧出问题还可能牵连整次启动体验。

下面介绍社区维护者 LeeRolling 的 dsh-boot-suite（GitHub：LeeRolling/dsh-boot-suite，目录页：skillhub.cn 插件页）。它把「开机动画」和「聊天壁纸」收进同一个 DSH 插件：动画走设置页「启动动画」，壁纸走「聊天背景」，两侧在工程上独立挂载，README 明确说明一侧异常不应拖垮另一侧的正常进入与聊天。

这是什么¶

dsh-boot-suite 的定位是 DeepSeek Harness 开机套件——冷启动时的分幕动画，以及进入聊天后的底图、横幅与可选循环视频。当前 package.json 版本为 2.13.10，许可证 MIT，面向 Windows 与 Web 平台（安装说明以桌面端为主）。

默认内置叙事是 六幕序列（黑幕标识 → 过曝 → 暖白档案底板 → 五步交互式访问授权 → 色散故障揭幕 → 聊天壁纸）。自 v2.2.0 起，分幕以 数据模板 描述，幕数可在 1～24 之间替换，不必改死六幕。开机动画不是预渲染视频，而是 lib/splash.js 与 lib/splash.css 用 DOM、CSS 动画与 WebAudio 现场绘制；素材侧包含真声台词 mp3 与界面音效，缺失时可回落系统 TTS。

核心功能¶

开机动画半侧¶

六幕默认文案与交互如下（前两幕需点按钮或 Enter / 空格，其余按设计自动推进；语音未播完不推进，停留时长随音频）：

README 列出 33 项可调项（身份名称、编号、权限等级、配色、速度、音色、语速、各处文案等）。显示策略支持每次会话 / 总是 / 每天，可要求确认或允许跳过。配置写入 ~/.dsh/dsh-startup.json，优先在 DSH 设置页「启动动画」修改。

模板：自带 templates/<id>/template.json；用户模板放在 ~/.dsh/startup-templates/<id>/template.json，同 id 时用户目录优先。设置页可选模板，或直接改 dsh-startup.json 的 template 字段（留空为内置）。设置页可打开模板编辑器，经「商店」从 dsh-boot-suite-templates 的 index.json 安装模板，无需登录。v2.12.0 起支持导入 mp4 / webm / gif / png / jpg / webp（≤64MB）生成用户模板，并为「第一幕入场 / 第一幕→第二幕 / 第二幕→桌面」三段分别选择转场（交叉叠化、闪白、故障、扫描线等，时长 200–2000ms）。

v2.5.0 开机体验：首帧在文档解析阶段绘制以压住 DSH 默认 Loading 卡片；片头播放时标题栏透明、原生窗口按钮浮在动画上；片头结束两段式揭幕；设置页底部可比对 GitHub 最新版本。

聊天壁纸半侧¶

• 默认背景（v2.13.1）：插件自带一张默认底图（与开机动画第二幕鲸鱼娘静帧同源视觉），装好即可在聊天中看到；设置页「背景图」可切回「默认背景（内置）」或选「不用背景图」。
• 静态底图：将图片放入 ~/.dsh/chat-wallpaper/，按修改时间取最新自动应用。
• 大字横幅：矢量一行字铺满窗口，字号随窗口计算，浓度可调。
• 纱的浓度：叠在底图上的半透明层，深/浅外观各一套，便于正文可读。
• 文字明暗自适应（v2.13.9）：聊天正文按壁纸与纱叠合后的亮度自动提亮或压深；侧边栏与标题栏垫半透明面板，输入框交回 DSH 原生主题，避免白底白字。
• 窗口按钮固定高对比（v2.13.10）：最小化 / 最大化 / 关闭按钮颜色与 DSH 外观深浅固定配对，减少被壁纸底色「洗」成低对比；片头期间标题栏仍透明。
• 循环视频（v2.13.0，默认关）：mp4/webm 或壁纸引擎项目文件夹放入 ~/.dsh/chat-wallpaper/loops/（可增自定义目录），设置页「循环视频」可选静态 / 视频、手动或随机轮换，默认静音读本机。

配置在 ~/.dsh/chat-wallpaper.json，经设置页「聊天背景」调整。

维护与回滚¶

插件注入 首屏，异常时可能出现整块黑屏、界面无法点击跳过。仓库提供不依赖 UI 的脚本：根目录 卸载.cmd（等同 tools/emergency-uninstall.cmd）、tools/rollback.cmd、tools/make-backup.ps1；诊断日志在 ~/.dsh/boot-suite-diag.log。v2.13.3 起，安装/更新前会在桌面生成 紧急回滚-V<当前版本>（先完全退出 DSH 再双击）.cmd，仅回滚插件版本、不动用户设置。

从旧插件 dsh-startup-screen / dsh-chat-wallpaper 迁移时，需先 dsh plugin --profile desktop remove 卸掉旧包再装本插件。

安装与启用¶

安装前请 完全退出 DeepSeek Harness（窗口与托盘）；否则 profile 的 package.json 可能被进程锁住，导致安装失败。

方式一：双击安装（README 推荐）¶

1. 下载仓库 ZIP 并解压（或按你惯用的方式取得源码目录）。
2. 任务管理器确认无 DeepSeek Harness 进程。
3. 双击根目录 安装.cmd。
4. 重新打开桌面端。

脚本会自动定位 DSH CLI（即使 dsh 不在 PATH）、已初始化的 profile，卸掉同名旧插件，以 link: 方式安装并修正 bundles，最后自检。仅查看脚本将执行的操作、不实际安装：

powershell -File tools\install.ps1 -CheckOnly

在线一键安装（GitHub 直连）¶

在 PowerShell 中执行：

irm https://raw.githubusercontent.com/LeeRolling/dsh-boot-suite/main/install-online.ps1 | iex

或下载最新 Windows 压缩包：

https://github.com/LeeRolling/dsh-boot-suite/releases/latest/download/dsh-boot-suite-win.zip

安装包内出问题可运行 「诊断.cmd」；在线安装说明同样提到该诊断入口。

方式二：命令行¶

先完全退出桌面端，再执行（将 <仓库路径> 换成本地解压目录）：

dsh plugin --profile desktop add link:<仓库路径>

若 dsh 不在 PATH，桌面端自带 CLI 位于：

%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd

典型用法¶

1. 开箱体验：安装并重启 DSH 后，默认六幕动画与内置聊天底图即可生效；在设置页分别打开「启动动画」「聊天背景」微调，无需手改 JSON。
2. 换聊天图：把图片丢进 ~/.dsh/chat-wallpaper/，最新修改时间的文件会被选用；要恢复内置图，在设置页点「默认背景（内置）」。
3. 换启动叙事：设置页「启动动画」→ 模板下拉框；或从模板商店安装条目到 ~/.dsh/startup-templates/；高级用户直接编辑 ~/.dsh/dsh-startup.json 的 template 字段。
4. 本地预览动画：仓库 preview/index.html 为带设置面板的离线预览；preview/demo.html 为纯净演示页（README 中演示 GIF 由此录制，真实客户端含真声与界面音效）。
5. 改代码前：维护者要求改 lib/ 后运行 npm test（13 套冒烟测试）；动手改源码前可用 tools/make-backup.ps1 留快照。

适用场景与注意¶

适合谁：希望在 DSH 桌面端统一配置「启动仪式感 + 聊天视觉」、又希望两侧故障隔离的用户；分类上社区目录将其归为 趣味换装，GitHub 上约 15 stars、2 forks（以目录页与仓库公开数据为准）。

务必知晓：

• 插件以 当前 DSH 进程权限 运行，安装前请自行审阅 源码与 LICENSE，README 注明 MIT 仅覆盖作者原创代码与文案，视觉与音频素材有第三方来源与 未授权商业用途 的说明。
• 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；DSH 生态是「一切皆插件」，本文介绍的是社区插件，不是官方应用商店条目。
• 首屏注入类插件风险较高：黑屏时优先 完全退出 DSH 后双击 卸载.cmd 或桌面紧急回滚脚本，并把 ~/.dsh/boot-suite-diag.log 留给排查。

视觉与叙事部分模板标注原作者 沈宏宏 等公开作品的形式参考与工程复刻；喜欢上游动画应到原仓库支持原作者。

结尾¶

dsh-boot-suite 用一个插件同时覆盖 DSH 冷启动分幕动画与聊天壁纸：设置页分入口、配置分文件、运行时两半侧独立。Windows 用户可 安装.cmd 或在线脚本完成安装；异常时有 卸载.cmd 与版本回滚手段。

• 社区目录：https://www.skillhub.cn/plugins/LeeRolling/dsh-boot-suite
• 源码与完整说明：https://github.com/LeeRolling/dsh-boot-suite