docs(canvas): 完善画布模块与函数的逻辑注释 #12

2026-11-12T04:51:53Z

codex-bot commented

2026-11-12 04:51:53 +00:00

本批补充三个运行时模块的注释，使恢复与同步的实现边界能够被准确理解；执行代码保持不变。

改动范围：

service/runs.ts：说明启动受理/执行完成的区别、固定版本向量与计划、取消/应用局部证明、确定未生效回执及轮询/合图分层校验。
service/assets.ts：说明上传元数据/真实 Blob 的校验时点、原请求回执分类、资源采纳与授权端口合同。
service/model-loader.ts、model-stream.ts：说明流/JSON 单响应协商、作用域标记、NDJSON 预算、receiving 与 EOF 后 ready 的边界。
service/index.ts：明确服务入口只重导出，不拥有 Root/队列或自动建立连接。
bindings/react.ts：说明 Provider 借用、选择器提交基线、元素代次/手势 token、同步状态和资源 effect 释放流程。
bindings/react-renderers.ts、react-flow.ts：说明精确描述/模型核对、memo 包装身份、预览类型表及显式框架边界。
bindings/projection.ts：说明展开/折叠场景、显示端点代理、record-v1/compat-v1 路径与 fallback 的实际语义。
bindings/connection-paint.ts：说明控制点凸包包围范围、边/段预算、缓存签名、geometryRevision 和未知结果。
bindings/compat-types.ts、index.ts：明确兼容显示类型与可移植公共入口的职责，不承担模型校验或实例装配。
bindings/element-sources.ts、runtime-sources.ts：说明元素/表依赖路由、读取缓存与通知基线分离、同步计数和订阅释放。
bindings/resource-view.ts、overlays.ts：说明资源显示尝试的迟到结果、重试/释放及屏幕浮层 token/可见性生命周期。
bindings/renderers.ts、renderer-context.ts：说明精确 renderer 描述解析、局部加载门禁及受检命令注入合同。
bindings/scene-changes.ts、scene-projection.ts：说明连续写集合的信任条件、局部修补/全量回退与显示帧缓存键。
bindings/projection-cache.ts：说明显示对象/数组结构共享、生命周期键、测量复用和输入数组所有权。
bindings/paint-index.ts、projected-paint.ts：说明绘制范围网格、溢出回退、协议数据依赖及 query/unknown 的生命周期。
bindings/geometry-cache.ts、hit-query.ts：说明投影数值缓存的作用域、显示帧命中协议、节点/连线预算及完整性诊断。
bindings/visibility.ts、node-internals.ts、connectors.ts：说明矩形裁剪、挂载 token 测量合并、兼容端口与实测 Handle 坐标。
bindings/frame-queue.ts、session-frames.ts：说明帧合并、即时读取、通知重入及订阅清理边界。
bindings/pointer-capture.ts、input-router.ts：说明 DOM 捕获归属、丢失捕获判定、文本/浮层上下文和按键处理优先级。
bindings/selectors.ts、session-sources.ts：说明稳定选择引用、按 view/element 分桶、候选更新/通知顺序及生命周期。
engine.ts：完整复核项目装配与根发布 hooks、前缀持久化、文件回收、请求协调、摘要/尺寸任务、导入装配、恢复会话、资源句柄及关闭顺序；区分请求中止、排空、可靠保存与服务完成。
recovery.ts：说明编码格式优先级、序列化外壳缓存、候选 Root 重建、依赖 DAG 及请求/历史/资源/任务跨表校验边界。
imports.ts：说明任务/解释器版本、NDJSON 字节游标、稳定 ID 与定位摘要、临时缓存、依赖组原子提交和暂停/取消/重开边界。
runs.ts：说明生成协议/目标判定、轮询小顶堆与 token、pendingPage 协调、持久屏障、退避及 hold/retry/stop 生命周期。
asset-depot-storage.ts：说明共享字节/项目 pin 清单的原子写入、文件指针解算/转换，以及跨项目回收与分页边界。
storage.ts：说明 Web Lock/fence 生命周期、同 leader 写尾链、checkpoint/journal 摘要链及事务可靠回执。
copy-snapshot.ts：说明格式1完整快照的不可变输入合同、逐项编码、全图解码与组件声明签名。
copy-snapshot-index.ts：说明格式2结构投影、字节定位、按需校验和窗口缓存的所有权/取消边界。
journal-delta.ts：说明补丁数上限、精确键序、路径检查和回放中子树共享的合同。
recovery-encoding.ts：说明同步捕获、异步准备计划、WeakMap 缓存、深度/字节计量，以及 sealed 标记的适用边界。
storage-port.ts：说明 scope/leader/fence、Root/文件/depot 原子批次、恢复与 durable 回执的实现责任。
recovery-json.ts：说明私有 sealed 快路径、Unicode/token 分片、合作预算和完整 Blob 输出边界。
default-image-size.ts：说明授权状态、创建捕获、归一化初始尺寸、resize 识别/转换例外、撤销候选与实际执行/持久化边界。
resources.ts：说明保守资源依赖收集、对象读写足迹、扫描闭包所有权、历史 schema/transition 前沿及完整性标志。
applied-recovery.ts：说明回执解释、资源/run 候选暂存、版本覆盖及 fresh canonical 断言与持久化的边界。
contracts.ts：说明 RuntimeState/CanonicalRead/AppliedModelProof 和服务端口的所有权、校验与发布合同。
conflicts.ts：说明 canonical/回执前提、逐项决策与替代依赖、历史恢复分支、已知资源保留和审计备份范围。
history-journal-recovery.ts：说明私有状态/事件游标、project→accept→finish→evidence 合同、分组贡献、结算遍历/尺寸修正和证据冻结时机。
history-event-source.ts：说明原生/adoption 事件区间、顺序检查、解释器与后续条件回放责任。
traversal-recovery.ts：说明纯 undo/redo 回退路径、双栈逆向起点、保留/丢弃和替代操作边界。
loading.ts：说明 v1-v6 证据合同、命令/实际 changes/发送门、前缀与 fresh completion、查询覆盖和源/ACK 合并责任。
loading-structure.ts：说明 born/owner 闭合判定、数据来源、命令与 changes 双门禁、applied 投影及缓存前提。
loading-import.ts：说明选区/后代/祖先/入边范围、准入 sequence 和复制源 topology 重建。
model-preview.ts：说明接收/发布状态、依赖反向传播、候选整体校验、终态比较与关闭。
loading-assets.ts：说明 URL 表缓存、v6 准入/顺序/冻结请求核对及首次资源 owner 范围验证。
loader.ts：说明 query 去重、FIFO/active/LRU、adapter 测量合同、EOF 完成、fresh 行为、独立订阅和终态句柄/关闭边界。
host.ts：说明账号/epoch 退役、workspace/reader 复用、独立预览、只读加载及可重试关闭。
workspace.ts：说明项目打开 Promise、partial/full 输入采纳、背景加载、共享端口所有权和关闭失败边界。
duplicate.ts：说明完整/可恢复/懒准备入口、切片软预算、checkpoint 回调与最终保存责任。
scope-counts.ts：说明计数/owner/拓扑声明的前提、验证范围与后续 payload 对照职责。
import-duplicate.ts：说明完整 NDJSON 编码、依赖/外部 guard 收集、旧源基础校验、引用合同和提交前检查。
duplicate-source.ts：说明 checkpoint 绑定、FIFO 投影缓存、ordinal 懒转换与不同阶段的取消处理。
import-document.ts：说明完整索引准备、元数据/元素范围、父链成本及 ordinal 读取。
import-native.ts：说明目标与依赖生命周期、reserve 副作用、引用映射、声明式任务字段省略和资源授权边界。
import-read-proof.ts：说明 LRU/pending/hash 表、整范围提交证明、恢复 verify 合同、取消与底层读取容量。
import-identities.ts：说明基表捕获、used 索引复用、写时复制、finish/clear 生命周期和上层身份校验责任。
import-verification.ts：说明 durable seal 索引、发送闸门、连续块前缀及引擎拥有的证据发布。
import-byte-reader.ts：说明范围截断、返回缓冲所有权、错误分类和内容身份验证边界。
import-json-array.ts：说明字节游标、缓存/扫描栈、单条缓冲、分隔验证与记录级错误。
import-document-stream.ts：说明 header 准备、ordinal/range 区别、范围串行延伸、重读/重试和坏尾部处理。
copy-budget.ts、import-budget.ts：说明合作时间片、工作计数、取消检查点与顺序 await 合同。
import-batches.ts：说明运行时批大小反馈、增长/收缩阈值及非持久性能状态。
import-groups.ts：说明 SCC 邻接表/DFS 栈、就绪组扫描、软/硬预算及未就绪组的后续处理。
digest-pool.ts：说明等待/执行容量、输出合同、取消和关闭的真实执行边界。
browser-digests.ts、digest.worker.ts：说明能力选择、单任务 Worker 协议、错误传播与响应采纳。
digest-worker-source.ts：说明原生 64MiB 阈值、失败不重试和 Worker 微任务让出。
import-integrity.ts、sha256.ts：说明顺序读块、取消检查、内存生命周期和同步增量状态。
asset-depot.ts：说明元信息校验/捕获、每次采纳重新授权、已有绑定读取及关闭后的结果采纳。
display-cache.ts：说明 owner/key 复用、独立 lease、最后释放、错误清理与权限/pin 的调用方责任。
image-decoder.ts、browser-images.ts、image.worker.ts：说明等待/active 容量、取消后的槽位归还、Worker 消息校验和 bitmap 清理。
resource-retention.ts：说明 pin 表方向、working/ACK 合并、保守任务保留、软退休撤销和 reservation 发布屏障。
orphan-files.ts：说明孤立文件覆盖条件、永久身份保留、盘点更新与异步读取取消。
import-file-retention.ts：说明源归属索引、当前/旧源退休资格、generation 更新、快路和外围屏障职责。
depot-cut.ts：说明清单生成中的读取、元数据与字节项、采纳 revision 约束以及原子提交职责。
batch-projection.ts：解释稀疏基线、原条件链检查、guard 的组合语义、UTF-8 成本比较与回退/抛错区别。
change-rebase.ts：解释逆向意图上下文、样式键合并、世界空间重规划、创建依赖排序及候选发布边界。
network.ts：解释单实例 FIFO 名额转交、同步准入钩子及排队/运行中取消的差异。
elision.ts：解释闭合生命周期证明、候选前缀、全账本复核和本地墓碑的不同职责。
reconcile.ts：解释规范读取的版本条件、操作参与 canvas 的来源，以及未解决意图的重放范围。
history-replay.ts：解释历史证据的版本绑定、两栈元数据回放和 entries 比较，不将其描述为文档写入。

