排查分支状态时发现文档与脚本长期不一致:main 上文档早已写「部署脚本不写死分支」,
而 main 的脚本仍是 `git pull --ff-only origin main`(该改动只在 test 上)。
本次已 cherry-pick 脚本改动到 main,文档主体因此自然对齐,只补两处:

1. ⚠️ 回滚命令必须带 --no-pull —— 原文档写的
   `git checkout <commit> && bash deploy/deploy-prod.sh`
   在旧脚本下会紧接着 pull 回分支最新,**把刚回滚的 commit 又拉走且静默无提示**;
   新脚本在 detached HEAD 下 fetch 会失败退出,不再假成功,但正确用法仍是 --no-pull。
   并提醒回滚后切回 main,否则下次部署仍在 detached HEAD。

2. 补 DEPLOY_BRANCH 用法 —— 脚本一直支持,文档从没提过。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>