dsh-plugin-cds
Verifieddsh-plugin-cds · v0.1.1 · MIT · Web UI
Claude Design System theme for DeepSeek Harness: overrides 11 host design tokens (light + dark), ships the CDS scale and motion physics. No fonts, no network requests.
Install
dsh plugin add dsh-plugin-cds Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Readme
dsh-plugin-cds
给 DeepSeek Harness 换上 Anthropic Claude Design System 配色的客户端插件。
适配 dsh 0.2.1-alpha.1(Cordis ~4.0.5-alpha.1)。
它只改颜色:11 条宿主设计令牌、零网络请求、零 DOM 节点替换。
安装
dsh plugin add dsh-plugin-cds
或者手动声明进 profile 的 package.json:
{
"dependencies": { "dsh-plugin-cds": "^0.1.0" },
"dsh": { "profile": { "bundles": ["dsh-plugin-cds"] } }
}
然后完全退出 DSH 再启动。客户端插件不走 HMR,改配置不会热重载。
在「插件」面板往下滚到**「已安装」**段,能看到标题为 CDS 主题、带陶土橙图标的卡片。开关可即时启停。
它做什么
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%。加上 2 条派生令牌(button-primary-fill 跟着品牌色、menu-icon 跟着主文字色),实际影响约 13 条。
附带的两样东西
CDS 完整色阶 —— 219 条 CSS 自定义属性,供其它插件配色使用:
import tokens from 'dsh-plugin-cds/tokens';
动效物理常量 —— 4 条弹簧预设 + 4 条贝塞尔曲线:
import { SPRING_SNAPPY, CDS_EASING } from '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 —— 只往
<head>加一个<style>,不替换任何节点 - 不碰主题机制 —— 沿用 DSH 自己的
ThemeRuntime,不另建状态 - 不写盘 —— 不修改任何用户设置
- 不发网络请求 —— CSS 内联在 JS 里,不加载外部字体或图片
注入规模:样式表 45.9 KB(单个 <style>)、客户端脚本 51.4 KB、219 条属性声明、43 个工具类名、30 组 @keyframes、23 条 @property 注册。
已知不足
| 问题 | 说明 |
|---|---|
| 亮色错误色偏浅 | #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 处撞车全部良性。 |
写 DSH 插件会踩的坑
仓库里有一份 10 条静默失败记录:不报错、不警告,功能就是悄悄不生效。写客户端插件前值得先看一遍。
许可
MIT。CDS 令牌值来自 open-claude-ui 的 clean-room 逆向实现(MIT)。