docs: 补充 Foundry 全仓中文源码与部署注释 [skip ci] #20

Merged
Zayden-Jung merged 1 commits from codex/chinese-source-comments into main 2026-11-16 10:04:36 +00:00
Collaborator

为 Foundry Core 补充可沿调用链阅读的中文注释,说明模块职责、关键变量、控制分支、事务与资源生命周期,方便理解跨画布编辑及 AI 异步写回。

改动覆盖全部 108 个 Go 文件、397 个函数:入口与认证、Codex worker、平台资源/画布/子图/canonical 模型/AI 队列、研究 API,以及对应测试。测试注释明确实际断言、隔离数据库前提与固定生成传输的范围。部署、迁移执行器、工作流、环境和模块配置补充执行阶段与维护约定。

历史 db/001–011 SQL 由迁移器按原文 SHA-256 校验,保留字节不变;新增 docs/database-comments.sql 逐迁移、逐表、逐约束说明,README 链接该索引。go.sum 和协议 JSON fixture 保持原文。未修改业务执行代码或工作流命令。

验证:

  • 对基线 30829ee 的 108 个 Go 文件逐一比较词法 token 和 Go 编译指令,均一致;397 个函数均有中文说明。
  • Python AST 一致;Shell/YAML/SQL/env/go.mod 去注释内容一致。
  • gofmt、bash -n、git diff --check 通过;11 份历史 SQL、go.sum、协议 JSON 字节一致。
  • 用户明确要求本次仅静态检查,不触发构建;提交和 PR 标题保留 [skip ci]。未运行 Go/数据库/headless 回归、真实 OAuth、付费模型或部署。

交付分支 codex/chinese-source-comments → main。等待用户手动合并;本 PR 不声称已合并、部署或运行验证通过。

为 Foundry Core 补充可沿调用链阅读的中文注释,说明模块职责、关键变量、控制分支、事务与资源生命周期,方便理解跨画布编辑及 AI 异步写回。 改动覆盖全部 108 个 Go 文件、397 个函数:入口与认证、Codex worker、平台资源/画布/子图/canonical 模型/AI 队列、研究 API,以及对应测试。测试注释明确实际断言、隔离数据库前提与固定生成传输的范围。部署、迁移执行器、工作流、环境和模块配置补充执行阶段与维护约定。 历史 db/001–011 SQL 由迁移器按原文 SHA-256 校验,保留字节不变;新增 docs/database-comments.sql 逐迁移、逐表、逐约束说明,README 链接该索引。go.sum 和协议 JSON fixture 保持原文。未修改业务执行代码或工作流命令。 验证: - 对基线 30829ee 的 108 个 Go 文件逐一比较词法 token 和 Go 编译指令,均一致;397 个函数均有中文说明。 - Python AST 一致;Shell/YAML/SQL/env/go.mod 去注释内容一致。 - gofmt、bash -n、git diff --check 通过;11 份历史 SQL、go.sum、协议 JSON 字节一致。 - 用户明确要求本次仅静态检查,不触发构建;提交和 PR 标题保留 [skip ci]。未运行 Go/数据库/headless 回归、真实 OAuth、付费模型或部署。 交付分支 codex/chinese-source-comments → main。等待用户手动合并;本 PR 不声称已合并、部署或运行验证通过。
codex-bot added 1 commit 2026-11-16 10:00:12 +00:00
codex-bot changed title from docs: u8865u5145 Foundry u5168u4ed3u4e2du6587u6e90u7801u4e0eu90e8u7f72u6ce8u91ca [skip ci] to docs: 补充 Foundry 全仓中文源码与部署注释 [skip ci] 2026-11-16 10:01:02 +00:00
Zayden-Jung merged commit 27412f58af into main 2026-11-16 10:04:36 +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/foundry-core#20