前言¶
DeepSeek Harness（DSH）把能力拆成插件，界面外观也可以由社区主题包接管。实际使用时常见几类麻烦：主题来源分散、包格式不一、和当前 DSH 版本是否匹配不好判断，装上去后白屏或设置入口失效又难回退。若只靠手工改 CSS 或逐个试包，成本高，也容易把正在用的 profile 弄乱。
下面介绍维护者 gulagala001 发布的 dsh-theme-plugin（社区分类：趣味换装）。它在 DSH 里集中提供外观设置、主题管理和主题市场，并在安装前做隔离运行检查；检查失败会保留当前可用外观并给出原因，必要时还可复制面向 AI 的修复任务说明。插件在 GitHub 上采用 MIT 许可，当前发布版本为 0.2.0-dsh.0.2.1-rc.2，面向 DSH 0.2.1-rc.2。
这是什么¶
dsh-theme-plugin 是 DeepSeek Harness 的主题与外观管理插件：浏览社区主题、一键检查并安装、管理已有与导入的主题，并协调与 DSH 原生主题基座的关系，避免同一套主题逻辑跑两份。
社区插件目录（如 SkillHub）是独立站点，与 DeepSeek / 幻方无官方从属关系；安装前请自行查看源码、许可证与第三方声明。
核心功能¶
三个设置入口¶
| 页面 | 作用 |
|---|---|
| 外观设置 | 明暗、配色、背景、字体、尺寸、圆角、透明度、动态、Logo／标题，以及受支持主题的专属项。 |
| 主题管理 | 查看内置、已装、导入与市场主题；启用、导出、移除和更新。 |
| 市场 | 多来源卡片展示说明与作者，支持搜索、风格筛选、热门／最新排序与一键安装。 |
README 中列出的内置方向包括 DSH 原生、Glyph 动态字符、Codex Desktop、iOS Liquid Glass、Claude CLI、Google Material 等，并提供 29 套配色。新装默认保留原生外观；若检测到已有主题或可迁移偏好，会承接当前选择。默认标题为 DeepSeek Harness，并保留主题侧的字体、造型与动态效果。
安装前检查与兼容边界¶
市场安装会先核对同包、同仓库是否有较新快照，并固定实际下载来源。源码型主题可自动准备客户端；检查在独立 DSH 与浏览器中覆盖加载、输入、设置入口、明暗切换、卸载与重挂载等。文档明确：预检不是恶意代码安全沙箱，也不能证明任意第三方代码在所有设备上绝对安全；主题功能与权限仍由原作者负责。
兼容声明与实际运行检查结果分开展示。未经验证的目录条目不标记为已兼容；依赖已移除旧接口的主题不会被强行装入。兼容以当前支持的 DSH 版本为基准，不为过老主题补旧接口。详情见仓库内 compatibility.md。
已有主题与文件导入¶
已由 DSH 原生管理的主题插件，由主题基座协调启停。文件导入支持已识别的 .json、.zip、.tgz；下载与适配尽量保留上游原包。
故障与升级¶
检查失败时保留原外观并显示具体原因。对旧条目或有问题的主题，会先查找同来源可用新版；无法兼容时可复制完整 AI 修复任务（见 ai-repair.md），修复包重新导入后仍须通过检查。升级 DSH 后，只声明经过适配的宿主版本；兼容器变化后受影响主题会重新检查，未通过前恢复可用外观。
数据与网络¶
主题库位于 DSH_HOME/dsh-theme-plugin/，按 profile 区分；部分外观偏好与自定义背景使用浏览器本地存储。市场浏览请求公开目录，安装请求 GitHub／npm／主题资源；主题管理本身不需要模型 Key，也不向市场上传会话。
安装与启用¶
适用环境： DSH 0.2.1-rc.2，Node.js 22.19+（见 package.json engines）。
在实际使用的 DSH 实例中，打开 插件 → ＋ 添加插件，粘贴官方发布包地址（勿自行拼接 dsh plugin add github:owner/repo）：
https://github.com/gulagala001/dsh-theme-plugin/releases/download/v0.2.0-dsh.0.2.1-rc.2/gulagala001-dsh-theme-plugin-0.2.0-dsh.0.2.1-rc.2.tgz
等当前任务结束后，按宿主提示启用或完整重启该实例，沿用原 profile 与数据。校验包可使用同版本 SHA256SUMS；其他宿主、升级与卸载见 install.md。
动态主题首次安装可能较慢：先进入暂存区，再启动匹配的独立 DSH 与浏览器检查；若无可用 Chromium／Chrome／Edge，会准备固定浏览器资源。失败不会跳过检查直接安装。
典型用法¶
安装并启用插件后，建议先完成下面一步，确认市场与检查链路正常。
- 打开 设置 → 外观 → 市场。
- 选择一套主题，点击 安装并应用。
成功标志： 安装前检查通过后，当前外观切换，主题出现在「主题管理」。
失败时： 保留原外观，界面显示具体失败原因；可按文档复制 AI 修复说明或改用其他已通过检查的主题。
日常可在 外观设置 微调明暗与配色，在 主题管理 中切换、导出或移除主题，在市场按风格或排序发现新包。
适用场景与注意¶
适合谁： 希望在同一 DSH 实例里统一管理外观、从多来源发现主题，并希望在装包前知道与当前 DSH 是否能在隔离环境里跑通的使用者与开发者。
权限与安全： 插件以当前 DSH 进程权限运行；第三方主题包会参与预检与加载。安装前应阅读 LICENSE、THIRD_PARTY_NOTICES.md 及主题原作者许可。
反馈： 问题可提交至 GitHub Issues，并附上完整 DSH／插件版本、入口、最小复现步骤及预期与实际表现（日志与截图请先脱敏）。
结尾¶
经过上面的步骤，你可以在 DSH 内用市场发现主题、用预检降低「装完不可用」的风险，并在失败时保留可回退的外观与可操作的修复线索。更多版本变化见 Releases；条目摘要与分类见 SkillHub 目录页，实现细节以 GitHub 仓库 为准。
