在 DeepSeek Harness (DSH) 中,僅靠 Prompt 指令“不要猜測”既無法強制執行也無法審計。dsh-evidence-gate 將結論紀律結構化,通過強制執行證據層級和交叉檢查來阻止智能體從未經驗證的猜測中得出結論,並確保所有結論可審計。
插件信息¶
- 名稱:aaronandwork/dsh-evidence-gate
- 維護者:AaronandWork
- 許可證:MIT
- 核心價值:Make agents in DeepSeek Harness (DSH) stop drawing conclusions from unverified guesses — and make every conclusion auditable.
核心功能¶
插件提供了一套結構化的結論驗證機制:
- 3-tier evidence hierarchy policy:建立證據層級策略,對結論進行分類管理。
- 模型工具判定:註冊
evidence_gate工具,對智能體提出的聲明進行判定(VERIFIED/REFERENCED/UNVERIFIED)。 - 持久化會話級交叉檢查:對會話內的工具活動進行持久化記錄,並基於參數和輸出錨點進行交叉覈驗。
- 會話級開關與賬本:提供會話級開關和持久化的統計賬本。
- UI 交互:提供會話級 UI 切換(盾牌芯片)。
- 防誤殺階梯:通過多層判定機制降低誤殺率。
- 輸出感知交叉檢查:交叉檢查不僅匹配命令字符串,還匹配工具輸出的關鍵詞、路徑和 URL。
- 靜默啓動:掛載時無默認輸出,僅調試時顯示信息。
- 誠實聲明保護:當無法覈驗時,允許引用真實存在的路徑通過(帶弱註記),防止誤殺。
安裝與啓用¶
插件以 DSH Bundle 形式發佈,無需手動編輯配置。
pnpm add github:AaronandWork/dsh-evidence-gate
安裝完成後,需在配置中啓用:
"bundles": [ "@aaronandwork/dsh-evidence-gate" ]
注意事項:
* pnpm add 命令會重寫 package.json,請手動檢查 bundles 配置。
* 確保 package.json 的 files 白名單包含 cordis.patch.yml。
* 安裝後重啓部署,瀏覽器刷新後自動加載。
典型用法¶
插件通過命令行指令和 UI 交互進行控制。
-
命令行控制:
/evidence-gate on:開啓當前會話的證據門。/evidence-gate off:關閉當前會話的證據門。/evidence-gate status:查看當前會話狀態、賬本、覈驗命中數及索引大小。/evidence-gate report:生成完整的會話報告,包含判定分組、依據統計、blocked/converted/採信數據。
-
UI 交互:
在編輯器界面中,使用盾牌芯片圖標切換開關,該開關僅對當前會話生效。
工作機制¶
- 策略注入:通過
systemPrompt.section(順序 550)注入策略文本。 - 證據層級:定義了
tested/measured/read_directly/prior_verified(直接證據)和documented/community_practice(引用來源)等層級。 - 持久化存儲:賬本、開關狀態和證據索引存儲於
DSH_HOME/evidence-gate/store.json,支持跨重啓保留。 - 交叉檢查:監聽
tools/result流,記錄工具參數和輸出錨點。智能體在陳述關鍵結論前必須調用evidence_gate工具。
防誤殺邏輯(階梯):
1. 本會話命中
2. 記錄的輸出關鍵詞命中
3. 其他會話(子代理)命中
4. 存在性底限(引用的路徑真實存在,通過帶弱註記)
5. 阻斷
適用場景與注意¶
- 適用場景:需要嚴格審計智能體結論來源、防止幻覺、構建高可信度 Agent 的場景。
- 權限注意:插件以 DSH 進程權限運行,安裝前應檢查源碼與許可證。
- 調試注意:設置環境變量
EVIDENCE_GATE_DEBUG=1可查看啓動日誌和加載信息。