sub2api-cn-relay-manager/docs

docs 导航首页

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

先读这里

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

1. SOURCE_OF_TRUTH.md

   • 当前文档真相入口
   • 先看这份，避免把历史审查、历史任务板、历史 artifact 误读为当前结论

2. EXECUTION_BOARD.md

   • 当前执行状态
   • 最新 gate
   • 剩余阻断
   • 最短 closure path

3. PRODUCTION_CLOSURE_BOARD.md

   • 当前是否可按 PRD 首版范围放行
   • 哪些是代码门禁，哪些是外部/环境门禁

真实宿主验收入口

4. REAL_HOST_ACCEPTANCE_CHECKLIST.md

   • 每次验收先过这一页
   • 最短闭环 / 红线 / 三层证据 / 诊断顺序

5. REAL_HOST_ACCEPTANCE_RUNBOOK.md

   • 标准验收步骤
   • artifact 结构
   • 证据分层要求

6. REAL_HOST_ACCEPTANCE_LEARNINGS.md

   • 已调通细节
   • 高频误判点
   • 推荐诊断顺序

背景/设计文档

6. PRD.md

   • PRD 首版范围

7. TDD_PLAN.md

   • 测试设计与实现计划

8. 2026-05-12-sub2api-cn-relay-manager-solution.md

   • 早期方案设计与宿主接口理解

9. DEPLOYMENT.md

   • 部署说明

10. KNOWN_LIMITATIONS.md

• 当前限制项

11. plans/2026-05-12-sub2api-cn-relay-manager-implementation-plan.md

• 初始实现计划

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

12. 2026-05-18-PRODUCTION_READINESS_REVIEW.md

• 历史审查快照
• 用来看当时发现了哪些系统性问题

13. 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）直接当成源码失败