前言¶
DeepSeek Harness (DSH) Web GUI 是进行智能体开发和调试的主要界面。默认情况下,界面与代码区域的字体固定。若要使用本地已安装的字体,通常需要准备字体文件或修改核心代码。dsh-system-fonts 插件通过读取系统注册表和字体目录,提供了直接的配置方案。
这是什么¶
这是一款为 DSH Web GUI 设计的系统字体选择插件。由用户 kira4094 维护。它解决了在未准备字体文件的情况下,直接使用系统已安装字体的问题,且不会对 DSH 官方代码造成任何修改。
核心功能¶
- 枚举系统全部字体:读取 Windows 注册表(HKLM/HKCU)和字体目录,列出所有已安装字体。
- 界面字体与代码字体独立设置:分别控制界面文字(
--dsw-font-family)和代码块/终端文字(--ds-font-family-code)。 - 即时生效:通过官方 API 应用更改,无需刷新页面。
- 持久化:设置保存在浏览器本地存储中,刷新或重启后保持。
- 刷新按钮:安装新字体后可手动刷新列表。
- 中英双语:自动跟随 DSH 界面语言。
- 纯插件架构:卸载后自动还原,不影响 DSH 原生体验。
安装与启用¶
插件依赖 Node.js 环境版本 >= 20。
安装命令如下:
dsh plugin --profile web add github:kira4094/dsh-system-fonts
安装完成后,需要重启 dsh web 进程(或 DSH Desktop)才能加载插件。
典型用法¶
- 打开设置页面,进入「通用」选项卡。
- 找到「系统字体」设置项。
- 在「界面字体」和「代码字体」下拉框中分别选择目标系统字体。
- 选择即时生效,无需手动刷新页面。
注意事项¶
- 平台限制:当前仅支持 Windows 系统(使用
reg query命令读取注册表)。在 Linux 或 macOS 上运行会退化为空列表。 - 卸载即还原:这是一个纯插件,卸载后配置会自动清除,DSH 界面将恢复默认状态。
总结¶
dsh-system-fonts 为 DSH Web GUI 提供了灵活的字体配置能力,适合希望优化本地开发体验的用户。你可以通过以下链接查看详情或获取源码: