docs(tests): 说明画布运行时、恢复和集成测试 #9

2026-11-12T02:04:42Z

codex-bot commented

2026-11-12 02:04:42 +00:00

为计算池、Worker 协议、增量摘要及复制调度预算补充中文模块、辅助函数、替身类方法和逐用例注释。执行逻辑与断言保持不变。

browser-digests.test.mjs（2例）：错配 Worker ID、启动/运行失败和线程替身清理。
digest-pool.test.mjs（3例）：活动/排队容量、FIFO、取消后的槽位保留、幂等关闭与输出校验。
digest-worker-source.test.mjs（3例）：WebCrypto/流式算法选择、原生失败不静默兜底、大输入分块预算。
image-decoder.test.mjs（3例）：并发容量、取消与底层执行退出、尺寸及 Worker 身份验证。
sha256.test.mjs（3例）：独立 Node crypto 对照、填充/块边界、有限读取和取消隔离。
copy-budget.test.mjs（5例）：普通/索引快照的字节一致性、预算让出、取消及宿主错误。

验证：六文件去注释 AST 一致；npm run test:headless 822项全部通过；git diff --check 通过。Worker 使用替身，未验证真实浏览器线程或打包，也未执行构建。

基于最新 main（PR #8 已合并），本 PR 只包含本轮六文件。全项目注释仍处于第4阶段，后续剩余测试、配置/CSS及全面准确性/覆盖审查继续。等待用户手动合并。

追加：深复制源、检查点和输入探针（3714af7）

copy-reference-source.test.mjs（3例）：端口/对象数组引用映射、外部生命周期和 SCC 容量。
copy-snapshot-index.test.mjs（4例）：拓扑/正文分离、懒读取、损坏定位及有限原始字节窗口。
copy-snapshot.test.mjs（3例）：完整快照往返和准备检查点约束。
duplicate-checkpoint.test.mjs（5例）：各语义阶段恢复、稳定 ID、DFS 游标和协作封存。
duplicate-source.test.mjs（3例）：记录游标懒输出、逐条失败和持久源绑定。
duplicate.test.mjs（8例）：深复制去重、分区/上级入边规则、资源复用、任务字段省略及引用 schema。
duplicate-scheduling.test.mjs（10例）：分片规划、取消、输入捕获及节奏化检查点。
renderer-copy-input.mjs：渐进复制期间的原生双击、中文组合输入、阶段采样、DOM/焦点与挂载数量检查。

八文件仅新增注释；AST 一致（含页面脚本字符串），822 项 Node 测试通过，diff 检查通过。本轮未运行 renderer 浏览器探针或构建。

追加：渐进导入、读取证明与 runner（d5ab402）

import-batches.test.mjs（2例）：按耗时自适应批量、尾项与超时回退。
import-document-stream.test.mjs（7例）：parser 5 边扫描边返回、稳定序号、坏尾部及扫描窗口复用。
import-document.test.mjs（5例）：parser 4 envelope、根 alias、单条上限及预算。
import-identities.test.mjs（3例）：稳定 ID 表缓存、防御捕获与增量分配。
import-integrity.test.mjs（2例）：完整源摘要及任务版本绑定；明确说明旧 Blob 替身 gate 未拦截实际 slice 读取的证明边界。
import-json-array.test.mjs（5例）：字节游标、UTF-8/嵌套分隔、坏记录/尾部、取消。
import-read-proof.test.mjs（11例）：已消费块证明、共享读取、淘汰重验、取消/关闭和容量。
imports.test.mjs（33例）：依赖分组、渐进发布、坏项隔离、循环原子组、恢复、背压、终态持久化及迟到准备隔离。

八文件仅补注释；68 个用例及辅助函数均有说明，去注释 AST 一致，822 项 Node 测试全部通过，git diff --check 通过。内存/可控 Blob 验证不等同于真实数据库或浏览器验证；未执行构建。

追加：引擎导入与源 seal（7b0e734）

imports-engine.test.mjs：逐项解释 62 个集成用例，补全命名辅助函数、Blob 替身及内存存储/幂等服务端端口说明。
串联本地可见、history、ledger、分块读取证明、完整 SHA 与持久化 seal、请求派发及恢复，区分各时序。
覆盖暂停/取消/重开、端点换代、深复制准备游标、旧格式解释器、依赖环发布、源文件回收、共享摘要池关闭归属与失败重试。
原单行端口展开以便对应注释阅读；执行逻辑与断言不变。

