workinf_Blender_Wasm/docs/status/N-020.md

N-020 Compositor

状态：BLOCKED（GraphIR、有界 CPU executor 与真实 Main graph 结构 reader 已落地；完整节点 参数映射、WebGPU、HDR golden 和服务端执行未实现）

已验证切片

1. N-020-A：版本化 CompositorGraphIR 覆盖 Image、Render Layer、Constant Color、 Transform、Invert、Exposure、Alpha Over、Blur、Mix、Viewer、Composite 与 Unsupported； 节点/资源 ID、重复 input socket、缺失引用和 graph cycle 会拒绝。
2. N-020-B（CPU 子集）：线性 sRGB Float32 RGBA executor 按拓扑序执行 Transform、颜色、 Alpha Over、Blur、Mix，并返回 Composite 与多 Viewer 输出。
3. N-020-C（部分）：最大 4096 nodes、16384 links、4096 resources、8192 dimension、 16M pixels、256 MiB image 和 100M blur operations；分配前检查，支持 worker cancellation。
4. N-020-D（门）：Unsupported node 保留 Blender type metadata，并返回 COMPOSITOR_NODE_UNSUPPORTED，不会删节点后继续运行。
5. N-020-A（部分）：Blender 5.2 Scene compositing_node_group 从真实 Main 快照读取稳定 node identifier、socket identifier 和 link；活动 Group Output/旧 Composite 映射为 Composite， Viewer 和常量 RGBA 映射到已验证节点，其他节点原样保留 blenderType 为 Unsupported。 4096 nodes/16384 links、重复 destination、缺 output 或不可读 node tree 返回 blocked status。
6. N-020-C（部分）：CPU executor 在长像素/blur 循环中周期检查 cancellation，不再只在节点 边界取消；内容寻址 frame key 绑定规范化 GraphIR、资源 Float32 内容 SHA-256、frame 和输出 尺寸。有界 LRU cache 以克隆后的真实 buffer 字节计费（最多 256 MiB），命中返回隔离副本， 调用方修改结果不会污染缓存。它是内存帧缓存，不等同于 tile scheduler 或 OPFS 持久缓存。
7. N-020-A/B（真实参数链）：Blender 5.2 Main reader 从真实 socket default 读取 Exposure，并仅在 factor=1、invert color=true、invert alpha=false 时把 Invert 映射到当前 CPU 精确子集；Group Output 的动态 Socket_0 规范化为 GraphIR Image。桌面生成 fixture 经 WASM/Worker 后直接由 CPU executor 求值 Constant→Exposure→Invert→Composite，RGBA 结果通过；未连接的 Glare 仍保留 Unsupported 并使完整图 capability gate 保持阻断。

仍然阻断

• N-020-A：Main graph 写回，以及 Transform、非默认 Invert、Alpha Over、Blur、Mix、Image/Render Layer 的逐节点参数与 resource/pass reader；基础真实图结构、常量色、Exposure、默认 Invert、 Viewer/Composite 已完成。
• N-020-B/C：WebGPU executor、tile scheduler、OPFS 持久 frame cache、增量 invalidation 和 GPU dispose；CPU 周期取消和内容寻址内存 LRU 已完成。
• N-020-D：服务端 Blender job、source hash 和结果提交。
• N-020-E：desktop HDR/alpha/color-space golden、OOM/fault/device-loss。

验收

WEB_TEST_PORT=5320 npm --prefix web run test:e2e -- --grep "N-020 CPU compositor"
npm --prefix web run test:compositor-main-reader