Refactor and enhance SnapForm functionality

- Introduced MODEL_NUMBERS for better model indexing.
- Improved enum_items function to cache results and handle download status.
- Updated ActiveJob class to manage temporary input paths and added displacement_via property.
- Changed IMAGE_DEPTH_PROCESS_RES_METHOD from "lower_bound_resize" to "upper_bound_resize".
- Enhanced RunJob operator to include new properties and improved error messages.
- Modified panel layout for better user experience and added runtime installation checks.
- Updated SnapFormSettings to reflect new model properties and defaults.
- Added temporary input path management in runtime.
- Refined worker functions to improve error handling and messaging.
- Expanded tests to cover new functionality and ensure backward compatibility.
- Fixed packaging script to align with versioning conventions.

README.md

@@ -19,8 +19,8 @@
 - 使用一个导出类型下拉菜单和一个 `Export` 按钮
 - 只显示当前格式的专属参数；GLB 与 PLY 设置不会同时出现
 - Debug 的模型选项按格式过滤；PLY 只提供两个带 Gaussian head 的 Giant 模型
-- Debug 在模型选项同一行用勾选或警告图标表示下载状态，不显示状态文字、License 和
-  已完成任务的文件计数
+- Debug 与 Convert to Depth Plane 的模型选项直接显示下载状态；未下载模型带
+  `(Missing)`，已下载模型保持原名
 - 分别调用 DA3 的 `glb`、`gs_ply`、`depth_vis` 和 `mini_npz` exporter
 - Image Empty 右键菜单可直接运行 DA3，根据 `mini_npz` 深度生成面片
 - 使用浮点深度贴图、Simple Subdivision、Displace Modifier 和原图 Bump
@@ -29,6 +29,7 @@
 - Debug 导出完成后只打开对应 job 文件夹，不向当前 Blender 文件添加任何数据
 - 完整保留每次任务生成的所有官方文件
 - 安装、模型下载和推理均在后台子进程运行，状态栏实时显示阶段、百分比进度条与取消按钮
+- 后台任务运行时，Install、Download 和 Export 按钮保持原位置并变灰，任务完成后恢复
 
 ## 使用
 
@@ -44,21 +45,27 @@
 ## Image Empty 转深度面片
 
 1. 在 3D View 选中 `Object Type = Empty`、`Display As = Image` 的对象。
-2. 右键选择 `Convert to Depth Plane`，在对话框中选择 Model、Use Ray Pose、Process Resolution、Subdivision，
-   以及是否删除原 Image Empty。默认分辨率为 `1024`、Subdivision 为 `5`，并默认删除原对象。
-   Model 可选择 `DA3 Small`、`DA3 Base`、`DA3 Large 1.1`、`DA3 Giant 1.1` 或
-   `DA3 Nested Giant Large 1.1`，默认 `DA3 Base`；Use Ray Pose
-   默认开启。转换导出 `mini_npz`，使用前需要在 `Setup` 下载所选模型，并固定使用
-   `process_res_method="lower_bound_resize"`；设备和参考视图策略继续使用场景设置。
-3. 推理完成后会自动创建面片。面片几何先由 `mini_npz` 的相机内参与深度确定，再通过对象
-   Transform 匹配原 Image Empty 的可见尺寸、位置、旋转和 Offset。XY 拟合得到的统一倍率
-   同时应用于 Z 轴，使面片厚度与宽高按同一比例变化。开启 `Delete Original` 时，成功生成后
+2. 右键选择 `Convert to Depth Plane`，通过 `Depth from` 选择深度来源：
+   - `AI Generated`：显示 Model、Use Ray Pose 和 Resolution Scale。实际 Process Res 为图片长边像素数
+     乘以 Resolution Scale；范围为 `0.1–1.0`，默认 `0.5`。计算后的 Process Res 会直接显示在
+     `Resolution Scale (… px)` 标签中。
+     转换导出 `mini_npz`，使用前需要在
+     `Setup` 下载所选模型，并固定使用 `process_res_method="upper_bound_resize"`；设备和参考视图策略
+     继续使用场景设置。
+   - `Original`：直接把原图作为深度贴图，不显示估算参数，也不启动 Runtime 或要求源图片存在于磁盘。
+   `Original` 是默认深度来源。选择 `AI Generated` 时，其 Model、Use Ray Pose 和 Resolution Scale
+   参数会集中显示在独立边框中。两种模式始终显示 Displace via、Subdivision 与 Delete Original。
+   Displace via 可选 `Modifier`（默认）或 `Material`；
+   Subdivision 默认为 `5`，并默认删除原对象。
+3. AI Generated 完成后会自动创建面片。面片几何先由 `mini_npz` 的相机内参与深度确定，再通过对象
+   Transform 匹配原 Image Empty 的可见尺寸、位置、旋转和 Offset。Original 模式直接使用源 Empty
+   的可见尺寸、Offset 与 Transform。开启 `Delete Original` 时，成功生成后
    删除源 Empty。生成面片 Object 使用源 Empty 的原名；关闭 `Delete Original` 时不处理
    同名冲突，由 Blender 自动为生成面片追加编号。
 4. 短边分段数为 `2^Subdivision`，长边分段数根据图像宽高比取最接近的整数。例如高:宽为
    `2:3`、Subdivision 为 `1` 时，直接生成 `2×3` 个面；Subdivision 为 `3` 时生成
    `8×12` 个面。随后的 Simple Subdivision 修改器使用原生名称，Viewport Levels 固定为
