dsh-appearance
轻量的 DSH 字体与主题插件：中英文字体分开选（只列本机已安装的），5 套官方色板预设（含代码块语法高亮），零依赖、零构建。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:LX-HMKK/DSH-appearance#2c89cdb957c970cae8d91b053e7d11cdc70522c4
Appearance 以 dsh-appearance 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
轻量的字体与主题插件 —— 给 DSH（DeepSeek Harness）桌面端 / Web 端加字体、配色预设、强调色与正文字号。不花哨：只改字体栈和颜色 token，没有动效、背景图或贴图皮肤。
| 轻 | 不打包字体文件、零运行时依赖、零构建步骤；仓库根就是插件包，两个 JS 文件 + 一份 38 个 token 的覆盖层，不改 DSH 源码 |
| 字体 | 中英文分两个框选，候选只列本机已安装的字体（Chromium Local Font Access）；代码字体单列 |
| 主题 | One Dark Pro（Darker 档）/ Dracula / Nord / GitHub / Catppuccin 五套官方色板；浅色一侧是 One Light / Alucard / Nord Light / GitHub Light / Latte |
| 覆盖 | 每个预设 38 个 token：底色、两级表面、四级文字、四档边框、状态色、代码块与 shiki 语法高亮——侧栏 / 菜单 / 代码块一起换 |
| 把关 | npm run check 逐个核对 token 名是否真的存在，并对 5 套预设 × 明暗两态 × 17 组做 WCAG 对比度检查，另有 54 项冒烟断言 |
| 预设 | 深色底色 | 浅色底色 | 强调色 | 关键字 | 字符串 |
|---|---|---|---|---|---|
| One Dark Pro | #23272E | #FAFAFA | #61AFEF | #C678DD | #98C379 |
| Dracula | #282A36 | #FFFBEB | #BD93F9 | #FF79C6 | #F1FA8C |
| Nord | #2E3440 | #ECEFF4 | #88C0D0 | #81A1C1 | #A3BE8C |
| GitHub | #0D1117 | #FFFFFF | #58A6FF | #FF7B72 | #A5D6FF |
| Catppuccin | #1E1E2E | #EFF1F5 | #89B4FA | #CBA6F7 | #A6E3A1 |
取各主题官方色值，不做主观发挥——One Dark Pro 深色用 Darker 档（底色 #23272E、侧栏 #1E2227、正文 #ABB2BF，语法色取自扩展自带的 OneDark-Pro-darker.json），Dracula / Nord / GitHub Primer / Catppuccin 同理。
只有两处偏离，都写在代码注释里：① 主题没公布的第四级灰阶按它自己的灰阶插值；② 浅色档里对比度不达标的原版彩色会压暗（例如 Latte 的粉彩）。
代码块底色取主题的面板/控件表面（VS Code 里 markdown 代码块就是这一层），所以代码块和对话底色一定分得开。组件级材质（菜单/浮层的模糊背板）与终端 ANSI 色不在覆盖范围内；明暗由「设置 → 通用」的外观切换决定，插件不另设开关。
插件是一个组合包（bundle）：带 dsh.bundle.patch 的 npm 包。
A. 界面安装（推荐，免命令行） —— DSH 左侧「Plugins」→「添加插件」，填本仓库的绝对路径（仓库根就是插件包）：
D:\path\to\dsh-appearance
B. 命令行安装
# 从仓库装
npx -y --package @deepseek-ai/dsh dsh plugin --profile desktop add https://github.com/LX-HMKK/DSH-appearance
# 或本地目录
npx -y --package @deepseek-ai/dsh dsh plugin --profile desktop add D:\path\to\dsh-appearance
装完会把这行追加进 profile 的 dsh.profile.bundles，重启一次 DSH，然后在「设置 → 外观」里用。
在 $DSH_HOME/profiles/<profile>/ 下做三件事：
package.json：dependencies 加 "dsh-appearance": "link:<本仓库绝对路径>"，dsh.profile.bundles 数组追加 "dsh-appearance"；node_modules/dsh-appearance 建目录联接（junction / symlink）指向本仓库根；node_modules/@deepseek-ai/schemastery → <profile>/node_modules/@deepseek-ai/schemastery。少了第 3 步会踩坑：目录联接会让 Node 按真实路径（本仓库）向上找依赖，而 DSH 的运行时包在 profile 里，宿主半侧的 import '@deepseek-ai/schemastery' 会直接 ERR_MODULE_NOT_FOUND。
校验（在 profile 目录里跑，解析链与真实 loader 一致）：
node -e "import('dsh-appearance').then(m => console.log(m.name, typeof m.apply, Object.keys(m.Config({}))))"
回滚：删掉依赖与 bundles 条目、删掉两个链接即可（安装前请备份 package.json）。
dsh-appearance-v1:{...}）、重置全部。| 字段 | 默认 | 含义 |
|---|---|---|
preset | default | 配色预设 id（onedark / dracula / nord / github / catppuccin） |
uiFont | '' | 界面与正文字体栈；空 = 跟随 DSH 默认 |
codeFont | '' | 代码字体栈；空 = 跟随 DSH 默认 |
accentLight / accentDark | '' | 强调色，按明暗档分别覆盖 |
surfaceLight / surfaceDark | '' | 背景色 |
inkLight / inkDark | '' | 文字色 |
手填值逐档合并：只填了深色档时，浅色档保留预设的值。认不出的预设 id（例如旧版本删掉的那几套）一律按 default 处理。
无构建步骤：改 index.js / client.js 直接生效。link 安装的 checkout 由 HMR 重载；替换版本号才需要重启。
npm test # 冒烟测试（54 项断言）
npm run verify # token 名 + 配色对比度
npm run check # 两个都跑（提交前必跑）
仓库根 = 插件包本体（awesome-dsh-plugin 的 CI 只从根 / packages / plugins / apps 读 package.json）
├─ package.json dsh.bundle.patch + dsh.client 两半侧的声明，以及开发用 scripts
├─ cordis.patch.yml 组合包层：插入插件行（行 id = 设置命名空间）
├─ index.js 宿主半侧：Config schema + 首屏字体注入
├─ client.js 浏览器半侧：设置页 + token 覆盖层（无构建）
├─ locale/{zh,en}.json 插件卡片的显示名与描述
├─ screenshots.json 插件市场详情页的截图清单
├─ assets/ 截图与配色预览图
└─ tools/ 开发工具（零依赖纯 Node）
├─ smoke-test.mjs 假 React + 假 ctx，把插件真跑一遍
├─ verify.mjs token 名校验 + 配色对比度校验
├─ gen-presets.cjs 色板 → 38 个 token 字面量的生成器
└─ asar.mjs 直接读取 DSH 的 app.asar（排查内部实现用）
两件事只有宿主（Node）能做：
Config（volatile 字段），浏览器半侧才能用 ctx.configForms.get('dsh-appearance') 读写。webserver/index-inject 是宿主侧的扩展点；客户端 CSS 要等 JS 模块图加载完才到。没有这一步，每次刷新都会先看到默认字体、再跳成用户选的字体。数据流：
用户改动
└─> ctx.configForms.get('dsh-appearance').set/unset
└─> Host 校验 + 写入 profile 的 cordis.patch.yml（volatile 字段，带 revision）
└─> 快照回流（subscribe）
├─> 宿主：下次渲染 index 时把字体写进 <head>（首屏即正确）
└─> 客户端：ctx.theme.overrideTokens('dsh-appearance', {...})
└─> ui-layout 把 token 写成 body 内联样式，即时生效
| 决策 | 原因 |
|---|---|
字体/颜色统一走 ctx.theme.overrideTokens | 官方给第三方留的主题扩展点：自带明暗双态、可撤销、随 HMR / 禁用自动回收。自己写 CSS 变量会和 ui-theme 的样式表打级联架。 |
首屏样式用 html:root 而不是 :root | 该行被插在 <head> 最前面，而 ui-theme 的 base.css 也是 :root。html:root 特异度更高（0,1,1 > 0,1,0），才能在样式表加载后继续生效；插件加载后由 ui-layout 的 body 内联样式接管，两者不冲突。 |
字号直接复用 ctx.theme.setFontSize | --dsh-content-font-size 由 ui-layout 在每次主题快照时重写，插件自己设会被冲掉；而且组件高度是按该轴的阶梯（calc(33px + var(--dsh-content-font-delta))）推导的，绕过去会错位。 |
fontSize: 13 与自己的字体名，并按自测字符宽度算 cols/rows；纯 CSS 改字体会让终端网格错位（终端 ANSI 配色同理不在覆盖范围内）。@font-face 放在后续版本。montserrat-*.woff2 旁边就是 Montserrat-OFL.txt）。codex-theme-v1: 主题串（字段映射到 --dsw-* token）。@font-face + 同源路由 + preload + font-display: block + 度量覆盖，避免会话滚动锚点抖动）。npx -y --package @deepseek-ai/dsh dsh plugin --profile desktop remove dsh-appearance
或在「Plugins → 已安装」里关掉 / 移除；卸载后本插件写入的 token 覆盖层与首屏样式都会一并回收。
MIT © LX-HMKK