前言¶
长时间在 DeepSeek Harness（DSH）里写提示、看回复和读代码块时，界面字体和主题往往只能跟着宿主默认走。系统级缩放或换显示器之后，字号和对比度不一定合适；想给侧边栏和内容区各定一套颜色，原生设置也未必够用。社区插件 dsh-stylebook（仓库 tsuixl/dsh-stylebook）把「界面文字 / 代码字体」和「三项主色 + 命名方案」收到 设置 → 外观 里，改完即时生效并写入 DSH Host。下面介绍它做什么、怎么装、怎么用，以及停用与卸载时要注意的点。
这是什么¶
dsh-stylebook 是 DSH 的外观插件：分别设置界面与代码的字体、字号、字重；用主题底色、侧边栏色、强调色三项调整主题（其余表面、文字和边框自动派生）；支持浅色、深色、跟随系统，以及内置与自定义的命名外观方案。维护者为 tsuixl。首个预览版本为 0.1.0-beta.1，通过 GitHub Releases 分发预构建包，尚未发布到 npm 或插件源；兼容范围暂定为 DSH 0.2.1-rc.5。项目在 SkillHub 目录页 可检索；该目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
字体¶
- 界面文字、代码字体分别选择字体、字号（10–22 px）和字重（Regular / Medium / SemiBold / Bold）。
- 字体菜单支持搜索名称、「读取系统字体」和手动输入；不支持或未授权时可搜索或输入名称。
- 保存的是字体名称，不会打包或上传字体文件；换设备缺少字体时使用回退字体。终端独立字体不在当前设置范围内。
配色与主题模式¶
- 在「配色」中通过色块或 HEX 编辑主题底色（主内容与浮层）、侧边栏、强调色；浅色与深色色板分别保存。
- 「主题模式」可选浅色、深色或跟随系统。
外观方案¶
- 提供四个内置方案，以及自定义方案的保存、选择、删除；修改不会覆盖原方案，仅自定义方案可删除。
- 修改即时应用并保存到 DSH Host；界面会显示保存状态，写入失败会以宿主实际接受值为准。
生命周期¶
- 恢复默认会保留自定义方案；停用插件会撤销 Stylebook 的界面和样式覆盖，原生明暗模式偏好仍保留。
- 从旧「七色」版本升级时，主内容区颜色迁移为主题底色，完整旧设置保留在插件
legacyBackup字段中（详见 README）。
安装与启用¶
安装和移除前应从托盘完整退出 DSH。从 v0.1.0-beta.1 Release 下载 .tgz，或使用自行构建的安装包。
在 PowerShell 中将路径替换为自己的桌面应用安装目录与安装包位置，使用该桌面版本自带的 CLI（不要使用另一套 npm DSH 管理桌面的保留 profile，也不要修改 app.asar）：
$dshCli = 'C:\path\to\DeepSeekHarness\resources\runtime\cli\bin\dsh.cmd'
& $dshCli plugin --profile desktop add 'C:\Downloads\dsh-stylebook-0.1.0-beta.1.tgz'
重新打开 DSH，进入「设置 → 外观」即可使用。
典型用法¶
经过上面的安装步骤后，可按 README 中的顺序调整：
- 在「主题模式」选择浅色、深色或跟随系统。
- 在「字体」分别调整界面文字和代码字体；需要时可点击「读取系统字体」。
- 在「配色」调整三项主色；其余区域由插件派生。
- 在「外观方案」选择已有方案，或「另存为方案」。
- 等待「已保存」后再认为设置完成；快速连续修改会按顺序保存，「完成」会等待期间新增的保存请求。
方案写入涉及插件配置与原生主题两个条目，不提供跨条目原子事务；部分失败时界面会明确提示。
适用场景与注意¶
适合谁：需要在 DSH 桌面版上细调阅读体验、统一代码块与界面字体，并希望用少量主色快速搭出可复用的浅色 / 深色方案的用户。
平台与验收：README 写明本项目以 Windows 桌面版验收为准；Web、macOS、Linux 尚未实测，代码共用不代表其他平台已通过验收。详情见仓库 验证记录（GitHub 上路径）。
安全与信任：插件在当前 DSH 进程权限下运行，会改写 Host 配置与界面注入；安装前应阅读 源码与 MIT 许可证，并只从 Release 或可信构建获取 .tgz。
卸载：完整退出 DSH 后执行：
& $dshCli plugin --profile desktop remove dsh-stylebook
需要保留个人方案时，先备份该 profile 的配置（尤其是 cordis.patch.yml）以及上一个可用的 .tgz；恢复时核对插件条目，避免用整份旧 profile 覆盖期间的其他修改。
结尾¶
dsh-stylebook 把 DSH 外观从「跟着默认走」变成可命名的字体与三色主题方案，适合在 Windows 桌面 DSH 0.2.1-rc.5 上先行试用。更多信息见 GitHub 仓库 与 SkillHub 目录页。
