常青森林主题 Frost-rA9/dsh-theme-everforest

适用于 Harness Web 界面的 Everforest

六套完整的 Everforest 配色，用于 Harness Web 界面。每套配色有一个深度（hard、medium 或 soft）和一个平面（light 或 dark）；Settings → General 里的选择器用来选深度，Appearance 设置用来选平面。

这个包是 Harness 客户端插件包：一行宿主记录，本身不带任何行为；再加一个自包含的浏览器模块，负责配色 token 层和设置行。

| 包名 | @local/dsh-theme-everforest |
| 客户端入口 | client.js（window.__ModuleLoader__.load） |
| 配色接口 | ctx.theme.overrideTokens('@local/dsh-theme-everforest', …) |
| 设置行 | settings.general.item，id 为 everforest，顺序 13 |
| 持久化 | localStorage['dsh-theme-everforest.depth'] |
| 覆盖的 token | 154 个（全部 base-sheet 别名、specific 与 themed-chrome token，外加语法） |

安装

在 Harness 会话里，用插件管理器安装这个包：

plugin_manager install_bundle
target: /absolute/path/to/dsh-theme-everforest

target 必须指向本仓库克隆后的绝对路径。

你也可以在 Web 界面的 Plugin Manager 页面里，指向这个目录来安装。这个包没有声明任何依赖，也没有安装脚本。

安装完成后，打开 Settings → General → Everforest，选一个深度。首次出现这个包时，刷新一下页面。

选择配色

设置行提供七个选项，每个选项同时设定深度和宿主主题偏好：

| 选项 | 作用 |
| Default | 移除 Everforest 层，恢复 Harness 内置配色 |
| Dark Hard / Medium / Soft | Everforest 的深色平面，并把 Appearance 固定为 Dark |
| Light Hard / Medium / Soft | Everforest 的浅色平面，并把 Appearance 固定为 Light |

选一个变体会设定两件事：深度，浏览器把它存在 localStorage 里，首次运行默认 medium；以及宿主主题偏好，通过 ctx.theme.setTheme 设定。安装好的 token 层对两种方案都带值，所以三个 Appearance 选项（Light、Dark、System）照常工作，决定这一层画哪一半。选 System 再配一个深度，页面就跟随操作系统，白天画 Light Medium，夜里画 Dark Medium。

深度是按浏览器保存的选择。主题服务只持久化三个内置偏好，而这个包刻意不声明宿主 Config——那会给一个本不需要构建期依赖的插件加上构建期依赖。

仓库结构

这个包就是一行宿主记录加一个浏览器模块，检查和配色文档放在旁边：

client.js palette data, token rules, token layer, settings row
index.js host half (no behavior)
cordis.patch.yml inserts the single loader row
icon.svg Plugin Manager artwork
locale/{en,zh}.json 插件管理器标题与描述
tools/check.mjs 覆盖率、颜色、对比度与清单校验器 tools/base-tokens.json 内置的基础 token 列表，来自 Harness 主题包 docs/PALETTE.md 上游调色板来源与六个平面 docs/MAPPING.md token 分组到调色板槽位的规则，以及对比度调校

运行检查

仓库不带构建步骤，你只需要下面这几条命令：

node --check client.js # browser half syntax
node --check index.js # host half syntax
node tools/check.mjs # full validation, non-zero exit on failure

tools/check.mjs 用一个垫片的 window 加载 client.js，校验生成的图层：对照 tools/base-tokens.json 检查 token 覆盖率、颜色合法性，以及全部六套调色板在 base、raised 和 sidebar 三种表面上的文字对比度。对比度检查采用 docs/MAPPING.md 中记录的 WCAG（Web Content Accessibility Guidelines）阈值。

Harness 升级改动主题包后，重新生成内置的基础 token 列表：

THEME_PACKAGE=@deepseek-ai/dsh-client-ui-theme
DSH_LIB="$(dirname "$(readlink -f "$(command -v dsh)")")/../node_modules"
node tools/check.mjs --extract \
--from "$DSH_LIB/@deepseek-ai/dsh/node_modules/@deepseek-ai/$THEME_PACKAGE"

提取器会读取该包里的 lib/client.js，找出 --dsw-alias-、--dsw-specific-、主题化 chrome 以及 --shiki- 名称，并扫描周边包中对 var(--dsw-static-) 的读取，因此静态补丁列表能跟上组件的实际消费情况。

已知限制

安装前有四点值得了解：

- 首屏闪烁：Harness 启动样式表在任何插件运行之前，就按持久化配色方案给画布上色，所以 Everforest 背景要等这个浏览器模块加载后才出现。这只是观感问题，而且对按浏览器生效的选择来说无法避免。
- 该图层是默认值，不是覆盖：在更深选择器上给 token 加阴影的组件，比如插件管理器的危险操作按钮，会保留自己的颜色。
- 未触及的属性：--dsw-focus-ring-color（交互行为）、阴影、圆角和字体保持原样。--dsw-static-neutral-00 和 --dsw-static-neutral-bluish-00 保持纯白，因为它们的消费方把它们当作半透明白色高光使用。
- 按浏览器生效的深度：选择保存在这个浏览器源下，不会通过配置档设置文档同步。

许可证

MIT。调色板取值与语法映射源自 sainnhe 的 Everforest（MIT）；见 LICENSE 和 docs/PALETTE.md。