前言¶

在 DeepSeek Harness（DSH）的 Web 客戶端中，當用戶通過 Settings -> Models 頁面配置第三方提供商時，頁面自帶的表單刻意隱藏了兩個關鍵字段：每個模型接受的輸入模態（是否允許圖片）以及推理級別。這通常迫使開發者直接編輯 YAML 配置文件或依賴適配器的默認行爲。dsh-models-input-modalities 插件通過在 Web 界面直接暴露這些字段，解決了這一配置痛點。

這是什麼¶

該插件由 DamonBao 維護，是一個 DSH Web 客戶端插件。它爲 Settings -> Models 頁面上的每個第三方（pi-ai）提供商卡片添加了一個“模型能力”摺疊面板。該面板允許用戶聲明每個模型接受的輸入模態和推理級別，而無需手動編輯配置文件。

核心功能¶

• 輸入模態選擇器：提供三種選擇：提供商默認、僅文本 或 文本和圖片。插件會根據選擇寫入適配器所需的語義。選擇“僅文本”寫入 input: [text]，選擇“文本和圖片”寫入 input: [text, image]，選擇“提供商默認”則移除該字段。
• 推理級別選擇器：提供三種選擇：目錄默認、非推理模型 或 聲明級別。展開“聲明級別”後，提供七個選項：off, minimal, low, medium, high, xhigh, max。插件會將選中的級別寫入 reasoningEfforts 字典。適配器會驗證聲明的集合，拒絕無效設置（例如沒有值的級別）。
• 衝突處理：使用 revision-fenced writes。當打開摺疊面板讀取數據時，插件會記錄當前的 revision。寫入時會以該 revision 爲依據。如果發生併發編輯，會觸發衝突通知並重新加載，而不是靜默覆蓋。
• 本地化支持：界面支持英文和中文，與 Web UI 的語言設置保持一致。
• 設置遷移：支持將舊版 llm-pi-ai 配置遷移到新的 pi-ai 結構中。

安裝與啓用¶

插件需要通過 DSH 的插件管理器進行安裝。
1. 在 DSH 的插件列表中找到該插件。
2. 執行安裝操作。
3. 安裝完成後，重啓 dsh web 進程。

典型用法¶

1. 打開 DSH，導航至 Settings -> Models。
2. 找到對應的第三方提供商卡片，展開“模型能力”摺疊面板。
3. 針對特定模型，選擇輸入模態（例如：文本和圖片）。
4. 選擇推理級別（例如：聲明級別，並勾選 high）。
5. 點擊保存。配置將寫入用戶層文件 $DSH_HOME/profiles/<profile>/cordis.patch.yml。

適用場景與注意¶

• 適用場景：當你需要爲特定模型啓用圖片輸入，或者需要精確控制推理級別（特別是當適配器需要特定參數映射時），該插件提供了比手動編輯 YAML 更直觀的方式。
• 注意：
  • 插件不預先寫入提供商配置（如 API Key、模型列表等），這些仍需通過標準表單創建。
  • 適配器會拒絕無效的聲明集合（例如只勾選了 off 但沒有拼寫，或者有其他級別但沒有拼寫）。
  • 插件會防止覆蓋未保存的草稿。
  • 在升級 DSH 前請備份 DSH_HOME。

短結尾¶

該插件通過在 Web 界面直接管理原本隱藏的模型能力字段，爲 DSH 用戶提供了更精細的配置控制。源碼與文檔可在 GitHub 查閱。

GitHub 倉庫 | 技能目錄頁