前言¶

在 DSH Web 中，如果已經在 Models 頁面添加了自定義 Provider 和模型，後續還需要關心兩個配置：模型支持哪些推理等級，Provider 使用哪種思考格式。

gao-gao-zai/dsh-custom-reasoning 是 gao-gao-zai 維護的 DSH 插件，用於爲自定義 pi-ai 模型配置推理等級和思考格式。它會在 DSH Web 的 Settings 頁面增加一個“思考等級”區域，讓配置入口集中到一個頁面裏。

下面介紹它的核心能力、安裝方式、典型用法，以及需要留意的限制。

這是什麼¶

一句話定位：爲 DeepSeek Harness（DSH）的自定義 pi-ai 模型配置推理等級和思考格式。

它解決的主要問題是：當你有多個自定義 pi-ai Provider 和模型時，需要在一處查看、調整並批量設置每個模型可用的推理等級，同時爲每個 Provider 選擇對應的思考格式。

插件許可證爲 MIT。DSH 社區目錄是獨立站點，與 DeepSeek、幻方無官方從屬關係。

核心功能¶

插件提供以下能力：

• 爲每個自定義模型配置多個推理等級：
• off
• minimal
• low
• medium
• high
• xhigh
• max
• 爲每個 Provider 配置思考格式：
• 自動檢測
• openai
• deepseek
• openrouter
• together
• zai
• qwen
• string-thinking
• ant-ling
• 在 DSH Web Settings 頁面增加“思考等級”區域。
• 配置保存後，對話中的模型選擇器會將模型支持的推理等級作爲單選項展示。
• 修改後自動保存，無需手動提交。
• 支持按住鼠標拖動，快速勾選或取消多個推理等級。
• 支持複製一個模型的等級配置，並點擊或拖動粘貼到其他模型。
• 保存時使用 Settings revision，避免靜默覆蓋併發修改。

安裝與啓用¶

前置條件：

• 已安裝並可以運行 DSH Web。
• 已在 DSH 的 Models 頁面添加至少一個自定義 Provider 和模型。
• 自定義模型配置由 llm-pi-ai Settings namespace 管理。

README 中的裝配步驟如下：

git clone https://github.com/gao-gao-zai/dsh-custom-reasoning.git
cd dsh-custom-reasoning
dsh plugin --profile web add .

其中，核心裝配命令是：

dsh plugin --profile web add .

裝配完成後，按提示重啓 DSH，並刷新頁面。

典型用法¶

先確認當前 DSH Web 可以訪問，並且 Models 頁面裏已有至少一個自定義 Provider 和模型。

1、打開 DSH Web。

2、進入 Settings。

3、打開“思考等級”區域。

4、爲每個 Provider 選擇合適的思考格式。

5、勾選每個模型支持的推理等級。

6、等待界面顯示“已保存”。

每個模型至少保留一個推理等級，界面不會允許取消最後一個選項。

複製等級配置¶

如果你希望把同一個推理等級配置應用到多個模型，可以使用複製配置：

1、點擊“複製配置”。

2、點擊一個模型的任意等級標籤，將該模型設爲模板。

3、點擊目標模型，或按住鼠標拖過多個目標模型。

4、按 Esc 或點擊“取消複製”退出複製模式。

複製操作只複製模型的 reasoningEfforts，不會修改 Provider 的思考格式。

保存與限制¶

插件保存配置時需要注意以下幾點：

• 只管理自定義 pi-ai Provider，不管理 DSH 內置模型。
• 推理等級和思考格式選項目前由插件內的固定列表提供。
• 修改後等待 800 ms 再保存，以合併連續操作。
• Provider 思考格式寫入 providers.<provider>.compat。
• 模型推理等級寫回對應 Provider 的 models 數組。
• 保存模型等級時會寫回所屬 Provider 的完整 models 數組。
• 保存請求攜帶 expectedRevision，服務端配置已變化時不會直接覆蓋。
• 併發修改由 revision 檢查保護，但衝突後需要刷新頁面重新加載最新配置。
• 保存失敗時，頁面會顯示 API 返回的錯誤。
• 插件不會在本地存儲 Provider 憑證或模型密鑰。
• 當前包只包含可加載的 JavaScript 文件，沒有獨立構建腳本和自動化測試。

適用場景與注意¶

這個插件適合使用 DSH Web、已經添加自定義 pi-ai Provider 和模型，並且希望集中管理推理等級與思考格式的場景。

安裝前建議檢查源碼與 MIT 許可證。插件會執行 DSH Settings 相關寫入操作，並且以當前 dsh 進程權限運行，因此不建議在來源不明或未完成審閱的環境裏直接使用。

如果團隊裏有多人同時修改同一份 DSH 配置，需要留意 revision 衝突；發生衝突時，刷新頁面重新加載最新配置後再繼續修改。

結尾¶

gao-gao-zai/dsh-custom-reasoning 的價值比較集中：把自定義 pi-ai 模型的推理等級和 Provider 思考格式放到 DSH Web Settings 裏統一管理，並提供拖拽勾選和複製配置這類批量操作。

相關鏈接：

• GitHub：https://github.com/gao-gao-zai/dsh-custom-reasoning
• 目錄頁線索地址：https://www.skillhub.cn/plugins/gao-gao-zai/dsh-custom-reasoning

目錄頁線索地址來自插件線索，未包含在已抓取資料中，訪問前可先覈對。