前言¶
在 DSH（DeepSeek Harness）桌面版里，主题和皮肤插件通常管的是整体观感；若只想把对话正文、代码块、侧栏终端或「思考 / 运行命令」等工作步骤的文字换成自己习惯的颜色，往往要么改不动细粒度区域，要么和换肤、强调色互相覆盖。维护者 anticbv 的 dsh-plugin-font-color 面向这类需求：在官方「设置 → 通用」里插入分组，对四个作用域分别调色，且只染对话区相关子树，状态写入宿主文件以便跨重启保留。
这是什么¶
dsh-plugin-font-color 是 DSH Web GUI 侧的字体颜色插件（npm 包名同仓库名）。它把 正文、代码、终端、工作步骤 四类文字颜色的配置放进官方通用设置页，位置在「字号大小」与「工作步骤展示」之间；未单独设置的作用域会跟随主题（代码→正文、终端→代码），与 dsh-dream-skin 等皮肤插件的换肤、强调色、壁纸互不覆盖，全部清空可回到原生观感。
仓库：https://github.com/anticbv/dsh-plugin-font-color
社区目录：https://www.skillhub.cn/plugins/anticbv/dsh-plugin-font-color（独立站点，与 DeepSeek / 幻方无官方从属关系）
许可证：MIT（© 2026 anticbv）
package.json 版本：0.2.0；README 标注 DSH Desktop 0.2.1-rc.3 为验证级适配。
四个作用域，互不干扰¶
下面按 README 说明各作用域的染色范围。
- 正文字体颜色——仅作用于对话区正文文字；侧栏、设置、菜单仍用主题色。
- 代码字体颜色——代码块、行内代码、聊天内工具终端块。
- 终端字体颜色——侧栏终端。
- 工作步骤字体颜色——会话中「思考 / 运行命令」等工作步骤条目。
取色控件复刻 dsh-dream-skin 的强调色控件：色块 + hex、「选色…」、「随机」、「恢复主题色」、12 色预设色板；分组可折叠，交互与官方「字号大小」组同构。
跨重启持久化¶
颜色状态不依赖浏览器 localStorage，而是写在宿主文件：
$DSH_HOME/dsh-font-color.json
Windows 下默认 $DSH_HOME 为 C:\Users\<用户名>\.dsh。这样可避免桌面版每次启动端口变化导致 localStorage 失效的问题（插件文档 docs/NOTES.md 中有说明）。
安装与启用¶
一句话安装（复制给 DSH）¶
README 提供的做法是直接把下面这段话发给 DSH，由它完成安装：
请帮我安装 dsh-plugin-font-color 字体颜色插件
（https://github.com/anticbv/dsh-plugin-font-color），装完告诉我如何重启 DSH。
方式一：插件管理器（推荐）¶
- 打开 设置 → 插件 → 安装。
- 安装源任选其一：
- Git 仓库地址：https://github.com/anticbv/dsh-plugin-font-color
- npm 包名（发布后可用）：dsh-plugin-font-color - 安装完成后 重启 DSH。
方式二：手动安装¶
- 下载或获取本仓库包体。
- 整体拷贝到
$DSH_HOME/profiles/<你的 profile>/node_modules/dsh-plugin-font-color/。 - 在该 profile 的
package.json中，将"dsh-plugin-font-color"加入dsh.profile.bundles数组。 - 重启 DSH。
验证是否生效¶
打开 设置 → 通用，在「字号大小」与「工作步骤展示」之间应出现 「正文字体颜色」 等分组。
排障时可在渲染进程控制台搜索 [font-color]；能力探针命中计数在 window.__DFC_STATUS__。
典型用法¶
- 重启并进入 设置 → 通用，展开「正文字体颜色」等分组。
- 对需要的作用域选色：可用 hex、系统选色、随机、预设色板，或「恢复主题色」取消该作用域自定义。
- 只改对话正文时，优先动「正文字体颜色」；代码、侧栏终端、工作步骤可分别设置，互不影响。
- 若同时使用皮肤类插件，本插件只改字体颜色，不覆盖皮肤的换肤与壁纸；想完全回到默认，清空各作用域即可。
适配版本与注意¶
| DSH Desktop 区间 | 级别 |
|---|---|
0.2.1-rc.3（含 0.2.1-rc.x） |
验证级（真机实测） |
>=0.1.0-rc.6 <0.3.0-0 |
声明级（能力探针兜底） |
>=0.3.0-0 |
未声明，升级后需重新评估 |
插件在 DSH 进程权限下运行，安装前建议浏览仓库源码并确认 MIT 许可证与上述持久化路径是否符合你的环境。>=0.3.0-0 的 DSH 尚未在 README 中声明支持，升级主程序后需自行验证设置页与染色是否仍正常。
结尾¶
dsh-plugin-font-color 把正文、代码、终端、工作步骤四类文字颜色拆成独立作用域，设置嵌在官方通用页，状态落在 $DSH_HOME/dsh-font-color.json，适合在保留主题与皮肤的前提下微调阅读对比度。详情与变更见 GitHub README 与 CHANGELOG；社区条目见 Skillhub 目录页。