去注释 AST 一致，822 项 Node 测试通过，diff 检查通过。此文件使用内存端口和可控 Blob，不代表真实 IDB、网络或渲染验证；未执行构建。

追加：模型流、预览与加载缓存（a1e3a32）

loader.test.mjs（14例）：作用域共享、独立取消、块元数据、EOF、响应/并发预算、LRU与校验后缓存、身份及观察者重入。
model-loader.test.mjs（7例）：Foundry adapter、Host共享只读读取、entry注入与预览生命周期。
model-preview.test.mjs（8例）：依赖闭合的只读合法前缀、未知类型、输入所有权、scope counts和身份清单。
model-stream.test.mjs（8例）：逐字节UTF-8 framing、完整性与EOF、流式transport、覆盖/身份校验及错误尾部。
display-cache.test.mjs（7例）：显示租约共享、最后释放清理、迟到结果、owner隔离与清理错误。

本批44用例及命名辅助函数/流生成器均补中文说明；只新增注释，AST一致，822项Node测试通过，diff检查通过。使用可控异步源和模拟transport，不代表真实服务或浏览器验证；未执行构建。

追加：部分模型可编辑加载协议（bad68c6）

loading-engine.test.mjs：逐项说明45个集成用例、命名辅助函数、存储/模型/transport和资源端口。
区分loading v1–v6协议与恢复image格式，解释字段编辑、范围证书、提前同步、结构修改、任务及资源准入逐步增加的条件。
说明working/loadingRead/ACK分离、unloaded与absent、成员完整与引用闭包完整、未知回执等待、持久化屏障及旧流完成的合并边界。
原单行端口展开配合注释阅读；逻辑和断言不变，模拟端口的验证范围也已说明。

AST一致，822项Node测试通过，git diff --check通过。本文件采用内存存储和假transport，未进行真实服务、浏览器或构建验证。

追加：旧画布迁移入口、租约和恢复（9ae7d2d）

browser-migration.test.mjs（3例）：旧编辑共享租约/迁移独占、pending材料及过期视图清理；明确Web Locks为替身。
entry.test.mjs（3例）：canonical-first、只在明确条件legacy fallback、权限错误不降级及迁移版本向量。
migration.test.mjs（11例）：旧writer排空、请求先持久化、未知结果原key/字节查询重试、可信终态与身份/存储故障。
renderer-migration.mjs：假服务端路由及五个真实浏览器场景，说明脏稿、peer视图锁、丢ACK重载、不同草稿及pending草稿恢复顺序。

四文件只新增中文模块/辅助函数/逻辑块注释；AST一致（页面脚本原字节保留），822项Node测试通过，diff检查通过。renderer浏览器场景未在本轮执行，未构建。

追加：AI 运行任务与远程集成场景（dd36d4f）

run-tracker.test.mjs：暂停引用计数、在途响应保存游标、最后释放才恢复轮询，以及 stop 终态。
runs.test.mjs：内存服务、持久化和时钟替身，以及 23 个受理排序、丢响应恢复、取消、输出应用/撤销、owner 迁移、身份与版本证据场景。
foundry-ai.integration.mjs：远程入口的注入端口、故障屏障、四组文本/取消/冲突/图片场景和资源清理。

仅新增或替换中文注释，三个文件 AST 一致；822 项 Node 测试通过，git diff --check 通过。远程 AI 集成本轮未执行，未构建。

追加：引擎恢复、持久化边界与生命周期（bd4f1a3）

engine.test.mjs：内存端口、Root/ACK/history/ledger 同步发布、未知请求、恢复屏障、本地抵消、连续保存、让出编码及回执摘要。
conflicts.test.mjs：显式保留/丢弃、新条件操作、撤销链、审计与身份校验，未知和付费动作的限制。
crash-windows.test.mjs：六种本地/服务端切点配对，查询/重发次数与原冻结字节；明确不是实际进程掉电测试。
durability.test.mjs：脏修订、保存失败、观察者异常和关闭元数据。
publication-guard.test.mjs：同步准备与唯一发布边界，失败保持原 Root 和查询引用。
session-lifecycle.test.mjs：视图身份、mode、工具、导航、detach/dispose 和一次通知。
orphan-files.test.mjs：分页盘点、引用保护、digest 保留期、取消与失败删除批次的重试；不声称真实文件系统原子性已验证。
dissolve.test.mjs：直接成员提升、世界姿态、嵌套归属、声明引用、加载门槛及单请求恢复/undo/redo。

