mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
2.0 KiB
2.0 KiB
事故复盘（postmortem）
English | 中文
事故复盘记录的是：一个 bug 流入了不该流入的环节（真实用户、已合并的 PR（Pull Request）、已发布的版本），值得关注的是为什么我们的流程放过了它，而不仅仅是那一行修复。
事故复盘不是 Agent Note（agent 决策记录）（Agent Note 记录一个经过深思熟虑的设计决策及其被否决的替代方案，或提出未来工作）。它是一份回顾性的失败记录：什么坏了、机制是什么、为什么每道安全网都没拦住、以及为此新增了哪些具体防护措施，以确保同类 bug 下次出现时会明确报错。
当一个 bug 满足以下条件时，请撰写事故复盘：隐蔽（机制不显而易见，即使是细心的工程师也得费力重新推导）、系统性（逃逸的原因是测试/工具/约定的缺口，而非一次性的笔误）、重新发现的代价高（它消耗了真实的调试时间，且下次还会如此）。请链接该事故复盘所推动建立的防护措施（测试、AGENTS.md 规则、ADR）。
每篇事故复盘以一段摘要开头：一个简短段落，让忙碌的读者在三十秒内吸收要点——什么坏了、用直白的话说根因是什么、为什么逃逸了、可长期沿用的教训是什么——然后才是后续的详细「概述 / 时间线 / 根因 / 防护措施」各节。
| # | 标题 |
|---|---|
| 0001 | ACP（Agent Client Protocol）服务器在连接时崩溃：export default 丢失了插件的 inject |
| 0002 | 文件系统快照工具被一个字面量 !!js 对象永久禁用 |
| 0003 | Web agent 验证了替代服务器，而非承载其会话的 GUI |
| 0004 | Landlock 部分强制执行通知导致子进程失败被误归类 |