验证：本 PR 九十九个文件均为注释改动，分批 AST 一致；抵消/ACK/历史相关单测 31/31 通过；wire/网络/run/结构恢复相关单测 94/94 通过；资源/孤立文件/导入源/导入引擎/共享仓库相关单测 109/109 通过；共享仓库/显示租约/解码池相关单测 15/15 通过（Worker 替身，本轮未运行真实浏览器解码）；摘要调度/Worker 算法/流式 SHA/源完整性相关单测 13/13 通过（适配器使用 Worker 替身）；复制预算/自适应批/引用分组/导入相关单测 43/43 通过；JSON 数组/文档流/读取证明相关单测 23/23 通过；读取证明/稳定 ID/导入引擎 seal 相关单测 76/76 通过；文档索引/原生转换/导入引擎相关单测 67/67 通过；懒复制源/引用合同/复制预算相关单测 11/11 通过；复制调度/检查点/模型预览/加载引擎相关单测 68/68 通过；bindings/模型读取/加载引擎/共享资源采纳相关单测 77/77 通过；共享加载器/Host 模型读取相关单测 21/21 通过；渐进预览/模型读取/加载引擎相关单测 60/60 通过；部分加载/导入引擎相关单测 107/107 通过；加载总协调/渐进预览相关单测 53/53 通过；结构恢复/历史转移/恢复记录相关单测 77/77 通过；混合历史恢复/默认尺寸/历史转移相关单测 91/91 通过；冲突/结构/已生效恢复相关单测 65/65 通过；已生效恢复/资源/run 协调相关单测 60/60 通过；资源扫描/历史转移/孤立文件相关单测 57/57 通过；资源默认尺寸/创建尺寸规划相关单测 46/46 通过；恢复 JSON/编码/持久屏障相关单测 20/20 通过；恢复编码/JSON/增量日志相关单测 22/22 通过；复制快照/索引/预算/复制源/日志差分相关单测 19/19 通过；共享资源/持久屏障/日志差分/恢复 JSON 相关 Node 单测 14/14 通过（本批未重跑真实浏览器 IndexedDB 集成场景）；生成任务/轮询器相关单测 25/25 通过；导入 runner/引擎/身份/批次/完整性/读证明相关单测 113/113 通过；恢复解码直接调用方相关单测 316/316 通过；引擎/持久屏障/崩溃窗口/资源与文件保留相关单测 93/93 通过；引擎文件检查/响应协调/加载/生成/资源相关单测 152/152 通过；资源尺寸/导入完整性/引擎导入/生成/复制快照相关单测 126/126 通过；引擎导入装配/完整性/runner/资源领用/渐进加载相关单测 155/155 通过；引擎完整复核后全量 headless 单测 822/822 通过；bindings 输入/帧队列/选择器/会话订阅相关单测 31/31 通过；bindings 几何缓存/命中/可见性/节点测量相关单测 15/15 通过；bindings 场景修补/结构共享/绘制索引相关单测 36/36 通过；bindings 元素/runtime/资源订阅/浮层/renderer 相关单测 31/31 通过；bindings renderer/场景投影/连线绘制范围/命中相关单测 49/49 通过；bindings 全部模块复核后全量 headless 单测 822/822 通过（本批未重跑浏览器 hooks 集成）；资源服务/共享授权/模型 loader/流/预览相关单测 32/32 通过；生成服务/轮询/已生效恢复相关单测 30/30 通过；git diff --check 通过。

