Failure Capsule — 可复现的故障证据包

一句话定位

把一次失败的代码或科研运行，变成可检查、可重放、可分享的证据包。

它能做什么

• 捕获命令、退出状态、Git 修订、运行环境和依赖文件哈希
• 默认只记录输入与非日志输出的哈希，不复制原始数据
• 对日志中的常见凭证、邮箱和本地路径做脱敏
• 与已知正常运行进行“观察到的差异”对比，不把差异冒充根因
• 重放原命令并区分 REPRODUCED、NOT_REPRODUCED、FIXED_NOT_REGRESSED 和 INCOMPLETE
• 根据可观察信号给出启发式失败类别和下一步最便宜的区分性测试

适合谁

• 正在调试 Python 项目或科研脚本的开发者
• 需要向导师、同事或开源社区提交可复核失败证据的人
• 想把一次偶发故障沉淀为可复现研究记录的实验者

快速开始

在工作区中运行：

python scripts/capsule.py capture --repo . --command "python -m pytest" --output .capsules/failed-run
python scripts/capsule.py replay .capsules/failed-run/capsule.json --repo .

先检查 CAPSULE.md 和 privacy-manifest.json，再决定是否分享。

重要边界

这是一个本地证据工具，不是沙箱，也不保证匿名。它不会自动安装依赖、修复代码、上传数据或凭空判断根因。命令本身会被保留以支持重放，因此分享前必须检查命令、日志、路径和元数据。