dsh-theme-plugin

以中国传统色为锚色的 DeepSeek Harness 主题包。49 个锚色 × 亮/暗 = 98 套主题，每套写满完整的令牌词表（98 个：89 个 --dsw-* + 9 个 --shiki-token-* 语法槽），3136 条对比度断言逐条通过 WCAG AA。其中 12 个锚色标为精选。

📖 English README

竹青·亮（素绢）  |  朱红·暗（熟宣）群青·亮（雪青）  |  藤黄·暗（赭纸）
四种纸各取一个锚色，四张图是同一个会话。屏上最艳的那一块，永远是你选的那个色。

安装

npx -y @deepseek-ai/dsh plugin --profile web add dsh-theme-plugin@latest
npx -y @deepseek-ai/dsh --profile web          # 启动 → 打开 http://127.0.0.1:3080/

装的是 npm 上的预构建产物，不用 clone，也不用构建。web profile 会在首次启动时自动建于 ~/.dsh/profiles/web。

• 验证 —— 浏览器控制台会打印 registered 98/98 themes (49 light / 49 dark)；dsh --profile web --dump-config 里应出现 theme-zhongguo 行。
• 更新 —— 把上面那条 add 再跑一次。
• 卸载 —— dsh plugin --profile web remove dsh-theme-plugin

使用

打开设置 → 传统色主题点选，即时生效。也可以用深链：

http://127.0.0.1:3080/#theme=zhuqing-light      # 竹青·亮
http://127.0.0.1:3080/#theme=qunqing-dark       # 群青·暗

改 hash 即时切换。深链优先于浏览器里记住的选择。记忆存在 localStorage，不写进 settings.yaml，所以换设备不跟随。

四种找法

翻 —— 默认摆开当前分支的 49 个锚色，按纸家族分组。每行的色卡就是这套主题实际交付的纸、帘、焦点，所以列表本身就是预览。
按状态 —— 六枚 chip 从左到右是一天：晨起 → 天亮。点 凌晨 夜航，拿到的是 8 套「暗而静」，不论它们是什么颜色。
搜 —— 色名、拼音、印色、档名都能命中。敲 lv 就能找出全部 12 套绿，不用切输入法。
仅精选 —— 12 套编辑推荐，覆盖四种纸与六个档。嫌 49 套太多时用它；面板自己也随主题变色，所以暗色分支长这样。

面板只引用 --dsw-* 令牌 —— 这正是它随你的选择变色、本身就是预览的原因。

设计：纸 · 帘 · 印

中国画不先上颜色，先备纸，再罩染，最后落款。这套主题按同一道工序施工，三个字对应三层。

纸 —— 约占屏幕六成。底不是「把传统色调浅」，而是另换一种材料。素绢、熟宣、雪青绢、赭纸四族的彩度被刻意拉开（OKLab 依次约 0.010 / 0.019 / 0.015 / 0.024），让四种纸是眼睛分得出的四种材料，而不只是数据上不同。亮色底定在 L ≈ 0.963–0.971：是暖白不是纯白 —— 纸退这一步，抬升面才有地方浮起来。

帘 —— 约占两成半。侧栏与气泡是锚色本人，不掺纸色，并被锁在与纸对比 1.25–1.55 的区间里：既淡不到消失，也硬不成一块色板。一眼认出是哪个传统色，靠气泡，不靠背景。

印 —— 焦点就是锚色本人。 主按钮与发送键都是锚色压深的版本。这条推翻了本包原先的律：那时主按钮填的是锚色的一枚配伍关系色，而它与锚色的色相中位差 109° —— 于是你选竹青，屏上最响的是一块茜红。那枚关系色仍在挑、仍逐主题记为 sealName / sealRel / sealWhy，只是退到导航选中态那一抹余痕上：是落款，不是焦点。面板会把挑它的道理写出来（「茜红 · 策展印 · 冷暖对冲」）。

墨 —— 文字、线、次级面走同一支墨梯，即纸色再压深。基础样式表里每个 nb-XX 台阶换成同明度的染色中性，悬停位移、海拔阶梯、边框与交互水洗的 alpha 逐一照抄：只换色相，不改关系。唯一有意的例外是墨梯的两个端点 —— 那是在这里定的，不是继承来的，因为基础样式表取的是极值。现在亮暗共用一个形状：正文 16.7–17.5，次级 7.4–8.0，三级 4.6–5.5。

语法 —— 代码块才是程序员视线真正住的地方，所以高亮也在主题之内。宿主的高亮器走 shiki 的 css-variables 主题（九个 --shiki-token-* 槽），每套主题都把它写满：五个彩色槽（keyword / string / constant / function / parameter）保留程序员已有的色相直觉，但颜色本人从 742 色名册里点名真实传统色；锚色色相落进某个槽的窗时，由锚色本人出演那个槽 —— 竹青主题的字符串就是竹青，群青主题的常量就是群青。注释与标点是墨不是彩：三级、次级墨对代码底重走一遍对比度门。九个槽对代码底全部 ≥ 4.5，五个彩色槽两两色相分离 ≥ 15°，都是断言。

