前言¶
DeepSeek Harness（DSH）的网页界面由多个界面插件组成，不同区域的文字样式可能来自不同的插件。对看小字费劲的使用者来说，单纯调大页面并不总是够用，也需要单独调整某个区域。
dsh-ui-font 是一个 DSH 社区插件，用来给 DSH 网页界面换字体、调字号。它把字体、字号、区域偏移和快捷键设置放到同一个设置入口里，并在运行时自动发现 DSH 界面插件的样式和描述，不捆绑字体文件。
仓库地址：https://github.com/warmwine/dsh-ui-font
许可证：MIT
这是什么¶
dsh-ui-font 是一个面向 DSH Web GUI 的字体与字号设置插件。
它主要解决三类问题：
- 想把普通文字或代码区域换成自己系统里已安装的字体；
- 想整体调大 DSH 网页界面字号；
- 某个区域太大或太小时，希望只调那个区域，不影响其他区域。
核心功能¶
字体选择¶
插件支持从系统已安装字体中分别选择普通文字字体和代码字体。
全局字号¶
全局字号由一个滑杆控制，范围是 -3 到 +20 像素，拖动后立即生效。
准星选取¶
设置页提供「选取区域」入口，也可以使用自定义快捷键召唤红色准星。移动鼠标选中目标区域后，点击 − 或 + 即可调整该区域字号。
准星选取会根据字号声明点选择调整方式：
- 如果目标文字由设计令牌定义，则按设计令牌调整；
- 如果目标文字来自单条 CSS 规则，则按该规则调整；
- 否则进入全局偏移。
区域微调¶
插件提供「按界面区域微调」列表，可以对单个插件区域单独调整。
某个区域的最终效果是该区域的个体偏移与全局偏移叠加后的结果。
快捷键¶
插件提供三个可自由录制的快捷键槽位：
- UI 捕捉；
- 字号放大；
- 字号缩小。
录制快捷键时，组合键需包含 Ctrl、Alt 或 Meta 之一。正常使用时建议先关闭设置面板，再按下快捷键。
设置持久化¶
设置会写入 DSH 服务端 settings.yaml。在离线或旧版本场景下，插件会使用 localStorage 回退。
早期版本（< 0.9.3）使用 localStorage 键名 dsh.uiFont.v1；升级后首次打开 Web GUI 时，会把该值迁移到服务端。插件每次写设置会同时落到 settings.yaml 和 localStorage，服务恢复后以服务端为准。
安装与启用¶
安装远程仓库版本：
dsh plugin --profile web add github:warmwine/dsh-ui-font
本地开发时可以从仓库路径安装：
dsh plugin --profile web add link:<本仓库路径>
安装或卸载后，需要重启 dsh web。
卸载命令：
dsh plugin --profile web remove dsh-ui-font
典型用法¶
下面是一个常规操作顺序：
1、安装插件并重启 dsh web。
2、打开 DSH 设置页，进入字体相关设置。
3、先用全局滑杆调整整体字号。
4、如果某个区域仍不满意，点「选取区域」或按已录制的 UI 捕捉快捷键，召唤红色准星。
5、将准星移到目标区域，点击 − 或 + 调整。
6、在「按界面区域微调」列表中单独调整对应插件区域。
7、如果需要快捷操作，在设置页为 UI 捕捉、字号放大、字号缩小录制快捷键。
技术边界¶
宿主半边使用 Node 内置模块；浏览器半边依赖平台提供的 react，package.json 中声明的 peerDependencies 为：
"react": "^18.2.0"
插件不捆绑字体文件，并在运行时自动发现 DSH 界面插件的样式和描述。
注意与边界¶
dsh-ssh的 xterm 网页终端使用内置字体，不参与缩放。- 换肤插件（qq98 之类）激活时会接管字体变量，最终以皮肤为准。
- 网页预览面板里 iframe 渲染的内容不是本页元素，准星选不到。
- 设置面板本身会挡住后面的界面，正常用法是关闭设置面板后再按快捷键。
- 焦点在文件预览等 iframe 中时，按键可能无法到达主页面；点一下主界面后再按即可。
- 卸载插件后，
ui-font设置 key 会留在settings.yaml中，需要手动删除。
适用场景¶
这个插件适合以下情况：
- 希望在 DSH Web 界面中换成自己系统里已安装的字体；
- 希望整体调大 DSH 网页界面字号；
- 需要单独调整某个插件区域，而不是让整个页面一起变化；
- 希望通过快捷键快速放大或缩小字号，而不是每次都打开设置页。
DSH 插件会在当前 DSH 运行环境中执行。安装前建议检查仓库源码和 MIT 许可证，并确认插件行为符合当前使用场景。
结尾¶
dsh-ui-font 把 DSH Web 界面的字体、字号、区域偏移和快捷键放到一组可配置项里，并用准星选取降低“不知道改哪个设置”的成本。它的设置落在 DSH 服务端 settings.yaml，也保留离线与旧版本场景下的 localStorage 回退路径。
GitHub：https://github.com/warmwine/dsh-ui-font
