暖砂赤陶主题 gongshiyun/dsh-theme-claude-desktop

@gongshiyun/dsh-theme-claude-desktop

参考 Claude Desktop 界面风格，以及仓库 gongshiyun/openchamber-claude-desktop-theme （配色又源自思源主题 frostime/sy-theme-siyaude（砂源）），为 DeepSeek Harness（DSH） 制作的客户端主题插件：

暖砂画布 + 赤陶主色的浅色 / 深色双变体，外加一整套 Anthropic 字体排印层。

浅色外观

深色外观

上面两张是按 DSH 界面结构生成的示意图（node tools/make-mock.mjs → docs/mock-.html），文案全部虚构；颜色直接读 lib/client.js 的 token 表，所以不会和主题脱节。
真实截图会暴露工作区名与对话内容，因此仓库里不放。

特性

| 明暗双变体 | 两套取值同时注册，切换由 DSH 内置的「设置 → 通用 → 外观」（浅色 / 深色 / 跟随系统）驱动，插件本身不持有任何主题状态，也就不会和系统跟随、首屏 bootstrap、theme-color 元信息打架。 |
| 覆盖完整 | 共 133 个 token：90 个 --dsw-alias- 语义 token 100% 覆盖，外加 11 个 --dsw-specific-、被组件直接消费的 18 个 --dsw-static-、11 个 --shiki- 语法色，以及字体排印层。 |
| 字体排印 | 界面 Anthropic Sans、标题 Anthropic Serif（H1–H3 衬线）、代码 Anthropic Mono；没装字体时优雅回退到 Segoe UI / Georgia / Cascadia Code，中文各自接思源与系统黑体、宋体。 |
| 字号设置兼容 | 标题字阶完整保留 --dsh-content-font-delta 增量，「设置 → 通用 → 内容字号」的 12–17px 调节照常生效。 |
| 零残留 | overrideTokens 返回的 disposer 挂在插件 fiber 上，禁用或卸载插件即刻回到内置配色。 |

安装

插件是一个普通的「双半边」npm 包：host 半边（lib/index.js）只提供一条可挂载的组合条目，全部逻辑在 client 半边（lib/client.js）。

方式 A：按 bundle 依赖安装

cd "$DSH_HOME/profiles/desktop" # Windows: C:\Users\<你>\.dsh\profiles\desktop
pnpm add @gongshiyun/dsh-theme-claude-desktop

本包的 package.json 里声明了 dsh.bundle.patch，profile 的 dsh.profile.bundles 引用它时会自动把条目插入组合树。

方式 B：只在某个 profile 里挂一条（本机验证用的方式）

在该 profile 的 cordis.patch.yml 顶层加上：

- insert:
- id: theme-claude-desktop
name: '@gongshiyun/dsh-theme-claude-desktop'

保存后 DSH 会热加载这条 patch，无需重启。用 Settings → 插件 或 plugin_manager list_plugins 可以看到 include:theme-claude-desktop 处于 active。

方式 C：开发联调（本仓库直接当源码目录）

把仓库做成 junction / 软链放进 profile 的 node_modules，改 lib/client.js 即刻生效（DSH 的 client bundle 走文件监听 + HMR，浏览器端会自动重新加载该模块）：

New-Item -ItemType Junction
-Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\@gongshiyun\dsh-theme-claude-desktop"
-Target "D:\ai-code\dsh-claude-theme"

切换明暗

设置 → 通用 → 外观 里选「浅色 / 深色 / 跟随系统」即可 —— 这正是本插件选择「token 覆盖层」而不是「注册两个第三方主题」的原因：第三方主题 id 不进内置外观设置的 schema，重启就会丢；而覆盖层直接跟着内置偏好走，明暗与跟随系统全部免费获得。

想恢复默认配色，把插件禁用（Settings → 插件）或从 cordis.patch.yml 里删掉那一行即可。

字体

三段字体栈都遵循「Anthropic 字体优先 → 本机近似字体 → 通用族」：

