83 lines
2.7 KiB
Markdown
83 lines
2.7 KiB
Markdown
|
# 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_RUNBOOK.md](./REAL_HOST_ACCEPTANCE_RUNBOOK.md)
|
|||
|
|
- 标准验收步骤
|
|||
|
|
- artifact 结构
|
|||
|
|
- 证据分层要求
|
|||
|
|
|
|||
|
|
5. [REAL_HOST_ACCEPTANCE_LEARNINGS.md](./REAL_HOST_ACCEPTANCE_LEARNINGS.md)
|
|||
|
|
- 已调通细节
|
|||
|
|
- 高频误判点
|
|||
|
|
- 推荐诊断顺序
|
|||
|
|
|
|||
|
|
## 背景/设计文档
|
|||
|
|
|
|||
|
|
6. [PRD.md](./PRD.md)
|
|||
|
|
- PRD 首版范围
|
|||
|
|
|
|||
|
|
7. [TDD_PLAN.md](./TDD_PLAN.md)
|
|||
|
|
- 测试设计与实现计划
|
|||
|
|
|
|||
|
|
8. [2026-05-12-sub2api-cn-relay-manager-solution.md](./2026-05-12-sub2api-cn-relay-manager-solution.md)
|
|||
|
|
- 早期方案设计与宿主接口理解
|
|||
|
|
|
|||
|
|
9. [DEPLOYMENT.md](./DEPLOYMENT.md)
|
|||
|
|
- 部署说明
|
|||
|
|
|
|||
|
|
10. [KNOWN_LIMITATIONS.md](./KNOWN_LIMITATIONS.md)
|
|||
|
|
- 当前限制项
|
|||
|
|
|
|||
|
|
11. [plans/2026-05-12-sub2api-cn-relay-manager-implementation-plan.md](./plans/2026-05-12-sub2api-cn-relay-manager-implementation-plan.md)
|
|||
|
|
- 初始实现计划
|
|||
|
|
|
|||
|
|
## 历史快照文档（只可参考，不可直接当当前真相）
|
|||
|
|
|
|||
|
|
12. [2026-05-18-PRODUCTION_READINESS_REVIEW.md](./2026-05-18-PRODUCTION_READINESS_REVIEW.md)
|
|||
|
|
- 历史审查快照
|
|||
|
|
- 用来看当时发现了哪些系统性问题
|
|||
|
|
|
|||
|
|
13. [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）直接当成源码失败
|