dsh-theme-presets:在 DSH Web GUI 上叠一层配色家族

前言

DeepSeek Harness(DSH)的 Web 界面自带「浅色 / 深色 / 跟随系统」三种外观,但界面 token 仍是一套默认配色。若你长期在 DSH 里调试智能体、盯日志或改配置,希望界面风格接近 Nord、Dracula 等常见编辑器主题,又不想手改 CSS 变量,就需要在「明暗模式」之上再选一层配色家族。

下面介绍社区插件 dsh-theme-presets(维护者 MicroSharpAnt,分类:趣味换装):在 DSH 内置外观之外,提供十一种可选预设,并与明暗模式正交组合。

这是什么

dsh-theme-presets 是 DSH Web GUI 的主题预设插件。它不改变「浅色 / 深色 / 跟随系统」的逻辑,只覆盖 --dsw-alias-* 层面的配色;选「默认」则恢复 DSH 自带配色。

当前包版本为 0.1.2(见仓库 package.json),许可证 MIT。浏览器端产物 lib/client.js 随仓库提交,安装后无需本地构建即可使用。

核心功能

  1. 十一个配色预设(另加「默认」):Nord、Dracula、Catppuccin、Tokyo Night、One Dark、Gruvbox、Solarized、GitHub、Everforest、Kanagawa、Rosé Pine。每个预设有独立的浅色、深色变体(例如 Nord 的 Snow Storm / Polar Night)。
  2. 与「外观」正交:预设只决定配色家族;明暗仍由「设置 → 通用」里上一行的「外观」控制。选 Nord 后,「浅色」对应 Snow Storm,「深色」对应 Polar Night,「跟随系统」则随系统在两者间切换。
  3. 设置界面色块预览:每个色块展示当前明暗模式下该预设的底色、强调色、正文色,并随「外观」变化。
  4. 持久化:选择写入当前 Web profile 的 cordis.patch.yml 中 theme-presets.config.preset,跨刷新、跨重启保留。
  5. 实现方式:各主题 15 个语义锚点定义在 presets.mjs,其余 token 由 deriveTokens() 通过 color-mix() 派生;配色取自各主题官方调色板,而非近似色。

安装与启用

在 DSH 的插件安装界面填入下列地址之一(以 README 原文为准):

https://github.com/MicroSharpAnt/dsh-theme-presets.git

也可以使用:

github:MicroSharpAnt/dsh-theme-presets

或:

git+ssh://git@github.com/MicroSharpAnt/dsh-theme-presets.git

注意:不要使用 git@github.com:... 这种 scp 语法。DSH 预检可能放行,但 pnpm 会把它拆成错误的包名与版本,日志里常见 added 0,实际未装上插件。

安装后无需构建即可使用。开发时可在安装界面填本地工作副本的绝对路径,改代码后需重启 dsh web 生效。

仓库曾用名 DSH-simple-theme-plugin,旧地址会重定向,建议直接使用上述新地址。

典型用法

  1. 安装插件并完成 DSH Web 侧加载。
  2. 打开 设置 → 通用 → 主题预设。
  3. 点击某个色块;需要恢复 DSH 原配色时选 默认。

明暗请在同页「外观」里切换,观察色块与界面是否随浅色/深色/跟随系统一起变化。

若自行改配色:编辑 presets.mjs 中 PRESETS 的 light / dark 锚点或新增预设,执行 npm run build 重新生成 lib/client.js,浏览器刷新即可;仅改配色不必重启 dsh web,若改了 host.js 或 src/plugin.mjs 则需重启。

适用场景与注意

适合:希望在 DSH Web 上使用与编辑器/终端一致的知名配色、又保留官方明暗切换的用户;趣味换装类插件,不改变业务逻辑。

注意:

  • 插件在当前 dsh 进程权限下运行,安装前应阅读仓库源码并确认 MIT 许可证与行为是否符合你的环境要求。
  • Node 引擎要求 >=20(见 package.json)。
  • 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护,与 DeepSeek / 幻方无官方从属关系;DSH 生态强调「一切皆插件」,本文安装方式以 README 为准,勿凭插件名自行拼接 CLI 安装命令。

仓库提供 npm test(进程外五个套件)与可选的 node e2e-test.mjs(需运行中的 dsh web 与本机 Chrome);端到端测试结束会恢复进入时的预设。

小结

dsh-theme-presets 在 DSH 内置浅/深/跟随系统之上,提供十一种可持久化的配色家族,设置路径清晰,与明暗模式分离。需要了解首屏无闪烁、宿主加载约束等实现细节时,可阅读仓库内 docs/internals.md。

  • 目录页:https://www.skillhub.cn/plugins/MicroSharpAnt/dsh-theme-presets
  • GitHub:https://github.com/MicroSharpAnt/dsh-theme-presets
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye