docs: 完善画布注释并复核核心数据边界 #11

2026-11-12T03:30:01Z

codex-bot commented

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

浏览器场景、旧画布测试和样式/配置缺少足够的流程说明，容易把内存替身或静态断言误读成真实后端、原生布局或完整产品验收。本 PR 补充中文模块、辅助函数、场景和逻辑块说明，标明状态归属、竞态、清理与证据边界。

改动范围：

core 数据边界复核：修订 data-containers、json-data、element-data、values、document、registry 六模块的来源证明、浅冻结、schema/墓碑校验、field 回放范围和迁移共享引用说明。
浏览器存储场景：共享字节回收、引用清单、导入恢复与加载屏障等段落。
页面集成场景：装配与代理替身、原生手势、恢复、AI、资源/导入、保留渲染和失效回调等流程。
根目录 13 个单测及六个场景/执行入口：旧快照历史/同步、目录/workspace、资源与图标、HTTP smoke、JSDOM、成员迁移、上传和反馈。
全部七个 CSS 文件：布局、交互命中、状态层、响应式、动画与同名选择器的后置覆盖。
README、环境模板和忽略规则：解释包/TS/组件生成器配置、headless 输出入口、严格 JSON 的字段与生成链路；在图标生成器和服务单测使用处增加数据旁注。

验证：

各批次修改的 TS/JS AST 对比一致；六个根场景入口的 node --check 通过。
七个 CSS 文件的 PostCSS 解析树（排除注释）一致，规则、声明和值及顺序未改。
根目录单测 84/84、服务适配器单测 14/14 通过；核心/元素校验/JSON 隔离/条件回放相关单测 37/37 通过。
106 个跟踪 JSON 均可解析且保持原字节；环境模板的赋值与 gitignore 的有效规则不变。
git diff --check 通过。未为这些注释批次重跑浏览器场景、Next 服务、构建或后端集成。

只修改注释与阅读说明，没有实现行为变更。项目注释任务已完成各目录首轮说明，第五阶段已完成上述六个 core 数据模块的逐函数复核，其余模块准确性与细粒度覆盖审查仍在进行；本 PR 不宣称整个任务完成。目标 main，等待用户手动合并。

浏览器场景、旧画布测试和样式/配置缺少足够的流程说明，容易把内存替身或静态断言误读成真实后端、原生布局或完整产品验收。本 PR 补充中文模块、辅助函数、场景和逻辑块说明，标明状态归属、竞态、清理与证据边界。改动范围： - core 数据边界复核：修订 data-containers、json-data、element-data、values、document、registry 六模块的来源证明、浅冻结、schema/墓碑校验、field 回放范围和迁移共享引用说明。 - 浏览器存储场景：共享字节回收、引用清单、导入恢复与加载屏障等段落。 - 页面集成场景：装配与代理替身、原生手势、恢复、AI、资源/导入、保留渲染和失效回调等流程。 - 根目录 13 个单测及六个场景/执行入口：旧快照历史/同步、目录/workspace、资源与图标、HTTP smoke、JSDOM、成员迁移、上传和反馈。 - 全部七个 CSS 文件：布局、交互命中、状态层、响应式、动画与同名选择器的后置覆盖。 - README、环境模板和忽略规则：解释包/TS/组件生成器配置、headless 输出入口、严格 JSON 的字段与生成链路；在图标生成器和服务单测使用处增加数据旁注。验证： - 各批次修改的 TS/JS AST 对比一致；六个根场景入口的 node --check 通过。 - 七个 CSS 文件的 PostCSS 解析树（排除注释）一致，规则、声明和值及顺序未改。 - 根目录单测 84/84、服务适配器单测 14/14 通过；核心/元素校验/JSON 隔离/条件回放相关单测 37/37 通过。 - 106 个跟踪 JSON 均可解析且保持原字节；环境模板的赋值与 gitignore 的有效规则不变。 - git diff --check 通过。未为这些注释批次重跑浏览器场景、Next 服务、构建或后端集成。只修改注释与阅读说明，没有实现行为变更。项目注释任务已完成各目录首轮说明，第五阶段已完成上述六个 core 数据模块的逐函数复核，其余模块准确性与细粒度覆盖审查仍在进行；本 PR 不宣称整个任务完成。目标 main，等待用户手动合并。

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

docs(tests): explain storage collection import recovery and loading barriers bd728d2d94

codex-bot added 1 commit 2026-11-12 03:36:49 +00:00

docs(tests): explain renderer fixture setup proxy routes and native gestures 50675ffed3

codex-bot changed title from ~~docs(tests): 说明浏览器存储回收、导入与加载恢复~~ to docs(tests): 说明浏览器存储与页面集成场景

2026-11-12 03:37:09 +00:00

codex-bot added 1 commit 2026-11-12 03:43:41 +00:00

docs(tests): explain renderer recovery AI import and retained ownership flows 6ad003eb37

codex-bot added 1 commit 2026-11-12 03:51:21 +00:00

docs(tests): explain legacy canvas and workspace unit coverage 412e31e898

codex-bot added 1 commit 2026-11-12 03:57:09 +00:00

docs(tests): explain legacy canvas scenario setup and recovery flows 2a0b6bb9d9