From 2ff38c71bb5acac0c9247a1729958252053b0424 Mon Sep 17 00:00:00 2001
From: yunyaozhou <admin@shujk.top>
Date: Thu, 9 Jul 2026 06:20:03 +0800
Subject: [PATCH] docs: add rollout testing guidance

---
 README.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/README.md b/README.md
index 6cf0c74..db7d244 100644
--- a/README.md
+++ b/README.md
@@ -182,6 +182,43 @@ node ./scripts/run-profile.mjs default
 node ./scripts/run-profile.mjs --prefer-state-profile
 ```
 
+## 测试与发布
+
+这个服务会改写目标用户的 Codex `base_url`，属于当前操作链路上的高风险本地网关。后续变更默认按“先对侧宿主、再当前宿主”发布。
+
+推荐顺序：
+
+1. 先部署 `a100` 上的 `codex-retry-gateway`。
+2. 在对侧机器的目标用户环境里发起真实 Codex 冒烟请求，不要先改当前正在依赖本机 `4610` 的会话。
+3. 确认健康检查、响应完整性与关键重试行为正常。
+4. 通过后再部署本机，例如 `pc`。
+
+推荐部署命令：
+
+```bash
+uv run ansible-playbook playbooks/deploy_managed_systemd_apps.yml -i inventory/hosts.yml --limit a100 -e managed_systemd_apps_selected_names=codex-retry-gateway
+```
+
+验证通过后，再切到本机：
+
+```bash
+uv run ansible-playbook playbooks/deploy_managed_systemd_apps.yml -i inventory/hosts.yml --limit pc -e managed_systemd_apps_selected_names=codex-retry-gateway
+```
+
+推荐冒烟命令：
+
+```bash
+codex --dangerously-bypass-approvals-and-sandbox -c model="gpt-5.4" hello
+```
+
+建议同时检查：
+
+- `curl http://<listen-host>:4610/__codex_retry_gateway/health`
+- `/responses` 成功流能完整结束，不会卡 pending，必要时应能看到 `response.completed`
+- 容量错误 `Selected model is at capacity. Please try a different model.` 仍能按网关策略自动重试
+
+如果当前对话依赖本机 `4610`，不要把本机作为首个发布目标；先在另一台已接管相同 profile 的机器验证，再回到本机切换。
+
 ## 如何恢复
 
 Windows: