| name | deploy-after-ci |
| description | BoardGame 生产更新最短路径。用于更新部署、发生产、更新线上；默认 CI 构建后直传镜像到服务器并 update-local + Android stable OTA，提 CI 时先查 Actions/Docker。 |
BoardGame CI 后部署
目标
把生产更新固定成两条命令路径，避免每次重新展开部署文档、手工拼 GitHub CLI、SSH 和 OTA 发布命令。
路径选择
- 用户只说“更新部署 / 部署生产 / 更新线上”：直接执行“CI 构建后直传镜像到服务器并
update-local + Android stable OTA”，不再让本机先拉 GHCR。
- 用户明确说“看 CI / CI 好了 / 查 CI / 等 CI”：先查远端
origin/main 对应的 Docker 镜像 CI；只有成功才执行服务器更新与 OTA。
- 用户明确说“只更新服务器 / 不发 OTA”：显式加
-SkipOta。
- 用户指定 tag：默认只建议用于服务器镜像更新；若同时要发 OTA，必须确认本地当前发布基线就是这次要发的版本。
直接部署
使用本 skill 的包装脚本：
powershell -NoProfile -ExecutionPolicy Bypass -File .codex\skill\deploy-after-ci\scripts\deploy-prod.ps1
只更新服务器，不发 OTA：
powershell -NoProfile -ExecutionPolicy Bypass -File .codex\skill\deploy-after-ci\scripts\deploy-prod.ps1 -SkipOta
指定 tag 且只更新服务器：
powershell -NoProfile -ExecutionPolicy Bypass -File .codex\skill\deploy-after-ci\scripts\deploy-prod.ps1 -Tag v1.2.3 -SkipOta
脚本默认会触发 Docker workflow，CI 构建完成后直接把镜像 tar 输送到服务器并执行 update-local，再在本地发布 Android stable OTA：
node scripts/release/deploy-and-ota.mjs --skip-wait --ota-channel stable
其中服务器步骤默认等价于手动触发：
gh workflow run docker-publish.yml --ref main -f stream_to_server=true -f deploy_after_stream=true -f deploy_tag=latest -f deploy_host=admin@8.148.71.102 -f remote_dir=/home/admin/BoardGame
只有用户明确要求“本机输送 / 不触发 CI 直传”时，才传 -DeployMode stream，让底层改用 stream-images-to-server.mjs 本机 fallback。只有用户明确要求“服务器直接拉镜像 / 不走镜像输送”时，才传 -DeployMode remote，让底层改用 deploy-image.sh update 旧链路。
查 CI 后部署
使用一条包装命令：
powershell -NoProfile -ExecutionPolicy Bypass -File .codex\skill\deploy-after-ci\scripts\deploy-after-ci.ps1 -CheckCi
指定 tag：
powershell -NoProfile -ExecutionPolicy Bypass -File .codex\skill\deploy-after-ci\scripts\deploy-after-ci.ps1 -CheckCi -Tag v1.2.3 -SkipOta
验证流程但不执行生产更新：
powershell -NoProfile -ExecutionPolicy Bypass -File .codex\skill\deploy-after-ci\scripts\deploy-after-ci.ps1 -CheckCi -DryRun
CI 检查口径：
- 远端分支：
origin/main
- GitHub 仓库：
zhuanggenhua/BoardGame
- 必须成功的 workflow：
Build & Push Docker Images
- 必须匹配远端
main 当前 SHA
若 Docker 镜像 CI 仍在运行、缺失或失败，停止，不执行部署。
只查 CI
powershell -NoProfile -ExecutionPolicy Bypass -File .codex\skill\deploy-after-ci\scripts\check-remote-ci.ps1
强制边界
- 不要因为本地工作区有未提交改动而阻塞
push 后的生产更新；生产更新只基于远端镜像。
- 不要在生产机直接运行
docker compose up -d。
- 不要默认让生产机或本机从 GHCR 拉镜像；默认必须走 CI 构建后直传到服务器并
update-local。
- “更新部署”默认包含 Android OTA；如果用户只要服务器更新，必须显式
-SkipOta 或口头说明“只更新服务器”。
- 指定 tag 时，不要在未确认本地发布基线与该 tag 对齐的情况下顺手发 OTA。
- 不要默认执行本地测试、lint、构建或额外审计。
- 部署失败时只报告：执行了哪个脚本、远端脚本失败位置、下一步最小补救。
