feat(node_assets): add image plane geometry nodes and validation scripts

- Implemented `image_plane.py` to build the Image Plane Geometry Nodes group with customizable parameters for geometry, subdivide, and thickness.
- Created `image_plane_validation.py` to validate the functionality of the image plane, ensuring correct geometry generation and material assignment.
- Developed `material_layers.py` to construct shader node groups for image materials, including depth and normal handling.
- Authored `plane_layouts.py` to define node arrangements for image geometry assets.
- Introduced `shadeless.py` to create a shadeless shader node group that displays color without scene lighting while preserving shadows and reflections.

docs/internals/operators/upscale.md

@@ -1,44 +1,21 @@
 # Upscale
 
-Upscale 从当前 Image Empty 读取单图或多帧媒体，在输入长边允许时生成 4× RGBA 结果并替换原图。
-
-## 执行过程
+`operators/upscale.py` 从当前 Image Empty 生成 2× 结果并替换原图，支持单图、视频与序列帧。
 
 ```mermaid
 flowchart TD
-    Empty["Image Empty"] --> Gate{"长边小于输入上限？"}
-    Gate -- "否" --> Disabled["禁用或报告错误"]
-    Gate -- "是" --> Prepare["准备媒体输入"]
-    Prepare --> Job["upscale-image Job"]
-    Job --> RGB["分块执行 4× RGB 推理"]
-    Job --> Alpha["独立缩放 Alpha"]
-    RGB --> Merge["合并 RGBA"]
-    Alpha --> Merge
-    Merge --> Replace["导入并替换当前 Image"]
+    A[检查源图长边小于 AI 输入上限] --> B[冻结 Preferences 模型与尺寸设置]
+    B --> C[准备媒体输入]
+    C --> D[upscale-image 逐帧处理]
+    D --> E{所选模型}
+    E -- Real-ESRGAN 或 SAFMN --> F[256×256 tile 与边缘上下文执行 4× RGB 推理]
+    E -- PiSA-SR --> G[分阶段生成推理，细节强度 0.7]
+    F --> H[统一缩放到源图 2×]
+    G --> H
+    H --> I[原 Alpha 独立 Lanczos 缩放并回填]
+    I --> J[写出 upscale 序列并替换 Image]
 ```
 
-模型只处理 RGB，Alpha 单独放大后再合并。Blender 侧在提交前检查 **Maximum AI Input Size**，Server 模型层也应用同一个输入上限。
+`server/models/upscale.py` 统一处理输入上限、模型分派和最终 RGB/Alpha 尺寸。`onnx_upscale.py` 处理常规 4× 模型，`onnx_pisa_sr.py` 处理 PiSA-SR。多帧与多 tile 只在最后一次运行请求内存收缩。
 
-## 节点说明
-
-### 检查尺寸并准备输入
-
-入口位于 `operators/upscale.py`。`UpscaleImage.poll()` 读取 `preferences.py` 中的 **Maximum AI Input Size**；当前 Image 长边必须严格小于该值。菜单显示的预计尺寸来自同一文件的 `upscale_output_size()`。
-
-执行时，`upscale.py` 冻结当前模型和输入上限，并通过 `common/image.py` 准备单图、视频或序列输入。Packed Image 与内存修改结果会导出临时文件，多帧输入保留帧起点和抽帧设置。
-
-### 分块放大 RGB
-
-`UpscaleImage` 提交 `upscale-image` Job。`server/jobs/upscale.py` 展开媒体帧并逐帧调用模型；`server/models/upscale.py` 负责输入约束、RGB/Alpha 分离和结果合并，`server/models/onnx_upscale.py` 以 256 × 256 分块执行 4× ONNX 推理并带入相邻上下文。
-
-`server/media/resolution.py` 统一解释输入长边上限。Blender 侧要求源图长边小于该值，结果长边小于该值的四倍。
-
-### 合并 Alpha
-
-`server/models/upscale.py` 使用 Lanczos 将 Alpha 放大到目标尺寸，再与 4× RGB 合并为 RGBA。Provider 资源不足时，Server 释放当前 Upscale Session，并返回降低输入上限或改用 CPU 的提示。
-
-### 导入并替换结果
-
-响应阶段回到 `operators/upscale.py`，通过 `common/image.py` 读取 `upscale.*` 结果序列并替换当前 Empty。
-
-后续 Upscale 和 Depth Plane 都以当前结果 Image 为输入。
+Provider 资源错误会释放当前 Upscale Session，并返回降低输入上限或切换 CPU 的提示。响应通过 `common/image.py` 加载、Pack、保留图像共享与帧设置，并提交 Undo。