-   `1`，Render Levels 固定为 `2`，不再随 Process Resolution 或 Subdivision 动态变化。
+   `1`，Render Levels 固定为 `2`，不再随 Resolution Scale 或 Subdivision 动态变化。
 
 所有任务使用统一的状态栏进度显示。变化中的阶段说明显示在右侧的紧凑进度条内部，取消按钮
 位于进度条右侧。Image Depth 的阶段包括 Runtime 启动、输入准备、模型加载、深度估算、缓存
@@ -86,12 +93,18 @@ Height    = sqrt(Area / Aspect)
 `snapform_camera_plane_height`，便于检查实际采用的
 参考深度和尺寸。
 
-Displace Modifier 的深度贴图使用 `Extension = Extend`。材质不再使用生成的深度图执行
-Displacement，其 `Strength` 固定为 `-1`、`Midlevel` 固定为 `1`；原始彩色贴图同时连接
+选择 `Modifier` 时，AI Generated 的 Displace Modifier 深度贴图使用 `Extension = Extend`，
+`Strength` 固定为 `-1`、`Midlevel` 固定为 `1`。Original 把原图指定给 Displace Texture，并设置
+`Texture Coordinates = UV`、`Midlevel = 0`；其余修改器设置保留 Blender 默认值。
+选择 `Material` 时，不创建 Displace Modifier；深度 Image Texture 的 Color 连接到 Displacement
+节点的 Height，再连接 Material Output 的 Displacement，并把材质 Surface Displacement 设置为
+`Displacement Only`。AI Generated 使用 `Midlevel = 1`、`Scale = -1`；Original 使用
+`Midlevel = 0`、`Scale = 1`，与对应修改器值一致。无论选择哪种呈现方式，原始彩色贴图都会连接
 Principled BSDF 的 `Base Color`，并通过
 `Bump.Height → Bump.Normal → Principled.Normal` 提供表面细节。Bump 的基础 Distance 为
 `0.001`，会乘以面片 Transform 的统一缩放倍率。原图 Color 还会经过 `Float Curve` 连接到
-Principled BSDF 的 `Roughness`，曲线两端输出分别为 `0.5` 和 `0.1`；材质 IOR 默认为 `1.2`。
+Principled BSDF 的 `Roughness`，曲线两端输出分别为 `0.5` 和 `0.1`；材质 IOR 保持
+Principled BSDF 默认值 `1.5`。
 
 这里的“原始距离”是 DA3 模型输出的尺度。普通 Small、Base、Large 和 Giant 模型的深度不应
 被解释为现实世界的米；需要现实尺度时应选择带 metric depth 的
@@ -99,15 +112,18 @@ Principled BSDF 的 `Roughness`，曲线两端输出分别为 `0.5` 和 `0.1`；
 相机内参逐像素反投影得到的完整 camera-space 网格；中位深度截面为现有 Displace Modifier
 工作流提供正确的整体高宽尺度。
 
-生成完成后会直接创建面片，不提供缓存重建入口或单独的导入参数。
-重新选择 `Convert to Depth Plane` 会再次运行 DA3。
+生成完成后会直接创建面片，不提供缓存重建入口或单独的导入参数。重新选择
+`Convert to Depth Plane` 会按当前 Depth from 再次转换。
 面片、深度 Image、Texture 与 Material 会在同一个 Blender Undo 步骤中创建；转换完成后执行
 `Ctrl+Z` 会完整撤销本次转换，不会越过转换去回退更早的 Image Empty 操作。
 
-当前转换入口要求 Image Empty 引用仍然存在的本地图像文件。DA3 的原始
+Image Empty 使用 Packed Image 时，SnapForm 会通过 Blender 写出临时 PNG 交给 DA3，
+不会 Unpack 或修改源 Image；任务结束后自动删除临时文件。普通图片仍直接读取源文件。DA3 的原始
 `results.npz` 保留在对应 job 的 `exports/mini_npz/` 中，生成的浮点深度 Image 会 Pack 到
-当前 `.blend`。源 Empty 名为 `img` 时，深度 Image 与 Displace Texture 都命名为
-`img.depth`。Pack 使用 OpenEXR，因而不会把大于 `1.0` 的原始深度截断。
+当前 `.blend`。Depth Image 与 Displace Texture 根据源 Image datablock 命名。例如 Empty Object
+名为 `obj_img`、引用的 Image 名为 `img.png` 时，Depth Image 与 Texture 都命名为 `img.depth`；
+生成的 Object、Mesh 与 Material 仍命名为 `obj_img`。Pack 使用 OpenEXR，因而不会把大于 `1.0`
+的原始深度截断。已有同名 datablock 时由 Blender 自动追加 `.001` 等编号。
 
 选择 PLY 后，模型菜单只会提供 `DA3 Giant 1.1` 和
 `DA3 Nested Giant Large 1.1`。Small、Base 和 Large 没有 Gaussian head，无法由
@@ -145,7 +161,7 @@ CC BY-NC 4.0，仅限非商业用途。
 `gs_views_interval` 仅在选择 `PLY (3DGS)` 时显示：
 
 - `process_res=1024`
-- `process_res_method="lower_bound_resize"`
+- `process_res_method="upper_bound_resize"`
 - `use_ray_pose=False`
 - `ref_view_strategy="saddle_balanced"`
 - `conf_thresh_percentile=40.0`