f3e21c6b98
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>
54 lines
3.3 KiB
Markdown
54 lines
3.3 KiB
Markdown
# CS13：主应用候选产物与实现交接
|
||
|
||
- queueTask: WBV2-P1424-001
|
||
- parentTask: WBV2-P1424-000
|
||
- packageStatus: planned
|
||
- dependsOn: CS06, CS07, CS09, CS10, CS11, CS12
|
||
- validation: NOT_RUN；acceptance: NOT_CLAIMED
|
||
|
||
## 业务与交付
|
||
|
||
App 主工作区 → WasmGPUCanvas/Worker → 匹配的 WebEngine WASM + compute Worker + Naga WASM
|
||
|
||
可供后续用户使用的完整本地主应用候选、构件 manifest 和实现报告；NOT_RUN / NOT_CLAIMED。
|
||
|
||
## 最小输入与源码依据
|
||
|
||
- `web/app/src/app/App.tsx`
|
||
- `web/app/src/app/WasmGPUCanvas.tsx`
|
||
- `web/app/src/workers/web-engine.worker.ts`
|
||
- `web/app/src/workers/gpu-compute.worker.ts`
|
||
- `blender-5.2.0/source/blender/web_engine/CMakeLists.txt`
|
||
- `tests/golden/WBV2-P1424-001/general-webgpu-compute-result.json`
|
||
|
||
- 历史候选 general-webgpu-compute-final 有 recorded JS/WASM 哈希，但不能据此证明它包含当前后续 native 接线。
|
||
- 当前实现阶段禁止运行浏览器、测试、类型/语法/上下文检查或证据审计。
|
||
|
||
## 实现步骤
|
||
|
||
1. 保留旧发布与候选；仅为生成本次一致产物执行受影响模块的增量编译和既有本地 packaging。
|
||
2. 候选同时包含 WebEngine JS/WASM、compute Worker、Naga WASM、协议、前端 loader 和必要隔离配置；避免使用只存在 build/bin 的模块。
|
||
3. 在构件生成时记录版本、接口版本和 SHA-256；这些是产物元数据，不作运行证据。复用历史产物前在所需范围核对来源，禁止重复全量构建。
|
||
4. 逐业务记录实现/未实现边界、source binding 增量、具体阻塞和下一修复动作；全部专项功能未完成就保持 in_progress。
|
||
5. 只完成本专项不触发全项目用户验证；全项目所有功能实现完成后才交 CS14。
|
||
|
||
## 失败边界
|
||
|
||
编译/打包 exit 0 不等于功能完成；不部署、不伪造 Chromium 证据，不改 parent/nextTask。
|
||
|
||
发生阻塞时记录具体业务、原生函数/create-info、producer/consumer 和下一修复动作；保留既有产物，继续无此依赖的实现卡，不用缺失证据作为实现阻塞。
|
||
|
||
## 延后的用户场景（当前不执行）
|
||
|
||
- 延后：Chromium 主入口加载匹配资源
|
||
- 曲线/Manager/Compositor/Python 各路由
|
||
- 无 WebGPU、隔离缺失、资源缺失的明确错误
|
||
|
||
没有在本次拆解中创建或运行测试 fixture。原生 shader、现有模板和真实业务数据是实现输入；需要新增用户使用 fixture 时在全项目实现完成后安排。
|
||
|
||
## 交接
|
||
|
||
每次报告填写：实际 workflow/route、源码函数与修改、仍未实现接口、产物元数据（仅生成时）、失败/no-mutation 策略、implementation 状态、validation=NOT_RUN、acceptance=NOT_CLAIMED、下一实现动作。记录 unitCount/verifiedUnits/unverifiedUnits/sourceTreeSha256 的来源；未绑定/未验证不增记覆盖。
|
||
|
||
执行约束：本卡属于 WBV2-P1424-001 / parent WBV2-P1424-000，nextTask=null 保持不变。全部功能实现前不执行测试、回归、冒烟、浏览器验收、类型/语法/上下文检查或证据审计。仅为产物生成进行必要增量编译。源码检索使用 tools/web/search-wbv2-batch-source.mjs 的精确 --source/--unit；GLSL fixture 只读取本卡列出的原文件。不加载完整专项规划、历史日志或源码 inventory。JS 仅承担浏览器 API/传输；几何算法仍使用 OCCT 出口，Three.js 仅显示。
|