Files
deepseek-harness/docs/postmortem/README.zh.md
T
ZiyaZhang e38955b2fa docs(i18n): re-translate cds/postmortem batch with the prompt-v4 pipeline
22 篇(core-data-structures 18、postmortem 3、rfc/README)译文按
v4 基线重出;机械核对零异常;rfc/README.zh 页内锚点按门禁规则改回
英文侧锚名。
2026-07-22 03:06:01 -07:00

1.6 KiB

事后分析

English | 中文

事件复盘:一个 bug 到达了它不该到达的地方(真实用户、已合并的 PR(Pull Request)、已发布的版本),值得关注的是为什么我们的流程放过了它,而不仅仅是那一行修复。

事后分析不是 RFC(RFC 记录一个经过深思熟虑的设计决策及其被否决的替代方案,或提出未来工作)。它是一份回顾性的失败记录:什么坏了、机制是什么、为什么每道安全网都没拦住、以及加了哪些具体的防护措施使同类 bug 下次能被显式暴露。

当一个 bug 满足以下条件时,请撰写事后分析:隐蔽(机制不显而易见,即使是细心的工程师也得费力重新推导)、系统性(逃逸的原因是测试/工具/约定的缺口,而非一次性的笔误)、重新发现的代价高(它消耗了真实的调试时间,且下次还会如此)。请链接该事后分析所推动建立的防护措施(测试、AGENTS.md 规则、ADR)。

每篇事后分析以一段摘要开头:一个简短段落,让忙碌的读者在三十秒内吸收要点——什么坏了、用直白的话说根因是什么、为什么逃逸了、持久的教训是什么——然后才是后续的详细「概述 / 时间线 / 根因 / 防护措施」各节。

# 标题
0001 ACP 服务器在连接时崩溃:export default 丢失了插件的 inject
0002 文件系统快照工具被一个字面量 !!js 对象永久禁用