DeepSeek Harness (DSH) 提供了智能体开发的命令行环境,其 Web UI 的默认字体在处理中英文混排或代码展示时,可能无法满足所有开发者的阅读习惯。dsh-custom-fonts 插件通过注入全局样式,允许在不重启进程的情况下,直接在设置页调整界面字体、代码字体及全局字号。
插件定位¶
这是一个由维护者 lsh2002 开发的纯客户端插件。安装后,DSH 的 Web 界面设置中会新增一个“Fonts (字体)”页面,提供中/英 UI 字体、代码字体及字号偏移的配置项,所有修改即刻生效且无需重启。
核心功能¶
- 设置入口:在 Settings 下新增 Fonts 页面,提供可视化的配置界面。
- 字体定制:
- UI 字体 · English:用于拉丁字符。
- UI 字体 · Chinese:用于汉字。
- Code font:用于代码块和行内代码。
- 字号偏移:提供 -4 到 +8 px 的全局滑块。该插件通过相对计算(
calc(1em + Npx))确保内核文本保持清晰,且不会导致页面布局崩坏。 - 实时预览:在设置页即可查看中英文混排 UI 示例及代码字体渲染效果,支持逗号分隔的字体列表或自由名称。
- 重置:一键清除所有注入样式,恢复默认。
安装与启用¶
通过 DSH 的插件命令行安装,安装后刷新页面即可激活,无需重启主机。
dsh plugin --profile web add dsh-custom-fonts
或直接从仓库安装:
dsh plugin --profile web add github:lsh2002/dsh-custom-fonts
工作原理¶
插件通过注入一个全局 CSS 样式表来实现字体与字号的控制。
字体栈采用标准脚本分离策略:英文字符优先匹配指定的英文字体,而英文字体中不包含的汉字会自动回退到指定的中文字体,无需复杂的 DOM 逻辑或语言检测。
字号偏移通过 calc(1em + Npx) 相对计算,即每个元素在其自身大小基础上增加 N 像素,这使得多级嵌套元素的尺寸变化保持一致且精确。
修改会立即全局应用,覆盖消息体、侧边栏、输入框等所有区域。
注意事项¶
- 这是一个纯客户端插件,不包含主机端逻辑。
- 修改会直接覆盖浏览器渲染的默认字体,建议在调整前记录默认配置以便重置。
- 代码字体与 UI 字体独立配置,可分别选择适合的等宽字体。
总结¶
dsh-custom-fonts 解决了 DSH Web UI 字体配置不灵活的问题。通过客户端样式注入,它提供了一种低侵入、零重启的方案,让开发者可以根据个人偏好或特定场景(如代码开发)定制界面的视觉体验。
- GitHub 仓库: https://github.com/lsh2002/dsh-custom-fonts