@guowenzhang/dsh-ui-beautify

DeepSeek Harness 的页面美化插件。目前的能力：在「设置 → 通用设置」里用下拉切换 Web GUI 的正文字体。字体不随插件分发——插件里只存下载地址，字体在首次使用时下载到本机缓存，之后完全离线可用。

它做什么

半边	职责
Host	认领两个路由：一个前缀路由把浏览器要的字体文件从镜像下载下来并缓存，再按 npm 包里的原始路径提供出去；一个精确路由汇报缓存里已有什么
Client	按选择链入对应字体的分片样式表，把 `--dsw-font-family` 重绑过去，并在通用设置页里贡献一个下拉选择行（含缓存状态）

字体通过主题服务的覆盖层（ctx.theme.overrideTokens）生效——它写成 body 的行内样式，优先级高于 :root，因此不受插件激活顺序影响，卸载时自动回滚。

选择行挂在 设置 → 通用设置（settings.general.item，order 11.5 与 11.6）——即「外观」一组里**「字号大小」正下方**，「正文字体」在下、「代码字体」再下一行，两者都在工作过程展示上方。用的是 ui-settings-general 专门为「不需要独立页面的单个偏好」留的加性插槽，所以字体选择不是独立页面，侧边栏里也没有导航项。选择写进当前 profile 的配置文件 $DSH_HOME/profiles/ /cordis.patch.yml 里 ui-beautify 行的 config（font / codeFont 两个字段），改完立即生效、无需重启。

更早的 DSH 版本把选择写在 $DSH_HOME/settings.yaml；该文件已被 DSH 迁移进 profile 的补丁文件并重命名为 settings.yaml.imported。现在手工改设置要改的是 profile 补丁。

可选字体

两款字体各自独立配置：正文字体与代码字体，各占通用设置里的一行，互不影响。

正文字体（`system` 之外 14 款）

全部是 OFL 开源字体，每款都带 unicode-range 分片。

id	字体	分片	全量体积	来源
`system`	系统默认	不下载任何字体	0	——
`noto-sans-sc`（默认值）	思源黑体	101	4.4 MB	`@fontsource-variable/noto-sans-sc@5.3.0`
`noto-serif-sc`	思源宋体	101	5.9 MB	`@fontsource-variable/noto-serif-sc@5.3.0`
`lxgw-wenkai`	霞鹜文楷	2 字重 × 97	9.0 MB	`lxgw-wenkai-webfont@1.7.0`
`lxgw-wenkai-tc`	霞鹜文楷 TC	2 字重 × 97	8.9 MB	`lxgw-wenkai-tc-webfont@1.2.0`
`lxgw-wenkai-screen`	霞鹜文楷屏幕版	97	5.0 MB	`lxgw-wenkai-screen-webfont@1.7.0`
`zcool-xiaowei`	站酷小薇体	92	3.2 MB	`@fontsource/zcool-xiaowei@5.3.0`
`zcool-kuaile`	站酷快乐体	93	1.1 MB	`@fontsource/zcool-kuaile@5.3.0`
`zcool-qingke-huangyou`	站酷庆科黄油体	92	3.0 MB	`@fontsource/zcool-qingke-huangyou@5.3.0`
`ma-shan-zheng`	马善政楷书	92	3.5 MB	`@fontsource/ma-shan-zheng@5.3.1`
`zhi-mang-xing`	志莽行书	92	2.5 MB	`@fontsource/zhi-mang-xing@5.3.0`
`long-cang`	龙藏体	92	3.2 MB	`@fontsource/long-cang@5.3.0`
`liu-jian-mao-cao`	柳建毛草	92	2.6 MB	`@fontsource/liu-jian-mao-cao@5.3.0`
`inter`	Inter（拉丁）	7	0.21 MB	`@fontsource-variable/inter@5.3.0`
`geist`	Geist（拉丁）	5	0.07 MB	`@fontsource-variable/geist@5.3.0`

