# N-013 Shader Node 图

状态：`in_progress（七节点 Main + 常量 PBR 映射子集）`

详细分解、ShaderIR、typed socket 校验、Main 写回、Web 编译、GLB 映射和验收命令见
[`docs/UNDECLARED_CAPABILITIES_EXECUTION_PLAN.md`](../UNDECLARED_CAPABILITIES_EXECUTION_PLAN.md)。

本轮已交付版本化 `ShaderGraphIR`、单 Material Output、typed socket/隐式转换、图循环、
Material/Image stable ID 以及 linked/missing/corrupt image 资源门。首个 native Main 写回
子集开放 RGB、Value、有限 Math、Principled、Image Texture、Normal Map 和 Material
Output；整图替换在一个 history transaction 中完成，并通过节点/链接及 RGB/Value
defaultValue 保存重开回归。

Math 已开放 ADD/SUBTRACT/MULTIPLY/DIVIDE/MINIMUM/MAXIMUM 的 Main `custom1` 写回和
operation 保存重开；其他运算继续结构化阻断。RGB/Value 到 Principled Base Color、
Roughness、Metallic 的有限常量链接现可确定性映射为 glTF PBR factor；缺值、越界、
重复输入和未知链接继续返回 `SHADER_GRAPH_UNMAPPABLE`。Mix、Mapping、Texture
Coordinate、Bump 及任意节点仍返回 `SHADER_NODE_UNSUPPORTED`。node properties 仅开放
Math operation；受限 Web 编译、完整色彩管理、完整 GLB 图映射和桌面渲染 golden 仍为 planned。
验收：`npm --prefix web run test:authoring-roundtrip`、`npm --prefix web run test:capability-gates`
以及 Shader GLB mapping E2E。