前言¶
在 DeepSeek Harness（DSH）里做智能体开发或日常使用时，界面背景往往由主题统一管控。想单独把整窗、面板、浮层或侧边栏调成更顺眼的颜色，通常要改主题配置或等页面重载，反馈慢，也不方便在浅色、深色两种模式下分别试色。
dsh-plugin-bg-color 是社区维护者 fox007xp 发布的 DSH 插件，分类为「趣味换装」。它通过悬浮面板在 Web 界面里实时调整上述区域的背景色，每次修改都作为主题 token 覆盖层生效，不重载页面；选择会写入 localStorage，刷新后自动恢复。
这是什么¶
插件全名 dsh-plugin-bg-color，当前 README 对应版本为 1.1.3（MIT 许可证）。它解决的是「在不替换整套主题的前提下，快速试背景配色并持久化偏好」——用的是 theme.overrideTokens() 叠一层覆盖，卸载时可以干净撤掉，而不是替换主题本身。
GitHub 仓库：https://github.com/fox007xp/dsh-plugin-bg-color
社区目录页：https://www.skillhub.cn/plugins/fox007xp/dsh-plugin-bg-color
核心功能¶
面板浮在 Web 界面右下角，主要能力如下。
- 8 套配色组合：每套同时提供浅色与深色两版，点一下即可预览；预设停留在明度安全区（浅色版主底 ≥
#ed，深色版 ≤#2c），降低把主题自带文字颜色「顶掉」的风险。 - 分区微调：原生取色器，以及可直接粘贴十六进制值的输入框。
- 浅色 / 深色分栏：两种模式可分别调整；面板上会标出当前实际生效的是哪一种。
- 全部重置：撤掉覆盖层，回到内置配色。
覆盖的 DSH 内部 token 如下（将来若 token 改名，可能仅外观退化，不至于导致界面渲染崩溃）：
| 区域 | Token |
|---|---|
| 整窗底色 | --dsw-alias-bg-base |
| 一级面板 | --dsw-alias-bg-layer-1 |
| 二级面板 | --dsw-alias-bg-layer-2 |
| 浮层与弹窗 | --dsw-alias-bg-overlay |
| 侧边栏 | --dsw-specific-sidebar-fill |
用户选择在 localStorage 的键 dsh-plugin-bg-color.regions 中持久化。
安装与启用¶
插件以当前 DSH 进程的权限运行；安装前建议自行查看仓库源码与 MIT 许可证。
从插件市场安装¶
前提：DSH 的插件市场能力默认关闭，需先启用官方实验 bundle，否则 Plugins 页不会出现 Discover 标签。
- 打开 Plugins 页 → Experimental plugins → 打开 Custom plugin indexes。
- 打开 Discover，将下列地址加为索引源：
https://raw.githubusercontent.com/fox007xp/dsh-plugin-bg-color/main/index.json
- 索引抓取成功后，在列表中找到「背景色调节」并执行 Install。
若找不到 Custom plugin indexes 相关开关，说明市场能力尚未启用，需先完成第一步。
直接安装本地目录¶
适合改代码并希望立刻看到效果的场景：
plugin_manager install_bundle, target: <本目录路径>
Host 侧入口为 index.js（不声明服务、没有配置）；Client 侧为 client.js（面板与 token 覆盖），通过 cordis.patch.yml 注入。
典型用法¶
安装并激活插件后：
- 在任意 Web 视图下打开右下角悬浮面板（挂在
shell.overlay，浮于各列之上）。 - 点选 8 套预设之一，观察整窗与各层背景是否合意；若当前为浅色或深色模式，预设会按 README 说明在两种模式下分别生效。
- 需要细调时，在对应分区用取色器或十六进制输入框修改单项背景。
- 在浅色 / 深色分栏中分别调整另一种模式下的颜色。
- 不满意时选「全部重置」，回到主题内置配色。
刷新页面后，上次保存在 dsh-plugin-bg-color.regions 中的选择会自动恢复，无需重新点选。
适用场景与注意¶
适合谁：长时间盯 DSH Web 界面、想微调背景层次又不想动整套主题或频繁重载的开发者与用户；社区目录将其归在「趣味换装」类。
已知限制（来自仓库 README）：
- 仅暴露上述 5 个背景 token；品牌色、边框色、文字色仍由主题管理。
- 覆盖背景不会重算对比度；中间灰度可能导致文字难以辨认，因此预设刻意避开中间调。
- 索引更新有两层缓存：GitHub raw 的 CDN（README 实测约 50 秒）与 Host 的索引缓存（默认 10 分钟），市场列表更新可能略有延迟。
市场能否抓取、安装参数能否装上、装进 profile 后能否激活等，仓库中的 VERIFICATION.md 有逐条记录，并标注了未验证项。
结尾¶
dsh-plugin-bg-color 把「整窗、面板、浮层、侧边栏」五条背景 token 做成可即时预览、可分区微调、可分浅色深色保存的轻量覆盖层，适合作为 DSH 主题之上的外观微调工具。
- 目录页：https://www.skillhub.cn/plugins/fox007xp/dsh-plugin-bg-color
- 源码与完整说明：https://github.com/fox007xp/dsh-plugin-bg-color
