dsh-theme-plugin
Đã xác minhdsh-theme-plugin · v0.3.3 · MIT · Giao diện web
中国传统色 DeepSeek Harness 主题包 · Chinese traditional color themes for DeepSeek Harness
Cài đặt
dsh plugin add dsh-theme-plugin Xác nhận layer đã áp bằng dsh --profile default --dump-config — xem hướng dẫn cài plugin.
Mã nguồn
Thẻ
Tác giả
Readme
dsh-theme-plugin
以中国传统色为锚色的 DeepSeek Harness 主题包。49 个锚色 × 亮/暗 = 98 套主题，每套写满完整的令牌词表（98 个：89 个 --dsw-* + 9 个 --shiki-token-* 语法槽），3136 条对比度断言逐条通过 WCAG AA。其中 12 个锚色标为精选。
竹青·亮（素绢） | 朱红·暗（熟宣）
群青·亮（雪青） | 藤黄·暗（赭纸）
四种纸各取一个锚色，四张图是同一个会话。屏上最艳的那一块，永远是你选的那个色。
安装
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 色精选。显示名为 名·亮 / 名·暗，如 竹青·暗。印色一列是上文说的那枚配伍关系色 —— 它是落款，不是按钮的颜色。
| 传统色 | 锚色 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。