docs(readme): consolidate truth-index and docs navigation

docs/REAL_HOST_ACCEPTANCE_RUNBOOK.md

@@ -1,6 +1,15 @@
 # Real Host Acceptance Runbook
 
-日期：2026-05-16
+日期：2026-05-21
+
+## 先读哪几份文档
+
+1. `docs/EXECUTION_BOARD.md`
+   - 当前 gate、最新阻断、最新 live 真相以它为准。
+2. `docs/PRODUCTION_CLOSURE_BOARD.md`
+   - 看是否已经达到可上线口径，以及哪些只是历史 PASS。
+3. `docs/REAL_HOST_ACCEPTANCE_LEARNINGS.md`
+   - 看已经调通的细节、典型误判点、推荐诊断顺序。
 
 ## 目标
 
@@ -153,6 +162,23 @@ artifacts/real-host-acceptance/<timestamp>/
 5. `reconcile` 不返回关键失败
 6. `rollback smoke` 成功（若本次需要验证回滚链路）
 
+## 推荐额外落盘的三层证据
+
+为了避免把不同语义混为一谈，真实宿主验收建议每次都额外记录下面三层证据：
+
+1. account 单体视角
+   - `GET /api/v1/admin/accounts/:id`
+   - `GET /api/v1/admin/accounts/:id/models`
+2. group/普通用户聚合视角
+   - 用真实可用的普通用户 key 或 subscription managed key 请求 `GET /v1/models`
+3. completion smoke
+   - 用同一条普通用户访问链路请求 `POST /v1/chat/completions`
+
+注意：
+- `GET /api/v1/admin/accounts/:id/models` 正确，不等于普通用户 `/v1/models` 一定正确
+- `/v1/models` 正确，也不等于 `/v1/chat/completions` 一定正确
+- 这三层必须分开记证据、分开下结论
+
 ## 当前门禁解释
 
 - 若以上脚本在真实宿主环境全部通过：
@@ -181,3 +207,22 @@ SKIP_ROLLBACK=1 scripts/real_host_acceptance.sh
 10. `scripts/import_remote43_provider.sh` 现已内置 remote43 的 subscription 验收补全动作：会根据 import batch 自动解析目标 group，执行“普通用户最低余额补齐 + key/group 绑定 + user_subscriptions upsert + 定向 Redis 缓存失效（auth / balance / subscription）”，并把 SQL / host state 证据写入 artifact 目录。
 11. 当 CRM 进程与 operator 到 host 的访问地址不一致时，优先显式设置 `CRM_HOST_BASE`，避免把 CRM 侧探测地址和本地运维隧道地址混用。
 12. 对 `Upstream service temporarily unavailable` 一类 502，不要先认定是上游聊天链路故障；先看脚本落盘的 `09-models.headers.txt` / `10-models.body.json`。若 `/v1/models` 已返回了别的 provider 模型集（例如 GPT 系列而不是预期的 DeepSeek/Minimax 模型），先检查普通用户 key/group 绑定，也要检查 CRM 导入时是否把 provider 的 `channel_template.model_mapping`、`restrict_models`、`billing_model_source` 一并下发到宿主 channel。
+13. subscription 场景里，closure 最终用于 gateway probe 的 key 是宿主侧 managed key，不一定是请求体里外部传入的 `ACCESS_API_KEY`。如果你拿原始 key 直打 `/v1/models` 收到 `403 not assigned to any group`，先不要判定 CRM 主链路失败。
+14. 对“既有 channel 没自动补 `model_pricing`”这类 live 现象，先核对在线 CRM 进程的启动时间与 git 提交时间；之前 MiniMax 的该现象最终被确认是 stale CRM 进程导致，而不是源码缺逻辑。
+15. 当 CRM 切换到本机运行时，`PACK_PATH` 也必须切换到控制面本机可读路径；继续沿用远端 `/home/ubuntu/...` 会触发 `stat pack path ... no such file or directory`，这是验收 harness 参数问题，不是导入业务逻辑问题。
+
+## 建议固定执行的快速诊断顺序
+
+1. 先看环境
+   - CRM 是否是最新提交对应的在线进程
+   - `PACK_PATH` 是否是 CRM 本机可读路径
+   - `CRM_HOST_BASE` 是否与 CRM 到 host 的实际访问地址一致
+2. 再看宿主落库
+   - account `credentials.model_mapping`
+   - `GET /api/v1/admin/accounts/:id/models`
+   - channel `model_mapping/model_pricing/restrict_models/billing_model_source`
+3. 最后看普通用户流量
+   - `/v1/models`
+   - `/v1/chat/completions`
+
+若需要背景解释、误判案例和已调通经验，直接看：`docs/REAL_HOST_ACCEPTANCE_LEARNINGS.md`