feat: Implement upscale functionality with ONNX models

- Added upscale operator to handle image upscaling by 4x using AI models.
- Introduced new jobs for upscale processing in the server, including debug and standard upscale jobs.
- Created a new ONNX model handler for upscale operations, supporting tiled inference and resource management.
- Updated tests to cover new upscale functionality, including input validation and output verification.
- Added documentation for the upscale feature, detailing usage and model options.

docs/models-and-storage.md

@@ -8,14 +8,16 @@ AnyImage 把运行环境、模型和任务结果放在 Blender 之外，多个 B
 
 - **Ready** 表示模型文件已经就绪。
 - **Download** 用于按需下载模型。
-- 默认安装会准备 MoGe-2 ViT-S Normal 和 BEN2 Base。
-- DA3、更大的 MoGe-2，以及只供 Debug 使用的 Real-ESRGAN General x4v3 需要时再下载即可。
+- 默认安装会准备 MoGe-2 ViT-S Normal、BEN2 Base 和 Real-ESRGAN General WDN x4v3。
+- DA3、更大的 MoGe-2，以及可选的 SAFMN Real x4、Real-ESRGAN x4plus 需要时再下载即可。
+- 可公开取得的 ONNX 制品使用经过大小与 SHA-256 校验的原址，并以 OmooLab R2 为镜像；不会把源码仓库名称推测成 Hugging Face 下载地址。
+- Real-ESRGAN General WDN x4v3 与 SAFMN Real x4 的上游只发布 PyTorch 权重，当前 ONNX 均从官方权重导出并仅从 R2 下载。
 
 较大的模型不一定适合所有图片。建议先用默认模型完成构图，再针对细节与性能需求比较其他模型。
 
 ## Device
 
-扩展偏好设置中的 **Device** 控制 Depth Plane、Surface 和 Remove Background 等正式任务。
+扩展偏好设置中的 **Device** 控制 Depth Plane、Surface、Remove Background 和 Upscale 等正式任务。
 
 - Windows 通常优先使用 DirectML。
 - Apple Silicon macOS 通常优先使用 CoreML。
@@ -23,6 +25,10 @@ AnyImage 把运行环境、模型和任务结果放在 Blender 之外，多个 B
 
 Debug 面板中的 **Debug Device** 只影响 Debug 任务，不会覆盖正式任务的 Device。
 
+## Session 缓存
+
+连续使用同一模型和 Device 时，Server 会复用已经加载的 ONNX Session。切换到 BEN2、深度或高清等另一模型族时，旧 Session 会被释放，因此 Server 最多保留当前使用的一套模型；如果高清推理遇到 provider 资源错误，也会立即卸载该 Session。这样保留连续操作的速度，同时避免多个模型长期占用显存或系统内存。
+
 ## Storage Root
 
 默认 Storage Root 是 `~/.anyimage`，主要包含：
@@ -31,9 +37,9 @@ Debug 面板中的 **Debug Device** 只影响 Debug 任务，不会覆盖正式
 ~/.anyimage/
 ├── .venv/           # 独立 Python Environment
 ├── models/          # 模型文件
-├── jobs/            # 每次任务的结果
+├── jobs/            # 每次任务的结果与 job.log
 ├── install.log      # Environment 安装日志
-└── server.log       # Job Server 日志
+└── server.log       # 带 Job ID 的任务主线与 Job Server 日志
 ```
 
 更改 Storage Root 相当于切换到另一套环境、模型和任务数据。AnyImage 不会自动移动旧目录。
@@ -48,6 +54,7 @@ Debug 面板中的 **Debug Device** 只影响 Debug 任务，不会覆盖正式
 
 遇到安装或 Server 问题时：
 
-- 在扩展偏好设置中点击 **Open Server Log** 查看运行日志。
+- 在扩展偏好设置中点击 **Open Server Log** 查看带时间、Job ID 与 Job Type 的运行主线。
+- 具体 Job 的 Handler 细节和完整 traceback 查看 `jobs/<job-id>/job.log`。
 - Environment 安装问题查看 Storage Root 下的 `install.log`。
 - 修改 Storage Root 后，确认你检查的是当前目录中的日志。