# 发布检查清单

这份清单用于预发布版本和稳定版本。Git 标签必须与 `package.json` 版本完全一致。发布或认证出现异常时，先执行 [npm 发布与认证运行手册](NPM_RELEASE_AUTH_RUNBOOK.md)；不得用重复登录、索要验证码或发布空版本绕过停止条件。

## 自动门禁

- [ ] Ubuntu 和 macOS 均通过 `npm ci`。
- [ ] Ubuntu 和 macOS 均通过类型检查和全部单元测试。
- [ ] Ubuntu 和 macOS 均完成生产构建。
- [ ] 真实 npm tarball 能在干净目录安装，两个 CLI 名称都可执行。
- [ ] tarball 演练包含一次安装中断和断点恢复。
- [ ] tarball 能初始化运行手册且绝不覆盖已有目录，并完成一次不带 `--yes` 的只读升级预览。
- [ ] `version --json` 与兼容矩阵中的 Codex、lark-cli、配置、状态和 SQLite 版本一致。
- [ ] `npm run release:check -- v<version>` 通过。
- [ ] npm 发布通过 GitHub OIDC Trusted Publisher 生成 provenance，仓库和 Environment 中不存在长期 `NPM_TOKEN`，预发布版本进入 `next` dist-tag。
- [ ] 通道符合版本契约：预发布只要求 `next` 指向目标版本，稳定版才要求 `latest` 指向目标版本。
- [ ] 发布验证只读取 GitHub Actions 和公开 Registry；没有用本机 `npm whoami` 判断 OIDC 发布成败，也没有把网页登录误当作 CLI 授权。

这些门禁由 CI 和 Release workflow 执行；任一平台失败都不会进入 npm publish。

## macOS 实机

- [ ] 使用非开发者的测试账号完成一次全新 `init`。
- [ ] LaunchAgent 重装后只有一个消息消费者和一个卡片消费者。
- [ ] `bridge-health.json` 报告正确 PID、实例和配置路径。
- [ ] 私聊测试卡、新手引导、项目切换和安全首次任务可用。
- [ ] 服务重启后会话、队列和 SQLite 状态可恢复。
- [ ] 已启动任务在重启后中断而非重放，任务记录与卡片冲突可以保守对账。
- [ ] 结构迁移前生成备份；模拟迁移失败后自动恢复旧数据库。
- [ ] `doctor --fix` 和脱敏诊断包在自定义 `BRIDGE_DATA_DIR` 下可用。
- [ ] Remote Ready 可以开启和关闭，卸载服务后不残留 `caffeinate`。
- [ ] 从旧仓库 `.env` 迁移一次，旧数据可读且旧文件未删除。
- [ ] 从上一 npm 版本执行升级：活动任务被拒绝、排队任务保留、备份 ID 可见、新服务版本和双消费者验证通过。
- [ ] 模拟新服务健康失败，数据和仍可用的旧包被自动恢复并验证。

## Linux 实机

- [ ] 使用带 systemd user service 的干净账号完成一次全新 `init`。
- [ ] unit 使用指定 `DOTENV_CONFIG_PATH`，重启和登录后自动恢复。
- [ ] `journalctl --user` 没有凭据、消息正文或未脱敏标识泄漏。
- [ ] 私聊测试卡、新手引导、项目切换和安全首次任务可用。
- [ ] 停止、重新安装和卸载不会删除用户配置与运行数据。
- [ ] `backup`、`backups`、`stop` 和 `rollback` 流程在 systemd user service 上通过。
- [ ] 从上一 npm 版本执行一次升级和一次显式允许的降级演练。

## 飞书端到端

- [ ] Bot、消息事件、卡片事件和 CardKit 探测全部通过。
- [ ] 安装器和 `doctor` 对项目群 scope 的 ready/missing/unknown 显示与真实后台一致；scope 不可读时不得伪装为已验证。
- [ ] 私聊自动发送测试卡；群聊未确认时不会自动发送。
- [ ] 管理员在已有群完成一次永久绑定；绑定前非管理员只收到提示，且没有 allowlist、binding 或 task 副作用。
- [ ] 私聊一键创建项目群完整通过：单群、成员邀请、工作台发送、原消息置顶、私聊群入口。
- [ ] 分别注入成员、工作台和置顶失败；重试只补失败步骤，不重复建群或工作台。
- [ ] 连点两次创建和重放相同 callback 均保持幂等。
- [ ] 工作台发送成功后、置顶前终止服务；重启只置顶已保存消息。
- [ ] 管理员、操作者、只读成员和项目 ACL 使用三个测试账号验证。
- [ ] 两名操作者在群聊完成任务转交、发起人收回和管理员接管；私聊不展示交接控件。
- [ ] 团队工作台不展示提示词、结果、路径、附件或原始 open_id。
- [ ] 运行手册固定任务、默认参数一键任务、显式参数命令和无效配置失败关闭均通过。
- [ ] 运行手册不能提升 sandbox，含提交、推送、部署或 PR 的模板和参数均被拒绝。
- [ ] 普通操作者无法超过 `CODEX_OPERATOR_SANDBOX_MODE`。
- [ ] 完全访问模式下，未加入白名单的群聊仍被拒绝。
- [ ] 提交、推送、发布、部署和 PR/MR 操作仍要求短期确认。
- [ ] 普通回复四种状态、CardKit 失败文本兜底和终态任务卡失败通知均通过。
- [ ] [全项目 SOP 总览](SOP_INDEX.md)、[正向 SOP](USER_SOP.md)、[逆向 SOP](FAILURE_RECOVERY_SOP.md) 与[验收矩阵](ACCEPTANCE_TEST_MATRIX.md)逐项签字；安装、任务、权限、结果、项目群、团队、恢复、升级和卸载任一成功状态不一致，或出现重复对象/重复执行，均阻断发布。

## 发布内容

- [ ] `CHANGELOG.md` 包含用户可见变化、迁移影响和已知限制。
- [ ] README、安装、排错和安全文档与当前 CLI 参数一致。
- [ ] tarball 不包含 `.env`、SQLite、日志、附件、真实 ID 或个人路径。
- [ ] GitHub Release notes 清楚标记 prerelease/stable，并给出升级与回滚方法。
- [ ] 中英文入口、配置参考、兼容矩阵、演示、Roadmap 和 Good First Issue 入口与当前版本一致。
- [ ] 发布后从 npm 注册表重新安装一次，并核对 CLI 版本和 dist-tag。
- [ ] 如果 CLI 授权进入邮件缺失、`Invalid OTP` 或同路径二次失败，已终止登录并按运行手册记录外部阻塞；任何验证码、恢复码和 Token 均未进入聊天或日志。