在 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可查看启动日志和加载信息。