docs(tests): 说明绘制、同步、恢复与资源测试 #8

2026-11-11T18:40:44Z

codex-bot commented

2026-11-11 18:40:44 +00:00

为绘制范围、命中和投影缓存回归补充中文模块、工厂/辅助函数及逐用例说明，不改执行逻辑或断言。

paint-index.test.mjs（8例）：网格边界、绘制外扩、unknown及数据依赖缓存。
connection-paint.test.mjs（8例）：曲线溢出、描边、锚点、预算与预览失效。
hit-query.test.mjs（8例）：屏幕/场景坐标、像素容差、自定义几何、曲线细分及诊断。
projection-cache.test.mjs（8例）：对象/数组复用、测量、身份/owner与失败不部分发布。
scene-projection.test.mjs（17例）：增量与完整投影对照、漏hint、局部工作量和未知类型规则。

验证：5文件49用例均有说明，去注释AST一致；npm run test:headless 822项通过；git diff --check通过。纯数据/计数测试不代表浏览器帧率或真实DOM验证，未执行构建。

基于最新main（PR #7已合并），仅含本轮5文件。全项目注释仍在阶段4，其余测试、配置、样式及最终审查后续继续。等待用户手动合并。

追加：保留投影、资源显示与批次证明（c426e94）

visibility.test.mjs（1例）：原生矩形可见边界及未知尺寸保守处理。
retained-projection.test.mjs（3例）：投影标记隔离、真实依赖源码转换与选择selector。
query-retention.test.mjs（1例）：独立GC进程下丢弃代次和显式旧前缀的引用保留。
resource-view.test.mjs（6例）：逐项显示、失败重试、替换取消、迟到句柄及dispose。
bindings.test.mjs（12例）：树坐标、手势租约、宿主/工作区关闭及未知类型占位。
batch-projection.test.mjs（9例）：wire压缩条件、逻辑ID、生命周期、稀疏证明和UTF-8成本。

本批6文件32用例与辅助函数均有说明；去注释AST一致，822项Node测试通过，diff检查通过。未改代码或断言；GC/VM/内存测试的验证边界已明确，没有浏览器或构建验证。

追加：账本、调度、重放与本地抵消（298f4b3）

ledger.test.mjs：FIFO/最小堆、未发送压缩、冻结身份、依赖与终态证据。
scheduler.test.mjs：持久化屏障、canvas writer、查询/重试、上传公平性、hold/stop、批次与时钟跳变。
reconcile-replay.test.mjs：ACK 前缀、字段存在性、作用域/代际身份与私有重放失败边界。
elision.test.mjs：未发送生命周期抵消证明、高水位、观察者边界与历史资源引用。

四文件只新增中文模块、辅助函数和用例说明；去注释 AST 一致，822 项 Node 测试全部通过，git diff --check 通过。没有运行浏览器或构建验证。

追加：恢复编码、日志与成功回执接纳（53905a4）

applied-recovery.test.mjs：已成功但本地等待接纳的请求，较新完整读取、显式重规划、落盘失败、取消与回执过期。
recovery-encoding.test.mjs：JSON 规范化、所有权缓存、getter/toJSON/Proxy、协作式预算、深度限制与 UTF-8 计数。
recovery-json.test.mjs：分块输出与原生 JSON 字节一致、外部值捕获、owner 丢失和宿主错误。
recovery-views.test.mjs：不可变文档/表的编码复用、浅冻结外部数据重读及旧 image 隔离。
journal-delta.test.mjs：日志补丁精确往返、体积、非法路径/超限拒绝及可复现的连续更新。

本批五文件仅新增中文模块、辅助函数和用例注释；去注释 AST 一致，822 项 Node 测试全部通过，diff 检查通过。没有运行浏览器、数据库或构建验证。

追加：结构恢复与历史 adoption（1a0d9cd）

structure-recovery.test.mjs：逐项说明 60 个用例，以及内存存储/简化服务端、几何比较、缩放树与成功回执证明辅助器。
说明分区/连线归属、世界坐标与 unitScale、删除恢复的身份代次、同组已确认/待处理历史、undo/redo 顺序与容量、连续恢复及证据损坏拒绝。
展开原单行 fixture 的端口方法并补充内部校验/发布顺序说明；没有修改执行逻辑或断言。

去注释 AST 一致，822 项 Node 测试全部通过，git diff --check 通过。本文件采用内存端口，未执行真实浏览器/数据库或构建验证。

追加：资源接纳、引用保留与共享存储（3cda36b）

