前言¶
DeepSeek Harness（DSH）的官方设置仅包含字号与配色，缺乏字体族入口。现有的第三方字体插件通常统一修改 --dsw-font-family，导致界面与正文字体不可分割。dsh-font-master 旨在将字体控制拆分为三个维度：文种（中/西）、用途（界面/内容/代码），满足不同场景下的排版需求。
核心功能¶
插件具备以下能力：
- 中西文分别指定：拉丁字母走西文字体，汉字走中文字体，互不干扰。
- 界面 / 内容 / 代码三处独立：侧栏外壳、会话正文、代码块分别设置字体。
- 读取本地字体文件：生成菜单列出发机器上安装的字体，支持中英文名搜索。
- 跟随界面字体：内容字体可直接沿用界面字体设置。
- 基于 Token 覆盖：不依赖语言检测，也不做 DOM 手术；中文字体留空也不会导致汉字丢失。
安装与启用¶
使用官方 CLI 安装插件：
dsh plugin --profile desktop add github:AnAcretiondisk9986/dsh-font-master
安装完成后需要重启 DSH 才能生效。
典型用法¶
- 打开设置菜单，进入「字体 / Fonts」。
- 共有 6 个槽位，分为 3 处用途（界面、内容、代码）× 2 个文种（西文、中文）。
- 按中文、等宽、西文分组，支持中英文名搜索。
- 点击「跟随界面字体」开关，可以让内容字体直接沿用界面字体设置。
技术实现¶
插件通过覆盖 DSH 的 CSS 变量实现控制，不涉及 DOM 操作：
- 界面字体：覆盖
--dsw-font-family。 - 内容字体：覆盖
--dsw-font-markdown-*系列变量。 - 代码字体：覆盖
--ds-font-family-code。 - 用户消息：通过匹配
class*="plainRun"选择器实现覆盖。
宿主侧会扫描系统字体目录（如 Windows 的 %WINDIR%\Fonts），读取 sfnt 结构中的字体族名，生成清单供浏览器侧调用。
注意事项¶
- 安装后必须重启 DSH 才能生效。
- 如果无法读取本机字体清单（如路由被拒），插件会退回内置候选表，菜单依然可用。
- 插件不依赖语言检测，中文字体留空也不会导致汉字丢失。
结语¶
本插件通过独立的变量覆盖和本地字体扫描，解决了 DSH 环境下字体配置粒度过粗的问题。
