dsh-system-fonts

一款为 DeepSeek Harness（DSH）Web GUI 设计的系统字体选择插件。它枚举你电脑上所有已安装的字体，让你自由设置 界面字体（--dsw-font-family）与 代码字体（--ds-font-family-code）。

• English README: README.en.md

---

这个插件做什么

让 DSH 使用你电脑上已经安装好的任意字体：

• 界面字体（--dsw-font-family）—— 控制整个 DSH 界面的文字
• 代码字体（--ds-font-family-code）—— 控制代码块、终端里的文字

你不需要准备任何字体文件——插件直接读取你 Windows 系统的字体注册表和字体目录，把全部已安装字体列成下拉框，选哪个就立刻用哪个。

功能特性

• 🖥️ 枚举系统全部字体：读取 HKLM / HKCU 字体注册表 + 用户级/系统字体目录，智能去重、剥离字重后缀（例如 FontName Bold → FontName）
• 🎨 界面字体 & 代码字体独立设置：分别控制 --dsw-font-family 与 --ds-font-family-code
• ⚡ 即时生效：通过官方 ctx.theme.overrideTokens API，改动立即应用到页面，无需刷新
• 💾 持久化：选择保存在浏览器 localStorage，刷新/重启后保持
• 🔄 刷新按钮：新安装字体后一键重新枚举
• 🌐 中英双语：自动跟随 DSH 界面语言
• 🔧 不改任何官方代码：纯插件，挂在 profile 层，卸载即还原

界面预览

在 设置 → 通用（General） 页面，你会看到一个 「系统字体」 设置项，包含两个下拉框：

界面字体  [ 默认（跟随主题）   ▾ ]
代码字体  [ 默认（跟随主题）   ▾ ]
[ 刷新字体列表 ]

下拉框里是你在本机安装的全部字体（按字母排序）。选哪个，对应的界面/代码字体立刻切换。

安装

从 GitHub 安装（推荐）

dsh plugin --profile web add github:kiray/dsh-system-fonts

本地目录安装

# 先 clone 或下载本项目，然后（profile 目录是 pnpm workspace 根，需加 -w）
dsh plugin --profile web add -w /path/to/dsh-system-fonts

安装完成后 重启 dsh web（或重启 DSH Desktop）。

卸载

dsh plugin --profile web remove dsh-system-fonts

使用

1. 重启后打开 设置 → 通用
2. 找到 「系统字体」
3. 在「界面字体」「代码字体」下拉框中选择你想要的系统字体
4. 立即生效，无需刷新

工作原理

┌─────────────────────────────┐        ┌──────────────────────────────┐
│  Host 端 (Node)             │        │  Browser 端 (Client)         │
│                             │        │                              │
│  读注册表 HKLM/HKCU 字体键   │  JSON   │  Settings → General 设置项   │
│  读 %LOCALAPPDATA% Fonts    │ ─────► │  下拉选择界面/代码字体         │
│  + %WINDIR%\Fonts           │        │  ctx.theme.overrideTokens()  │
│                             │        │  localStorage 持久化          │
└─────────────┬───────────────┘        └──────────────▲───────────────┘
              │                                       │
              └── /plugins/dsh-system-fonts/fonts ─────┘

• Host 端（lib/index.js）：用 reg query 读取 HKLM/HKCU\...\Fonts，扫描字体目录，归一化 family 名（去字重后缀、去重、排序），通过 webServer 暴露 /plugins/dsh-system-fonts/fonts JSON 接口。
• Client 端（lib/client.js）：注册 Settings → General 槽位，拉取字体列表，用下拉框展示，ctx.theme.overrideTokens 应用，localStorage 持久化。

支持平台

当前 Host 端的字体枚举针对 Windows（使用 reg query + Windows 字体目录）。 Linux / macOS 暂未实现枚举（会退化为仅返回空列表）。欢迎 PR 补充 POSIX 字体枚举（如 fc-list）。

贡献

欢迎提交 Issue 与 PR！

• 补充 Linux / macOS 字体枚举
• 增加「搜索字体」输入框（字体多时更好找）
• 增加字体预览（用所选字体渲染示例文本）
• 更多翻译

License

MIT