nan
938d95db0f
- Implemented a preview tool for rectifying images with interactive aspect controls in `preview.py`. - Added tests for depth metadata loading to ensure consistent schema usage in `test_depth_metadata.py`. - Developed comprehensive tests for cutout calibration processes in `test_cutout_calibration.py`, including stability checks and depth calibration. - Created tests for frame compositing operations in `test_frame_compositing.py`, ensuring correct handling of depth and transparency. - Introduced material slot inheritance functionality in `material_slots.py` to manage geometry material assignments. - Built shared shader nodes for material processing in `shader.py`, including roughness and bump mapping setups.
2.2 KiB
2.2 KiB
Job Runtime 与 Server
runtime.py 配置 BlendJob JobRuntime 和独立 Python 3.12 Environment。server/app.py 注册 Job，model_manager.py 管理模型文件与缓存 Session。
flowchart TD
A[Operator request] --> B[JobRuntime 队列]
B --> C[Server Job 调用媒体与模型模块]
C --> D[写入 Job 目录]
D --> E[主线程 response 导入结果]
| Job | 实现与用途 |
|---|---|
download-model、download-required-models |
app.py 下载单个或缺失模型 |
remove-background |
jobs/remove_background.py 生成前景 Alpha |
upscale-image |
jobs/upscale.py 生成 2× 图像或序列 |
generate-depth-plane-geometry |
jobs/depth_plane.py 生成深度、元数据和法线 |
generate-cutout-artifacts |
jobs/cutout.py 按请求生成深度和法线 |
generate-panorama-geometry |
jobs/panorama.py 生成全景径向深度 |
media/ 展开单图、序列与视频，并限制分析尺寸。Job 在阶段与帧边界检查取消，通过 context.progress() 返回进度。媒体上下文清理抽取的临时帧，Operator 清理 Blender 导出的临时输入。
geometry/prediction_artifacts.py 缩放源 RGB 后运行一次 MoGe，将同一预测交给深度、法线和元数据写入器。源 Alpha 用于产物有效性和参考深度采样。文件协议见 Job 产物。
模型与缓存
| 用途 | 模型 | Session 分类 |
|---|---|---|
| Depth 与 Normal | MoGe-2 ViT-S / ViT-B Normal、MoGe-3 ViT-L | geometry |
| Remove Background | BiRefNet Lite、BEN2、BiRefNet HR Matting | background |
| Upscale | Real-ESRGAN WDN、Real-ESRGAN x4plus、HAT GAN x4 Sharper | upscale |
model_catalog.py 声明文件来源、许可、大小和 SHA-256；model_download.py 下载并校验。ModelManager 按模型路径和设备缓存 Session，切换模型或设备时释放对应类别。Clear Models 或关闭 Server 时释放已加载资源。
首次安装通过 post_install() 下载默认 MoGe-2、BiRefNet Lite 与 Real-ESRGAN WDN。Storage Root 默认 ~/.anyimage，保存环境、模型、Job 产物和日志。设置入口见 AI 环境管理。