dsh-font-customizer
中文 · English
中文
DeepSeek Harness（DSH）Web UI 的字体自定义插件：界面字体、代码字体、正文字号一站式调整，设置持久化在宿主机上，换浏览器、换设备都是同一套字体。
功能
- 界面字体：覆盖全局 CSS 变量
--dsw-font-family，DSH 全部界面文字即时生效
- 代码字体：覆盖
--ds-font-family-code，代码块 / 等宽区域即时生效
- 字号：12–17px，优先接入客户端主题服务（与内置字号设置联动）
- 预设字体栈：微软雅黑、思源黑体/宋体、霞鹜文楷、HarmonyOS Sans、MiSans、OPPOSans、楷体、仿宋、黑体、宋体；代码侧含 JetBrains Mono、Fira Code、Cascadia Code、更纱黑体（中英等宽）、MapMono、霞鹜文楷等宽等
- 本机字体探测：预设列表用 canvas 宽度差法标注哪些字体本机已装（label 带 ✓）
- 全量字体扫描：一键调用
window.queryLocalFonts()（Chrome/Edge 103+，需要授权），把本机全部已安装字体列进下拉框
- 自定义字体栈：手写任意 CSS 字体栈
- 持久化：配置存在
${DSH_HOME:-~/.dsh}/dsh-font-customizer/config.json（原子写入），由宿主半侧通过 /dsh-font-customizer/config 路由读写
修改即时预览、自动保存；「重置」一键恢复 DSH 内置字体。
安装
dsh plugin --profile web add github:daha1216/dsh-font-customizer
然后重启 DSH（dsh web），刷新页面，在 设置 → 通用 里找到「字体（dsh-font-customizer）」一行。
本地开发（仓库检出目录内）：
dsh plugin --profile web add .
卸载
dsh plugin --profile web remove dsh-font-customizer
配置文件不会自动删除，需要时手动删 ~/.dsh/dsh-font-customizer/。
使用说明
- 预设里的 ✓ 表示该字体家族在本机已安装（探测法，个别字体可能误报）
- 扫描本机字体首次点击时浏览器会弹出「本地字体」权限询问，允许后下拉框出现「本机已安装（N）」分组
- 自定义选择后输入 CSS 字体栈，如
'LXGW WenKai', sans-serif；界面字体栈尾建议 sans-serif，代码字体栈尾建议 monospace
- 字号选「默认（跟随 DSH 内置）」时完全交还内置字号设置管理
工作原理
| 半侧 | 文件 | 职责 |
|---|
| 宿主 | dsh/index.js | 注册 /dsh-font-customizer/config HTTP 路由，配置原子落盘 |
| 浏览器 | dsh/client.js | 拉取配置 → 覆盖 :root CSS 变量；设置页 UI；字体探测/扫描 |
两个半侧零依赖、零构建：宿主是纯 ESM + Node 内置模块；客户端手写懒 CJS 协议（window.__ModuleLoader__.load），react 由 DSH 模块表提供。
English
Font customizer plugin for the DeepSeek Harness (DSH) Web UI: UI font family, code font family, and content font size in one settings row. Settings persist on the host, so every browser and device gets the same fonts.
Features
- UI font: overrides the global CSS variable
--dsw-font-family — applies to all DSH interface text instantly
- Code font: overrides
--ds-font-family-code
- Font size: 12–17px, wired into the client theme service when available
- Preset stacks for CJK-friendly fonts (Microsoft YaHei, Source Han Sans/Serif, LXGW WenKai, HarmonyOS Sans, MiSans, OPPOSans, KaiTi, FangSong, …) and coding fonts (JetBrains Mono, Fira Code, Cascadia Code, Sarasa Gothic, MapMono, …)
- Local font detection via canvas width-diff probing (installed families get a ✓)
- Full local font scan via
window.queryLocalFonts() (Chrome/Edge 103+, permission required)
- Custom CSS font stacks
- Persistence: stored at
${DSH_HOME:-~/.dsh}/dsh-font-customizer/config.json (atomic writes) behind the host route /dsh-font-customizer/config
Changes preview instantly and auto-save; the reset button restores DSH's built-in fonts.
Install
dsh plugin --profile web add github:daha1216/dsh-font-customizer
Restart DSH (dsh web) and refresh the page — the row appears under Settings → General as「字体（dsh-font-customizer）」.
For local development, from a checkout of this repo:
dsh plugin --profile web add .
License
MIT © daha1216
