Files
sub2api-cn-relay-manager/docs
phamnazage-jpg 91fa5d6ab4 fix(review): 完成系统性 Review 修复方案 - Task B-01 HTTP Server 超时配置
本次提交包含:
- B-01: HTTP Server 添加超时配置 (ReadTimeout/WriteTimeout/IdleTimeout/MaxHeaderBytes)
- 添加结构化日志包 internal/log/ (B-02 部分完成)
- 添加 Review 报告文档
- 添加系统性修复方案文档
- 添加最佳实践审核报告文档
- 更新任务清单和执行板

测试验证:
- TestServerHasTimeoutConfiguration 通过

关联文档:
- docs/2026-06-01-SYSTEMATIC-REVIEW-REPORT.md
- docs/2026-06-01-SYSTEMATIC-REPAIR-PLAN.md
- docs/2026-06-01-BEST-PRACTICE-AUDIT-REPORT.md
2026-06-01 22:02:01 +08:00
..

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 首版范围放行
    • 哪些是代码门禁,哪些是外部/环境门禁

真实宿主验收入口

  1. REAL_HOST_ACCEPTANCE_CHECKLIST.md

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

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

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

    • OpenClaw 最后一跳真实使用验证
    • 升级后补丁自检与 cron 提醒
    • tksea / 53hk 多模型运行态口径
  5. PROJECT_STRUCTURE.md

    • 当前仓库目录职责说明
    • 新增文件该放在哪一层
  6. ../scripts/README.md

    • scripts/deployscripts/acceptancescripts/test 的入口说明
    • 继续整理脚本或追脚本回归时先看这里

背景/设计文档

  1. PRD.md
  • PRD 首版范围
  1. TDD_PLAN.md
  • 测试设计与实现计划
  1. 2026-05-12-sub2api-cn-relay-manager-solution.md
  • 早期方案设计与宿主接口理解
  1. DEPLOYMENT.md
  • 部署说明
  1. KNOWN_LIMITATIONS.md
  • 当前限制项
  1. plans/2026-05-12-sub2api-cn-relay-manager-implementation-plan.md
  • 初始实现计划

历史快照文档(只可参考,不可直接当当前真相)

  1. 2026-05-18-PRODUCTION_READINESS_REVIEW.md
  • 历史审查快照
  • 用来看当时发现了哪些系统性问题
  1. 2026-05-18-PRODUCTION_REMEDIATION_TASK_BOARD.md
  • 历史整改任务板
  • 用来看 2026-05-18 那一轮是如何收口的

当前阅读规则

  • 想知道“现在到底是什么状态”:

    • SOURCE_OF_TRUTH.mdEXECUTION_BOARD.mdPRODUCTION_CLOSURE_BOARD.md
  • 想继续做真实宿主验收:

    • SOURCE_OF_TRUTH.mdREAL_HOST_ACCEPTANCE_RUNBOOK.mdREAL_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直接当成源码失败