| 用途 | 首选 | 回退链 |
| 界面正文 | Anthropic Sans Text / Anthropic Sans | Styrene B → Segoe UI Variable Text → Segoe UI → PingFang SC → Microsoft YaHei UI → Noto Sans SC |
| 标题（H1–H3） | Anthropic Serif Text / Anthropic Serif | Copernicus → Tiempos Text → Georgia → Noto Serif SC → 宋体 |
| 代码 | Anthropic Mono | Cascadia Code → JetBrains Mono → SF Mono → Consolas |

装了 Anthropic 字体就自动生效，不用改配置。安装方式见 matthieuhuguet/anthropic-fonts；在 Windows 上把 ttf 装到「为所有用户安装」，重启 DSH 即可。

想改成全无衬线标题，把 lib/client.js 里 --dsw-font-markdown-h1/h2/h3 三处 FONT_SERIF 换成 FONT_SANS 就行（这三条是 font 简写，必须整条重写，只改 -font-family 子 token 不会影响实际渲染 —— 这一点在文件头注释里有说明）。

配色

| 角色 | 浅色 | 深色 |
| 画布 bg-base | #FFFAF2 | #26221E |
| 侧栏 sidebar-fill | #F3EBDD | #1E1A16 |
| 输入卡片 input-major | #FFFDF9 | #2E2721 |
| 用户气泡 bubble | #F6E7D8 | #332B24 |
| 正文 label-primary | #3A2E24 | #E2D9CC |
| 次要文字 label-secondary | #776450 | #A39684 |
| 主色 brand-primary | #B85430 | #DF805B |
| 链接 link | #3B6A89 | #95BFD0 |
| 成功 / 警告 / 错误 | #4A7350 / #96651C / #A94636 | #A6C896 / #E3BC72 / #E48270 |
| 代码块底色 markdown-code-block | #F8F1E6 | #201B17 |

完整色板（含每个 token 的明暗取值、语义状态色、代码高亮色）见 docs/preview.html（可直接用浏览器打开）或渲染好的 docs/preview.png：

色板预览

已知限制

- 首屏仍用内置配色：加载页的 --dsh-boot- 由 host 在 index 响应里注入，第三方插件拿不到，所以从启动到 client 插件挂载之间会有一次极短的色差（通常只有一帧）。
首屏之后的 theme-color 元信息会跟随实际渲染的 body 背景。
- 个别硬编码颜色不随主题变化：例如 hovercard 的 #2C2C2E 是写在组件样式里的常量，不是 token。这类位置只能等上游把它 token 化。
- --dsw-static-* 是「与配色无关」的常量：本插件只改了被组件直接消费的 18 个（如文件卡片的 neutral-50/850），给的是能同时成立的中性暖值，而不是逐明暗切换的值。
- 第三方主题 id 不进内置外观 schema：因此本插件不做 ctx.theme.register()，只做 overrideTokens()。

开发

node tools/validate.mjs # 校验 token 表：成对取值、命名存在、调色板无冗余、alias 层覆盖率
node tools/make-preview.mjs # 由 token 表生成 docs/preview.html（色板）
node tools/make-mock.mjs # 由 token 表生成 docs/mock-light.html / docs/mock-dark.html（README 示意图）
node tools/extract-base-tokens.mjs # 从本机 ui-theme bundle 重新抽取内置 token 清单（升级 DSH 后核对）

Windows：抓一张当前 DSH 桌面端窗口截图（Web GUI 需要带 token 的 URL，直连会 401） .\tools\capture-dsh-window.ps1 -Out shot.png

渲染两份 HTML 用无头 Chrome 即可（示意图建议 2 倍像素密度）：

chrome --headless=new --disable-gpu --hide-scrollbars \
--force-device-scale-factor=2 --window-size=1224,788 \
--screenshot=docs/mock-light.png docs/mock-light.html

lib/client.js 的结构是：字体栈 → 明/暗两套调色板常量 → token 表 → apply()。
改配色只动调色板常量即可，tools/validate.mjs 会拦住写错的键名。

兼容性

- DSH >= 0.1.5-rc.1（依赖 ctx.theme.overrideTokens() 与 dsh.client 双半边包约定）
- 平台：web
- 依赖：仅 theme 一个 client service，不 require 任何外部模块（连 React 都不用）

许可

MIT