从 PR #11 合并后的最新 main 创建，只包含本批注释提交。全项目注释工作仍在第 5 阶段审查中，本 PR 是可独立评审的阶段交付。
等待用户手动合并。

本批补充三个运行时模块的注释，使恢复与同步的实现边界能够被准确理解；执行代码保持不变。改动范围： - service/runs.ts：说明启动受理/执行完成的区别、固定版本向量与计划、取消/应用局部证明、确定未生效回执及轮询/合图分层校验。 - service/assets.ts：说明上传元数据/真实 Blob 的校验时点、原请求回执分类、资源采纳与授权端口合同。 - service/model-loader.ts、model-stream.ts：说明流/JSON 单响应协商、作用域标记、NDJSON 预算、receiving 与 EOF 后 ready 的边界。 - service/index.ts：明确服务入口只重导出，不拥有 Root/队列或自动建立连接。 - bindings/react.ts：说明 Provider 借用、选择器提交基线、元素代次/手势 token、同步状态和资源 effect 释放流程。 - bindings/react-renderers.ts、react-flow.ts：说明精确描述/模型核对、memo 包装身份、预览类型表及显式框架边界。 - bindings/projection.ts：说明展开/折叠场景、显示端点代理、record-v1/compat-v1 路径与 fallback 的实际语义。 - bindings/connection-paint.ts：说明控制点凸包包围范围、边/段预算、缓存签名、geometryRevision 和未知结果。 - bindings/compat-types.ts、index.ts：明确兼容显示类型与可移植公共入口的职责，不承担模型校验或实例装配。 - bindings/element-sources.ts、runtime-sources.ts：说明元素/表依赖路由、读取缓存与通知基线分离、同步计数和订阅释放。 - bindings/resource-view.ts、overlays.ts：说明资源显示尝试的迟到结果、重试/释放及屏幕浮层 token/可见性生命周期。 - bindings/renderers.ts、renderer-context.ts：说明精确 renderer 描述解析、局部加载门禁及受检命令注入合同。 - bindings/scene-changes.ts、scene-projection.ts：说明连续写集合的信任条件、局部修补/全量回退与显示帧缓存键。 - bindings/projection-cache.ts：说明显示对象/数组结构共享、生命周期键、测量复用和输入数组所有权。 - bindings/paint-index.ts、projected-paint.ts：说明绘制范围网格、溢出回退、协议数据依赖及 query/unknown 的生命周期。 - bindings/geometry-cache.ts、hit-query.ts：说明投影数值缓存的作用域、显示帧命中协议、节点/连线预算及完整性诊断。 - bindings/visibility.ts、node-internals.ts、connectors.ts：说明矩形裁剪、挂载 token 测量合并、兼容端口与实测 Handle 坐标。 - bindings/frame-queue.ts、session-frames.ts：说明帧合并、即时读取、通知重入及订阅清理边界。 - bindings/pointer-capture.ts、input-router.ts：说明 DOM 捕获归属、丢失捕获判定、文本/浮层上下文和按键处理优先级。 - bindings/selectors.ts、session-sources.ts：说明稳定选择引用、按 view/element 分桶、候选更新/通知顺序及生命周期。 - engine.ts：完整复核项目装配与根发布 hooks、前缀持久化、文件回收、请求协调、摘要/尺寸任务、导入装配、恢复会话、资源句柄及关闭顺序；区分请求中止、排空、可靠保存与服务完成。 - recovery.ts：说明编码格式优先级、序列化外壳缓存、候选 Root 重建、依赖 DAG 及请求/历史/资源/任务跨表校验边界。 - imports.ts：说明任务/解释器版本、NDJSON 字节游标、稳定 ID 与定位摘要、临时缓存、依赖组原子提交和暂停/取消/重开边界。 - runs.ts：说明生成协议/目标判定、轮询小顶堆与 token、pendingPage 协调、持久屏障、退避及 hold/retry/stop 生命周期。 - asset-depot-storage.ts：说明共享字节/项目 pin 清单的原子写入、文件指针解算/转换，以及跨项目回收与分页边界。 - storage.ts：说明 Web Lock/fence 生命周期、同 leader 写尾链、checkpoint/journal 摘要链及事务可靠回执。 - copy-snapshot.ts：说明格式1完整快照的不可变输入合同、逐项编码、全图解码与组件声明签名。 - copy-snapshot-index.ts：说明格式2结构投影、字节定位、按需校验和窗口缓存的所有权/取消边界。 - journal-delta.ts：说明补丁数上限、精确键序、路径检查和回放中子树共享的合同。 - recovery-encoding.ts：说明同步捕获、异步准备计划、WeakMap 缓存、深度/字节计量，以及 sealed 标记的适用边界。 - storage-port.ts：说明 scope/leader/fence、Root/文件/depot 原子批次、恢复与 durable 回执的实现责任。 - recovery-json.ts：说明私有 sealed 快路径、Unicode/token 分片、合作预算和完整 Blob 输出边界。 - default-image-size.ts：说明授权状态、创建捕获、归一化初始尺寸、resize 识别/转换例外、撤销候选与实际执行/持久化边界。 - resources.ts：说明保守资源依赖收集、对象读写足迹、扫描闭包所有权、历史 schema/transition 前沿及完整性标志。 - applied-recovery.ts：说明回执解释、资源/run 候选暂存、版本覆盖及 fresh canonical 断言与持久化的边界。 - contracts.ts：说明 RuntimeState/CanonicalRead/AppliedModelProof 和服务端口的所有权、校验与发布合同。 - conflicts.ts：说明 canonical/回执前提、逐项决策与替代依赖、历史恢复分支、已知资源保留和审计备份范围。 - history-journal-recovery.ts：说明私有状态/事件游标、project→accept→finish→evidence 合同、分组贡献、结算遍历/尺寸修正和证据冻结时机。 - history-event-source.ts：说明原生/adoption 事件区间、顺序检查、解释器与后续条件回放责任。 - traversal-recovery.ts：说明纯 undo/redo 回退路径、双栈逆向起点、保留/丢弃和替代操作边界。 - loading.ts：说明 v1-v6 证据合同、命令/实际 changes/发送门、前缀与 fresh completion、查询覆盖和源/ACK 合并责任。 - loading-structure.ts：说明 born/owner 闭合判定、数据来源、命令与 changes 双门禁、applied 投影及缓存前提。 - loading-import.ts：说明选区/后代/祖先/入边范围、准入 sequence 和复制源 topology 重建。 - model-preview.ts：说明接收/发布状态、依赖反向传播、候选整体校验、终态比较与关闭。 - loading-assets.ts：说明 URL 表缓存、v6 准入/顺序/冻结请求核对及首次资源 owner 范围验证。 - loader.ts：说明 query 去重、FIFO/active/LRU、adapter 测量合同、EOF 完成、fresh 行为、独立订阅和终态句柄/关闭边界。 - host.ts：说明账号/epoch 退役、workspace/reader 复用、独立预览、只读加载及可重试关闭。 - workspace.ts：说明项目打开 Promise、partial/full 输入采纳、背景加载、共享端口所有权和关闭失败边界。 - duplicate.ts：说明完整/可恢复/懒准备入口、切片软预算、checkpoint 回调与最终保存责任。 - scope-counts.ts：说明计数/owner/拓扑声明的前提、验证范围与后续 payload 对照职责。 - import-duplicate.ts：说明完整 NDJSON 编码、依赖/外部 guard 收集、旧源基础校验、引用合同和提交前检查。 - duplicate-source.ts：说明 checkpoint 绑定、FIFO 投影缓存、ordinal 懒转换与不同阶段的取消处理。 - import-document.ts：说明完整索引准备、元数据/元素范围、父链成本及 ordinal 读取。 - import-native.ts：说明目标与依赖生命周期、reserve 副作用、引用映射、声明式任务字段省略和资源授权边界。 - import-read-proof.ts：说明 LRU/pending/hash 表、整范围提交证明、恢复 verify 合同、取消与底层读取容量。 - import-identities.ts：说明基表捕获、used 索引复用、写时复制、finish/clear 生命周期和上层身份校验责任。 - import-verification.ts：说明 durable seal 索引、发送闸门、连续块前缀及引擎拥有的证据发布。 - import-byte-reader.ts：说明范围截断、返回缓冲所有权、错误分类和内容身份验证边界。 - import-json-array.ts：说明字节游标、缓存/扫描栈、单条缓冲、分隔验证与记录级错误。 - import-document-stream.ts：说明 header 准备、ordinal/range 区别、范围串行延伸、重读/重试和坏尾部处理。 - copy-budget.ts、import-budget.ts：说明合作时间片、工作计数、取消检查点与顺序 await 合同。 - import-batches.ts：说明运行时批大小反馈、增长/收缩阈值及非持久性能状态。 - import-groups.ts：说明 SCC 邻接表/DFS 栈、就绪组扫描、软/硬预算及未就绪组的后续处理。 - digest-pool.ts：说明等待/执行容量、输出合同、取消和关闭的真实执行边界。 - browser-digests.ts、digest.worker.ts：说明能力选择、单任务 Worker 协议、错误传播与响应采纳。 - digest-worker-source.ts：说明原生 64MiB 阈值、失败不重试和 Worker 微任务让出。 - import-integrity.ts、sha256.ts：说明顺序读块、取消检查、内存生命周期和同步增量状态。 - asset-depot.ts：说明元信息校验/捕获、每次采纳重新授权、已有绑定读取及关闭后的结果采纳。 - display-cache.ts：说明 owner/key 复用、独立 lease、最后释放、错误清理与权限/pin 的调用方责任。 - image-decoder.ts、browser-images.ts、image.worker.ts：说明等待/active 容量、取消后的槽位归还、Worker 消息校验和 bitmap 清理。 - resource-retention.ts：说明 pin 表方向、working/ACK 合并、保守任务保留、软退休撤销和 reservation 发布屏障。 - orphan-files.ts：说明孤立文件覆盖条件、永久身份保留、盘点更新与异步读取取消。 - import-file-retention.ts：说明源归属索引、当前/旧源退休资格、generation 更新、快路和外围屏障职责。 - depot-cut.ts：说明清单生成中的读取、元数据与字节项、采纳 revision 约束以及原子提交职责。 - batch-projection.ts：解释稀疏基线、原条件链检查、guard 的组合语义、UTF-8 成本比较与回退/抛错区别。 - change-rebase.ts：解释逆向意图上下文、样式键合并、世界空间重规划、创建依赖排序及候选发布边界。 - network.ts：解释单实例 FIFO 名额转交、同步准入钩子及排队/运行中取消的差异。 - elision.ts：解释闭合生命周期证明、候选前缀、全账本复核和本地墓碑的不同职责。 - reconcile.ts：解释规范读取的版本条件、操作参与 canvas 的来源，以及未解决意图的重放范围。 - history-replay.ts：解释历史证据的版本绑定、两栈元数据回放和 entries 比较，不将其描述为文档写入。验证：本 PR 九十九个文件均为注释改动，分批 AST 一致；抵消/ACK/历史相关单测 31/31 通过；wire/网络/run/结构恢复相关单测 94/94 通过；资源/孤立文件/导入源/导入引擎/共享仓库相关单测 109/109 通过；共享仓库/显示租约/解码池相关单测 15/15 通过（Worker 替身，本轮未运行真实浏览器解码）；摘要调度/Worker 算法/流式 SHA/源完整性相关单测 13/13 通过（适配器使用 Worker 替身）；复制预算/自适应批/引用分组/导入相关单测 43/43 通过；JSON 数组/文档流/读取证明相关单测 23/23 通过；读取证明/稳定 ID/导入引擎 seal 相关单测 76/76 通过；文档索引/原生转换/导入引擎相关单测 67/67 通过；懒复制源/引用合同/复制预算相关单测 11/11 通过；复制调度/检查点/模型预览/加载引擎相关单测 68/68 通过；bindings/模型读取/加载引擎/共享资源采纳相关单测 77/77 通过；共享加载器/Host 模型读取相关单测 21/21 通过；渐进预览/模型读取/加载引擎相关单测 60/60 通过；部分加载/导入引擎相关单测 107/107 通过；加载总协调/渐进预览相关单测 53/53 通过；结构恢复/历史转移/恢复记录相关单测 77/77 通过；混合历史恢复/默认尺寸/历史转移相关单测 91/91 通过；冲突/结构/已生效恢复相关单测 65/65 通过；已生效恢复/资源/run 协调相关单测 60/60 通过；资源扫描/历史转移/孤立文件相关单测 57/57 通过；资源默认尺寸/创建尺寸规划相关单测 46/46 通过；恢复 JSON/编码/持久屏障相关单测 20/20 通过；恢复编码/JSON/增量日志相关单测 22/22 通过；复制快照/索引/预算/复制源/日志差分相关单测 19/19 通过；共享资源/持久屏障/日志差分/恢复 JSON 相关 Node 单测 14/14 通过（本批未重跑真实浏览器 IndexedDB 集成场景）；生成任务/轮询器相关单测 25/25 通过；导入 runner/引擎/身份/批次/完整性/读证明相关单测 113/113 通过；恢复解码直接调用方相关单测 316/316 通过；引擎/持久屏障/崩溃窗口/资源与文件保留相关单测 93/93 通过；引擎文件检查/响应协调/加载/生成/资源相关单测 152/152 通过；资源尺寸/导入完整性/引擎导入/生成/复制快照相关单测 126/126 通过；引擎导入装配/完整性/runner/资源领用/渐进加载相关单测 155/155 通过；引擎完整复核后全量 headless 单测 822/822 通过；bindings 输入/帧队列/选择器/会话订阅相关单测 31/31 通过；bindings 几何缓存/命中/可见性/节点测量相关单测 15/15 通过；bindings 场景修补/结构共享/绘制索引相关单测 36/36 通过；bindings 元素/runtime/资源订阅/浮层/renderer 相关单测 31/31 通过；bindings renderer/场景投影/连线绘制范围/命中相关单测 49/49 通过；bindings 全部模块复核后全量 headless 单测 822/822 通过（本批未重跑浏览器 hooks 集成）；资源服务/共享授权/模型 loader/流/预览相关单测 32/32 通过；生成服务/轮询/已生效恢复相关单测 30/30 通过；git diff --check 通过。从 PR #11 合并后的最新 main 创建，只包含本批注释提交。全项目注释工作仍在第 5 阶段审查中，本 PR 是可独立评审的阶段交付。等待用户手动合并。

codex-bot added 1 commit 2026-11-12 04:51:54 +00:00

docs(runtime): clarify elision and reconciliation evidence 20bdc7d44a

codex-bot added 1 commit 2026-11-12 04:54:41 +00:00

docs(runtime): explain wire projection and conflict replanning c491cd023c

codex-bot added 1 commit 2026-11-12 04:58:21 +00:00

docs(runtime): clarify resource and file retention boundaries 9ea8463867

codex-bot added 1 commit 2026-11-12 05:01:42 +00:00

docs(runtime): explain asset display and image decode lifecycles f6acdac8d8

codex-bot added 1 commit 2026-11-12 05:04:30 +00:00

docs(runtime): explain digest scheduling and streaming boundaries 2b0afddd07

codex-bot added 1 commit 2026-11-12 05:07:23 +00:00

docs(runtime): explain import scheduling and dependency selection d02cd2b01d