八文件仅注释与空白变化，AST 一致，git diff --check 通过。此前六文件阶段完整 822 项 Node 测试通过，后补的解散/文件回收两文件 14 项定向测试通过。未执行浏览器、远程集成或构建。

追加：服务协议、代理和包消费者（9d788e1）

service.test.mjs：14 个适配器用例与辅助模型/冻结请求，说明版本、身份、覆盖范围、局部 ACK、条件操作和可选回执摘要。
proxy.integration.mjs：临时 Next 项目/子进程、上游替身、冻结字节和认证转发、资产/AI/流式/allowlist 断言及清理。
foundry.integration.mjs：Foundry runner 入口、隔离身份、成功后丢响应、迁移/复制/解散、旧流捕获、上传恢复、跨项目采用与可选 AI。明确本地存储和锁是替身。
package.integration.mjs：构建/离线打包、解包路径守卫、无浏览器全局的 Node 消费、无 DOM 类型检查、显式 React peers 及浏览器入口；内嵌源码模板保持原字节。
package-browser-cases.mjs：真实编译 Worker、正常终止计数、PNG/SHA-256 与 IndexedDB/Web Locks 恢复、无网络派发及清理边界。

五文件 AST 一致，仅注释与排版变化；822 项 Node 测试通过，git diff --check 通过。本轮未执行代理编译、包构建、浏览器或远程集成。

