前言¶

DeepSeek Harness (DSH) 的默认排版通常较为通用。dsh-fonttune 插件为开发者提供了对对话、界面和代码区域的细粒度控制，使界面风格与代码阅读体验独立于默认配置。

插件概览¶

名称：dsh-fonttune
维护者：LyaxZ
定位：DeepSeek Harness (DSH) 字体插件：对话拥有完整排印控制，界面默认跟随，代码独立支持连字与预设方案。

核心功能¶

插件主要提供三套独立的排印控制轴，并支持预设方案管理。

• 三套排印控制

  • 对话：拥有完整的字体族、字号、行高、字重控制。
  • 界面：提供字体与字重，默认跟随对话设置（可关闭），字号与行高由对话继承。
  • 代码：独立成轴，支持连字与特性开关。

• 实时调参

  • 悬浮调参面板：对话区域角落的小圆点可展开为卡片，支持实时调整字号、行高和字重。面板大小与位置会自动记忆。
  • 字号偏移：对话与代码字号偏移范围均为 -3 ~ +6 px。
  • 字重偏移：支持相对偏移，按档计数（如 -1, 0, +1），保留原有的层级粗细关系。
  • 行高：对话行高使用倍率（100%~160%），代码行高使用加法偏移（-4 ~ +8 px）。

• 字体与渲染管理

  • 独立回退列表：界面/对话/代码各自拥有独立的字体回退列表，支持拖拽排序。
  • 文字渲染质感：提供跟随系统、锐利、圆润三种模式。
  • 拒绝合成样式：默认允许合成，关闭后可禁用浏览器为中文伪造的斜体与粗体。

• 预设与配置

  • 预设方案：支持将整套配置保存为 JSON 格式的预设方案，支持改名、导入与导出。
  • 编辑模式：提供简单模式（西文/中文单选）与高级模式（字体栈编辑器）。

安装与启用¶

通过 DSH CLI 安装插件：

dsh plugin --profile web add dsh-fonttune

安装后需要重启 DSH 才能看到更改。

使用方法¶

1. 打开设置 → 插件 → 插件配置 → 展开「字体增强」卡片。
2. 在简单模式下点击「西文/中文」格子更换字体；或使用高级模式维护完整的字体栈。
3. 拖动滑块调整字号、字重或行高，松手即生效。
4. 使用预设方案下拉框切换预设配置。
5. 关闭「界面跟随对话」开关，使界面字体独立。
6. 重置所有字段以恢复默认设置。

兼容性与限制¶

• 宿主版本：需要宿主 DSH 版本 >= 0.1.7-alpha.1 且 < 0.3.0-0。
• 配置保存：设置保存在 profile 的 cordis.patch.yml（0.1.7+）或 settings.yaml 中。

总结¶

dsh-fonttune 解决了 DSH 默认排版单一的问题，通过将对话、界面、代码的排印控制分离，配合悬浮面板和预设方案，实现了高效、灵活的视觉定制。