docs(canvas): 说明新旧主画布视图与交互适配 #5

Merged
Zayden-Jung merged 2 commits from codex/headless-view-comments into main 2026-11-11 18:39:11 +00:00
Collaborator

新版主画布把editor/runtime会话与ReactFlow显示连接起来,需要明确状态归属和交互生命周期。本次为headless-graph-canvas.tsx补充中文模块、函数与逻辑块注释,不改变执行代码。

覆盖:立即/逐帧订阅、场景及测量缓存、加载覆盖与初始视口、几何空间转换、命中校验、手势token租约、资源显示订阅、焦点与可见性保留、节点/连线动作适配、工具栏/文件/任务入口,以及视图attach/detach。

验证:去注释语法树与修改前一致;npm run test:headless 822项通过;git diff --check通过。未执行浏览器或构建验证。

基于最新main(PR #4已合并),差异仅此单文件注释。全项目注释工作尚未完成,旧主画布及测试/脚本/样式仍待后续处理。等待用户手动合并。

追加:旧版主画布交互注释(1c83298)

  • graph-canvas.tsx:初始快照/草稿/视口、Context动作适配、分支创建、拖放成员归属、端口解析与跨子图连线、真实/演示图片导入、JSON导入导出、删除前结构事务及迁移/恢复入口。
  • 验证:该文件去注释AST一致;822项Node测试通过;diff检查通过。未修改执行逻辑,未运行浏览器或构建检查。

已核对src下221个跟踪TS/TSX模块全部完成首轮阅读与注释,模块头无遗漏;最终准确性/细粒度覆盖仍留全项目审查阶段。测试、脚本、配置、CSS尚待后续处理。

新版主画布把editor/runtime会话与ReactFlow显示连接起来,需要明确状态归属和交互生命周期。本次为headless-graph-canvas.tsx补充中文模块、函数与逻辑块注释,不改变执行代码。 覆盖:立即/逐帧订阅、场景及测量缓存、加载覆盖与初始视口、几何空间转换、命中校验、手势token租约、资源显示订阅、焦点与可见性保留、节点/连线动作适配、工具栏/文件/任务入口,以及视图attach/detach。 验证:去注释语法树与修改前一致;npm run test:headless 822项通过;git diff --check通过。未执行浏览器或构建验证。 基于最新main(PR #4已合并),差异仅此单文件注释。全项目注释工作尚未完成,旧主画布及测试/脚本/样式仍待后续处理。等待用户手动合并。 追加:旧版主画布交互注释(1c83298) - graph-canvas.tsx:初始快照/草稿/视口、Context动作适配、分支创建、拖放成员归属、端口解析与跨子图连线、真实/演示图片导入、JSON导入导出、删除前结构事务及迁移/恢复入口。 - 验证:该文件去注释AST一致;822项Node测试通过;diff检查通过。未修改执行逻辑,未运行浏览器或构建检查。 已核对src下221个跟踪TS/TSX模块全部完成首轮阅读与注释,模块头无遗漏;最终准确性/细粒度覆盖仍留全项目审查阶段。测试、脚本、配置、CSS尚待后续处理。
codex-bot added 1 commit 2026-11-11 18:18:04 +00:00
codex-bot added 1 commit 2026-11-11 18:21:47 +00:00
codex-bot changed title from docs(canvas): 说明新版画布视图与交互适配 to docs(canvas): 说明新旧主画布视图与交互适配 2026-11-11 18:21:56 +00:00
Zayden-Jung merged commit e75b9ed5e4 into main 2026-11-11 18:39:11 +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/Endoleap#5