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>
60 lines
3.4 KiB
Markdown
60 lines
3.4 KiB
Markdown
# DW14：节点编辑器、Geometry Nodes 与烘焙
|
||
|
||
- stage: `nodes-render`
|
||
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
|
||
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
|
||
- 完整交付依赖：DW09, DW11
|
||
- 工作量级：XL；不表示日期承诺
|
||
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`
|
||
|
||
## 优先复用的十多天成果
|
||
|
||
已有 NODE-GRAPH-AUTHORING、geometry node 协议和 MOD_nodes storage；保留原生 evaluator 所有权。
|
||
|
||
既有任务：`NODE-GRAPH-AUTHORING`（记录为 implemented）。按需读取一个任务结果的 summary/remaining/ownedPaths，不打开完整产品报告。
|
||
|
||
相关交接仅作按需引用：
|
||
|
||
- `tests/golden/WBV2-P1424-001/nodes-bake-storage-implementation.md`
|
||
|
||
先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。
|
||
|
||
## 操作者工作流与交付
|
||
|
||
节点编辑/分组 → 实时原生求值 → 几何/属性/实例输出 → 缓存/烘焙/保存
|
||
|
||
可创建和持续编辑的原生节点工作流，Geometry Nodes 求值、Spreadsheet、缓存和烘焙连贯。
|
||
|
||
## 最小生产入口
|
||
|
||
- `web/app/src/app/WasmShaderEditor.tsx`
|
||
- `web/protocol/geometry-node-commands.ts`
|
||
- `web/protocol/geometry-nodes.ts`
|
||
- `blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp`
|
||
- `blender-5.2.0/source/blender/modifiers/intern/MOD_nodes_storage.cc`
|
||
- `blender-5.2.0/source/blender/editors/space_node/space_node.cc`
|
||
- `blender-5.2.0/source/blender/editors/space_spreadsheet/space_spreadsheet.cc`
|
||
|
||
以上为聚焦入口，非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段；接入新 operator 时追加其具体原生文件，单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture；功能完成前不执行任何验证。
|
||
|
||
## 只补未完成部分
|
||
|
||
1. 先复用节点图编辑操作，补齐 add/delete/link/reroute/frame/group/interface、socket 类型转换、搜索、布局与跨图 context。
|
||
2. Geometry Nodes 原生注册/evaluator、fields/domains/attributes/instances、viewer 与 Spreadsheet 真实数据读取连通。
|
||
3. 几何节点涉及的几何算法统一 OCCT 出口，其余原生求值调度/数据语义不转为 JS 模拟。
|
||
4. 补齐 simulation/repeat 等本地源码已存在 zone、node group 依赖、modifier 输入和原生 bake storage。
|
||
5. 时间变化、拓扑/输入变化触发缓存失效；缓存文件和 pack/reopen 使用 DW06，不持久化 GPU handle。
|
||
6. 每类节点按源码逐批接入，Shader/Compositor 专有 evaluator 交 DW15/DW19，编辑器基础共享。
|
||
|
||
## 失败边界
|
||
|
||
仅保存节点图、只连 node socket 或只编译 storage 单元不能代表节点功能完成。
|
||
|
||
## 实现交接与后续使用
|
||
|
||
交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。
|
||
|
||
用户使用阶段的场景（现在不执行）：搭建实例化与属性节点组，用 Spreadsheet 查看真实结果，修改输入并烘焙时间相关输出。
|
||
|
||
每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。
|