前言¶
在使用 DeepSeek Harness（DSH）開發智能體時，平衡計算成本與輸出質量是常見需求。如果全程使用昂貴模型成本過高，而全程使用廉價模型則可能降低質量。dsh-escalation-advisor 插件提供了一種折中方案：在大多數情況下運行便宜模型，僅在需要時借用更強的 DSH 模型進行“諮詢”或“升級”。諮詢過程以可見的 DSH 子會話形式運行，而非隱藏的 LLM 請求，便於調試和審計。
是什麼¶
dsh-escalation-advisor 是一個 DSH 專用插件，由 zhangqian98 維護，採用 MIT 許可證。它通過在任務樹中創建可見的子會話，讓用戶能夠檢查諮詢記錄、工具調用、token 使用量和最終結果。插件支持三種工作模式，並允許針對不同智能體類型（主智能體與本地子智能體）配置不同的覆蓋策略。
核心功能¶
三種工作模式¶
插件支持以下三種模式：
* manual：僅提供 consult_advisor 接口，無自動諮詢。
* escalate：默認模式，提供手動諮詢及確定性卡住/失敗評分。
* continuous：在自然輪次邊界進行影子審閱。
覆蓋策略¶
覆蓋策略可針對主智能體和本地 DSH 子智能體獨立配置：
* Manual：主智能體和本地子智能體均開啓。
* Automatic Escalation：主智能體和本地子智能體均開啓。
* Continuous Review：主智能體默認開啓，本地子智能體默認關閉。
Completion Review¶
Completion Review 是一個獨立的觸發器，在智能體準備最終交付時運行，檢查任務是否就緒（目標、成功標準、變更文件等），並通過 concern/blocker 引導智能體。該功能默認關閉。
Advisor Profiles¶
支持配置命名的 Advisor Profiles，包含 ID、標籤、模型路由和工具策略。智能體在諮詢時選擇一個 Profile，該 Profile 在首次諮詢後被固定，後續切換 Profile 或移除工具權限均會被拒絕。
會話覆蓋¶
通過 UI 頭部面板或命令行可以設置版本化的 advisor/policy 記錄，包括模式預設、超時、工具白/黑名單、觸發器開關等。未設置項將遵循全局默認值。
安裝與啓用¶
安裝前請確認 DSH 版本。該插件支持 DSH 0.1.2-rc.1、0.1.5-alpha.2 和 0.1.5-rc.1。CI 檢查 Node.js 版本爲 22.19+。
使用 npm 安裝：
dsh plugin --profile web add dsh-escalation-advisor@0.1.0-alpha.29
dsh web
也可以從 GitHub 源碼安裝：
dsh plugin --profile web add github:zhangqian98/dsh-escalation-advisor#v0.1.0-alpha.29
安裝後，在 Settings → Plugins → DSH Escalation Advisor 中配置強模型路由。該插件僅存儲提供者/模型路由 ID，複用 DSH Models 中已配置的認證信息。
典型用法¶
管理策略¶
在會話中使用以下命令管理策略和觸發器：
* /advisor catalog：查看或配置 Advisor Profiles。
* /advisor-trigger <trigger> <on|off|inherit>：切換手動、自動升級或完成審閱等觸發器的狀態。
* /advisor-tool <tool> <on|off|inherit>：控制工具的允許/拒絕策略。
配置 Profiles¶
在全局設置中配置 Advisor Profiles，指定 ID、標籤、模型路由和工具策略。智能體在調用 consult_advisor 時通過 advisor_profile 參數指定使用哪個 Profile。
適用場景與注意¶
該插件適合需要在 DSH 環境中精細化控制成本與質量的開發者。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證（MIT）。注意：
* 子會話排除：Advisor 子會話本身不會被手動諮詢、升級評分或連續審閱，防止遞歸諮詢。
* 默認設置：Completion Review 和 Local-subagent continuous review 默認關閉，以防止倍增強模型調用。
* 歷史兼容性：升級到 0.1.5-rc.1 時，建議先備份，並運行包含的維護腳本 scripts/patch-dsh-history.mjs 以處理舊版本的歷史記錄。
短結尾¶
dsh-escalation-advisor 通過提供可見的、可配置的第二意見機制，幫助 DSH 用戶在保持成本可控的同時提升輸出質量。更多細節請參考 GitHub 倉庫。