闸门 —— AA 是地板，而「高级」住在天花板那一侧，所以多数规则是双向的。pnpm check 从产出的令牌重新推导上面每一条断言：3136 行对比度，外加帘彩度、唯一焦点（两个焦点令牌都必须是锚色本人的色相，且是全屏最艳的块）、语法槽色相分离、锚色露脸、层次方向与令牌覆盖等不变量。它不采信生成器对自己的任何说法。

六档 —— 49 个色名对不懂传统色的人不构成选项，所以每套主题还带一个「今天想怎么工作」的档。它是算出来的：判据只用锚色的 OKLab 明度、彩度、色相。

L < 0.50 ─┬─ C < 0.13 → 夜航（暗而静）
└─ C ≥ 0.13 → 爆肝（暗而烈）
C < 0.115 ──────────→ 禅定（淡而静）
暖(h<120 或 h≥315) ─┬─ L < 0.71 → 攻坚（暖而烈）
└─ L ≥ 0.71 → 收工（暖而明）
冷 ────────────────→ 心流（冷而浓）

面板按程序员的一天排：晨起心流 → 午后禅定 → 傍晚攻坚 → 深夜爆肝 → 凌晨夜航 → 天亮收工 → 又是心流。锚色分布是 心流 11 · 禅定 12 · 攻坚 8 · 爆肝 4 · 夜航 8 · 收工 6。

早先的设计是「五个模式各挑一套主题当代表」，结果面板里只有五行有标签、其余空着，读起来像数据缺失。改成划分之后，词汇量仍是六个，但每套主题恰好属于一档 —— 标签没有空洞，还能反过来当筛选维度。六档是这批数据的自然粒度：再切第七刀，无论切哪儿都会切出 1–3 套的瘦档，那就不再是「类」而是「名」了。档名是编辑主张，但那是六条主张，不是 49 条；pnpm check 用七个哨兵（群青→心流、碧螺春绿→禅定、朱红→攻坚、覆盆子红→爆肝、满天星紫→夜航、黛紫→夜航、雄黄→收工）把四条切线钉死 —— 树被改坏时哨兵会掉出来，而档名随便换。

精选 —— 49 个锚色里有 12 个带 curated 标记，点「仅精选」可收到这一组。一个锚的亮暗两套都必须没有生成器降级项。名单分三段推导：编辑种子 → 每档补一枚（六档都必须在精选里露面，否则收窄之后那个标签就没有一套主题可选，等于不存在）→ 用 OKLab 最远点采样补齐到 12。补位一律取「离已选集合最远」的那枚，所以覆盖六档没有牺牲「12 色在色彩空间里铺开」。

四族锚色分布：素绢 12 · 熟宣 14 · 雪青 17 · 赭纸 6。同一模式内，最接近的两套主题在四个签名维度（底、品牌、气泡、焦点）上仍相差 ΔE 0.018，门槛是 0.015。

主题总览

49 锚色 × 亮/暗 = 98 主题 —— 点击展开

⭐ 为面板置顶的 12 色精选。显示名为 名·亮 / 名·暗，如 竹青·暗。印色一列是上文说的那枚配伍关系色 —— 它是落款，不是按钮的颜色。

名册是生成器吐出来的，不手工维护。

开发

要求：Node.js 20+ 与 pnpm 10.15（由 packageManager 声明）。测试通过 tsx 运行，所以 Node 20 及以上使用同一条命令。

git clone https://github.com/nevertoday/dsh-theme-plugin
cd dsh-theme-plugin
pnpm install && pnpm build          # 构建 lib/client.js，即浏览器包
dsh plugin --profile web add -w .   # 挂载当前目录
dsh --profile web

• 必须带 -w，因为 profile 目录是 pnpm 工作区根。add 会以目录链接挂载并把包并入 dsh.profile.bundles；装载器直接读工作副本里的 lib/client.js，所以改动要靠 pnpm build 才可见。
• 仓库带一份 .npmrc（auto-install-peers=false）。缺了它 pnpm ≥ 9 装不上：它会去拉那些标了 optional 的 @deepseek-ai/* peer，而其中一个依赖着从未发布到 npm 的包。
• pnpm build 需要 tsdown；备胎是 node scripts/build-esbuild.mjs。
• lib/ 提不提交都行。主构建目前约 640 KB，sourcemap 约 934 KB（esbuild 备胎略大）；两种 builder 都受 680 KB / 1020 KB 发布预算约束。

DSH 0.1 的客户端 boot manifest 不携带宿主插件配置，因此本包有意不公开无效的 cordis.yml 配置块。用户只通过选择面板或 #theme= 进入，选择保存在浏览器里。

闸门 —— pnpm check（3136 行对比度 + 不变量）与 pnpm test（68 个测试，含对 lib/client.js 的装载锁）。两者都不需要起 harness。

重新生成主题 —— pnpm generate 要从中国传统色仓库读色卡数据与 OKLab 色彩数学，用环境变量指过去：

ZH_COLORS_REPO=/path/to/zhongguo-traditional-colors pnpm generate

它也会去上一级目录和同级检出里找，所以按常规布局摆放时不需要这个变量。两份可执行输入以 SHA-256 固定在上游 revision 3f5fc62；接受上游变更前必须先审 diff，再更新指纹。生成器是确定性的 —— 不读时钟、不用随机数 —— 输入不变，重跑必须字节一致。

许可

MIT，见 LICENSE。