docs: 补全 Tessera 中文源码说明并更新 agent guide #10

2026-11-15T12:10:20Z

codex-bot commented

2026-11-15 12:10:20 +00:00

目标与结果

在本地 Nexus runtime 抽取之前，为 Tessera 全部代码补全可沿调用链阅读的中文注释。覆盖 bridge/model/render/runtime/shell、76 个 Rust 文件、48 个 Endor 文件和两个工具脚本，说明实际调用方、变量用途、控制分支、VM 根/内部边、缓存失效、事件及失败清理。

实际改动

bridge：UI 能力注册、原生签名、构造/方法分派、图形资源、开发者页面和树查询说明。
model/render：对象与文档发布、Mount/协议/快照、布局/滚动/命中、文本与图像、软件合成、3D 场景/相机/空间索引说明。
runtime/shell：API/worker、源码计划与 VM 会话、绑定刷新、任务/IO、事件、窗口及开发者工具的职责和生命周期说明。
全部测试、示例和脚本按完整文件复核，修正注释中与实际断言、坐标、资源或失败边界不符的描述。
src/runtime/api/guide.rs 除注释外，另有十处返回说明文本更新：与已存在的可恢复布局/绘制、窗口、限制及路由行为一致；没有修改 Rust 分派或执行算法。
vendor/aster 更新到 ab0be1efd3495a2b188f60ef2542492696e39add，包含同一批详细注释；Aster 非注释执行代码与其基线一致。

关联 Aster PR：Zayden-Jung/endorphin-aster-vm#3 。建议先审阅/合并 Aster，再手动合并本 PR；子模块提交已推送，当前即可获取。

检查结果

126/126 代码文件完成清单及完整文件注释深度/调用方复核。
76 个 Rust 文件的 rustfmt --check、完整差异 git diff --check、两个工具脚本语法检查通过。
125 个代码文件的非注释执行内容与基线一致；guide.rs 的注释等价核对与十处说明字符串变更单独审查。
Aster 全仓静态/生成检查及四项纯 Python 生成器测试通过，ASDL 与 JSON Schema 字节保持不变。

验证边界与后续

用户暂不使用 CI/CD，且未授权本机编译；没有运行 Rust 编译、Cargo test/clippy、GUI 或 Endor 示例。静态等价和注释复核不代表运行验证通过。

现有 Scene3D 对 ObjectList 内容变更的依赖问题已记录，后续以独立行为修复和回归处理，不混入注释交付。Nexus 实际抽取尚未开始，未创建 Nexus 远程仓库。

请用户手动合并到 main；bot 不代为合并。

## 目标与结果在本地 Nexus runtime 抽取之前，为 Tessera 全部代码补全可沿调用链阅读的中文注释。覆盖 bridge/model/render/runtime/shell、76 个 Rust 文件、48 个 Endor 文件和两个工具脚本，说明实际调用方、变量用途、控制分支、VM 根/内部边、缓存失效、事件及失败清理。 ## 实际改动 - bridge：UI 能力注册、原生签名、构造/方法分派、图形资源、开发者页面和树查询说明。 - model/render：对象与文档发布、Mount/协议/快照、布局/滚动/命中、文本与图像、软件合成、3D 场景/相机/空间索引说明。 - runtime/shell：API/worker、源码计划与 VM 会话、绑定刷新、任务/IO、事件、窗口及开发者工具的职责和生命周期说明。 - 全部测试、示例和脚本按完整文件复核，修正注释中与实际断言、坐标、资源或失败边界不符的描述。 - src/runtime/api/guide.rs 除注释外，另有十处返回说明文本更新：与已存在的可恢复布局/绘制、窗口、限制及路由行为一致；没有修改 Rust 分派或执行算法。 - vendor/aster 更新到 ab0be1efd3495a2b188f60ef2542492696e39add，包含同一批详细注释；Aster 非注释执行代码与其基线一致。关联 Aster PR：https://gitea.entroia.com/Zayden-Jung/endorphin-aster-vm/pulls/3 。建议先审阅/合并 Aster，再手动合并本 PR；子模块提交已推送，当前即可获取。 ## 检查结果 - 126/126 代码文件完成清单及完整文件注释深度/调用方复核。 - 76 个 Rust 文件的 rustfmt --check、完整差异 git diff --check、两个工具脚本语法检查通过。 - 125 个代码文件的非注释执行内容与基线一致；guide.rs 的注释等价核对与十处说明字符串变更单独审查。 - Aster 全仓静态/生成检查及四项纯 Python 生成器测试通过，ASDL 与 JSON Schema 字节保持不变。 ## 验证边界与后续用户暂不使用 CI/CD，且未授权本机编译；没有运行 Rust 编译、Cargo test/clippy、GUI 或 Endor 示例。静态等价和注释复核不代表运行验证通过。现有 Scene3D 对 ObjectList 内容变更的依赖问题已记录，后续以独立行为修复和回归处理，不混入注释交付。Nexus 实际抽取尚未开始，未创建 Nexus 远程仓库。请用户手动合并到 main；bot 不代为合并。

codex-bot added 78 commits 2026-11-15 12:10:21 +00:00

docs: explain UI bridge callers, control flow and VM ownership fbc5bed19e

docs: explain graphics resources and runtime dispatch lifecycles 21aa7b837b

docs: explain task scheduling, VM sessions and API control flow e7f387ed9f

docs: explain worker publication and HTTP integration regressions ed1a9d2956

docs: explain host test setup, dependencies and incremental painting 91bd0d4c5a

docs: explain visual contracts, mount lifecycle and event test assertions 6f84d6574a

docs: explain scrolling, incremental refresh and flex test invariants 00514825a0

docs: explain box layout, camera projection and 3d picking tests 3ed148c880

docs: explain world ui, scroll policies and native identity test paths d9c191ec00

docs: explain effects, bindings, publication and shutdown test paths 742fee4295

docs: explain binding convergence and managed block model ownership dbf0bb5800