dsh-theme：DeepSeek Harness 的可配置皮肤插件

DeepSeek Harness (DSH) 的 Web UI 支持通过配置调整外观，但直接修改样式文件不仅繁琐，而且难以维护。dsh-theme 插件提供了一套配置化的皮肤方案，将调色板、字体和图片槽位封装为配置项，内置了两套预设主题，且不修改 DSH 源代码。

插件定位¶

这是一个为 DeepSeek Harness Web UI 提供的“皮肤”插件，由开发者 naniwet 维护。其核心价值在于：将复杂的样式调整转化为配置文件的修改。你只需调整 YAML 配置即可更换整套 UI，无需修改 DSH 源码。

核心功能¶

• 配置化皮肤：调色板、字体和图片槽位均可配置。
• 内置预设：包含 Code Geass 和 SPY×FAMILY 两套预设。
  • Code Geass：使用金色 #c9a227 和深红 #a01c26，配合宋体/衬线体。
  • SPY×FAMILY：使用森林绿 #2f5d50 和玫瑰红 #d4788a，配合苹方/圆体无衬线体。
• 全面覆盖：覆盖背景、侧边栏、按钮、消息气泡、滚动条等所有 UI 表面。
• 本地存储：设置保存在本地，无需修改 DSH 的配置文档。
• 无侵入卸载：插件卸载时会自动移除样式，恢复默认 UI。

安装¶

使用官方命令安装插件：

dsh plugin --profile web add /path/to/dsh-theme

注意：如果使用 link: 方式安装本地目录，不会自动安装依赖。需在插件目录下手动运行 npm install，否则 profile 启动时会报错。

配置与使用¶

1. 启用插件：执行上述安装命令。
2. 切换皮肤：进入 DSH Web UI 的 Settings → General，在皮肤选项中选择预设（如 Code Geass 或 SPY×FAMILY）。选择即刻生效，浏览器会记住偏好。
3. 自定义配置：将预设文件复制到 $DSH_HOME/profiles/web/cordis.patch.yml。修改其中的图片路径或调色板数值。注意：config 块会替换整个条目配置，而非逐键合并，因此需保留所有需要的键。

注意事项与限制¶

• border9Slice 行为：该配置项仅绘制四个角落的装饰，并非完整的边框。
• 侧边栏折叠：当侧边栏折叠时，角色艺术会被隐藏。
• 图标匹配机制：内置图标通过 CSS 模块类名的子字符串匹配，若上游重命名类名，匹配可能会失效。
• active 配置：active 配置仅决定浏览器未做出选择前的初始视图，切换皮肤后以用户选择为准。
• 图片来源与许可：插件内置的粉丝艺术为 AI 生成，非官方素材，不包含在 MIT 许可证下。
• 权限范围：图片通过主机进程服务，浏览器无需文件系统访问权限。