# Upscale

本页对应 `src/anyimage/operators/upscale.py`。该模块读取扩展首选项中的模型与全局 AI 输入长边上限，检查当前 Image 是否可处理，再提交 4× 高清任务。

## 对应文件

```text
src/anyimage/
├── operators/
│   ├── upscale.py                 # Blender 入口、任务参数与结果替换
│   └── common/image_data.py            # 媒体输入准备与结果 Image 创建
└── server/
    ├── jobs/upscale.py            # 单图与多帧任务编排
    ├── media/resolution.py        # 共用长边限制与等比缩放
    ├── models/upscale.py          # 输入约束与 Alpha 合并
    └── models/onnx_upscale.py     # 分块 4× ONNX 推理
```

## 主流程

```mermaid
flowchart TD
    Empty["Image Empty"] --> Source["读取当前 Image"]
    Source --> Gate{"当前长边小于全局上限？"}
    Gate -- "否" --> Disabled["Upscale 置灰"]
    Gate -- "是" --> Prepare["准备媒体输入"]
    Prepare --> Job["upscale-image Job"]
    Job --> RGB["分块执行 4× RGB 推理"]
    Job --> Alpha["独立缩放 Alpha"]
    RGB --> Merge["合并 RGBA 结果"]
    Alpha --> Merge
    Merge --> Replace["导入并替换当前 Image"]
```

模型以 256×256 分块处理 RGB，并带入相邻上下文以减弱块边界；Alpha 不进入模型，使用 Lanczos 独立放大后合并为 RGBA。`max_input_size` 来自全局 **Maximum AI Input Size**，默认 `2048`。Operator 只允许当前 Image 长边小于该值时执行，因此正式流程不会预缩放输入，4× 输出长边小于上限的四倍。Server 仍保留相同上限作为任务边界。

菜单根据当前尺寸只显示预计的 4× 结果尺寸。结果通过与 Remove Background、Image Mask 和 Perspective 相同的 Image Empty 替换入口处理：原 Image 没有其他用户且未启用 Fake User 时，移除旧数据并让结果沿用原名；存在其他用户时保留原 Image，并只让当前 Empty 使用独立结果。结果不增加 Upscale 专属后缀，也不保存来源引用。后续 Upscale 与 Depth Plane 都读取当前 Image。模型与全局输入上限在每次执行时从 Preferences 读取，再写入可序列化的隐藏属性交给 Job。Provider 资源错误会释放当前 Upscale Session，并提示降低全局输入上限或改用 CPU。