为计算池、Worker 协议、增量摘要及复制调度预算补充中文模块、辅助函数、替身类方法和逐用例注释。执行逻辑与断言保持不变。 - browser-digests.test.mjs（2例）：错配 Worker ID、启动/运行失败和线程替身清理。 - digest-pool.test.mjs（3例）：活动/排队容量、FIFO、取消后的槽位保留、幂等关闭与输出校验。 - digest-worker-source.test.mjs（3例）：WebCrypto/流式算法选择、原生失败不静默兜底、大输入分块预算。 - image-decoder.test.mjs（3例）：并发容量、取消与底层执行退出、尺寸及 Worker 身份验证。 - sha256.test.mjs（3例）：独立 Node crypto 对照、填充/块边界、有限读取和取消隔离。 - copy-budget.test.mjs（5例）：普通/索引快照的字节一致性、预算让出、取消及宿主错误。验证：六文件去注释 AST 一致；npm run test:headless 822项全部通过；git diff --check 通过。Worker 使用替身，未验证真实浏览器线程或打包，也未执行构建。基于最新 main（PR #8 已合并），本 PR 只包含本轮六文件。全项目注释仍处于第4阶段，后续剩余测试、配置/CSS及全面准确性/覆盖审查继续。等待用户手动合并。追加：深复制源、检查点和输入探针（3714af7） - copy-reference-source.test.mjs（3例）：端口/对象数组引用映射、外部生命周期和 SCC 容量。 - copy-snapshot-index.test.mjs（4例）：拓扑/正文分离、懒读取、损坏定位及有限原始字节窗口。 - copy-snapshot.test.mjs（3例）：完整快照往返和准备检查点约束。 - duplicate-checkpoint.test.mjs（5例）：各语义阶段恢复、稳定 ID、DFS 游标和协作封存。 - duplicate-source.test.mjs（3例）：记录游标懒输出、逐条失败和持久源绑定。 - duplicate.test.mjs（8例）：深复制去重、分区/上级入边规则、资源复用、任务字段省略及引用 schema。 - duplicate-scheduling.test.mjs（10例）：分片规划、取消、输入捕获及节奏化检查点。 - renderer-copy-input.mjs：渐进复制期间的原生双击、中文组合输入、阶段采样、DOM/焦点与挂载数量检查。八文件仅新增注释；AST 一致（含页面脚本字符串），822 项 Node 测试通过，diff 检查通过。本轮未运行 renderer 浏览器探针或构建。追加：渐进导入、读取证明与 runner（d5ab402） - import-batches.test.mjs（2例）：按耗时自适应批量、尾项与超时回退。 - import-document-stream.test.mjs（7例）：parser 5 边扫描边返回、稳定序号、坏尾部及扫描窗口复用。 - import-document.test.mjs（5例）：parser 4 envelope、根 alias、单条上限及预算。 - import-identities.test.mjs（3例）：稳定 ID 表缓存、防御捕获与增量分配。 - import-integrity.test.mjs（2例）：完整源摘要及任务版本绑定；明确说明旧 Blob 替身 gate 未拦截实际 slice 读取的证明边界。 - import-json-array.test.mjs（5例）：字节游标、UTF-8/嵌套分隔、坏记录/尾部、取消。 - import-read-proof.test.mjs（11例）：已消费块证明、共享读取、淘汰重验、取消/关闭和容量。 - imports.test.mjs（33例）：依赖分组、渐进发布、坏项隔离、循环原子组、恢复、背压、终态持久化及迟到准备隔离。八文件仅补注释；68 个用例及辅助函数均有说明，去注释 AST 一致，822 项 Node 测试全部通过，git diff --check 通过。内存/可控 Blob 验证不等同于真实数据库或浏览器验证；未执行构建。追加：引擎导入与源 seal（7b0e734） - imports-engine.test.mjs：逐项解释 62 个集成用例，补全命名辅助函数、Blob 替身及内存存储/幂等服务端端口说明。 - 串联本地可见、history、ledger、分块读取证明、完整 SHA 与持久化 seal、请求派发及恢复，区分各时序。 - 覆盖暂停/取消/重开、端点换代、深复制准备游标、旧格式解释器、依赖环发布、源文件回收、共享摘要池关闭归属与失败重试。 - 原单行端口展开以便对应注释阅读；执行逻辑与断言不变。去注释 AST 一致，822 项 Node 测试通过，diff 检查通过。此文件使用内存端口和可控 Blob，不代表真实 IDB、网络或渲染验证；未执行构建。追加：模型流、预览与加载缓存（a1e3a32） - loader.test.mjs（14例）：作用域共享、独立取消、块元数据、EOF、响应/并发预算、LRU与校验后缓存、身份及观察者重入。 - model-loader.test.mjs（7例）：Foundry adapter、Host共享只读读取、entry注入与预览生命周期。 - model-preview.test.mjs（8例）：依赖闭合的只读合法前缀、未知类型、输入所有权、scope counts和身份清单。 - model-stream.test.mjs（8例）：逐字节UTF-8 framing、完整性与EOF、流式transport、覆盖/身份校验及错误尾部。 - display-cache.test.mjs（7例）：显示租约共享、最后释放清理、迟到结果、owner隔离与清理错误。本批44用例及命名辅助函数/流生成器均补中文说明；只新增注释，AST一致，822项Node测试通过，diff检查通过。使用可控异步源和模拟transport，不代表真实服务或浏览器验证；未执行构建。追加：部分模型可编辑加载协议（bad68c6） - loading-engine.test.mjs：逐项说明45个集成用例、命名辅助函数、存储/模型/transport和资源端口。 - 区分loading v1–v6协议与恢复image格式，解释字段编辑、范围证书、提前同步、结构修改、任务及资源准入逐步增加的条件。 - 说明working/loadingRead/ACK分离、unloaded与absent、成员完整与引用闭包完整、未知回执等待、持久化屏障及旧流完成的合并边界。 - 原单行端口展开配合注释阅读；逻辑和断言不变，模拟端口的验证范围也已说明。 AST一致，822项Node测试通过，git diff --check通过。本文件采用内存存储和假transport，未进行真实服务、浏览器或构建验证。追加：旧画布迁移入口、租约和恢复（9ae7d2d） - browser-migration.test.mjs（3例）：旧编辑共享租约/迁移独占、pending材料及过期视图清理；明确Web Locks为替身。 - entry.test.mjs（3例）：canonical-first、只在明确条件legacy fallback、权限错误不降级及迁移版本向量。 - migration.test.mjs（11例）：旧writer排空、请求先持久化、未知结果原key/字节查询重试、可信终态与身份/存储故障。 - renderer-migration.mjs：假服务端路由及五个真实浏览器场景，说明脏稿、peer视图锁、丢ACK重载、不同草稿及pending草稿恢复顺序。四文件只新增中文模块/辅助函数/逻辑块注释；AST一致（页面脚本原字节保留），822项Node测试通过，diff检查通过。renderer浏览器场景未在本轮执行，未构建。追加：AI 运行任务与远程集成场景（dd36d4f） - run-tracker.test.mjs：暂停引用计数、在途响应保存游标、最后释放才恢复轮询，以及 stop 终态。 - runs.test.mjs：内存服务、持久化和时钟替身，以及 23 个受理排序、丢响应恢复、取消、输出应用/撤销、owner 迁移、身份与版本证据场景。 - foundry-ai.integration.mjs：远程入口的注入端口、故障屏障、四组文本/取消/冲突/图片场景和资源清理。仅新增或替换中文注释，三个文件 AST 一致；822 项 Node 测试通过，git diff --check 通过。远程 AI 集成本轮未执行，未构建。追加：引擎恢复、持久化边界与生命周期（bd4f1a3） - engine.test.mjs：内存端口、Root/ACK/history/ledger 同步发布、未知请求、恢复屏障、本地抵消、连续保存、让出编码及回执摘要。 - conflicts.test.mjs：显式保留/丢弃、新条件操作、撤销链、审计与身份校验，未知和付费动作的限制。 - crash-windows.test.mjs：六种本地/服务端切点配对，查询/重发次数与原冻结字节；明确不是实际进程掉电测试。 - durability.test.mjs：脏修订、保存失败、观察者异常和关闭元数据。 - publication-guard.test.mjs：同步准备与唯一发布边界，失败保持原 Root 和查询引用。 - session-lifecycle.test.mjs：视图身份、mode、工具、导航、detach/dispose 和一次通知。 - orphan-files.test.mjs：分页盘点、引用保护、digest 保留期、取消与失败删除批次的重试；不声称真实文件系统原子性已验证。 - dissolve.test.mjs：直接成员提升、世界姿态、嵌套归属、声明引用、加载门槛及单请求恢复/undo/redo。八文件仅注释与空白变化，AST 一致，git diff --check 通过。此前六文件阶段完整 822 项 Node 测试通过，后补的解散/文件回收两文件 14 项定向测试通过。未执行浏览器、远程集成或构建。追加：服务协议、代理和包消费者（9d788e1） - service.test.mjs：14 个适配器用例与辅助模型/冻结请求，说明版本、身份、覆盖范围、局部 ACK、条件操作和可选回执摘要。 - proxy.integration.mjs：临时 Next 项目/子进程、上游替身、冻结字节和认证转发、资产/AI/流式/allowlist 断言及清理。 - foundry.integration.mjs：Foundry runner 入口、隔离身份、成功后丢响应、迁移/复制/解散、旧流捕获、上传恢复、跨项目采用与可选 AI。明确本地存储和锁是替身。 - package.integration.mjs：构建/离线打包、解包路径守卫、无浏览器全局的 Node 消费、无 DOM 类型检查、显式 React peers 及浏览器入口；内嵌源码模板保持原字节。 - package-browser-cases.mjs：真实编译 Worker、正常终止计数、PNG/SHA-256 与 IndexedDB/Web Locks 恢复、无网络派发及清理边界。五文件 AST 一致，仅注释与排版变化；822 项 Node 测试通过，git diff --check 通过。本轮未执行代理编译、包构建、浏览器或远程集成。

codex-bot added 1 commit 2026-11-12 02:04:44 +00:00

docs(tests): explain worker pools hashes and copy budgets 2f55f59bfc

codex-bot added 1 commit 2026-11-12 02:09:47 +00:00

docs(tests): explain deep copy sources checkpoints and input probe 3714af788f

codex-bot changed title from ~~docs(tests): 说明计算池、摘要与复制预算测试~~ to docs(tests): 说明计算池与深复制测试

2026-11-12 02:10:07 +00:00

codex-bot added 1 commit 2026-11-12 02:15:25 +00:00

docs(tests): explain progressive import parsers proofs and runner d5ab402592

codex-bot changed title from ~~docs(tests): 说明计算池与深复制测试~~ to docs(tests): 说明计算池、复制与渐进导入测试

2026-11-12 02:15:56 +00:00

codex-bot added 1 commit 2026-11-12 02:20:54 +00:00

docs(tests): explain engine import publication recovery and source seals 7b0e734e16