asset-adoption.test.mjs：同步发布绑定/内容/历史、跨项目授权复用、落盘失败、迟到结果、文档导入及旧 Root 竞态。
asset-depot.test.mjs：权限、缓存身份/字节校验、关闭隔离、二进制流预算及 authority 元数据版本。
asset-service.test.mjs：冻结上传身份、成功回执、显示地址路由、未知结果与 multipart 请求头。
import-file-retention.test.mjs：导入源文件归档、退休标记、generation 与 purge 身份保护。
resource-pin-scan.test.mjs：working/ACK/history/显式引用、缓存边界及 registry 的资源字段。
asset-adoption-browser-cases.mjs：真实 IDB 上跨项目接纳、重开、授权及关闭项目 pin。
asset-depot-browser-cases.mjs：字节去重、作用域隔离、完整 manifest、回收/回滚与实际上传后的共享字节提升。
depot-files-browser-cases.mjs：文件指针/MIME、DB 升级、资源独立回收及新接纳和旧提交竞态。

本批仅注释与必要排版。八文件去注释 AST 一致，822 项 Node 测试通过，diff 检查通过。五个 Node 测试模块覆盖 28 用例，三份浏览器脚本含五个导出场景；浏览器场景未在本轮执行，也未进行构建。

追加：项目资源生命周期与本地回收（7de9a3e）

resources.test.mjs：逐项说明 32 个用例、所有命名辅助函数以及内存存储/上传/文档服务端口。
覆盖默认尺寸 grant、用户 resize 撤权、解码元数据与显式 fitImage、文件与账本持久化屏障、上传未知/成功待接纳、图片替换及重开。
说明 working/history/ACK/任务/显示 pin、共享 reader/URL 生命周期、软退休宽限期、删除 reservation、删除失败重试及同步监听器重入 persist 的原子删除要求。

本批仅新增中文注释，执行逻辑/断言不变；去注释 AST 一致，822 项 Node 测试通过，git diff --check 通过。此文件使用内存端口；未进行真实数据库、浏览器或构建验证。

