100 lines
3.3 KiB
Markdown
100 lines
3.3 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_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. [PRD.md](./PRD.md)
|
||
- PRD 首版范围
|
||
|
||
11. [TDD_PLAN.md](./TDD_PLAN.md)
|
||
- 测试设计与实现计划
|
||
|
||
12. [2026-05-12-sub2api-cn-relay-manager-solution.md](./2026-05-12-sub2api-cn-relay-manager-solution.md)
|
||
- 早期方案设计与宿主接口理解
|
||
|
||
13. [DEPLOYMENT.md](./DEPLOYMENT.md)
|
||
- 部署说明
|
||
|
||
14. [KNOWN_LIMITATIONS.md](./KNOWN_LIMITATIONS.md)
|
||
- 当前限制项
|
||
|
||
15. [plans/2026-05-12-sub2api-cn-relay-manager-implementation-plan.md](./plans/2026-05-12-sub2api-cn-relay-manager-implementation-plan.md)
|
||
- 初始实现计划
|
||
|
||
## 历史快照文档（只可参考，不可直接当当前真相）
|
||
|
||
16. [2026-05-18-PRODUCTION_READINESS_REVIEW.md](./2026-05-18-PRODUCTION_READINESS_REVIEW.md)
|
||
- 历史审查快照
|
||
- 用来看当时发现了哪些系统性问题
|
||
|
||
17. [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）直接当成源码失败
|