前言¶
在基於 DeepSeek Harness (DSH) 構建的多步智能體任務中，模型通常會在每次工具調用前進行“重新思考”。這種機制在複雜任務中能提升準確率，但也會顯著增加時間成本（例如，一個包含 50 步的工具調用任務，可能因中間的推理過程而花費數分鐘）。本插件旨在精細控制這一過程，在保證複雜任務性能的同時，避免在簡單任務上浪費算力。
插件簡介¶
該插件是 DeepSeek Harness (DSH) 的一個擴展，由開發者 drscrewdriver 維護。它主要用於控制模型請求中的 reasoning_effort 參數，支持根據歷史記錄自動調度推理強度，也允許手動固定某一強度等級。
核心功能¶
插件提供了以下主要能力：
- 每輪推理強度控制：可針對單輪對話調整模型的推理努力程度。
- 自動調度模式：在會話模型選擇器中選擇
Auto後，插件會根據最近的工具調用歷史，自動調度low、high或max的推理強度。 - 手動鎖定模式：支持手動固定推理強度，包括
off、on、minimal、low、medium、high、xhigh和max。 - 版本依賴：插件依賴於 DSH 環境版本
>= 0.1.7-rc.1 < 0.1.8。
使用方法¶
在 DSH 的會話模型選擇器中，可以通過以下方式配置：
-
自動調度：
在模型選擇器中選擇Auto。此時插件會作爲一個“掩碼”介入，根據歷史記錄解析並決定每一步使用low、high還是max，避免簡單任務變得昂貴，同時保證繁重任務不因資源不足而中斷。 -
手動指定：
手動選擇具體的等級。例如，選擇high可以直接發送官方默認的推理努力值。
支持的推理等級說明：
* off：關閉思考（手動模式，不會被自動選中）。
* on：啓用思考（僅適用於僅切換模型的場景，用於發送 enable_thinking 標誌，不發送 reasoning_effort）。
* minimal：最低努力（適合輕量級任務）。
* low：低努力（適合簡單聊天任務）。
* medium：中等努力。
* high：高努力（官方默認值）。
* xhigh：超高努力。
* max：最大努力（用於重負載工作）。
注意事項¶
- 依賴變更：自 v0.7.0-beta.1 (2026-09-06) 起，插件不再依賴
dsh-llm-openai-completions適配器，轉而使用官方的llm-pi-ai兼容層。若使用舊版 DSH (0.1.2–0.1.6)，需使用插件 3.0.2 版本。 - 語言支持：日語 (
ja) 和韓語 (ko) 在標準 DSH 環境下不可用。這些語言需要使用自定義的 DSH Fork（更新locale-settings.ts和client/index.ts並重建），或者等待官方支持。 - 等級區分：
on僅用於啓用思考開關，並非推理強度等級。對於具備推理能力的模型，不應選擇on。
總結¶
該插件通過精細化管理 reasoning_effort，讓 DSH 智能體的執行過程更加經濟高效。適合需要在保證複雜任務推理質量的同時，優化資源消耗的開發者使用。
