From f3373d6f9a2b92e29ff826284061bc1c401dd419 Mon Sep 17 00:00:00 2001
From: aiyimickey <39365912+aiyimickey@users.noreply.github.com>
Date: Fri, 15 May 2026 15:21:33 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E8=BF=9E=E9=80=9A?=
 =?UTF-8?q?=E6=80=A7=E6=A3=80=E6=9F=A5=E6=96=87=E6=A1=A3=20=E2=80=94=20?=
 =?UTF-8?q?=E9=87=8D=E8=AF=95=E6=9C=BA=E5=88=B6=20+=20=E5=8F=8C=E5=90=91?=
 =?UTF-8?q?=E6=A3=80=E6=9F=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 deploy-ai-readme.md | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/deploy-ai-readme.md b/deploy-ai-readme.md
index f77ea3f..8054adf 100644
--- a/deploy-ai-readme.md
+++ b/deploy-ai-readme.md
@@ -64,23 +64,28 @@ bash scripts/deploy-ai.sh [选项]
 
 ## 部署后验证
 
-### 公共 URL 检查
+### 部署后 API 连通性检查
 
-部署完成后检查站点 HTTP 状态码，200/301/307 视为成功。
+部署 issue-ai 和 assets-ai 后自动执行双向连通性检查，均带 **重试机制**（3 次、间隔 10s），应对同时部署两个站点时目标容器暂不可达的情况。
 
-### issue→assets API 连通性检查
-
-部署 issue-ai 后自动执行：
+| 部署站点 | 检查方向 | 使用 Key | 目标 URL |
+|---------|---------|---------|----------|
+| issue-ai | issue → assets | `ASSETS_API_KEY` | `ASSETS_API_URL/assets?pageSize=1` |
+| assets-ai | assets → issue | `ISSUE_API_KEY` | `ISSUE_API_URL/tickets?pageSize=1` |
 
+流程：
 1. 将连通性检查脚本发送到 txjp 宿主机
-2. `docker cp` 到 issue-ai 容器内
-3. 使用容器内的 `ASSETS_API_KEY` 调 `ASSETS_API_URL/assets?pageSize=1`
-4. 返回 200 → 通过；返回 401 → **部署失败退出**，提示检查 API Key 配置
+2. `docker cp` 到对应容器内
+3. 容器内 Node.js 发起 HTTP 请求，失败自动重试（最多 3 次，间隔 10s）
+4. 返回 200 → 通过；全部重试仍失败 → **部署失败退出**
 
 **错误输出示例**：
 ```
 [✗] issue→assets API 连通性检查失败！请检查 ASSETS_API_KEY 是否在 assets-ai 中注册
-  连通失败: HTTP 401 (请检查 ASSETS_API_KEY 是否在 assets-ai 的 API Keys 中注册)
+  连接失败: HTTP 401 (第1次)
+  10s 后重试...
+  连通失败: HTTP 401 (第2次)
+  已达最大重试次数
 ```
 
 ## 排除文件