前言¶
DeepSeek Harness（DSH）採用插件化架構，擴展功能通常通過修改配置文件或直接注入 Bundle 實現。在管理模型能力時，有時需要針對特定模型配置輸入模態（如是否支持圖像）或推理努力級別。dsh-model-modality 插件通過修改 DSH 的 Web Models 設置頁面，提供了可視化的配置入口，直接寫入 input 和 reasoningEfforts 字段，無需手動編輯配置文件。
插件定位¶
該插件由開發者 hmtxj 維護，旨在爲 DSH 的 Models 設置頁面增加針對單個模型的控制能力。它作用於由 @deepseek-ai/dsh-llm-pi-ai 適配器管理的 Provider，將原本只能在配置文件中體現的模型能力聲明，下沉到 UI 界面進行操作。
安裝與啓用¶
安裝插件需要通過 CLI 命令執行，安裝後需重啓對應的 DSH Profile。
dsh plugin --profile web add github:hmtxj/dsh-model-modality
安裝完成後，重啓目標 Profile，在 Web 界面進入 Settings → Models 即可看到相關控制項。
功能說明¶
插件主要提供兩類配置功能，分別作用於 Provider 卡片和模型編輯對話框。
1. 輸入模態配置¶
在 Settings → Models 頁面，每個 Provider 卡片下會列出該 Provider 提供的模型。
- 默認狀態：Text（文本）輸入默認啓用且無法取消勾選。
- 啓用圖像：勾選 Image 選項後，插件會向配置寫入
input: [text, image]。 - 禁用圖像：取消勾選 Image 選項後，配置將寫入
input: [text]，明確聲明該模型僅支持文本，而非繼承 Catalog 默認值。 - 保存：輸入類型的修改會立即保存。
2. 推理努力級別配置¶
在 Provider 的 Edit 對話框中，展開具體的模型行，在上下文和輸出限制旁邊會出現推理控制。
- 可選值：支持
off、minimal、low、medium、high、xhigh、max七個級別。 - 映射規則：
- 選擇某個級別後，配置會以
{ "high": "high", "max": "max" }的形式寫入，即“選擇即映射”。 off映射爲null。- 繼承配置：若清空所有選擇，將移除顯式聲明，恢復爲 Catalog 的默認配置。
- 拒絕項：僅選擇
off會被拒絕，因爲適配器不接受該配置。 - 保存：需通過對話框的常規保存動作提交，該操作會更新或創建顯式的
models列表。
注意事項¶
使用該插件需注意以下限制與環境要求：
- 適配器限制：僅適用於由
pi-ai適配器家族管理的 Provider，其他適配器不受影響。 - Bundle 寫入權限：推理控制功能需要對已安裝的 Models UI Bundle 具有寫入權限。插件在 Profile 加載時會自動對 Bundle 進行 Patch。
- 反向代理兼容性：輸入類型的 API 在當前構建版本中要求
Host頭爲 Loopback（迴環地址）。如果通過反向代理轉發外部 Host 頭，可能會收到403錯誤。 - 兼容版本：已驗證兼容 DSH
0.1.5-rc.1（配合 Models UI0.1.5-rc.2）和0.2.0-rc.2。後續版本若 UI 結構變更（如ModelRow組件變化），插件可能無法識別佈局。 - 插件移除：移除插件不會自動恢復已被 Patch 的 Bundle。如果需要恢復，只能刪除該 Bundle 並重新安裝，或手動恢復與該 Bundle 版本對應的備份文件（
client.js.pre-thinking-patch）。
總結¶
dsh-model-modality 通過 UI 擴展簡化了 DSH 中模型模態和推理級別的配置流程。它不生成新的能力，而是聲明現有的能力。對於需要精細化管理模型配置的開發者，該插件提供了比直接編輯 YAML 文件更直觀的操作方式。