代码字体（`system` 之外 5 款）

默认是 system——不改变任何现有观感，代码块沿用 DSH 内置的等宽字体栈。想要统一观感再自己选：

id	字体	分片	全量体积	来源
`system`（默认值）	系统默认	不下载任何字体，沿用内置栈	0	——
`jetbrains-mono`	JetBrains Mono	6	0.08 MB	`@fontsource-variable/jetbrains-mono@5.3.0`
`fira-code`	Fira Code	7	0.11 MB	`@fontsource-variable/fira-code@5.3.0`
`geist-mono`	Geist Mono	6	0.07 MB	`@fontsource-variable/geist-mono@5.3.0`
`noto-sans-mono`	Noto Sans Mono	7	0.30 MB	`@fontsource-variable/noto-sans-mono@5.3.0`
`maple-mono-cn`	Maple Mono CN	239	9.0 MB	`@mogeko/maple-mono-cn@7.9.0`

只有 maple-mono-cn 覆盖中文——中文注释也能对齐，代价是 9 MB 且 npm 镜像没同步这个包，只能走 jsDelivr（这正是镜像回退存在的意义）。其余四款只覆盖拉丁字符，中文回退到内置栈。

体积怎么读

「分片」与「全量体积」指的是这一款字体——它那几个样式表声明出来的全部分片之和（实测，解码后字节），不是 npm 包的整包大小：包里通常还有别的字重、别的子集和 .woff 备份，那些永远不会被下载。挑字体时以这张表为准，别拿包体积估算。

「全量体积」也永远不会真的下完。 分片是按 unicode-range 切的，浏览器只请求页面实际渲染到的字符所属的那几片：以思源黑体为例，latin 片约 25 KB，中文片多在 30 KB 上下（实测 19 片，最大 77 KB），也就是首屏通常只有几百 KB 而不是 4.4 MB。

system 不是「把字体栈复制一份写进 token」，而是移除样式表链接与 token 覆盖层，让 token 回到 ui-theme 自己的声明。区别在于：复制一份会把今天的默认值冻结在插件里，上游改了默认字体这里也不会跟随；移除覆盖则始终跟随。选中它也是「关掉自定义字体」的唯一方式，不需要卸载插件。

字体是怎么下载的

插件包里一个字体文件都没有（assets/fonts/ 已删除，包体积从 12.7 MB 降到约 0.19 MB）。src/fonts.ts 里每一行只记 npm 包名、锁定版本和分包内的样式表路径，例如：

{ id: 'noto-sans-sc', family: 'Noto Sans SC Variable', group: 'cjk',
  source: { package: '@fontsource-variable/noto-sans-sc', version: '5.3.0', sheets: ['index.css'] } }

浏览器请求 /plugins/dsh-ui-beautify/fonts//，Host 半边按这个路径去镜像取文件、落盘、再回给浏览器。路由直接镜像 npm 包的目录结构，所以样式表里那些 url(./files/x.woff2) 相对路径原样成立，Host 不需要改写一个字节的 CSS（tests/http.mjs 断言了「逐字节相同」）。

下载链路

浏览器从不直连外部站点——它只跟 DSH 自己的源说话，由 Host 去取：

浏览器  ──①──▶  http://127.0.0.1:3080/plugins/dsh-ui-beautify/fonts//
（同源）               │
                      ├─ 命中缓存 ──▶ 读盘回给浏览器（分片带 immutable，浏览器自己再缓存一年）
                      │
                      └─ 未命中 ──②──▶  ① registry.npmmirror.com/
//files/

                                        ② cdn.jsdelivr.net/npm/
@/

                                             │  200 → 校验 → 原子落盘 → 回给浏览器
                                             │  404 → 404    不可达/内容不对 → 502（no-store，可重试）

