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，所以换设备不跟随。

四种找法

面板只引用 --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。

主题总览

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

| 传统色 | 锚色 hex | 纸家族 | 印色 | 亮色主题 id | 暗色主题 id | |---|---|---|---|---|---| | 竹青 | #00A86B | 素绢 | 茜红 | zhuqing-light | zhuqing-dark | | 朱红 ⭐ | #ED5126 | 熟宣 | 赭石 | zhuhong-light | zhuhong-dark | | 群青 | #1772B4 | 雪青 | 枫叶红 | qunqing-light | qunqing-dark | | 藤黄 | #FFD111 | 赭纸 | 瑶碧 | tenghuang-light | tenghuang-dark | | 绛紫 ⭐ | #8E354A | 熟宣 | 洋葱紫 | jiangzi-light | jiangzi-dark | | 紫云 | #A020F0 | 雪青 | 蜻蜓红 | ziyun-light | ziyun-dark | | 玫红色 | #FF007F | 熟宣 | 品红 | meihongse-light | meihongse-dark | | 淡曙红 | #EE2746 | 熟宣 | 殷红 | danshuhong-light | danshuhong-dark | | 绀青 | #4F84FF | 雪青 | 落霞 | ganqing-light | ganqing-dark | | 玫瑰紫 | #BA2F7B | 熟宣 | 高粱红 | meiguizi-light | meiguizi-dark | | 鹦鹉绿 | #5BAE23 | 素绢 | 猩红 | yingwulv-light | yingwulv-dark | | 菠萝红 | #FC7930 | 熟宣 | 芙蓉红 | boluohong-light | boluohong-dark | | 覆盆子红 ⭐ | #AC1F18 | 熟宣 | 苋菜红 | fupenzihong-light | fupenzihong-dark | | 苍碧 | #2A52BE | 雪青 | 猩红 | cangbi-light | cangbi-dark | | 雄黄 ⭐ | #FF9900 | 赭纸 | 绀青 | xionghuang-light | xionghuang-dark | | 琥珀黄 | #FEBA07 | 赭纸 | 绀青 | hupohuang-light | hupohuang-dark | | 魏紫 | #7E1671 | 雪青 | 魏紫·深 | weizi-light | weizi-dark | | 橄榄黄绿 | #BEC936 | 素绢 | 魏紫 | ganlanhuanglv-light | ganlanhuanglv-dark | | 火砖红 | #CD6227 | 熟宣 | 淡可可棕 | huozhuanhong-light | huozhuanhong-dark | | 香叶红 | #F07C82 | 熟宣 | 鹅冠红 | xiangyehong-light | xiangyehong-dark | | 烟萦紫 | #8A4B9C | 雪青 | 烟萦紫·深 | yanyingzi-light | yanyingzi-dark | | 韎韐 | #A5441B | 熟宣 | 蟹蝥红 | meige-light | meige-dark | | 綟绶 | #6B8E23 | 素绢 | 暗紫苑红 | lishou-light | lishou-dark | | 紫藤萝 ⭐ | #9B8AE8 | 雪青 | 淡罂粟红 | zitengluo-light | zitengluo-dark | | 汉绣绿 ⭐ | #2E7D32 | 素绢 | 绛紫 | hanxiulv-light | hanxiulv-dark | | 暗紫苑红 | #82202B | 熟宣 | 殷红 | anziyuanhong-light | anziyuanhong-dark | | 新绿 ⭐ | #6CC788 | 素绢 | 茜裙 | xinlv-light | xinlv-dark | | 菱锰红 ⭐ | #D276A3 | 熟宣 | 苋菜紫 | lingmenghong-light | lingmenghong-dark | | 满天星紫 ⭐ | #2E317C | 雪青 | 栗紫 | mantianxingzi-light | mantianxingzi-dark | | 孔雀蓝 | #0EB0C9 | 雪青 | 胭脂红 | kongquelan-light | kongquelan-dark | | 宝石蓝 ⭐ | #2486B9 | 雪青 | 朱墙 | baoshilan-light | baoshilan-dark | | 美蝶绿 | #12AA9C | 素绢 | 枫叶红 | meidielv-light | meidielv-dark | | 扁豆紫 | #A35C8F | 雪青 | 扁豆紫·深 | biandouzi-light | biandouzi-dark | | 浅紫藤萝 ⭐ | #D1B3FF | 雪青 | 杏子 | qianzitengluo-light | qianzitengluo-dark | | 青矾绿 | #2C9678 | 素绢 | 汉绣红 | qingfanlv-light | qingfanlv-dark | | 碧螺春绿 | #867018 | 赭纸 | 苍碧 | biluochunlv-light | biluochunlv-dark | | 橄榄石绿 | #B2CF87 | 素绢 | 酢酱草红 | ganlanshilv-light | ganlanshilv-dark | | 粉团花红 | #EC9BAD | 熟宣 | 锦葵红 | fentuanhuahong-light | fentuanhuahong-dark | | 荷叶绿 | #1A6840 | 素绢 | 栗紫 | heyelv-light | heyelv-dark | | 石绿 | #57C3C2 | 素绢 | 银红 | shilv-light | shilv-dark | | 柞叶棕 | #692A1B | 熟宣 | 栗棕 | zhayezong-light | zhayezong-dark | | 长春花蓝 | #7EC0EE | 雪青 | 香叶红 | changchunhualan-light | changchunhualan-dark | | 山梗紫 | #61649F | 雪青 | 满江红 | shangengzi-light | shangengzi-dark | | 鷃蓝 | #144A74 | 雪青 | 枣红 | yanlan-light | yanlan-dark | | 粉绿 | #83CBAC | 素绢 | 梅红 | fenlv-light | fenlv-dark | | 玉鈫蓝 | #126E82 | 雪青 | 赭石 | yuqinlan-light | yuqinlan-dark | | 皮弁 | #8B5D33 | 赭纸 | 石青 | pibian-light | pibian-dark | | 橄榄绿 ⭐ | #5E5314 | 赭纸 | 满天星紫 | ganlanlv-light | ganlanlv-dark | | 黛紫 | #5D3A6F | 雪青 | 黛紫·深 | daizi-light | daizi-dark |

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

开发

要求：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（60 个测试，含对 lib/client.js 的装载锁）。两者都不需要起 harness。

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

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

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

许可

MIT，见 LICENSE。