dcg黄金测试与同构性验证:如何防止输出格式悄悄漂移 dcg黄金测试与同构性验证如何防止输出格式悄悄漂移【免费下载链接】destructive_command_guardThe Destructive Command Guard (dcg) is for blocking dangerous git and shell commands from being executed by agents.项目地址: https://gitcode.com/GitHub_Trending/de/destructive_command_guarddcgDestructive Command Guard是一个专为 AI 编程代理设计的危险命令拦截工具它会在git reset --hard、rm -rf ./src、DROP TABLE users这类毁灭性命令执行前将其拦截。但一个守护工具自身的输出格式如果悄悄变了同样会出事——代理端解析失败的 JSON、漂移的判定结果会让保护形同虚设。本文带你了解 dcg 如何用**黄金测试Golden Tests与同构性验证Isomorphism Verification**这两道防线确保每一次重构都不改变拦截行为让你这个新手也能看懂它稳在哪里。为什么输出漂移是隐形杀手dcg 作为 hook 挂在 Claude Code、Codex CLI、Cursor 等代理的工作流里代理把命令交给它它返回一份结构严格的 JSONdeny/allow。任何字段名变化、缺失、顺序漂移都可能让某个代理版本直接解析失败。问题在于这类漂移通常不是一次大改动造成的而是几百次小重构里一点点漏出来的。人眼根本盯不住。dcg 的答案是——把期望的输出本身变成代码库里受版本管理的文件让机器来盯。第一道防线黄金测试Golden Tests黄金测试的核心思路提前保存一份标准答案golden file每次跑测试时把真实输出和它逐字段对比多一个键、少一个字段、值变了立刻报错。dcg 的黄金测试覆盖两类输出测试场景黄金文件位置守护对象Hook 模式代理拦截场景tests/golden/hook/deny_git.json、deny_filesystem.json等Robot 模式纯 JSON 输出tests/golden/robot/deny_git_reset.json等测试逻辑在 tests/golden_json_tests.rs几个值得新手注意的设计关键字段永不许变permissionDecision、ruleId、packId、severity这些字段是代理端依赖的契约新增字段可以删改不行动态字段打码allowOnceCode一次性放行码每次调用都随机生成直接对比永远失败。dcg 会先把它替换成DYNAMIC占位符再比较——这就是既严格又聪明的对比策略失败时有详细 diff不是简单一句不匹配而是精确指出MISSING: xxx、EXTRA: xxx、CHANGED: xxx expected ... actual ...方便定位受控更新机制确属有意变更时用UPDATE_GOLDEN1环境变量重新生成黄金文件把漂移变成一次显式的、可审查的提交而不是悄悄发生。第二道防线同构性验证行为不漂移黄金文件锁住的是输出长什么样而同构性验证锁住的是判定逻辑本身同样一条命令重构前后必须得到完全相同的结论。dcg 的回归语料库在 tests/corpus/用 TOML 文件组织成四大类目录含义验证目标true_positives/必须拦截的危险命令一条都不许漏false_positives/必须放行的安全命令一条都不许误杀bypass_attempts/混淆、包装、heredoc 变体的攻击命令伪装后也要拦住edge_cases/引号、Unicode、超长管道命令不许崩溃即可真正的同构性验证跑在 tests/regression_corpus.rs 和 tests/golden_isomorphism.rs对每条命令不仅检查allow/deny结论还要求pack_id、pattern_name、rule_id、判定理由等全部字段逐项一致。这保证了哪怕结论没变由哪条规则、在哪个包命中的这种归因信息也不许漂移。此外还有两个补充测试把盲区也堵上决策一致性tests/golden_isomorphism.rs同一条命令连评两次结果必须逐字段相同跨包回放tests/cross_pack_corpus.rs普通语料只跑默认启用的包而跨包套件会强制启用全部 50 个安全包、在 posix / PowerShell / cmd / unknown 四种 shell 方言下重放每条用例。它甚至用known_failing标记已发现但尚未修复的误报——用例不许削弱一旦修复成功测试反而会强制提醒你摘掉标记。六条不可触碰的行为不变式dcg 把绝对不能漂移的语义写成了白纸黑字的契约收录在 docs/canonical-corpus-invariants.md包求值顺序确定——按层级、再按字典序同样输入永远命中同一个包和规则安全模式先于危险模式——先全量检查白名单模式再检查危险模式允许列表只豁免命中规则本身不波及其他包有界失败语义——超时或解析失败绝不当作安全而是显式转交人工复核或拦截词边界关键词门控——digit不会误触发git规则terminal不会误触发rm规则hook 输出契约稳定——放行时 stdout 无 JSON拦截时 JSON 到 stdout、警告框到 stderr。文档末尾有一句硬约束任何违反上述不变式的改动必须走显式设计评审并同步更新语料。这条规则把行为变更从代码评审的暗角变成了需要文档留痕的正式流程。输出快照连终端长什么样都被锁住除了 JSON人类看到的终端输出也被纳入验证。tests/snapshots/ 目录下的.snap文件逐字符记录了扫描结果表格、拦截提示框的渲染效果如 output_snapshots__scan_results_ascii.snap确保列宽、字段、对齐方式不会被无意改动。新手如何运行这套验证全部验证都随标准测试流程自动执行无需任何配置# 同构性验证语料库全量回放 cargo test --test regression_corpus # 黄金测试JSON 输出稳定性 cargo test --test golden_json_tests # 跨包回放全量安全包 × 四种 shell 方言 cargo test --test cross_pack_corpus发现误报或绕过时流程同样简单往对应的语料 TOML 文件里加一条用例格式见 tests/corpus/README.md跑一次测试确认修复后取消注释——回归从此永久留在库中。小结给守护工具自己装一道守卫对新手来说dcg 这套体系最值得借鉴的就三句话把期望输出变成文件让 CI 而不是人眼去比对黄金测试把行为契约写成不变式任何漂移都要过评审同构性验证 docs/canonical-corpus-invariants.md动态内容打码、失败给 diff、更新要显式严格但不僵化。一个拦截rm -rf的工具自己却不怕格式被 rm 掉——这就是 dcg 黄金测试与同构性验证想给你的安全感。【免费下载链接】destructive_command_guardThe Destructive Command Guard (dcg) is for blocking dangerous git and shell commands from being executed by agents.项目地址: https://gitcode.com/GitHub_Trending/de/destructive_command_guard创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考