前言¶

在 DeepSeek Harness（DSH）里跑编码智能体时，模型常会声称「测试已通过」「文件已改」等结论。这些陈述是否与实际 shell、edit 等工具的执行结果一致，单靠对话文本无法确认。社区插件 dsh-truth-gate（npm 包名 @zakza/dsh-truth-gate，仓库 Achi-Migo/dsh-truth-gate）在 Harness 侧对照工具回执（receipts）做校验，默认以 shadow 模式只记录、不干预 agent 行为，便于先观察再决定是否启用 gate。

这是什么¶

TruthGate for DeepSeek Harness：原生 DSH 插件，校验 coding-agent 关于测试、编辑等陈述是否与 shell/edit 类工具回执一致。维护者 Achi-Migo，在 SkillHub 目录中归类为 admin-security。引擎为随包提供的纯标准库 Python 模块 opc_truth（位于 python/），要求本机 Python ≥ 3.11 且在 PATH 上可用。

核心功能¶

• 三种运行模式（配置项 mode）：off 关闭；shadow 仅记录校验结果（默认）；gate 在文档语义上用于更强约束（具体拦截行为以实现为准）。
• 回执对照：针对 agent 声明与已发生的工具执行回执做一致性检查，而非仅信任自然语言输出。
• 可配置校验参数：协议要求、循环上限、超时等见下文配置节。
• DSH 版本：声明兼容 DSH 0.2.1-rc.3 与 0.2.1-rc.4；package.json 中 engines.dsh 为 >=0.2.1-rc.3 <0.3.0-0，Node ≥ 20。

安装与启用¶

安装前请确认 DSH 版本落在上述区间，并已安装 Python 3.11+。官方 README 给出的安装方式如下（<profile> 替换为你的 DSH profile 名）：

# from npm (preferred)
dsh plugin --profile <profile> add @zakza/dsh-truth-gate

# or local tarball / checkout
dsh plugin --profile <profile> add ./zakza-dsh-truth-gate-0.1.0.tgz
dsh plugin --profile <profile> add ./dsh-truth-gate

插件通过 cordis.patch.yml 注入 Harness；当前 npm 版本为 0.1.0，许可证 MIT。

在 cordis.patch.yml 或插件配置中可设置：

# cordis.patch.yml / plugin config
mode: shadow          # off | shadow | gate
python: python        # interpreter
requireProtocol: true
loopLimit: 3
timeoutMs: 15000

• mode：默认 shadow，适合先上线观察校验日志而不改变 agent 决策。
• python：用于调用内置 opc_truth 的解释器命令。
• requireProtocol、loopLimit、timeoutMs：控制校验协议与资源边界，按环境收紧或放宽。

典型用法¶

仓库提供 PowerShell 冒烟脚本，用于在指定 profile 下做快速验证（示例 profile 名为 truthgate-dev，可按本地改名）：

powershell -ExecutionPolicy Bypass -File scripts/smoke.ps1 -ProfileName truthgate-dev

日常使用时，建议先在 shadow 下跑真实任务，对照 Harness 日志与插件记录，确认「陈述 vs 回执」的差异模式，再评估是否切换到 gate。具体 hook 时机与 gate 行为以仓库 lib/ 与 cordis.patch.yml 为准。

适用场景与注意¶

适合：需要在 DSH 会话里审计 agent 是否「说一套做一套」的团队；希望在启用强拦截前先 Shadow 观测的 admin / security 场景（与目录分类 admin-security 一致）。

注意：

1. 插件与 DSH 进程同权限运行，安装前应阅读 GitHub 源码 与 MIT 许可证，确认符合组织安全策略。
2. npm 包名为 @zakza/dsh-truth-gate，与 GitHub 组织路径 Achi-Migo 并存，安装与排错时以 README 命令为准，勿自行拼接未文档化的 github:owner/repo 安装串。
3. SkillHub 目录页（plugins/Achi-Migo/dsh-truth-gate）为社区索引，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文事实以仓库 README 与 package.json 为准。

结尾¶

dsh-truth-gate 把「agent 说了什么」和「工具回执证明了什么」拆开对照，默认 shadow 降低误拦风险。若要进一步了解说明与 issue，见 SkillHub 目录页 与 GitHub 仓库。