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>
3.4 KiB
DW19:合成节点与图像结果工作流
- stage:
nodes-render - queueTask:
WBV2-P1424-001;parent:WBV2-P1424-000;nextTask:null - 包状态:
planned_gap_closure(并不表示已有源码尚未实现) - 完整交付依赖:DW14, DW15, DW16
- 工作量级:L;不表示日期承诺
- validation:
NOT_RUN;acceptance:NOT_CLAIMED
优先复用的十多天成果
COMPOSITOR 模块和 shader_operation/utilities/result 原生入口已有;复用 CS09。
既有任务:SEQUENCER-COMPOSITOR-COVERAGE(记录为 implemented)。按需读取一个任务结果的 summary/remaining/ownedPaths,不打开完整产品报告。
先对照当前小范围源码和最新交接保留已实现子项;只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。
操作者工作流与交付
输入渲染/图像 → 原生合成节点树 → Viewer/图像编辑器 → 文件输出
原生合成节点实际求值,用户在 Viewer/图像编辑器看到并保存结果。
最小生产入口
web/protocol/compositor-commands.tsblender-5.2.0/source/blender/compositor/intern/shader_operation.ccblender-5.2.0/source/blender/compositor/intern/utilities.ccblender-5.2.0/source/blender/compositor/intern/result.ccweb/app/src/app/WasmImageView.tsxblender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp
以上为聚焦入口,非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段;接入新 operator 时追加其具体原生文件,单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture;功能完成前不执行任何验证。
只补未完成部分
- 复用 DW14 节点编辑器,按原生节点 family 补齐颜色、滤镜、变换、mask/keying、通道和多输入类型。
- CS09 从已注册真实节点开始完成 ShaderOperation→compute→Result→Viewer;逐家族扩展,CPU/WASM 原生节点保留真实原实现。
- domain/data_size、单值/图像、边界像素、alpha/color space、precision 和多 pass 中间结果保持原语义。
- 渲染层/序列输入、时间变化、group 和 file output 支持缓存失效与依赖更新。
- 取消、参数变更、节点树切换不发布过时图像;保存节点树与外部结果,各资源生命周期清晰。
compute 专项引用:CS09。卡位于 docs/tasks/WBV2-P1424-001-compute-ssbo/;一次只读当前一张,既有实现不重复,状态依据后续真实交接更新。CS09 在 DW19 负责消费者,CS12 在 DW26 负责原生 Python 入口,CS13/CS14 分别归 DW31/USER01;不要另起平行路线。
失败边界
保存图结构、显示输入图或执行独立示例 shader 都不能当 compositor 完成。
实现交接与后续使用
交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件,不运行验收;编译成功不能替代功能。旧的已完成子项可引用并保留,不能声称本轮重新实现。
用户使用阶段的场景(现在不执行):对渲染图做调色、滤镜与遮罩合成,改变节点参数后保存结果与节点工程。
每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 EXECUTION.md,首次领取时阅读;不要将完整计划作为后续执行上下文。