发版窗口检查清单（开发 + 运维）

与 release-ops-quickstart.md、strict-signoff-ops-runbook.md、release-phase-plan.md 配套。目标：先稳定发版，再叠功能。

P0 一键（自动化 + 打印人工项）：pnpm run release:p0-preflight（含月结：-- --with-month-close）。

---

A. 开发侧（合并前 / 打 tag 前）

在仓库根目录：

pnpm run check              # 与 GitHub Actions check job 一致
pnpm run check:staging      # 权限码、预置角色、STRICT 样例 env
pnpm run check:docs         # VitePress 无死链（勿链 docs/ 外路径）
pnpm run check:audit        # backend + frontend 依赖 high+ 审计

小程序主包 / pkg-me（动 pages.json 或 me-sub 时）：

pnpm run verify:miniapp-me-sub
pnpm --filter taskflow-miniapp run build:mp-weixin
pnpm run verify:miniapp-main-package

候选发版（本地，可选 DATABASE_URL 跑月结）：

pnpm run prerelease         # check + staging + check:month-close

仅验证 Docker 文档构建路径：

cp deploy/docker/env.staging.example deploy/docker/.env.pack
pnpm run check:env-pack

---

B. 预发部署后（运维）

1. 合并 STRICT 到预发 .env.pack 并重启 gateway / sys / acc
2. pnpm --filter taskflow-backend run db:sync-roles-perms（本版有新 btn_* 时）
3. 下载 CI artifact release-signoff-templates，填写 release-signoff-bundle.md
4. m4-settlement-manual-checklist.md + miniapp-m3-wip-acceptance.md 手工勾选

---

C. 发版后冒烟（5 分钟）

项	预期
经理登录 → 报表 → 站点 Tab	数字加载；点击「待结算」可进结算/记工列表
只读账号	无结算 FAB；写 API 403（E2E 已覆盖部分）
个人记账入口	openid 可进，不跳账号登录页
小程序「我的」→ 个人信息	路径为 /pages/me-sub/personal-info；主包 < 2048KB
业务助手（menu_sys_assistant）	Web /sys/assistant、小程序「智能问数」可进；pnpm run smoke:assistant（网关+sys 已起）通过

业务助手发版（四组件）

助手相关变更须 同窗口 发布：

1. taskflow backend（Sys 工具 + BFF + ASSISTANT_TOOL_CALLBACK_*）
2. ai-playground（personal_agent.py 远程工具与 prompt）
3. frontend（/sys/assistant）
4. miniapp（pages/assistant/home）

部署后：

pnpm --filter taskflow-backend run db:sync-roles-perms   # 新环境绑定 menu_sys_assistant
pnpm run check:ai-playground                           # 同级 ai-playground 时
pnpm run smoke:assistant                               # 预发网关冒烟

手工验收：对话结算 → 上传凭证标记发放 → 库存调整 → 多工人 WIP 报工（labor_lines_json）。

---

与路线图

完成 B 后可在 roadmap-four-tracks.md 勾掉 §4.2 / M3 / M4 签字项。