nevertoday/dsh-theme-plugin

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
49 锚色 × 亮/暗 = 98 主题 —— 点击展开

⭐ 为面板置顶的 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 及以上使用同一条命令。
sh
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 色彩数学，用环境变量指过去：
sh
ZH_COLORS_REPO=/path/to/zhongguo-traditional-colors pnpm generate

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

许可

MIT，见 LICENSE。