DeepSeek Harness 字体插件 (dsh-font-plugin)

DeepSeek Harness (DSH) 支持 Web UI 的插件化扩展。在开发或调试智能体时，编辑器和代码区域的字体样式直接影响阅读体验。现有主题设置往往无法满足精细化定制需求，或者需要修改底层源码。下面介绍一款专注于字体控制的 DSH 插件。

这是什么¶

dsh-font-plugin 是一个 DeepSeek Harness 插件，由用户 wtksana 维护。它通过覆盖 CSS 变量，实现对 Web UI 中编辑器正文和代码区域的字体族与连字设置的控制。

核心功能¶

该插件提供以下三个核心配置项：

1. Font Family : Editor：覆盖 CSS 变量 --dsw-font-family，同时作用于 UI 文本和 Markdown 正文。
2. Font Family : Code：覆盖 CSS 变量 --ds-font-family-code，作用于代码块、命令和日志区域。
3. Font Ligatures：支持三种状态：
   • Auto：跟随主题默认设置。
   • On：开启连字。
   • Off：关闭连字。

安装与启用¶

该插件以 web 为目标平台。安装后需要在 Web UI 中手动启用。

1. 从 npm 安装：

    dsh plugin --profile web add dsh-font-plugin

2. 从 GitHub 安装：

    dsh plugin --profile web add github:wtksana/dsh-font-plugin

3. 本地开发安装：

    dsh plugin --profile web add ./path/to/dsh-font-plugin

安装完成后，启动 dsh 时会自动计算客户端包的修订号。如果在本地修改了代码，需要重启 dsh。

典型用法¶

字体栈配置¶

字体名称可以以逗号分隔的形式输入（例如 MiSans, Microsoft YaHei, sans-serif）。名称是否加引号均可，单个名称会被系统自动添加引号和回退字体。

通过 UI 配置¶

1. 在 DSH Web UI 中打开 Settings → Plugins。
2. 找到 Plugin configuration。
3. 展开 dsh-font-plugin 卡片。
4. 修改字段后点击 Save。

通过 YAML 直接配置¶

也可以直接编辑 $DSH_HOME/settings.yaml 文件：

dsh-font:
  editorFont: MiSans
  codeFont: MiSans
  ligatures: auto

保存行为：保存操作会将你输入的确切值写入用户层配置。即使该值等于官方默认值，只要字段存在，即被视为一次覆盖。点击 Reset 会将该字段清除，使其回退到主题默认值。

适用场景与注意¶

• 权限与依赖：DSH 插件以当前进程权限运行。安装前建议检查源码与许可证（本项目为 MIT 许可证）。
• 字体粗细与大小：字体的粗细和大小由 DSH 0.1.2 及以上版本的官方主题设置（Appearance）提供，本插件仅负责字体族和连字，不干预粗细与大小。
• 本地化：界面文案通过官方 ctx.locale 机制进行中英文本地化。
• 卸载：执行 dsh plugin remove dsh-font-plugin 会同时移除插件包及其补丁层。

总结¶

该插件通过标准的 DSH 插件配置契约，为 Web UI 提供了非侵入式的字体定制能力。开发者可以通过 UI 或 YAML 文件快速调整编辑器和代码区域的显示效果。

• 插件目录
• GitHub 仓库