sub2api-cn-relay-manager/docs/README.md

# docs 导航首页

日期：2026-05-21
项目：`sub2api-cn-relay-manager`

## 先读这里

如果你是第一次进入 `docs/` 目录，先按这个顺序读：

1. [SOURCE_OF_TRUTH.md](./SOURCE_OF_TRUTH.md)
   - 当前文档真相入口
   - 先看这份，避免把历史审查、历史任务板、历史 artifact 误读为当前结论

2. [EXECUTION_BOARD.md](./EXECUTION_BOARD.md)
   - 当前执行状态
   - 最新 gate
   - 剩余阻断
   - 最短 closure path

3. [PRODUCTION_CLOSURE_BOARD.md](./PRODUCTION_CLOSURE_BOARD.md)
   - 当前是否可按 PRD 首版范围放行
   - 哪些是代码门禁，哪些是外部/环境门禁

## 真实宿主验收入口

4. [REAL_HOST_ACCEPTANCE_CHECKLIST.md](./REAL_HOST_ACCEPTANCE_CHECKLIST.md)
   - 每次验收先过这一页
   - 最短闭环 / 红线 / 三层证据 / 诊断顺序

5. [REAL_HOST_ACCEPTANCE_RUNBOOK.md](./REAL_HOST_ACCEPTANCE_RUNBOOK.md)
   - 标准验收步骤
   - artifact 结构
   - 证据分层要求

6. [REAL_HOST_ACCEPTANCE_LEARNINGS.md](./REAL_HOST_ACCEPTANCE_LEARNINGS.md)
   - 已调通细节
   - 高频误判点
   - 推荐诊断顺序

7. [OPENCLAW_EXTERNAL_VALIDATION.md](./OPENCLAW_EXTERNAL_VALIDATION.md)
   - OpenClaw 最后一跳真实使用验证
   - 升级后补丁自检与 cron 提醒
   - `tksea` / `53hk` 多模型运行态口径

8. [PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md)
   - 当前仓库目录职责说明
   - 新增文件该放在哪一层

9. [../scripts/README.md](../scripts/README.md)
   - `scripts/deploy`、`scripts/acceptance`、`scripts/test` 的入口说明
   - 继续整理脚本或追脚本回归时先看这里

10. [2026-05-31-FRONTEND_REVIEW_CHECKLIST.md](./2026-05-31-FRONTEND_REVIEW_CHECKLIST.md)
   - 前端专项 review 入口
   - 回答“前端资产在哪里、怎么审、最小命令集是什么”

11. [2026-05-31-FRONTEND_CLOSURE_AUDIT.md](./2026-05-31-FRONTEND_CLOSURE_AUDIT.md)
   - 前端页面级闭环审计
   - 回答“哪些页已闭环、哪些页只是接线或兼容入口”

12. [2026-05-31-PROVIDERS_ACTION_ACCEPTANCE_MATRIX.md](./2026-05-31-PROVIDERS_ACTION_ACCEPTANCE_MATRIX.md)
   - `providers.html` 当前页面边界与显式动作矩阵

13. [2026-06-01-FRONTEND_ACCEPTANCE_MATRIX.md](./2026-06-01-FRONTEND_ACCEPTANCE_MATRIX.md)
   - 前端页面到验收脚本的统一映射
   - 回答“哪个页面该跑哪个脚本”

14. [2026-05-31-FRONTEND_REMEDIATION_TASK_BOARD.md](./2026-05-31-FRONTEND_REMEDIATION_TASK_BOARD.md)
   - 前端系统性修复任务板
   - 用于判断剩余前端缺口是否已收口

## 背景/设计文档

15. [PRD.md](./PRD.md)
   - PRD 首版范围

16. [TDD_PLAN.md](./TDD_PLAN.md)
   - 测试设计与实现计划

17. [2026-05-12-sub2api-cn-relay-manager-solution.md](./2026-05-12-sub2api-cn-relay-manager-solution.md)
   - 早期方案设计与宿主接口理解

18. [DEPLOYMENT.md](./DEPLOYMENT.md)
   - 部署说明

19. [KNOWN_LIMITATIONS.md](./KNOWN_LIMITATIONS.md)
   - 当前限制项

20. [plans/2026-05-12-sub2api-cn-relay-manager-implementation-plan.md](./plans/2026-05-12-sub2api-cn-relay-manager-implementation-plan.md)
   - 初始实现计划

## 历史快照文档（只可参考，不可直接当当前真相）

21. [2026-05-18-PRODUCTION_READINESS_REVIEW.md](./2026-05-18-PRODUCTION_READINESS_REVIEW.md)
   - 历史审查快照
   - 用来看当时发现了哪些系统性问题

22. [2026-05-18-PRODUCTION_REMEDIATION_TASK_BOARD.md](./2026-05-18-PRODUCTION_REMEDIATION_TASK_BOARD.md)
   - 历史整改任务板
   - 用来看 2026-05-18 那一轮是如何收口的

## 当前阅读规则

- 想知道“现在到底是什么状态”：
  - 读 `SOURCE_OF_TRUTH.md` → `EXECUTION_BOARD.md` → `PRODUCTION_CLOSURE_BOARD.md`

- 想继续做真实宿主验收：
  - 读 `SOURCE_OF_TRUTH.md` → `REAL_HOST_ACCEPTANCE_RUNBOOK.md` → `REAL_HOST_ACCEPTANCE_LEARNINGS.md`

- 想回顾为什么会演化到现在：
  - 读 `SOURCE_OF_TRUTH.md` → 历史 review/task board → 再回到 `EXECUTION_BOARD.md`

## 明确禁止的错误读法

- ❌ 直接拿历史 review/task board 顶部 gate 当当前状态
- ❌ 直接拿历史 PASS artifact 当 latest-head 当前真相
- ❌ 把 `/v1/models` 通过自动等同于 completion 已通过
- ❌ 把 harness 参数错误（如 `PACK_PATH`、容器目标、probe auth）直接当成源码失败