前言¶

DeepSeek Harness (DSH) 的設計理念是讓日常模型處理常規工作，而在關鍵決策、重複失敗或回合結束時，由更強的顧問模型提供第二意見。dsh-advisor-flow 是一個將 pi-advisor-flow 移植到 DSH 的插件，它爲智能體增加了諮詢工具、審查門限、使用賬本和隱私分級功能。

插件簡介¶

名稱：dsh-advisor-flow
維護者：ccll
定位：DeepSeek Harness (DSH) 插件，提供按需執行的審查與顧問工作流。

該插件解決了智能體在運行過程中缺乏外部審查機制的問題。它通過引入一個獨立的顧問模型（複用 DSH 的模型路由），在不接管主流程控制權的前提下，對執行計劃、失敗重試和最終結果進行強制審查。

核心能力¶

該插件提供以下核心功能：

1. 按需諮詢工具：執行器可在需要時調用 ask_advisor 工具。該工具支持通用審查（無參數），或傳入具體問題、草稿、倉庫上下文分級及文件列表進行鍼對性審查。每次回答攜帶 adviceId 以便後續引用。
2. 手動諮詢：會話所有者可隨時使用 /advisor-manual [focus] 命令發起諮詢，或使用 /advisor cancel 取消進行中的諮詢。
3. 硬循環門限：當工具調用簽名重複達到預設閾值（默認爲 3）時，系統會攔截調用並請求顧問審查。顧問返回 proceed（繼續）、revise（修訂）或 blocked（阻塞）三種裁決。
4. 執行指南注入：插件會在系統提示中注入執行指南，包括 before-plan（前計劃）、after-failure（失敗後）和 before-completion（完成前）三個階段的約束。
5. 硬完成審查：在默認的 hard 模式下，每個回合關閉前都會進行強制審查。若裁決爲 revise 或 blocked，顧問會將建議反饋給執行器。soft 模式則僅作爲參考。
6. 結果記錄：執行器可使用 record_advisor_outcome 工具記錄建議是否被採納及驗證結果，默認關閉。
7. 使用賬本與狀態：通過 /advisor status 命令，可查看會話狀態、門限統計以及按觸發類型分類的 Token 消耗和成本明細。
8. 隱私分級：支持倉庫上下文分級（關閉/摘要/完整）。敏感數據在發送前會被替換爲佔位符（redactSecrets），文件內容僅在獨立確認後纔會離開本地。
9. 非阻塞保證：無論顧問服務或門限檢查失敗，都不會阻塞主智能體的循環。

安裝與啓用¶

由於 npm 發佈尚在進行中，目前需直接從倉庫安裝。

dsh plugin --profile web add github:ccll/dsh-advisor-flow

安裝後，若未在界面看到設置卡片，請重啓 dsh web。

配置文件位於 settings.yaml 的 advisor-flow 命名空間下。啓用插件需同時配置 advisor-flow.enabled 以及 advisor.provider 和 advisor.model。

advisor-flow:
  enabled: true
  advisor:
    provider: deepseek-official
    model: deepseek-reasoner
  mode: hard
  gates:
    plan: { enabled: true }
    failure: { enabled: true }
    loop: { enabled: true, threshold: 3 }
    completion: { enabled: true }
  failureMode: block-tool
  privacy:
    repoContext: summary
    redactSecrets: true

使用方式¶

插件通過命令行和工具兩種方式交互。

命令行交互：
- /advisor-manual [focus]：立即啓動手動諮詢。
- /advisor cancel：取消正在進行的諮詢。
- /advisor：切換會話的顧問模式（開啓/關閉）。
- /advisor status：查詢會話狀態、門限統計和成本。

工具調用示例：
執行器調用 ask_advisor 獲取通用審查：

// 無參數，進行通用審查
ask_advisor()

調用 ask_advisor 獲取針對特定問題的審查：

ask_advisor({
  question: "當前的重試策略是否存在風險？",
  draft: "重試 3 次，每次間隔 1 秒...",
  repoContext: "summary" // 只能縮小所有者允許的分級範圍
})

注意事項¶

• 非接管原則：顧問模型僅提供建議，不直接調用工具或修改文件，工作流控制權始終在主智能體手中。
• 兼容性：插件依賴 DSH 的插件接口，package.json 中聲明的兼容版本爲 0.2.0-rc.2，但 README 中測試環境爲 0.1.5-rc.1，安裝前請確認環境兼容性。
• 安全：默認不開啓敏感數據刪除，建議在設置中開啓 redactSecrets，確保敏感值在截斷前被替換。

結語¶

dsh-advisor-flow 爲 DSH 智能體提供了一個標準化的審查層，通過配置化的門限和隱私分級，幫助開發者在保持工作流自主權的同時，引入外部模型的監督能力。

GitHub 倉庫
SkillHub 插件目錄