Claude 陶土主题 ztc1522021381/dsh-plugin-cds

dsh-plugin-cds

给 DeepSeek Harness 换上 Anthropic Claude Design System（CDS）配色的客户端插件。

适配 dsh 0.2.1-alpha.1（Cordis ~4.0.5-alpha.1），已在该版本上实测运行。

它只改颜色，不动别的：11 条宿主令牌、0 次网络请求、0 个 DOM 节点替换。

它做什么

DSH 定义了 118 条 --dsw-alias- / --dsw-specific- 设计令牌。本插件覆盖其中 11 条，每条同时给亮色和暗色两套值。

最明显的变化是品牌色：DSH 原本亮色用近黑 #0f1115、暗色用近白 #f9fafb，CDS 统一改成陶土橙 #c6613f。

| 令牌 | 亮色 DSH → CDS | 暗色 DSH → CDS |
| brand-primary | #0f1115 → #c6613f | #f9fafb → #c6613f |
| bg-base | #fff → #fcfcfb | #151517 → #151515 |
| bg-layer-1 | #fff → #fff | #232324 → #1a1a19 |
| bg-layer-2 | #fff → #fff | #2c2c2e → #20201f |
| bg-overlay | #e9ecf2 → #fff | #61666b → #2c2c2a |
| border-l1 | #0000000a → hsla(0,0%,8%,.10) | #ffffff0f → hsla(0,0%,100%,.09) |
| border-l2 | #0000001a → hsla(0,0%,8%,.20) | #ffffff1f → hsla(0,0%,100%,.18) |
| label-primary | #0f1115 → #151515 | #f9fafb → #f5f5f5 |
| label-secondary | #61666b → #525252 | #cfd3d6 → #a3a3a3 |
| state-error-primary | #ec1313 → #ef4444 | #f25a5a → #f87171 |
| sidebar-fill | #f9fafb → #f9f9f7 | #1b1b1c → #0b0b0b |

覆盖占比 11 / 118 = 9.3%，其余 107 条保持 DSH 原值。加上 2 条派生令牌（button-primary-fill 跟着品牌色、menu-icon 跟着主文字色），实际影响约 13 条。

附带的两样东西

CDS 完整色阶 —— 219 条 CSS 自定义属性（--cds-surface-100、--cds-gray-750 等），供其它插件按 CDS 风格配色使用。界面本身不依赖它们。

动效物理常量 —— 4 条弹簧预设 + 4 条贝塞尔曲线，import 自 dsh-plugin-cds/motion：

| 预设 | 刚度/阻尼 | 阻尼比 | 超调 | 稳定时间 |
| SPRING_BOUNCY | 600/30 | 0.612 | +8.77% | 0.244s |
| SPRING_SNAPPY | 320/28 | 0.783 | +1.93% | 0.203s |
| SPRING_GENTLE | 380/18 | 0.462 | +19.49% | 0.427s |
| SPRING_HEAVY_SNAP | 1200/80, mass 0.1 | 3.652 | 0% | 0.258s |

它不做什么

- 不碰布局 —— 零 spacing / radius / font 令牌覆盖
- 不碰 DOM —— 只往 加一个 ，不替换任何节点
- 不碰主题机制 —— 沿用 DSH 自己的 ThemeRuntime，不另建状态
- 不写盘 —— 不修改任何用户设置
- 不发网络请求 —— CSS 内联在 JS 里，不加载外部字体或图片

注入规模：样式表 45.9 KB（单个 ）、客户端脚本 51.4 KB、219 条属性声明、43 个工具类名、30 组 @keyframes、23 条 @property 注册。

安装

1. 构建
node tools/build.mjs
node tools/build-plugin.mjs

2. 声明进 profile（幂等，自动备份）
node tools/install-profile.mjs

3. 镜像文件到 profile 两处副本
node tools/sync-profile.mjs

然后完全退出 DSH 再启动 —— 客户端插件不走 HMR，改文件不会热重载。

在「插件」面板往下滚到「已安装」段，能看到标题为 CDS 主题、带陶土橙图标的卡片。开关可即时启停。

已知不足

| 问题 | 说明 |
| 亮色错误色偏浅 | #ef4444 对 #fcfcfb 只有 3.67:1，低于正文要求的 4.5（图标/边框够用）。CDS 原值，未改动。 |
| 字体不生效 | CDS 定义了 --cds-font-anthropic-*，但字体文件未随上游发布，实际落到系统字体栈。只有字号/行高/字重生效。 |
| --cds-gray-750..900 仅亮色 | 暗色下靠 surface 阶梯兜底，个别 hover 态叠加可能与 CDS 原版有细微偏差。 |
| 全局作用域 | 43 个类名挂在 :root，未做 Shadow DOM 隔离。已扫描 DSH 全部 8135 个 JS 文件，5 处撞车全部良性。 |

开发

node tools/verify-all.mjs # 12 步自检

单独步骤：

node tools/make-icon.mjs # 生成 icon.png（手写 PNG 编码，无第三方依赖）
node tools/extract-tokens.mjs # CDS → 已求值 light/dark + 桥接表
node tools/build.mjs # 命名空间净化 + 暗色桥接 → dist/
node tools/build-plugin.mjs # 生成 lib/client.js（CSS 内联 + 令牌转置）
node tools/install-profile.mjs # 声明进 profile（幂等）
node tools/sync-profile.mjs # 镜像文件到两处副本并核对
node tools/diff-profile.mjs # 打印 profile 改动 + 逐字节比对

排查「插件到底装没装 / 面板为什么不显示」：

node tools/replay-list-bundles.mjs # 独立复现面板的 listBundles()
node tools/verify-panel-meta.mjs # 调真实的 readPluginMeta，看标题/图标/分区
node tools/read-pixels.mjs # 采样运行中窗口的像素，反推令牌是否生效

发布前清理本机路径：

node tools/scrub-paths.mjs --check
node tools/scrub-paths.mjs
node tools/fix-placeholders.mjs
node tools/ensure-prelude.mjs

写 DSH 插件会踩的坑

见 docs/dsh-plugin-notes.md —— 10 条静默失败的坑，每条都附验证方法。这些是本文档最实用的部分：不报错、不警告，功能就是悄悄不生效。

许可

MIT。CDS 令牌值来自 open-claude-ui 的 clean-room 逆向实现（MIT）。