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>
52 lines
3.0 KiB
Markdown
52 lines
3.0 KiB
Markdown
# DW30：整机资源、长任务与应用恢复
|
||
|
||
- stage: `integration-remainder`
|
||
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
|
||
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
|
||
- 完整交付依赖：DW06, DW16, DW18, DW22, DW24, DW27
|
||
- 工作量级：L；不表示日期承诺
|
||
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`
|
||
|
||
## 优先复用的十多天成果
|
||
|
||
已有 Worker lifecycle、内存预算、取消/进度、storage recovery 与 CS10/CS11。
|
||
|
||
先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。
|
||
|
||
## 操作者工作流与交付
|
||
|
||
打开较大项目 → 编辑/计算/播放/保存并行请求 → 中断/恢复 → 继续工作
|
||
|
||
跨功能的资源与恢复机制，支撑长时间日常使用；明确设备下限和恢复边界。
|
||
|
||
## 最小生产入口
|
||
|
||
- `web/app/src/workers/web-engine.worker.ts`
|
||
- `web/app/src/engine-client/WebEngineClient.ts`
|
||
- `web/app/src/engine-client/gpu-compute-host.ts`
|
||
- `web/app/src/workers/gpu-compute.worker.ts`
|
||
- `blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp`
|
||
- `web/protocol/web-engine.ts`
|
||
|
||
以上为聚焦入口，非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段；接入新 operator 时追加其具体原生文件，单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture；功能完成前不执行任何验证。
|
||
|
||
## 只补未完成部分
|
||
|
||
1. 复用已有 session/request/revision/owner generation，统一 native 引擎、Python、GPU、媒体与任务队列的取消及结果归属。
|
||
2. 按实际资源模型实现 WASM memory growth、线程/SharedArrayBuffer、job scheduling、有界 caches 与释放顺序。
|
||
3. 保证大工程打开、编辑、渲染/模拟、文件替换和恢复过程不丢最后 coherent 数据，不在主 UI 线程阻塞计算。
|
||
4. 断开服务/设备丢失/Worker 重启/存储配额不足的用户可恢复行为有实际代码，恢复不能重放有副作用的 operator。
|
||
5. 性能调优先复用本地已有能力和版本失效机制；实现阶段不跑 benchmark、冒烟或浏览器验证，资源成本记录为未测。
|
||
|
||
## 失败边界
|
||
|
||
不得以无限提高内存限额、吞异常或自动丢弃用户数据解决阻塞。
|
||
|
||
## 实现交接与后续使用
|
||
|
||
交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。
|
||
|
||
用户使用阶段的场景（现在不执行）：在长渲染/模拟期间取消操作、切换工程，再恢复上个项目继续编辑和保存。
|
||
|
||
每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。
|