跳到主内容

dsh-theme-plugin

19Star1Fork0Issue0Watching

为 DeepSeek Harness 提供 49 锚色×亮暗共 98 套中国传统色主题,含设置面板与深链切换,全部通过 WCAG AA 对比度。

机审证据5/5方法论数据来源安装命令持续维护DSH 版本风险扫描
机审证据安装命令仓库已核验dsh-plugin Topic许可证READMEAI 百科
语言
JavaScript
License
MIT
分支
main
dsh-plugindsh-plugin-marketdsh-plugins

安装

命令web profile
$ dsh plugin --profile web add dsh-theme-plugin

在终端中运行以上命令,通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh?看这篇新手教程

对话式安装

帮我安装 DeepSeek Harness 插件 nevertoday/dsh-theme-plugin:先查看仓库 https://github.com/nevertoday/dsh-theme-plugin 确认安全性,然后执行安装命令并验证插件加载成功。

把这段指令粘贴给 DSH Web GUI 里的助手,由它代你完成安装与验证。

一句话定位

为 DeepSeek Harness Web 端提供一套以中国传统色为锚色的换肤方案:49 个锚色各生一亮一暗、共 98 套主题,覆盖设置面板里的颜色选择与 #theme= 深链切换,并把代码块的语法高亮一并主题化。

核心能力

  • 注册 98 套主题到宿主(49 个锚色 × 亮/暗),每套写满 98 个设计令牌(89 个 --dsw-* + 9 个 shiki 语法槽),全部通过 WCAG AA 对比度门
  • 在「设置 → 传统色主题」面板里提供浏览、按状态筛选、拼音/色名搜索、仅看精选四种找法,所见即所得(每行的色卡就是该主题实际呈现的纸、帘、焦点)
  • 支持 #theme=<id> 深链直跳,例如 http://127.0.0.1:3080/#theme=zhuqing-light 打开即为竹青·亮
  • 自动按当前页面是亮是暗决定面板先开哪一支,避免切换时反复闪烁
  • 把用户上次选的主题存进浏览器 localStorage,刷新后自动恢复;点选新主题会清除 hash 里的 theme= 参数,避免深链与记忆互相打架

技术实现

  • 语言: TypeScript(ESM)
  • 关键依赖: @deepseek-ai/cordis(宿主框架)、@deepseek-ai/dsh-client-runtime(客户端上下文)、@deepseek-ai/dsh-client-ui-theme(主题注册服务)—— 三者均为 optional peer
  • 架构模式: 插件被拆成「宿主半」与「客户端半」两个入口。src/index.ts 只做一件事:通过 cordis.patch.yml 把 theme-zhongguo 行插入到组合树里,apply() 故意留空;真正干活的 src/client/index.ts 在浏览器里调用 ctx.theme.register() 注册主题、监听 theme/change、写 DOM 令牌、挂载设置面板
  • 入口文件: src/client/index.ts(浏览器端,注册并应用主题)、src/index.ts(宿主半,仅声明插件名);构建产物 lib/client.js 是浏览器加载的实际包

适用场景

装了 DSH Web 客户端又长期盯屏幕的开发者/设计师,想换掉默认的浅深蓝配色、让界面更贴近个人审美或工作节奏;尤其适合既在意代码块可读性、又想用一整套有文化主题感而非随机配色的换肤方案的用户。

前置依赖与兼容性

依赖最低版本说明
Node.js>=20package.json#engines.node 声明,[email protected] 是配套推荐版本
DSH Web 客户端0.1.x(peerDependencies 标 *)仅在 web profile 下生效,需宿主暴露 theme / slots / locale 三个客户端服务
平台跨平台无 os / cpu 限制,浏览器侧运行
原生模块无不依赖 node-pty / node:sqlite 等原生模块

安装方式

dsh plugin --profile web add github:nevertoday/dsh-theme-plugin

配置项

本插件无需额外配置。

常见问题

Q: 安装后怎么确认插件生效了?

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

Q: 主题选择会保存在哪里,会跟随账号同步吗?

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

Q: 安装后还需要额外配置吗?

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

Q: 怎么切换主题?

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

Q: 怎么卸载?

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

Q: 49 个锚色是什么?

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

Q: 主题对代码块的语法高亮有影响吗?

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

上手难度

入门 —— 安装即可使用,不需要改任何配置;若要本地改色或重新生成主题,需要懂 OKLab 色彩空间和 pnpm 工作区。

已知问题与限制

  • 浏览器侧 bundle 体积较大:主构建约 640 KB + 934 KB sourcemap,esbuild 备胎略大;CI 用 680 KB / 1020 KB 预算把两者都卡住(README.md:179)
  • 本地开发必须用 pnpm ≥ 9 并保留仓库自带的 .npmrc(auto-install-peers=false),否则会试图拉取一份并未发布到 npm 的 @deepseek-ai/* peer 依赖而装不上(README.md:177)
  • 本地链路安装(dsh plugin add -w .)改代码后必须 pnpm build 才可见,因为宿主读的是工作副本里的 lib/client.js(README.md:172-176)
  • 源码中未发现 TODO/FIXME/HACK 标注;未声明 host 端 cordis 配置 schema(src/index.ts:5-17),DSH 0.1 客户端启动清单尚不携带宿主插件配置,因此也无处配置

查看使用指南 →

该插件的安装步骤、关键要点、FAQ 与兼容性说明(基于已收录字段派生)。

收录徽章

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/nevertoday/dsh-theme-plugin)

把这段 markdown 粘贴到你的 GitHub README,链接回本插件详情页。徽章只声明已被本站收录,不代表安全认证。

返回插件目录