docs(canvas): 说明旧画布树状态与事务协调 #4

2026-11-11T18:14:16Z

codex-bot commented

2026-11-11 18:14:16 +00:00

旧版画布树控制器将文档、历史、writer与跨画布事务组合在一个Hook中，缺少足够说明。本次仅为use-canvas-tree.ts增加中文模块、类型、函数和逻辑块注释，帮助理解当前实现。

说明内容覆盖：

documents/views、同步ref与React发布状态、每画布writer及恢复候选。
undo/redo双栈、本地快照与服务端事务条目、重做后的board别名。
节点/连线坐标还原、子画布按需加载、自动保存与迁移前排空。
成员迁移FIFO、固定body/key重试、ACK三方合并与请求期间历史调整。
上传占位跨分区移动、资源完成后历史更新、AI结果显式采用前协调。

验证：去注释TS/JSX语法树与修改前一致；npm run test:headless 822项通过；git diff --check通过。未执行浏览器或构建检查。本次没有更改运行逻辑。

基于最新main（PR #3已合并），仅包含本次单文件提交。全项目注释工作尚未完成，主画布组件等继续后续处理。等待用户手动合并。

旧版画布树控制器将文档、历史、writer与跨画布事务组合在一个Hook中，缺少足够说明。本次仅为use-canvas-tree.ts增加中文模块、类型、函数和逻辑块注释，帮助理解当前实现。说明内容覆盖： - documents/views、同步ref与React发布状态、每画布writer及恢复候选。 - undo/redo双栈、本地快照与服务端事务条目、重做后的board别名。 - 节点/连线坐标还原、子画布按需加载、自动保存与迁移前排空。 - 成员迁移FIFO、固定body/key重试、ACK三方合并与请求期间历史调整。 - 上传占位跨分区移动、资源完成后历史更新、AI结果显式采用前协调。验证：去注释TS/JSX语法树与修改前一致；npm run test:headless 822项通过；git diff --check通过。未执行浏览器或构建检查。本次没有更改运行逻辑。基于最新main（PR #3已合并），仅包含本次单文件提交。全项目注释工作尚未完成，主画布组件等继续后续处理。等待用户手动合并。

codex-bot added 1 commit 2026-11-11 18:14:17 +00:00

docs(canvas): explain legacy tree state and transaction coordination 33f5c076f6

Zayden-Jung merged commit 6b74629d98 into main

2026-11-11 18:16:17 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Zayden-Jung/Endoleap#4