什么时候填写
当一批功能完成、准备推送、已经部署、或者因为 token、DNS、备案、控制台权限而暂时无法部署时，都要留下这份记录。
它解决的是最后一公里：另一个 AI 不需要猜“到底有没有上线”，也不会把本地验证误当成线上验证。
Release Record
发布记录模板
功能做完不是终点。每次提交、部署和线上复查都要留下证据：改了什么、验证了什么、有没有部署、线上是否可用、失败怎么回滚、下一位 AI 应该接着看哪里。
发布记录预览
复制后把空白项填成提交号、命令、页面、部署地址、线上检查和残留风险。
# 发布记录 ## 1. 发布身份 - 项目/站点： - 发布类型：主站页面 / 在线工具 / 交付流程 / LiteMall / 后端服务 / 服务器部署 - 关联需求包或任务单： - 提交号： - 执行者： ## 2. 发布范围 - 本次包含： - 本次不包含： - 受影响路由： - 受影响文件或模块： - 不能触碰的边界： ## 3. 本地验证 - 运行命令和结果： - 页面/接口本地检查： - 移动端或浏览器检查： - sitemap/feed/SEO 检查： - 未覆盖项： ## 4. 部署记录 - 部署环境：Vercel / 自有服务器 / 客户环境 / 未部署 - 部署命令或控制台动作： - Deployment URL 或服务地址： - 环境变量名称或配置项： - 部署失败或跳过原因： ## 5. 线上复查 - 生产域名检查： - 关键页面或接口： - 搜索收录相关：sitemap / robots / feed / canonical - 安全边界：密钥、后台入口、账号、支付、生产数据 - 线上问题和处理： ## 6. 回滚和恢复 - 回滚入口：Vercel 回滚 / revert 提交 / 服务器旧版本 / 数据库恢复 - 回滚前需要备份： - 回滚后需要复查： - 不能自动回滚的事项： ## 7. 交接结论 - 已完成： - 残留风险： - 下一步触发条件： - 需要用户手动做的事： - 下一位 AI 接手时先读： ## 8. 质量检查 - 发布记录能对应到具体提交号、路由、命令和验证结果。 - 本地验证、部署动作和线上复查分开写，不把“build 通过”等同于“线上已验证”。 - 未部署、DNS 关闭、token 缺失或外部平台未操作时，必须写清阻塞原因。 - 涉及 LiteMall、后台、支付、生产数据和账号时，必须写明安全边界。 - 结束时要给下一位 AI 一个明确的继续条件，而不是只写“待优化”。 ## 9. 停止规则 - 没有通过本地构建或关键测试时，不能写成“发布完成”。 - 没有实际部署时，不能说线上已更新，只能记录待推送或待部署。 - 公网页面不得出现密钥、Token、后台账号、支付配置、真实订单和客户数据。 - 数据库、服务器、DNS、HTTPS 或小程序合法域名变更没有回滚路径时，不能继续生产操作。 - 用户需要在控制台完成的动作必须单独列出，不能伪装成 AI 已完成。
发布闭环
每次结束都按这个顺序留下证据，避免下一位 AI 不知道该相信本地、Vercel 还是生产域名。
第 1 步
确认发布范围
先说明这次发布包含什么、不包含什么、对应哪个需求包或实施任务单。
关联的需求包、任务单、Runbook 或用户指令。
本次提交号、分支、受影响路由和主要文件。
明确没有混入报价页、密钥、生产数据、后台入口或随机工具。
第 2 步
记录本地验证
把运行过的命令、页面字符串检查、移动端检查和未覆盖风险写下来。
`npm run lint`、`npm run test:unit`、`npm run build` 的结果。
新增或改动页面的本地访问结果。
移动端宽度、长文案、按钮、表格和二维码的检查结果。
第 3 步
记录部署动作
发布到 Vercel、自有服务器或客户环境时，记录部署入口、时间、命令和失败处理。
部署命令、部署平台、deployment URL 或服务器发布目录。
环境变量名称、域名状态、DNS/备案/HTTPS 是否满足。
如果没有部署，说明阻塞原因和需要用户执行的命令。
第 4 步
记录线上复查
线上可访问后，用真实域名检查关键页面、接口、sitemap、feed 和安全边界。
生产域名状态码和关键文案命中结果。
公开路由是否进入 sitemap。
确认没有暴露密钥、后台账号、支付配置、生产数据和不稳定入口。
第 5 步
留下交接结论
最后写清已完成、未覆盖、残留风险、回滚方式和下一步触发条件。
HANDOFF.md 和执行计划更新结果。
回滚路径、Vercel 回滚方式或服务器旧版本位置。
下一位 AI 应该继续做什么，以及什么时候不能继续。
模板字段
这些字段不是写给用户看的总结，而是给后续 AI 复核和继续执行的证据。
1. 发布身份
项目/站点：
发布类型：主站页面 / 在线工具 / 交付流程 / LiteMall / 后端服务 / 服务器部署
关联需求包或任务单：
提交号：
执行者：
2. 发布范围
本次包含：
本次不包含：
受影响路由：
受影响文件或模块：
不能触碰的边界：
3. 本地验证
运行命令和结果：
页面/接口本地检查：
移动端或浏览器检查：
sitemap/feed/SEO 检查：
未覆盖项：
4. 部署记录
部署环境：Vercel / 自有服务器 / 客户环境 / 未部署
部署命令或控制台动作：
Deployment URL 或服务地址：
环境变量名称或配置项：
部署失败或跳过原因：
5. 线上复查
生产域名检查：
关键页面或接口：
搜索收录相关：sitemap / robots / feed / canonical
安全边界：密钥、后台入口、账号、支付、生产数据
线上问题和处理：
6. 回滚和恢复
回滚入口：Vercel 回滚 / revert 提交 / 服务器旧版本 / 数据库恢复
回滚前需要备份：
回滚后需要复查：
不能自动回滚的事项：
7. 交接结论
已完成：
残留风险：
下一步触发条件：
需要用户手动做的事：
下一位 AI 接手时先读：
质量检查
发布记录能对应到具体提交号、路由、命令和验证结果。
本地验证、部署动作和线上复查分开写，不把“build 通过”等同于“线上已验证”。
未部署、DNS 关闭、token 缺失或外部平台未操作时，必须写清阻塞原因。
涉及 LiteMall、后台、支付、生产数据和账号时，必须写明安全边界。
结束时要给下一位 AI 一个明确的继续条件，而不是只写“待优化”。
