regress-guard

regress-guard 是面向 ZCode 的 AI 编码治理插件，核心理念是'不信任 agent 的完成声明'。它在提交这一关键节点重新运行项目自身的测试套件，将'完成'变为机器可验证的声明。 主要能力包括： 1. 完成度复核：PreToolUse 钩子拦截提交命令，自行运行项目测试（pytest/jest/maven/gradle/go 自动检测），EARS 风格验收行须凭证据勾选后方可标记完成。同树重试命中内容键缓存实现 0 秒放行。 2. 边界守卫：对未在当前变更清单中声明的文件编辑/写入操作进行事前拦截，计划文件列表即为边界。 3. 假设台账：当现实证伪计划假设时，强制记录 was→reality→evidence 链条。 4. 六层信任面：项目级通知通道需人工授权信任表 + 内容钉扎；HOME/env 注入重定向在启动器白名单处中和；克隆仓库注入面已关闭。 5. FP 校准遥测：每次拦截由人工事后裁定（有用/误报/忽略），agent 对自身准确率无投票权。公开基准含 82 个用例 / 13 个家族。 6. 自愈：会话启动时比对已安装副本与源仓库，版本漂移会公告而非静默容忍。 安装方式包括 ZCode 插件市场、个人源（github:1339190177/regress-guard）及开发轨道（clone 后 bash install.sh）。运行时零第三方 Python 依赖，仅需 Python 3.10+。 提供 16 个命令（/regress:init、/regress:plan、/regress:verify、/regress:bypass 等），覆盖初始化、计划生成、测试验证、特征测试生成、断点续作、健康报表等场景。项目状态与考古数据存放在 .regress/ 目录。默认零网络出站，可选企业微信自建应用通知（需人工授权且 API 基址钉扎官方域名）。MIT 许可证。