前言¶
DeepSeek Harness（DSH）的 Web 客户端自带亮暗外观与若干 Appearance 选项，但默认视觉偏产品原色与固定圆角尺度。若你长时间在浏览器或桌面壳里跑智能体会话，界面冷暖与圆角、字体栈往往比换一套「第四套主题名」更实用——前提是改动仍走 Host 设置、不破坏状态色与菜单材质等契约。
下面介绍社区插件 Linen theme（包名 dsh-theme-linen），维护者为 Chuyuxuan0v0，在 SkillHub 目录中归类为「趣味换装」。它通过 token 层覆盖为 Web GUI 提供暖中性色阶，并附带 设置 → Linen theme（中文界面中为「亚麻主题」）独立配置页。
这是什么¶
Linen 是面向 DSH Web 界面的暖中性主题插件：表面更温暖、圆角可在产品尺度与更圆一档之间连续调节、默认正文字体与代码字体更偏 system-ui / Cascadia Code，亮色与暗色外观同时生效。关闭开关即可恢复产品默认，不会把 Appearance 里的亮暗偏好变成第四种主题选项——实现上通过 overrideTokens 叠加，而非替换 ThemeDefinition.icons 注册。
源码与说明见 GitHub：Chuyuxuan0v0/deepseek-harness-theme-linen。社区目录页：SkillHub 插件页。目录为社区站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，安装前请自行审阅源码与 MIT 许可证。
核心功能¶
视觉与交互 token¶
README 用表格归纳了主要影响范围，要点如下：
| 区域 | 效果 |
|---|---|
| Surfaces | 页面、浮层、侧栏、代码块、滚动条等迁至暖中性色阶 |
| Borders and text | 四级边框、七级文字色阶与暖色 ramp 对齐 |
| Corner radius | 滑块在各 --dsw-radius-* 档位间插值：产品尺度 4/8/12/16/20/28 与更圆尺度 12/20/26/34/40/52；滑块 100 对应早期版本曾 shipped 的最圆尺度 |
| Fonts | 默认正文与代码栈优先 system-ui / Cascadia Code；强调字重默认由 600 调整为 500 |
| Interactive fills | 悬停、激活、ghost 与浮动按钮填充跟随暖色 ramp |
圆圈、胶囊与发丝级细节保持字面量几何；只有共享圆角尺度跟随主题。
刻意不改的部分¶
下列项由 Host 机制约束，主题作者有意不覆盖（详见 README「What it deliberately does not change」）：
- 字号与行高——主题 presenter 每次 apply 会从 Settings 重写，应使用 Appearance → font size。
- Elevation 与阴影 token——在
body, body *上声明，body 级覆盖无法作用到消费端。 - 菜单材质（
--dsw-menu-surface-fill等）——覆盖会破坏共享菜单模糊契约。 - 产品图标——仅存在于
ctx.theme.register，会顶掉亮暗偏好。 - 品牌色与状态色（success / warning / error / link）——避免状态无法传达。
设置页字段¶
打开 Settings → Linen theme，改动立即生效，写入 Host 设置文档，重启与换浏览器仍保留。字段含义（与 README Configure 表一致）：
| 设置 | 取值 | 含义 |
|---|---|---|
| Enable the Linen theme | on / off | 关闭则恢复全部产品默认 |
| Palette | Warm / Product | Product 保留原色，仅应用圆角与字体 |
| Corner radius | 滑块 0–200 | 0 为产品尺度，100 为早期最圆尺度，200 更圆 |
| Emphasis weight | 滑块 300–700，步长 100 | 强调正文粗细；产品默认 600 |
| Body font | 字体列表 | 空则用主题栈；Appearance 中选的字体仍优先 |
| Code font | 字体列表 | 代码块、行内代码及终端外代码文本 |
拖滑块时界面即时重绘，仅在手势结束时写入 Host；字体字段为逗号分隔族名，失焦或 Enter 提交。
运行要求¶
- 具备 Web 客户端的 DSH 配置（
dsh web或桌面应用）。 - 标准 Web 组合需提供
theme、slots、configForms、locale等 client 服务。
包为自包含：激活时不安装额外依赖（schema 库已 vendored 在 vendor/）。
安装与启用¶
不要用仓库名自行拼接 dsh plugin add github:...；官方 README 给出的方式为插件管理器 install_bundle，指向本目录绝对路径：
plugin_manager { action: "install_bundle", target: "<absolute path to this directory>" }
若从打包的 tarball 安装，先解压再对解压目录执行上述命令。
安装完成后 刷新窗口一次；之后每次加载主题会自动生效。
更新¶
已安装的包无法再次 install_bundle，需先移除再装：
plugin_manager { action: "remove_bundle", target: "dsh-theme-linen" }
plugin_manager { action: "install_bundle", target: "<absolute path>" }
替换已安装包后需 重启 dsh，以便浏览器加载新模块 generation。
典型用法¶
- 按上文
install_bundle安装并刷新 Web 窗口。 - 进入 Settings → Linen theme，打开 Enable the Linen theme。
- 若只想保留产品配色、只调圆角与字体，将 Palette 设为 Product。
- 用 Corner radius 在 0（产品）与 100（早期最圆）之间找手感；需要更圆可继续向 200 调节。
- 正文与代码字体可在设置页填写族名，或继续在 Appearance 中选字体（Appearance 优先）。
README 提供亮色新会话界面与设置页截图路径：assets/light-appearance.png、assets/settings-page.png（仅文档用，不打进发布包）。
适用场景与注意¶
适合谁：长期在 DSH Web 或桌面壳中调试智能体、希望界面偏暖中性、圆角与字体可细调，且接受不改状态色与菜单材质的开发者。
权限与安全：插件随当前 DSH 进程与 Web 客户端加载运行，安装前应阅读 index.js、client.js 及 cordis.patch.yml，确认 bundle 行为与 MIT 许可符合你的环境策略。禁止在未审阅源码的情况下在生产环境 blindly install_bundle。
与产品设置的分工：字号、行高、亮暗外观仍走产品 Appearance；Linen 负责 token 层暖色、圆角插值、默认字体栈与强调字重等可在设置页关闭或部分保留（Palette: Product）。
结尾¶
Linen（dsh-theme-linen）把 DSH Web 界面的暖中性外观、圆角连续调节和字体偏好收进独立设置页，亮暗双模式一并生效，关闭即可回退产品默认。需要安装命令、字段说明与主题作者注意事项时，以 README 为准。
- 目录页：https://www.skillhub.cn/plugins/Chuyuxuan0v0/deepseek-harness-theme-linen
- GitHub：https://github.com/Chuyuxuan0v0/deepseek-harness-theme-linen
