站点扩展复盘模板：四维检查清单

扩展类商品的问题往往不在开发阶段暴露，而在交付后逐步显现：某个环境里样式错位、某次更新后钩子失效、某类访问路径下资源加载异常。复盘模板的价值是把这些零散经验固化成可重复执行的检查动作，让下一次交付不再依赖记忆。

功能维度：先列能力边界
复盘从“它到底承诺了什么”开始。把扩展声明的能力逐条写成可验证的句子，例如“能在指定页面注入一段结构化内容”“能在不修改核心文件的前提下改变某类输出”。每条能力后面跟三种状态：验证通过、部分通过、未覆盖。部分通过必须写清边界条件，未覆盖必须写明原因与后续动作。这一节的作用是防止能力被口头放大，也防止后续维护者误判职责范围。

兼容与性能维度：把环境写成矩阵
兼容问题几乎都来自环境差异。模板要求列出运行环境的几个关键变量：宿主版本区间、依赖项版本区间、是否与其他同类扩展共存、权限配置差异。每个变量组合不必全测，但要标注“已验证”“高风险”“未验证”三档，高风险组合必须附一条最小复现路径。性能部分记录三个观察点：首次加载耗时量级、常驻内存变化趋势、是否存在随数据量增长而恶化的操作。只写量级和趋势，不写具体数值，避免结论随时间失效。

交付与回滚维度：留好退路
复盘的最后一段回答“出问题怎么办”。模板要求写明停用步骤、数据残留位置、清理顺序、以及停用后宿主是否恢复正常的最小验证方法。同时记录本次交付中变更了哪些对外接口、哪些配置项新增或废弃。回滚清单要能被一个不熟悉该项目的人独立执行，因此每条动作都要写清楚前置条件和预期结果。

使用步骤与注意事项
使用时分三步：交付前按模板填空形成基线记录；交付后一周内补充实际观察；下一次迭代前对照上一版基线做差异比对。注意三点：模板里的检查项只增不删，废弃项标注而非删除，保留历史判断依据；每条“通过”都要附一句证据描述，避免无依据打勾；复盘结论只写可复用的方法，不写具体环境细节，方便跨项目迁移。坚持几轮之后，扩展类商品的交付质量会从“靠人盯”转为“靠清单兜底”。