本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-theme-plugin

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-theme-plugin

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 验证 —— 浏览器控制台会打印 registered 98/98 themes (49 light / 49 dark)；dsh --profile web --dump-config 里应出现 theme-zhongguo 行。
• 更新 —— 把上面那条 add 再跑一次。
• 卸载 —— dsh plugin --profile web remove dsh-theme-plugin
• 必须带 -w，因为 profile 目录是 pnpm 工作区根。add 会以目录链接挂载并把包并入 dsh.profile.bundles；装载器直接读工作副本里的 lib/client.js，所以改动要靠 pnpm build 才可见。
• 仓库带一份 .npmrc（auto-install-peers=false）。缺了它 pnpm ≥ 9 装不上：它会去拉那些标了 optional 的 @deepseek-ai/* peer，而其中一个依赖着从未发布到 npm 的包。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后怎么确认插件生效了？

打开 DSH Web 端后查看浏览器控制台，看到 registered 98/98 themes (49 light / 49 dark) 这一行就说明 98 套主题已经全部注册成功。

主题选择会保存在哪里，会跟随账号同步吗？

记住的主题存在浏览器的 localStorage 里（键名 dsh:theme-zhongguo:theme），不会写入 settings.yaml，因此换设备或换浏览器都不会跟随。

安装后还需要额外配置吗？

无需任何配置。本插件刻意不暴露配置项，DSH 0.1 的客户端启动清单还不携带宿主插件配置，所以所有交互都走设置面板或 #theme= 深链。

怎么切换主题？

两种方式：在「设置 → 传统色主题」面板里点选，或者直接打开形如 http://127.0.0.1:3080/#theme=zhuqing-light 的深链；点选后会自动清除 hash 里的 theme= 参数。

怎么卸载？

执行 dsh plugin --profile web remove dsh-theme-plugin 即可，下次启动 DSH 时面板里的「传统色主题」入口会消失。

49 个锚色是什么？

49 个中国传统色（如竹青、朱红、群青、藤黄、绛紫等），每个锚色衍生出亮/暗两套主题，共 98 套，其中 12 个标为「精选」放在面板顶部。

主题对代码块的语法高亮有影响吗？

有。每个主题都填满 9 个 shiki 的 --shiki-token-* 槽位，五个彩色槽保留程序员熟悉的色相直觉，注释与标点则降为墨色而非彩色，保证可读性。

本地开发时为何必须带 -w 安装？

因为 profile 目录是 pnpm 工作区根；-w 让插件以目录链接方式挂载，并写入 dsh.profile.bundles，改动后必须 pnpm build 才能让宿主读到新的 lib/client.js。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（peerDependencies 标 *，实测面向 DSH 0.1.x 的 web 客户端）
• Node: >=20

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则