在智能體開發流程中，除了配置模型列表與上下文窗口，控制推理行爲（reasoningEfforts）以及適配不同網關的兼容性往往需要額外的配置步驟。官方設置頁面在處理這些細粒度控制時存在缺口。該插件通過掛載到 DSH 官方擴展槽位，爲 llm-pi-ai 提供方提供了一個獨立的設置頁面，用於配置逐模型的思考強度等級、請求頭以及網關兼容開關。
插件定位¶
這是一個 DeepSeek Harness (DSH) web 插件，主要解決以下問題：
- 精細化推理控制：爲每個模型單獨設置推理強度（
reasoningEfforts），支持未設置、禁用、標準檔位或自定義檔位。 - 批量配置：支持提供方級的一鍵“標準檔位”部署，將提供方下所有模型統一調整。
- 請求頭管理：允許爲特定提供方添加靜態的自定義 HTTP 請求頭。
- 網關適配：提供兼容性開關（
compat），用於解決網關報錯或字段不匹配問題。
插件本身不存儲持久數據，所有配置通過官方 settings.mutate 寫入 profile 的 cordis.patch.yml 中，數據屬主爲 llm-pi-ai 命名空間。
安裝與啓用¶
安裝該插件需要指定一個 40 位的 commit hash（推薦使用 git ls-remote 獲取默認分支的 hash）。
dsh plugin --profile web add github:fuzz1og/dsh-model-capabilities#<40位commit>
安裝完成後，必須重啓 web profile 才能使配置生效。該插件支持安裝在 headless 或 tui profile 中，但僅提供 web profile 的 UI 界面。
使用步驟¶
-
進入配置頁
安裝並重啓後，在 DSH 的設置側欄中，Models下方會出現新的“模型能力”頁面。該頁面掛載在官方擴展位id: model-capabilities, order: 16。 -
配置提供方與模型
左側列表展示所有llm-pi-ai提供方。點擊提供方名稱右側的 “標準檔位” 按鈕，可將該提供方下所有模型的思考強度統一設置爲標準檔位並保存。 -
設置模型級推理強度
展開具體的模型行，通過下拉菜單選擇推理強度：- 未設置：不干預默認行爲。
- 禁用：明確標記爲不支持推理。
- 標準檔位：應用預設的標準檔位（
off,low,medium,high,max）。 - 自定義：手動指定具體的參數值（例如將
max映射爲ultra）。
-
添加自定義請求頭
展開模型的 “請求頭” 區域，點擊添加，輸入名稱與固定值。例如，某些網關要求攜帶x-opencode-session頭，需在此處填寫一個固定值（插件不支持動態佔位符）。 -
調整兼容性設置
在提供方配置中展開 “兼容設置”，根據網關文檔調整布爾開關或枚舉值。例如，將maxTokensField修改爲max_tokens，或將developer角色改爲system以解決 400 錯誤。
注意事項¶
- DSH 版本要求：插件依賴 DSH
>= 0.1.7-alpha.1。 - 數據所有權：插件無自有持久數據，所有讀寫操作在
llm-pi-ai命名空間下進行，利用官方 revision 柵欄防止衝突。 - 模態編輯限制：插件不編輯支持模態（
input），這部分由官方 Models 頁面管理，插件僅讀取相關字段。 - 會話頭限制：
x-opencode-session等自定義頭必須填寫固定值，不支持動態輪換。 - 寫入機制：逐模型保存採用路徑級操作（
providers.<route>.models[i].reasoningEfforts），不會整體替換模型列表，因此不會覆蓋官方頁面維護的模態設置。
