dsh-task-effort: 根據任務自動調整模型推理強度

前言¶

在 DeepSeek Harness (DSH) 的智能體開發中，模型的 reasoningEffort 參數決定了推理的深度與成本。固定設置一個檔位往往不合適：閒聊使用 high 檔位會浪費 Token，而複雜任務使用 off 檔位則可能導致質量不足。此外，高峯時段的定價策略也需要在成本與質量之間做平衡。

插件定位¶

這是一個 DSH 插件，用於在每次 LLM 調用前，根據當前任務內容自動決定模型的 reasoningEffort（off/low/high/max），並結合高峯時段定價策略進行限檔。它由 zhangzhenwen1 維護，定位在「模型推理」分類。

核心功能¶

自動分類與調整：根據任務內容（關鍵詞、消息長度）自動選擇 off/low/high/max 檔位。
價格感知限檔：識別工作日高峯時段（北京時間 09-12/14-18），自動壓低 effort 檔位以節省成本。
錯誤自動升級：若本輪工具調用報錯，剩餘步驟自動強制升級到 max 檔位。
手動兜底機制：支持通過 [effort=...] 標記或 GUI 手動控制，優先級高於自動判定。
子代理支持：子代理默認按 max 檔位處理，也可設置爲 off。

安裝與啓用¶

使用官方命令安裝：

dsh plugin --profile web add dsh-task-effort
# 或從 GitHub 安裝
dsh plugin --profile web add github:zhangzhenwen1/dsh-task-effort

安裝後重啓 dsh web。配置項可通過 profile 的 cordis.patch.yml 覆蓋。

判定規則¶

插件在 agent/pre-step 讀取消息並分類，在 agent/request 應用配置。判定優先級從高到低：

顯式標記：消息包含 [effort=off|high|max]（支持 low/medium 別名，low 映射爲 off）。
複雜任務：命中 maxKeywords（如 refactor/design/debug/分析/重構）。
繼續指令：命中 continuationKeywords（如 continue/接着/next），沿用上一輪。
閒聊：剝離禮貌前綴（politenessPrefixes）後命中 offKeywords。
長指令：消息長度超過 longThreshold（默認 200）。
短指令：消息長度短於 shortThreshold（默認 4）且無信號，沿用上一輪。
默認：使用 defaultEffort（默認 high）。

配置項¶

以下是主要的配置項說明：

鍵	默認值	說明
`enabled`	`true`	總開關
`providers`	`["deepseek-official"]`	僅調整這些 provider 的請求
`defaultEffort`	`"high"`	無信號時的默認檔位
`maxKeywords`	見源碼	複雜任務關鍵詞
`offKeywords`	見源碼	閒聊關鍵詞
`politenessPrefixes`	見源碼	判定前剝離的禮貌前綴
`continuationKeywords`	見源碼	繼續類指令
`longThreshold`	`200`	消息長度超過即 max
`shortThreshold`	`4`	短於此且無信號則沿用上一輪
`escalateOnError`	`true`	輪內工具報錯後升級到 max
`costAware`	`true`	時段感知：高峯時段自動壓檔
`peakCap`	`"high"`	高峯時段的 effort 上限
`subagents`	`"auto"`	子代理策略：auto/off
`notify`	`true`	effort 變化時注入說明
`log`	`true`	打印判定日誌

手動控制¶

GUI 模型選擇器：在界面手動選擇模型檔位後，插件會暫停自動判定，尊重手動選擇。新建會話或重啓 dsh web 後自動恢復。
消息標記：在消息中輸入 [effort=off] 或 [effort=max]，優先級最高，僅當輪生效。
臨時關閉：修改配置 enabled: false 或移除 patch 條目。

界面可見性¶

插件會在會話中注入 <system-reminder> 說明當前 effort 變化原因（包含判定原因、檔位、當前時段及倒計時）。
模型選擇器旁的膠囊會顯示實際生效的檔位（Off / Low / High / Max）。
Request/header 事件中會記錄實際檔位變化。

已知限制¶

判定邏輯基於啓發式關鍵詞匹配，可能發生誤判。遇到問題時，使用 [effort=...] 標記進行兜底。

總結¶

該插件通過自動適配任務強度和高峯限檔，幫助 DSH 用戶在控制成本的同時保證推理質量。
完整目錄與源碼：Catalog URL | GitHub URL