亚麻暖色主题 Chuyuxuan0v0/deepseek-harness-theme-linen

Linen 主题

DeepSeek Harness Web 界面的暖中性主题。表面更温暖，圆角再圆一档，默认字体更锐利，亮色与暗色外观同时生效。

完整中文说明见下方 中文。

截图

应用主题后的亮色外观——新建会话界面，可以看到温暖的表面和更柔和的圆角阶梯：

Linen 主题应用于亮色外观下的新建会话界面

主题的设置页，位于 Settings → Linen theme：

Linen 主题设置页

改了什么

| 区域 | 效果 |
| 表面 | 页面、抬升层、浮层、侧边栏、代码块、滚动条统一换成暖中性色板 |
| 边框与文字 | 四档边框、七档文字重新调到同一条暖色阶梯 |
| 圆角 | 滑块在产品的 4/8/12/16/20/28 与最圆一档 8/14/18/24/28/36 之间逐档插值，默认取中间值 |
| 字体 | 默认正文与代码字体栈优先用 system-ui / Cascadia Code；强调字重从 600 降到 500 |
| 交互填充 | 悬停、按下、幽灵按钮、浮动按钮的填充跟随暖色阶梯 |

刻意不改的部分

下面每一项都受 Host 机制限制，与审美无关：

- 字号与行高——主题呈现层每次应用都会按 Settings 重写它们，一旦覆盖，Settings 里的字号步进器就失效了。要调字号请用 Appearance → font size。
- 层级与阴影 token——声明在 body, body 上，body 层的覆盖永远到不了真正使用它们的元素。
- 菜单材质——--dsw-menu-surface-fill 和 --dsw-menu-backdrop-filter 归主题所有，覆盖它们会破坏共享的菜单模糊约定。
- 产品图标——ThemeDefinition.icons 只存在于 ctx.theme.register，用它就会替换掉你的亮色/暗色偏好。
- 品牌色、链接色、状态色——主题一旦改掉成功、警告、错误或链接的颜色，就不再能传达状态。

圆形、胶囊、发丝线细节保留各自的字面几何；只有共享的 --dsw-radius- 阶梯跟随主题。

安装

这个包是自包含的：激活时不安装任何依赖（schema 库已内置）。用插件管理器安装，目标填本目录的绝对路径：

plugin_manager { action: "install_bundle", target: "<absolute path to this directory>" }

或者用打包好的 tarball：先解压，再让 install_bundle 指向解压后的目录。

安装完重载一次窗口。之后每次加载，主题都会立即生效。

更新

install_bundle 会拒绝已安装的包。先移除再重装：

plugin_manager { action: "remove_bundle", target: "dsh-theme-linen" }
plugin_manager { action: "install_bundle", target: "<absolute path>" }

替换已安装的包需要重启 dsh，浏览器才能加载新的模块代际。

配置

打开 Settings → Linen theme。改动立即生效，并存入 Host 设置文档，因此重启后依然保留，换浏览器也跟着你走。

| 设置项 | 取值 | 含义 |
| Enable the Linen theme | on / off | 关闭后恢复所有产品默认值 |
| Palette | Warm / Product | Product 保留原始配色，只应用圆角和字体 |
| Corner radius | 滑块，0–100% | 在产品圆角档位与最圆档位之间插值每一级圆角；0% 即产品档位 |
| Emphasis weight | 滑块，300–700 | 强调正文的字重，步长 100；产品默认为 600 |
| Body font | 字体列表 | 留空则使用主题字体栈；在 Appearance 里选定的字体仍然优先 |
| Code font | 字体列表 | 代码块、行内代码，以及终端之外的代码文本 |

拖动滑块会立即重绘，但只在手势结束时写入 Host，所以一次拖动只产生一次设置写入，而不是每像素一次。字体字段接受逗号分隔的字体族名，在失焦或按 Enter 时提交。

要求

- 一个带 Web 客户端的 DeepSeek Harness 配置档（dsh web 或桌面应用）。
- theme、slots、configForms、locale 这几个客户端服务，标准 Web 组合已提供。

目录结构

index.js Host half: the Config schema (all fields volatile)
client.js Browser half: the token layer and the settings page
cordis.patch.yml Bundle patch that inserts the plugin row
locale/.json Plugin manager title and description (8 languages)
icon.svg Plugin artwork
vendor/ Vendored @deepseek-ai/schemastery and cosmokit builds (MIT)
scripts/verify.mjs Package invariant checks, run by CI and locally
scripts/measure-apply.mjs Counts the token rebuilds one settings click causes
assets/ Screenshots used by this README (not packed)