走 Host 代理而不是让浏览器直接 `` 到 CDN，换来四件事：单源（不受 CSP / CORS 影响）、磁盘缓存（离线可用，浏览器换一个也还在）、镜像失败可回退、以及下载内容可控校验。代价是 Host 必须有外网出口；若宿主机不通网而浏览器通网，这条路走不通——这是本插件唯一依赖宿主联网的地方。

于是下载是按需分片的，不是整包预取：

选中某款字体 → 浏览器请求它的样式表（约 2–105 KB），Host 从镜像取回并缓存。
浏览器按 unicode-range 算出页面需要哪几片 → 逐个请求 /files/*.woff2，每片首次请求时 Host 才去下载。
同一文件的并发请求在 Host 内合并成一次下载（FontStore 的 in-flight 表）。
页面再次加载时全部走本地磁盘，不再联网。

镜像按顺序尝试，默认先 registry.npmmirror.com（国内可达），失败再退到 cdn.jsdelivr.net。任何一次下载都要先通过校验才会写入缓存：woff2 必须真的是 wOF2 开头，.css 必须含 @font-face/@import——镜像返回 200 的错误页不会被当成字体缓存下来，也不会发给浏览器。

缓存位置与失效

$DSH_HOME/cache/ui-beautify/fonts///

`` 是 包名@版本 + 样式表列表 的哈希。改动其中任何一项（升级字体版本、给一款字体加减字重）都会换一个 generation 目录，旧的在新目录写成功后删除——不会出现「升级了插件却还在发旧分片」。文件先写临时名再 rename，因此缓存里不会留下写了一半的分片。

缓存的应答语义：

情况	应答
命中缓存	直接读盘；样式表 `no-cache`（每次校验），分片 `immutable` 长缓存
镜像没有这个文件	`404`
镜像不可达、或返回的内容不是字体	`502` + `no-store`（可重试，不会被缓存）

字体没下下来时界面不会坏：@font-face 带 font-display: swap，浏览器先用手上的回退字体渲染，分片到位后再替换；彻底失败就一直用回退字体，只是没换成功。

行里的缓存状态

这一行只有三个元素，和旁边的偏好行完全一致：标题、当前字体的描述、以及一行状态；右侧是一个胶囊下拉。

正文字体                                        [ 思源黑体 ⌄ ]
无衬线，笔画粗细均匀、字形方正，界面文本最中性稳妥。
已缓存 103 KB · 1/101 片 · 打开本页时统计，刷新页面（F5）更新

没有下载按钮——字体是按需拉的，点选即用，不需要用户先决定下载什么。下载状态出现在两处：

位置	显示
下拉每一项	`思源黑体 · 已缓存 4.3 MB`、`思源宋体 · 未下载`（`system` 不带后缀，它不下载任何东西）
行内状态行	当前字体的完整读数：`已缓存 103 KB · 1/101 片`

状态行里的分母来自已缓存的样式表：分片名字只写在样式表里，所以没有样式表就无从知道总数，也就显示为「未下载」。分子是磁盘上真实存在的分片数，因此「1/101」表示的是按需下载的进度，而不是下载失败——随着你继续浏览、页面出现新字符，它会自己涨。

下拉按「基准 / 中文字体 / 拉丁字体」分组，当前选中项带勾。切换字体即写入设置，无需确认。

数字的读取时机只有两个：这一行渲染时，以及切换字体后约 1.5 秒（给首次下载留出落盘时间）。它不是实时订阅——下载在后台继续时数字会停在那一刻。因为没有刷新按钮，状态行末尾常驻一句提示，告诉用户**刷新页面（F5）**即可重新统计；重新加载会重新挂载这一行，也就重新读一次。

状态来自 Host 的 GET /plugins/dsh-ui-beautify/cache（no-store，只读）：

curl.exe -s http://127.0.0.1:3080/plugins/dsh-ui-beautify/cache
# {"faces":{"noto-sans-sc":{"bytes":105494,"shardsCached":1,"shardsTotal":101}}}

两个可配项

mirrors 与 cacheDir 是这个插件行的普通配置（不是设置页里的实时字段）：它们在宿主启动时读一次，改完要重启宿主。写在 profile 的 cordis.patch.yml 或 ~/.dsh/cordis.patch.yml 的插件行 config 下：

- id: ui-beautify
  name: '@guowenzhang/dsh-ui-beautify'
  config:
    mirrors:
      - 'https://registry.npmmirror.com/{package}/{version}/files/{path}'
      - 'https://cdn.jsdelivr.net/npm/{package}@{version}/{path}'
    cacheDir: 'D:/dsh-font-cache'   # 留空则用 $DSH_HOME/cache/ui-beautify/fonts

模板里的 {package} / {version} / {path} 会被替换；换公司内网镜像、加一层代理缓存，都只改这里，不动代码。

覆盖范围

两个角色各改一组 token，都通过 ctx.theme.overrideTokens 写成 body 的行内样式：

角色	token	覆盖到
正文字体	`--dsw-font-family`	正文 / UI / Markdown
代码字体	`--ds-font-family-code` + `--dsw-font-mono`	代码块、行内代码、JSON 树、轨迹表、工具行、侧栏路径、审批面板等

顺带修掉一个老问题：--dsw-font-mono ui-theme 从未定义过，而 ui-jobs、ui-agent-preset、ui-plugin-manager、文档预览四处都在用 var(--dsw-font-mono, …) 的带兜底写法（ui-jobs 那处甚至没写兜底）。现在代码字体一并把它绑上，这几处也跟着生效。

以下位置硬编码了字体，CSS 变量管不到，保持原样：

集成终端（xterm 构造参数，不走 CSS）
队列面板 QueueDock.module.css 里写死的 Inter 前缀

安装

dsh plugin --profile web add C:/02-codespace/deepseek-harness/dsh-ui-beautify

本地目录安装时 pnpm 建的是 symlink（link:），所以改完重建 lib/ 重启即生效，无需重装。

client 产物变了要硬刷新浏览器（Ctrl+F5），否则浏览器继续跑旧 bundle。

开发

npm install
npm run typecheck      # tsc --noEmit
npm run build          # tsdown（host）+ build-client.mjs（client handoff 包）
npm test               # 冒烟 + HTTP 层验证（对构建产物运行，不联网）
npm run test:cdn       # 联网：逐字体校验两个镜像、分片与字体族名
npm run probe --   # 联网：评估一个候选 npm 包能不能当字体用

tests/smoke.mjs：mock ctx 调 apply()，断言路由注册、字体表完整性（id 字符集、包名版本、样式表路径）、路由解析与路径穿越防护、镜像模板拼接、缓存目录解析、设置 schema。
tests/http.mjs：桩镜像（node:http）+ 真实 node:http 服务器驱动插件 handler。断言响应头与字节、第二次请求走磁盘、并发冷请求只下载一次、三种失败应答（404 / 502 / 403）、镜像回退，最后关掉桩镜像再请求一次，证明缓存命中可离线工作。
tests/client.mjs：按浏览器加载器的姿势（window.__ModuleLoader__.load）加载构建产物 lib/client.js，配一个假 ctx、DOM 桩与只记录调用的 React 桩驱动 apply() 并真的渲染那一行，断言：注册进 settings.general.item（而非 settings.section）、order 11.5、每款字体链入的链接、系统默认时全部移除、--dsw-font-family 的重绑内容、下拉的分组与每项文案（思源黑体 · 已缓存 4.3 MB）、以及行内状态行由用量数据算出来。client 半边没有单元测试的其他覆盖，这条是「bundle 能不能加载、链接指向对不对、这一行显示什么」的唯一防线。
tests/cdn.mjs：对真实镜像逐个字体跑，除了 200 还检查两件容易踩的事——样式表里声明的 font-family 与表里写的一致，以及它确实是 unicode-range 分片而不是一个整字体文件。

lib/ 是提交进仓库的构建产物，这样可以直接从 git 安装。改完源码记得 npm run build 并把 lib/ 一起提交。

加一款字体

npm run probe -- [@版本] 评估候选包（见下节），拿到可用的样式表路径与字体族名。
在 src/fonts.ts 的 FONT_FACES 加一行（id / family / group / source）——family 必须与该包样式表里的 font-family 逐字一致，写错会让所有 @font-face 匹配不上而静默回退；id 只能是 [a-z0-9-]，它同时是路由段。FONT_CHOICES 由这张表派生，不用另改。
在 src/client/FontRow.tsx 的 CHOICE_COPY 加名称与描述的字典键，并在 src/client/locales.ts 补齐中英文案。
npm run test:cdn 验证（务必跑，下面两个坑只有联网才看得出来），再 npm run build && npm test。

除此之外插件里没有别处枚举字体。

候选从哪里找

字体不是从某个字体站下的：插件只认 npm 包（一行 包名@版本，运行时从镜像取），所以"找字体" = "找发布了 webfont 的 npm 包"。实践中就两类来源：

来源	覆盖	本插件已用
Fontsource（`@fontsource/`、`@fontsource-variable/`）	把 Google Fonts 全量转成 npm 包，每款都带 `unicode-range` 分片，命名统一（`index.css` + `files/`）	思源黑体、思源宋体、站酷小薇/快乐/庆科黄油、马善政楷书、志莽行书、龙藏体、柳建毛草、Inter、Geist
字体作者或社区自建包	中文 webfont 的分片打包，命名各不相同，必须逐个验	`lxgw-wenkai-webfont`、`lxgw-wenkai-tc-webfont`、`lxgw-wenkai-screen-webfont`（霞鹜文楷系列）

同类但未收录的还有 @chinese-fonts/*、cn-fontsource-*、misans-vf（MiSans）等——最后一个是 jsDelivr 独有（npmmirror 没同步），加进来就得依赖 jsDelivr。

npm run probe 就是给第二类准备的评估器：

npm run probe -- @fontsource/zcool-kuaile
npm run probe -- lxgw-wenkai-webfont 1.7.0 lxgwwenkai-regular.css

它对每个候选样式表报出：两个镜像各自的状态码、声明的字体族、@font-face 与 unicode-range 条数（决定是不是真分片）、首个分片的实际字节数；拿到切片样式表后，直接打印一行可以粘进 fonts.ts 的配置。实测同一款字体的两种样式表：

index.css                    registry.npmmirror.com=200 cdn.jsdelivr.net=200
    family 'Noto Sans SC' · slice ✓ 101 shards
    first url: files/noto-sans-sc-4-400-normal.woff2 (2300 B)
chinese-simplified-400.css   registry.npmmirror.com=200 cdn.jsdelivr.net=200
    family 'Noto Sans SC' · NOT SLICED (1 face(s), 0 ranges) — one download per subset
    first url: files/noto-sans-sc-chinese-simplified-400-normal.woff2 (1142552 B)

2.3 KB 对 1.1 MB——这就是下面两个坑，探针会在你提交之前把它们指出来。

选包时的两个坑

一、@fontsource 的 .css 名字看着更对，其实是整字体。 以 @fontsource/noto-sans-sc 为例：index.css / 400.css 有 101 条 @font-face 且条条带 unicode-range（分片）；而 chinese-simplified-400.css 只有 1 条、没有 unicode-range，指向的是 1.09 MB 的整包中文文件——而它对应的分片只有 2.3 KB。中文一律用 index.css 或 .css，不要用 .css。

二、style.css 可能只是 @import。 lxgw-wenkai-webfont 的 style.css 只有 248 字节、6 条 @import，一个 @font-face 都没有。要直接指向 lxgwwenkai-regular.css 这类真正带规则的子样式表。（顺带一提：该包的 @fontsource 版本 @fontsource/lxgw-wenkai 只有 3 个拉丁整字体、合计 22 MB，没有中文分片，不能用。）

npm run test:cdn 对每条样式表都断言「@font-face 条数 > 1 且条条带 unicode-range」，上面两种坑都会被它挡下来。

字重

一个字体可以有多个样式表，sheets 数组按顺序全部链入。霞鹜文楷只有 300/500/700 三个字重（没有 400），这里链入 regular(400) 与 bold(700)：界面用到的 400/500 落在 400，600/700 落到 700。可变字体（@fontsource-variable/*）一个分片就覆盖全部字重，不需要多份。

排查：装了但字体没变

按顺序查这七处。

1. 插件在不在 profile 清单里。 dsh plugin add 之后如果还有别的插件管理操作（GUI 插件页、并发的 dsh plugin 命令），新装的 bundle 可能被基于旧快照的重写挤掉——实测装完 50 秒后另一次 profile 写入就会把它覆盖：

(Get-Content "$env:USERPROFILE\.dsh\profiles\web\package.json" -Raw | ConvertFrom-Json).dsh.profile.bundles

列表里没有 @guowenzhang/dsh-ui-beautify 就重跑一次安装。

2. Host 半边通没通。 这条不需要浏览器，也顺带验证了镜像可达：

curl.exe -s -o NUL -w "%{http_code}`n" http://127.0.0.1:3080/plugins/dsh-ui-beautify/fonts/noto-sans-sc/index.css

200 说明路由已在跑、镜像也通——profile 的 patchReload: live 会让 HMR 在清单变化后热重组，装完不必重启宿主。若是 502，是镜像不可达（检查 mirrors 配置与网络）；若是 404，多半是清单里没有这个插件。

3. 命名空间有没有暴露。 那一行读的是 Host 注册的 ui-beautify 命名空间；若状态行显示「宿主设置服务不可用」，说明没有挂载 settings 提供方（dsh-settings-file），选择无法保存。

4. 那一行在不在。 它注册进的是 settings.general.item——由 ui-settings-general 声明。若宿主里没有这个包（老版本或裁剪过的组合），ctx.slots.inject 会一直等这个声明，这一行不出现，但字体照常应用；此时只能改当前 profile 的 cordis.patch.yml 手工选。设置里搜「正文字体」，位置在「外观」一组的「字号大小」正下方。

5. 点了没反应。 先看那一行的状态行有没有写「宿主仍在运行本插件的旧版本，它的配置里没有这一行对应的字段」——写了就是下面这个情况，必须重启 dsh：

宿主半边和浏览器半边不是一起更新的。 lib/client.js 由浏览器在每次加载页面时从磁盘重新取，所以改完 client 产物只需硬刷新；而 lib/index.mjs（Host 半边）是每个进程只 import 一次，它的配置 schema 就是启动那一刻的那份。于是升级插件后可能出现：浏览器已经渲染出新的行，宿主的 schema 里却没有对应的设置字段——写进去会被拒，控件看着可点，实际什么都不会发生。

判据很直接，比对三个时间：

(Get-Process -Id ).StartTime                                  # 宿主何时启动
(Get-Item "$env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml").LastWriteTime  # 设置何时写入
(Get-Item C:\02-codespace\deepseek-harness\dsh-ui-beautify\lib\index.mjs).LastWriteTime  # 插件何时构建

宿主启动时间早于插件构建时间，就需要重启。重启后 Host 重新 import，schema 里就有了新字段；浏览器再硬刷新一次即可。

6. Client 半边跑没跑。 浏览器 Console：

document.querySelectorAll('link[data-plugin*="ui-beautify"]').length   // 选中内置字体时应为 1，霞鹜文楷为 2
getComputedStyle(document.body).getPropertyValue('--dsw-font-family')
getComputedStyle(document.body).getPropertyValue('--ds-font-family-code')

第三项应输出以当前所选代码字体族名开头的等宽栈（选 system 时是 ui-theme 的默认值）。

Host 通了但 client 没跑：浏览器还持有旧的 boot 图，硬刷新（Ctrl+F5）。改过 lib/client.js 后同理——HANDOFF_ID 没变时浏览器会继续跑旧 bundle，这是最容易被忽略的一步。

注意 getComputedStyle().fontFamily 只反映声明的字体栈，不代表字体文件已经下载成功。 要确认分片真的加载了：

document.fonts.check('14px "LXGW WenKai"')   // true = 该字体已加载

或在 DevTools 的 Elements → Computed → Rendered Fonts 里看实际渲染用的字体；在 Network 里筛 fonts/ 能看到哪些分片被拉取、哪些来自 (disk cache)。

7. 缓存里到底有没有东西。 通用设置里那一行的状态行就会写；要命令行确认，缓存目录默认在 $DSH_HOME/cache/ui-beautify/fonts（Windows 上是 C:\Users\\.dsh\cache\ui-beautify\fonts），每个字体一个目录，里面一个 generation 目录：

curl.exe -s http://127.0.0.1:3080/plugins/dsh-ui-beautify/cache
Get-ChildItem "$env:USERPROFILE\.dsh\cache\ui-beautify\fonts" -Recurse -File | Select-Object -First 10 FullName, Length

想重新下（比如怀疑缓存坏了），直接删掉对应字体的目录即可，下次请求会重建。

src/
  params.ts               两半边共用的路由（字体前缀 + 缓存精确路由）与命名空间常量
  fonts.ts                角色表（正文 / 代码）、两份字体表、字体栈、缓存用量类型
  source.ts               镜像模板、带超时/体积上限/内容校验的下载
  store.ts                磁盘缓存（generation、原子写入、并发合并、过期清理、用量统计）
  serve.ts                两个 HTTP 面：字体文件应答（404/502）与缓存用量 JSON
  settings.ts             Host：ui-beautify 命名空间（font / codeFont）与 mirrors/cacheDir 配置
  index.ts                Host：认领两个路由
  client/
    index.ts              Client：注册两行偏好项 + 按角色应用所选字体
    FontRows.tsx          偏好行组件（标题 / 描述 / 缓存状态 + 下拉选择），两个角色共用
    FontRows.module.css
    settings-controller.ts 设置命名空间、缓存用量 ↔ 行快照
    locales.ts            中英文案
tests/
  smoke.mjs               路由、两份字体表、路径解析、配置默认值（离线）
  http.mjs                桩镜像下的 HTTP 层：字节、缓存、并发、失败应答、离线、用量上报
  client.mjs              加载 lib/client.js 驱动 apply() 并渲染两行：插槽、链接、两种 token、下拉与状态行
  cdn.mjs                 联网逐字体（两个角色）校验镜像、分片与族名
tools/
  probe-font.mjs          联网评估候选 npm 包：分片、族名、镜像可达、可直接粘贴的配置行

接下来可以加的

第三个角色：整个机制已经是「角色表」——加一行 FONT_ROLES 条目（key、tokens、fallback、faces、defaultId）就多一个可独立配置的字体位，比如标题字体、终端字体（终端需要先支持通过 CSS 变量传字体）。
镜像自动测速：启动时对 mirrors 各探一次，把最快的排到前面，而不是固定顺序。
缓存管理：通用设置里再加一行，显示每款字体的缓存占用并提供「清理」——FontStore 已经有 generation 概念，加上 enumerating 与 rm 即可；GET /plugins/dsh-ui-beautify/cache 已经在报这份数据。
跟随系统字体：把 system 从「不覆盖」扩展成「跟随一个可配置的字体栈」。
字号阶梯、行高、圆角、间距：同一套行机制继续加行即可。
自定义主题配色：ctx.theme.register 可注册整套 alias token。

许可

插件本体 Apache

@guowenzhang/dsh-ui-beautify

Install

README