前言¶

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 默認排版單一的問題，通過將對話、界面、代碼的排印控制分離，配合懸浮面板和預設方案，實現了高效、靈活的視覺定製。