前言¶

DeepSeek Harness (DSH) 的推理強度（Effort）來源於適配器聲明的元數據。如果適配器未聲明推理強度，DSH 會直接拒絕任何未聲明的請求。對於第三方模型，尤其是 llm-pi-ai 路由下的模型，往往缺少這些聲明，導致無法開啓推理功能。

dsh-custom-reasoning 插件通過在適配器元數據中補全推理等級聲明，解決了這一問題。安裝後，該插件會自動爲符合條件的第三方模型掛載標準五檔推理強度，之後由 DSH 官方推理等級選擇器接管控制。

它是什麼¶

dsh-custom-reasoning 是一個由 3likofj 維護的 DSH 插件。它專爲 llm-pi-ai 路由設計，負責自動爲官方未提供推理強度選項的第三方模型補全 reasoningEfforts 聲明，並管理相關的 compat 字段。

插件的核心邏輯是“自動補全”與“兼容性接管”：

自動補全五檔推理等級
插件監聽模型切換，檢測當前模型是否屬於 llm-pi-ai 且沒有任何推理元數據。如果是，它會自動爲該模型聲明 off/low/medium/high/max 五個等級。這一過程無需手動操作，選擇器出現後即可直接使用。
管理 compat 字段
插件會根據用戶選擇的線格式（如 openai、deepseek、qwen 等），自動寫入 compat 字段：
- 寫入 supportsReasoningEffort: true
- 寫入對應的 thinkingFormat（如 “openai”）
這樣可以確保 pi-ai provider 能正確解析並轉發推理參數。
持久化與回退
插件通過 remote.settings.mutate 將聲明寫入宿主設置，落點到當前 profile 的 Cordis patch。這意味着聲明會持久保存，關閉插件後失效。如果模型聲明瞭 compat 字段，插件會逐字段保留原有配置。

安裝需要使用官方插件管理命令。安裝前請確保環境滿足 Node >= 20，並在 dsh.profile.bundles 中啓用了該 bundle。

dsh plugin --profile <profile> add github:3likofj/dsh-custom-reasoning

若需釘住特定版本，可在末尾添加提交哈希。

安裝完成後，可以通過項目自帶的驗證腳本檢查插件邏輯是否正確執行：

node test/verify.mjs

該插件的使用有明確的邊界條件：

dsh-custom-reasoning 通過補全元數據，消除了第三方模型使用官方推理強度選擇器的障礙。對於使用 llm-pi-ai 路由的開發者，這是一個降低配置成本、統一交互體驗的有效工具。