在 DeepSeek Harness(DSH)的使用或开发过程中,界面字体的统一性与阅读体验直接影响信息获取效率。现有的界面定制方案往往涉及修改配置文件,不够直观。dsh-custom-font 插件提供了一种“所见即所得”的字体与排版调整方案,支持即时生效与自动保存,解决了中英文混排不一致以及设置跨环境迁移的问题。
插件定位¶
该插件由 Vergil-long 维护,定位为 DSH 的自定义界面字体插件。它允许用户在设置页中像操作 Word 一样修改界面文字的字体、字号、加粗、颜色与版式,改动即时生效。插件内置了两套开源字体,并内置了一套作者推荐的排版方案,无需用户预先安装字体即可获得一致的观感。
安装与启用¶
通过 DSH 的命令行工具进行安装:
npx @deepseek-ai/dsh plugin --profile web add dsh-custom-font
安装后,插件会自动集成到 DSH 的设置菜单中。
核心功能¶
插件提供了以下核心能力:
- 所见即所得的调整:支持字体、字号、加粗、颜色调整,以及版式细节(两端对齐、引用块斜体+竖线、行内代码灰底、表头样式、链接颜色等)。
- 自动读取系统字体:在 Windows 环境下,插件会自动读取已安装字体库(200+ 个字体),并生成下拉列表供选择,支持一键刷新。
- 中英文分离设置:正文与标题可分别设置中文字体与西文字体,确保数字与英文跟随西文字体栈,保持排版整洁。
- 内置字体支持:内置 STIX2Text(西文正体)与 Latin Modern Mono Light(代码体)两套开源字体。这些字体仅在需要时由本地宿主端返回,不联网下载。用户可在高级设置中关闭内置字体。
- 分类管理:提供正文、标题、代码三类基础设置,并在高级设置中支持 h1~h6 的逐级自定义。
使用方式¶
- 打开 DeepSeek Harness → 设置 → 左侧「自定义字体」。
- 在基础页的三栏中分别设置正文、标题、代码的字体、字号、加粗与颜色。
- 点击「高级设置」可展开更多选项,包括 h1~h6 的独立设置、内置字体开关、版式微调等。
- 使用「应用作者推荐」可一键应用预设的排版方案,或使用「一键恢复默认值」复位。
- 改动即时生效,并自动保存。
设置持久化¶
插件将设置文件保存在 ~/.dsh/dsh-custom-font/settings。这种设计使得设置跟随 DSH 的配置目录,更换桌面外壳或重装环境时不会丢失,支持通过「导出设置」与「导入设置」进行备份或迁移。在深色模式下,插件会自动调整链接颜色为亮蓝,确保可读性。
技术细节与注意事项¶
- 字体来源:插件内置字体遵循 SIL Open Font License 1.1 与 GUST Font License,代码遵循 MIT 许可证。
- 权限要求:插件通过 PowerShell 读取 Windows 系统字体,不需要管理员权限。
- 数据安全:内置字体文件仅在本地宿主端返回,不会联网下载。