docs: 补充 Foundry 入口注册与部署注释 [skip ci] #21

Merged
codex-bot merged 2 commits from codex/chinese-source-comments into main 2026-11-19 11:20:46 +00:00
Collaborator

本 PR 汇总 Foundry 代码阅读阶段的入口与部署注释,持续更新并保持 Draft,结束后等待用户手动合并。

当前改动:

  • cmd/foundry/main.go:解释各模块注册、认证子路由挂载、可选配置和 ServeMux 匹配规则。
  • deploy/release.sh:说明配置校验、迁移、release 目录、worker 替换、候选检查与切流,明确各阶段失败/回滚边界。
  • deploy/codex-worker.sh:说明预装 CLI、登录/授权准备、挂载、容器限制与 worker 启动参数。
  • deploy/route.sh:说明 Traefik 动态配置、Compose 覆盖、HTTPS 探测与旧路由恢复。
  • deploy/check-schema.sh:说明临时数据库、历史迁移与角色验证、Go 测试二进制及固定客户端集成。
  • deploy/check-canvas-real.sh:说明真实模型专项检查的 opt-in、隔离、准备条件与清理。
  • deploy/migrate.py:说明迁移排序、校验和、基线接管、统一事务与权限授予。
  • deploy/research/query-indexes.sql:说明手工并发索引及维护预算,区别于自动数据库迁移。

注释段前留空行,便于区分说明与代码。所有更新只涉及注释与排版。

检查:5 个 sh 的 bash -n 通过;Shell 非注释内容与 heredoc 逐字一致;Python AST 一致;SQL 语句不变;git diff --check 通过。未启动容器、执行迁移、调用模型、编译或构建,本轮注释提交使用 skip ci。

不自动合并,不直接推送 main。已有全仓中文注释已随 main 的 PR #20 集成,本 PR 的当前差异仅包含上述入口与部署补充。

本 PR 汇总 Foundry 代码阅读阶段的入口与部署注释,持续更新并保持 Draft,结束后等待用户手动合并。 当前改动: - cmd/foundry/main.go:解释各模块注册、认证子路由挂载、可选配置和 ServeMux 匹配规则。 - deploy/release.sh:说明配置校验、迁移、release 目录、worker 替换、候选检查与切流,明确各阶段失败/回滚边界。 - deploy/codex-worker.sh:说明预装 CLI、登录/授权准备、挂载、容器限制与 worker 启动参数。 - deploy/route.sh:说明 Traefik 动态配置、Compose 覆盖、HTTPS 探测与旧路由恢复。 - deploy/check-schema.sh:说明临时数据库、历史迁移与角色验证、Go 测试二进制及固定客户端集成。 - deploy/check-canvas-real.sh:说明真实模型专项检查的 opt-in、隔离、准备条件与清理。 - deploy/migrate.py:说明迁移排序、校验和、基线接管、统一事务与权限授予。 - deploy/research/query-indexes.sql:说明手工并发索引及维护预算,区别于自动数据库迁移。 注释段前留空行,便于区分说明与代码。所有更新只涉及注释与排版。 检查:5 个 sh 的 bash -n 通过;Shell 非注释内容与 heredoc 逐字一致;Python AST 一致;SQL 语句不变;git diff --check 通过。未启动容器、执行迁移、调用模型、编译或构建,本轮注释提交使用 skip ci。 不自动合并,不直接推送 main。已有全仓中文注释已随 main 的 PR #20 集成,本 PR 的当前差异仅包含上述入口与部署补充。
codex-bot added 1 commit 2026-11-16 13:19:57 +00:00
codex-bot added 1 commit 2026-11-16 16:01:31 +00:00
codex-bot changed title from WIP: Foundry 代码阅读阶段:中文注释与入口说明 to WIP: Foundry 代码阅读阶段:入口注册与部署注释 2026-11-16 16:02:08 +00:00
codex-bot changed title from WIP: Foundry 代码阅读阶段:入口注册与部署注释 to docs: 补充 Foundry 入口注册与部署注释 [skip ci] 2026-11-19 11:20:42 +00:00
codex-bot merged commit 3bc3051383 into main 2026-11-19 11:20:46 +00:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Zayden-Jung/Bedrock#21