发布

发布由 tag 驱动，无需任何配置：不用密钥，也没有本地构建步骤。

git tag v1.0.1
git push origin v1.0.1

随后 Release 工作流会校验包、构建 tarball，并把它挂到 GitHub Release 上，用的是 GitHub 自动提供的 GITHUB_TOKEN。推送的 tag 若已有对应 release，会替换挂载的产物，而不是报错。

打 tag 之前，每次 push 和 pull request 都会跑同样的检查，本地也可以跑：

npm pack --dry-run --json > /tmp/pack.json && node scripts/verify.mjs /tmp/pack.json
scripts/verify.mjs 守住几条不变量，否则它们会悄悄失效：浏览器模块 id 必须等于包名，设置命名空间必须等于补丁行 id，每个 Config 字段必须是 .volatile()，随包携带的 schema 库必须能从打包后的文件里解析到，每个语言区域都必须带标题和描述。

主题作者须知

- 每个 token 值都是 { light, dark } 一对。主题服务故意拒绝裸字符串：只给一个值，配色方案一翻转就看不清了。
- 这一层通过 overrideTokens 应用，所以「外观」偏好照常生效，主题也永远不会变成第四个选项。
- 设置字段必须是 .volatile()。设置目录只有在至少一个字段是 live 时才暴露命名空间，而 token 变更必须在不重新挂载浏览器插件的前提下生效。

License

本插件采用 MIT。随包携带的 @deepseek-ai/schemastery 和 @deepseek-ai/cosmokit 构建产物保留各自的 MIT 许可，一并放在 vendor/ 下。

一个暖中性主题。它让界面表面更温暖、圆角再圆一档、默认字体更锐利，亮色和暗色外观同时生效。

改了什么

页面与浮层底色、四级边框、七级文字色阶、侧栏、代码块与行内代码、滚动条、插画、悬停与激活填充，统一挪到暖中性色阶；圆角用滑块在「产品尺度 ↔ 最圆」之间连续调整；正文字体和代码字体优先使用 system-ui 与 Cascadia Code；加粗正文默认 500。

刻意不改什么

字号与行高（会被设置里的字号控件覆盖，改了那个控件就成了摆设）、elevation 与阴影（在 body, body 上逐元素声明，body 级覆盖到不了）、菜单材质（主题所有权，覆盖会破坏共享毛玻璃）、产品图标（只在 register 上，会顶掉你的亮暗偏好）、品牌色与状态色（改了就不再传达状态）。

圆圈、胶囊和发丝级细节保持自己的字面量几何，只有共享的 --dsw-radius-* 尺度跟随主题。

安装

这个包是自包含的，激活时不装任何依赖（schema 库已随包携带）。用插件管理器指向本目录的绝对路径安装：

plugin_manager { action: "install_bundle", target: "<本目录绝对路径>" }

安装后刷新一次窗口。之后每次加载都会自动生效。

更新

install_bundle 不允许重复安装同一个包，先移除再装，然后重启 dsh 让浏览器加载新的模块。

发版

推标签即可，不需要任何额外配置（不用配 secret，也不用本地打包）：

git tag v1.0.1
git push origin v1.0.1

Release 工作流会自动校验、打包并把 tgz 挂到对应 Release 上，用的是 GitHub 自带的 GITHUB_TOKEN。同一个标签重跑会替换附件而不是报错。

推之前同样的检查也会在每次 push 和 PR 上跑，本地也可以跑：

npm pack --dry-run --json > /tmp/pack.json && node scripts/verify.mjs /tmp/pack.json

配置

打开 设置 → 亚麻主题。改动立即生效，保存在宿主设置文档里，重启后仍在，换浏览器也跟随。可调：启用开关、配色（暖中性 / 产品原色）、圆角滑块（0–100%，0% 就是产品尺度）、强调字重滑块（300–700，以 100 为步进）、正文字体、代码字体。

拖动滑块时画面立即跟手，但只在松手时才写入宿主，所以一次拖动只产生一次设置写入，而不是每个像素一次。

字体输入框接受逗号分隔的字体名，失焦或回车提交；留空则使用主题自带的字体栈，而你在「外观」里手选的字体始终优先。