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
  1. 從 GitHub 安裝:
    dsh plugin --profile web add github:wtksana/dsh-font-plugin
  1. 本地開發安裝:
    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 文件快速調整編輯器和代碼區域的顯示效果。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