前言¶
在 DeepSeek Harness (DSH) 生態中，代理開發往往需要額外的判斷邏輯。dsh-advisor 插件移植了 rpiv-advisor 子系統，爲每個代理作用域提供了一個零參數的 advisor() 工具。它將完整的會話歷史和工具清單轉發給一個單獨配置的評審模型，利用原始的 rpiv 系統提示詞，返回計劃、修正或停止信號，從而輔助主模型做出更準確的決策。
是什麼¶
- 名稱：dsh-advisor
- 描述：獨立的 DSH 插件包，用於移植
rpiv-advisor子系統。 - 維護者：NexusAgentX
- 分類：模型推理
- 許可證：MIT
核心能力¶
- 零參數工具：作爲一個工具註冊在代理作用域中，無需爲每個代理編寫額外參數。
- 按需調用：由主模型決定何時調用
advisor()，不包含輪次觀察者或自動注入機制。 - 歷史轉發：將完整的派生會話歷史和工具清單轉發給評審模型。
- 評審機制：使用原始 rpiv 系統提示詞與評審模型交互。
- 結果處理：評審模型的輸出（計劃、修正或停止信號）作爲普通工具結果返回。
- 配置靈活性：支持插件行配置、dsh Web 設置頁面和
/advisor命令三種配置層級。
安裝與配置¶
安裝¶
使用官方提供的命令進行註冊安裝：
dsh plugin --profile web add dsh-advisor # <name> = your profile name
配置說明¶
插件默認處於關閉狀態。啓用時，必須配置 provider 和 model，否則工具將不被安裝並報告禁用原因。配置項包括：
enabled：總開關，默認爲false。provider：必填。評審模型的提供商路由。model：必填。評審模型的 ID。reasoningEffort：推理強度，默認爲空（自動），支持minimal、low、medium、high、xhigh、max、off。systemPrompt：覆蓋原始 rpiv 提示詞，默認爲空（使用內置）。guidance：執行器提示詞覆蓋，包含promptSnippet和promptGuidelines。disabledForModels：執行器黑名單，阻止特定模型看到advisor工具。
配置在三個層級上組合，後一層級會覆蓋先前的配置：
1. 插件行配置：位於 cordis.patch.yml，作爲基礎層。
2. dsh Web 設置頁面：在“插件配置”頁面的 Advisor 卡片中修改，會寫入 advisor 命名空間並覆蓋插件行配置。
3. /advisor 命令：僅在當前會話生效，不會修改持久化配置。
使用方法¶
會話控制¶
啓用插件後，可通過命令行控制會話中的行爲：
/advisor：切換當前會話的 advisor 工具。/advisor on：在當前會話中啓用。/advisor off：在當前會話中禁用。/advisor status：查看模型、強度、工具可見性及禁用原因。
工具調用¶
當主模型認爲需要更強的判斷時，它會主動調用 advisor() 工具。評審模型的返回內容是自由文本形式的計劃、修正或停止信號。主模型讀取該結果後繼續執行，並將關鍵建議體現在下一條可見回覆中。
注意事項¶
- 默認關閉：安裝後需手動啓用。
- 強制配置：啓用時必須同時配置
provider和model，否則工具不可用。 - 配置校驗：未知配置鍵會被拒絕；舊配置鍵
immuneTurns和maxDeltaMessages已被忽略。 - 依賴關係：依賴 peerDependencies，需確保環境滿足依賴版本要求。
- 控制權：主要模型保持控制權，它決定何時調用
advisor()。 - 生態說明：該插件位於社區目錄（skillhub.cn），與 DeepSeek 官方無從屬關係。
