前言¶

在 DSH 中配置自定義 llm-pi-ai 提供方時，除了 provider 和 model，還經常需要處理推理強度：每個模型支持哪些級別，每個級別實際發送什麼 wire value，provider 的默認值是什麼。

dsh-reasoning-settings 是面向這個場景的 DSH 插件。它爲自定義提供方提供獨立的推理強度設置頁，並支持在 subagent 調用中選擇 provider、model 與推理強度。

這是什麼¶

dsh-reasoning-settings 由 JuneLearn 維護，許可證爲 MIT。

它圍繞模型推理配置和自定義提供方設置，主要解決兩類問題：

• 爲自定義 llm-pi-ai 提供方聲明可選擇的推理強度級別，並配置實際發送的 wire value。
• 在 subagent 調用中，讓模型路由和推理強度繼承更符合父級當前選擇。

核心能力¶

設置頁能力¶

插件的設置頁能力包括：

1. 自動讀取官方 Models 頁面中已添加的自定義 providers 和 models。
2. 爲每個模型聲明 off / minimal / low / medium / high / xhigh / max 推理強度級別。
3. 爲每個級別自定義實際發送到 API 的 wire value。
4. 設置 provider 範圍默認推理強度，並限制在該 provider 所有模型支持的級別內。
5. 爲 openai-completions provider 配置推理 wire format。
6. 通過官方 settings.mutate API 寫回 llm-pi-ai.providers.*，且不觸碰 API keys。

子代理調用能力¶

插件在 subagent 調用方面提供以下能力：

1. 修復進程內 subagents 繼承 Agent 創建時的官方模型，而不是父級當前第三方 provider/model 選擇的問題。
2. 讓 subagents 繼承顯式父級推理強度，或回退到目標 provider 配置的默認推理強度。
3. 將僅 model 的子覆蓋（如 grok-4.5）解析到用戶配置的第三方 provider，而不是無關的官方 provider。
4. 擴展普通 subagent 與 subagent_fork 工具，增加每次調用的 provider、model、reasoning_effort 字段，且不替代其官方生命週期、後臺或結果行爲。
5. 服務器入口修復針對 Harness 0.1.0-rc.5 的進程內 subagent、subagent_fork 與 Workflow children。

安裝與啓用¶

安裝前先檢查運行環境。

運行環境需要 Node.js 22.19.x 或 24 及以上版本，推薦 Node.js 24 LTS；還需要 Git、pnpm，並能訪問 registry.npmjs.org 與 github.com。

npx 方式¶

npx 方式不需要 DeepSeek Harness 源碼 checkout。

先安裝插件：

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings

安裝後啓動 Web：

npx --yes -p @deepseek-ai/dsh dsh web

Web 默認監聽 http://127.0.0.1:3080；僅默認端口被佔用或顯式選擇其他端口時使用其他端口。

pnpm 源碼方式¶

pnpm 源碼方式需要 DeepSeek Harness 源碼樹。

進入 D:\deepseek-harness 後安裝插件：

cd D:\deepseek-harness
pnpm dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings

然後啓動 Web：

cd D:\deepseek-harness
pnpm dsh web

升級¶

升級時再次運行對應的安裝命令；無需卸載或維護 profile-patch。

npx 方式再次運行：

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings

pnpm 源碼方式再次運行：

cd D:\deepseek-harness
pnpm dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings

卸載¶

npx 方式卸載：

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web remove dsh-reasoning-settings

典型用法¶

下面是一個完整使用路徑：

1. 先在官方 Models 頁面添加自定義 provider 和模型。
2. 打開 Settings > Reasoning effort。
3. 爲每個模型選擇支持的推理強度級別。
4. 設置 provider 默認強度。
5. 在該 provider 下點擊 Save。
6. 開始新會話後，在模型選擇器中選擇模型和推理強度。

這裏需要區分“能發送”和“被接受”：插件只聲明 Harness 可選擇和發送的推理強度級別；relay API 是否真正支持取決於該 relay。

如果請求返回 HTTP 400，應取消該模型不支持的級別或調整其 wire value。

子代理工具字段¶

插件擴展普通 subagent 與 subagent_fork 工具，增加每次調用的字段：

• provider：已配置的 provider id。
• model：該 provider 擁有的 model id。
• reasoning_effort：可選的 off / minimal / low / medium / high / xhigh / max 級別。

使用規則如下：

• provider 和 model 必須一起提供。
• 省略兩者保持正常繼承。
• 省略 reasoning_effort 時，按目標 provider 配置的默認推理強度處理。

適用場景與注意¶

適合以下場景：

• 已配置自定義 llm-pi-ai provider 和 models 的 DSH 使用場景。
• 需要爲不同模型聲明推理強度級別，並配置實際發送 wire value 的場景。
• 需要在 subagent 或 subagent_fork 調用中按次指定 provider、model 與推理強度的場景。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼、依賴與許可證。
• 插件不觸碰 API keys，僅通過官方 settings.mutate API 寫回 llm-pi-ai.providers.*。
• 插件獨立於任何特定 relay；資料中包含第三方 API relay 推廣鏈接和兌換碼，但插件不要求任何特定 relay。
• 是否使用第三方 relay 服務，應自行判斷其價格、可靠性與隱私條款。

參考¶

• GitHub：https://github.com/JuneLearn/dsh-reasoning-settings
• 社區目錄頁：https://www.skillhub.cn/plugins/JuneLearn/dsh-reasoning-settings

社區目錄頁是獨立站點，不是官方應用商店；不要將插件目錄與 DeepSeek / 幻方理解爲官方從屬關係。