Files
workinf_Blender_Wasm/docs/tasks/WBV2-P1424-001-desktop-completion/DW31.md
mes123456 f3e21c6b98
Some checks failed
M6 deployable RC / quick (push) Has been cancelled
M6 deployable RC / chromium (push) Has been cancelled
M6 deployable RC / release (push) Has been cancelled
chore: checkpoint web Blender migration source, tools and docs
Accumulated uncommitted work: GHOST Web backend, WebGL/GPU web layer,
web workflow engine and protocol, tooling, docs and task records.
Large generated evidence, user-testing archives, build snapshots and
imported test assets remain untracked.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-11-10 11:18:01 +08:00

3.9 KiB
Raw Blame History

DW31:完整主应用候选、操作手册与交付

  • stage: integration-remainder
  • queueTask: WBV2-P1424-001;parent: WBV2-P1424-000;nextTask: null
  • 包状态:planned_gap_closure(并不表示已有源码尚未实现)
  • 完整交付依赖:DW29, DW30
  • 工作量级:L;不表示日期承诺
  • validation: NOT_RUN;acceptance: NOT_CLAIMED

优先复用的十多天成果

保留所有已有本地候选、已发布资源和构件记录;优先以 cycle 157 及后续已交接增量为基础。

相关交接仅作按需引用:

  • tests/golden/WBV2-P1424-001/unattended-implementation/cycle-000157/result.json

先对照当前小范围源码和最新交接保留已实现子项;只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。

操作者工作流与交付

一个明确主入口 → 匹配的界面/原生引擎/资源 → 完整操作工作流 → 用户交付

可由操作者实际使用的完整主应用候选与使用说明、源版本/构件对应关系;验证仍未声明通过。

最小生产入口

  • web/app/src/main.tsx
  • web/app/src/app/App.tsx
  • web/app/src/workers/web-engine.worker.ts
  • blender-5.2.0/source/blender/web_engine/CMakeLists.txt
  • tests/golden/WBV2-P1424-001/desktop-delivery-manifest.json
  • tests/golden/WBV2-P1424-001/desktop-completion-manifest.json

以上为聚焦入口,非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段;接入新 operator 时追加其具体原生文件,单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture;功能完成前不执行任何验证。

只补未完成部分

  1. 各包已持续维护生产接线和必要候选;本包收敛为一套匹配 frontend/Worker/protocol/WebEngine/Python/Naga/OCCT/startup/fonts/media 资源的应用交付。
  2. 以实际 source/package/interface 版本决定复用或必要增量重编译,构件生成时记录 SHA-256 和来源;保留旧版本,避免重复全量 build。
  3. 主入口、loader URL、cross-origin isolation、Worker/WASM MIME 与本地离线资源包形成实际配置,不仅交付 build/bin 内一个 WASM。
  4. 操作手册按工程/建模/材质渲染/动画/模拟/媒体/脚本任务编排,写清保存、资源管理、取消/恢复与平台等价行为,不把内部技术细节塞给用户。
  5. 每一功能族的实现剩余、占位、无 producer/consumer、必要辅助服务依赖均完成处理后,才记录 implementation_complete_unverified。
  6. 交付记录接受条件为所有实际功能实现已闭合,非“31 张卡都写报告”;build/package 成功不能自动认定实现完成或验证通过。
  7. 用户使用阶段由 USER01 承接;只生成本地候选,不在计划阶段部署或发布。

compute 专项引用:CS13。卡位于 docs/tasks/WBV2-P1424-001-compute-ssbo/;一次只读当前一张,既有实现不重复,状态依据后续真实交接更新。CS09 在 DW19 负责消费者,CS12 在 DW26 负责原生 Python 入口,CS13/CS14 分别归 DW31/USER01;不要另起平行路线。

失败边界

任一未解决的功能缺口仍保持 in_progress;不能用“稍后测试会发现”掩盖已知未实现项。

实现交接与后续使用

交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件,不运行验收;编译成功不能替代功能。旧的已完成子项可引用并保留,不能声称本轮重新实现。

用户使用阶段的场景(现在不执行):用户按同一手册从启动到保存与交付输出完成全部业务,无需手动拼装多个候选。

每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 EXECUTION.md,首次领取时阅读;不要将完整计划作为后续执行上下文。