为绘制范围、命中和投影缓存回归补充中文模块、工厂/辅助函数及逐用例说明，不改执行逻辑或断言。 - paint-index.test.mjs（8例）：网格边界、绘制外扩、unknown及数据依赖缓存。 - connection-paint.test.mjs（8例）：曲线溢出、描边、锚点、预算与预览失效。 - hit-query.test.mjs（8例）：屏幕/场景坐标、像素容差、自定义几何、曲线细分及诊断。 - projection-cache.test.mjs（8例）：对象/数组复用、测量、身份/owner与失败不部分发布。 - scene-projection.test.mjs（17例）：增量与完整投影对照、漏hint、局部工作量和未知类型规则。验证：5文件49用例均有说明，去注释AST一致；npm run test:headless 822项通过；git diff --check通过。纯数据/计数测试不代表浏览器帧率或真实DOM验证，未执行构建。基于最新main（PR #7已合并），仅含本轮5文件。全项目注释仍在阶段4，其余测试、配置、样式及最终审查后续继续。等待用户手动合并。追加：保留投影、资源显示与批次证明（c426e94） - visibility.test.mjs（1例）：原生矩形可见边界及未知尺寸保守处理。 - retained-projection.test.mjs（3例）：投影标记隔离、真实依赖源码转换与选择selector。 - query-retention.test.mjs（1例）：独立GC进程下丢弃代次和显式旧前缀的引用保留。 - resource-view.test.mjs（6例）：逐项显示、失败重试、替换取消、迟到句柄及dispose。 - bindings.test.mjs（12例）：树坐标、手势租约、宿主/工作区关闭及未知类型占位。 - batch-projection.test.mjs（9例）：wire压缩条件、逻辑ID、生命周期、稀疏证明和UTF-8成本。本批6文件32用例与辅助函数均有说明；去注释AST一致，822项Node测试通过，diff检查通过。未改代码或断言；GC/VM/内存测试的验证边界已明确，没有浏览器或构建验证。追加：账本、调度、重放与本地抵消（298f4b3） - ledger.test.mjs：FIFO/最小堆、未发送压缩、冻结身份、依赖与终态证据。 - scheduler.test.mjs：持久化屏障、canvas writer、查询/重试、上传公平性、hold/stop、批次与时钟跳变。 - reconcile-replay.test.mjs：ACK 前缀、字段存在性、作用域/代际身份与私有重放失败边界。 - elision.test.mjs：未发送生命周期抵消证明、高水位、观察者边界与历史资源引用。四文件只新增中文模块、辅助函数和用例说明；去注释 AST 一致，822 项 Node 测试全部通过，git diff --check 通过。没有运行浏览器或构建验证。追加：恢复编码、日志与成功回执接纳（53905a4） - applied-recovery.test.mjs：已成功但本地等待接纳的请求，较新完整读取、显式重规划、落盘失败、取消与回执过期。 - recovery-encoding.test.mjs：JSON 规范化、所有权缓存、getter/toJSON/Proxy、协作式预算、深度限制与 UTF-8 计数。 - recovery-json.test.mjs：分块输出与原生 JSON 字节一致、外部值捕获、owner 丢失和宿主错误。 - recovery-views.test.mjs：不可变文档/表的编码复用、浅冻结外部数据重读及旧 image 隔离。 - journal-delta.test.mjs：日志补丁精确往返、体积、非法路径/超限拒绝及可复现的连续更新。本批五文件仅新增中文模块、辅助函数和用例注释；去注释 AST 一致，822 项 Node 测试全部通过，diff 检查通过。没有运行浏览器、数据库或构建验证。追加：结构恢复与历史 adoption（1a0d9cd） - structure-recovery.test.mjs：逐项说明 60 个用例，以及内存存储/简化服务端、几何比较、缩放树与成功回执证明辅助器。 - 说明分区/连线归属、世界坐标与 unitScale、删除恢复的身份代次、同组已确认/待处理历史、undo/redo 顺序与容量、连续恢复及证据损坏拒绝。 - 展开原单行 fixture 的端口方法并补充内部校验/发布顺序说明；没有修改执行逻辑或断言。去注释 AST 一致，822 项 Node 测试全部通过，git diff --check 通过。本文件采用内存端口，未执行真实浏览器/数据库或构建验证。追加：资源接纳、引用保留与共享存储（3cda36b） - asset-adoption.test.mjs：同步发布绑定/内容/历史、跨项目授权复用、落盘失败、迟到结果、文档导入及旧 Root 竞态。 - asset-depot.test.mjs：权限、缓存身份/字节校验、关闭隔离、二进制流预算及 authority 元数据版本。 - asset-service.test.mjs：冻结上传身份、成功回执、显示地址路由、未知结果与 multipart 请求头。 - import-file-retention.test.mjs：导入源文件归档、退休标记、generation 与 purge 身份保护。 - resource-pin-scan.test.mjs：working/ACK/history/显式引用、缓存边界及 registry 的资源字段。 - asset-adoption-browser-cases.mjs：真实 IDB 上跨项目接纳、重开、授权及关闭项目 pin。 - asset-depot-browser-cases.mjs：字节去重、作用域隔离、完整 manifest、回收/回滚与实际上传后的共享字节提升。 - depot-files-browser-cases.mjs：文件指针/MIME、DB 升级、资源独立回收及新接纳和旧提交竞态。本批仅注释与必要排版。八文件去注释 AST 一致，822 项 Node 测试通过，diff 检查通过。五个 Node 测试模块覆盖 28 用例，三份浏览器脚本含五个导出场景；浏览器场景未在本轮执行，也未进行构建。追加：项目资源生命周期与本地回收（7de9a3e） - resources.test.mjs：逐项说明 32 个用例、所有命名辅助函数以及内存存储/上传/文档服务端口。 - 覆盖默认尺寸 grant、用户 resize 撤权、解码元数据与显式 fitImage、文件与账本持久化屏障、上传未知/成功待接纳、图片替换及重开。 - 说明 working/history/ACK/任务/显示 pin、共享 reader/URL 生命周期、软退休宽限期、删除 reservation、删除失败重试及同步监听器重入 persist 的原子删除要求。本批仅新增中文注释，执行逻辑/断言不变；去注释 AST 一致，822 项 Node 测试通过，git diff --check 通过。此文件使用内存端口；未进行真实数据库、浏览器或构建验证。

codex-bot added 1 commit 2026-11-11 18:40:44 +00:00

docs(tests): explain paint bounds hit queries and scene caching 330d8d6e34

codex-bot added 1 commit 2026-11-11 18:43:57 +00:00

docs(tests): explain retained views resource handles and batch proofs c426e94b58

codex-bot changed title from ~~docs(tests): 说明绘制范围、命中与投影缓存测试~~ to docs(tests): 说明绘制、bindings 与批次证明测试

2026-11-11 18:44:07 +00:00

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

docs(tests): explain ledger scheduling replay and local elision 298f4b36c0

codex-bot changed title from ~~docs(tests): 说明绘制、bindings 与批次证明测试~~ to docs(tests): 说明绘制、同步调度与重放测试

2026-11-12 01:42:30 +00:00

codex-bot added 1 commit 2026-11-12 01:45:33 +00:00

docs(tests): explain recovery encoding journals and applied receipts 53905a4868