Add unit tests for service functionality and model caching

- Implement tests for ben2 and da3 model caching to ensure models are reused for matching runtime keys.
- Verify service state management, including client registration, job cancellation, and client expiration.
- Test discovery file creation and removal based on service ownership.
- Ensure frame extraction functionality works without models and produces expected results.

docs/technical.md

@@ -5,24 +5,24 @@
 
 `SnapForm` 是一套从图片快速构建空间结构的 Blender Extension。目前以
 [Depth Anything 3](https://github.com/ByteDance-Seed/Depth-Anything-3)
-作为首个 AI 能力，在独立 Backend Environment 中运行 DA3，可将官方导出结果保存在独立 job 目录，
+作为首个 AI 能力，在独立 Environment 中运行 DA3，可将官方导出结果保存在独立 job 目录，
 也可把 Image Empty 转换成带几何与材质置换的立体面片。Debug 面板还可运行
 [BEN2](https://github.com/PramaLLC/BEN2) 背景剔除功能测试。
 
 ## 当前功能
 
 - 使用 Blender Extension manifest，可通过 `Install from Disk` 安装
-- 在独立 Backend Environment 中通过常驻 Backend Service 运行 Torch、DA3 与 BEN2，避免污染 Blender Python 进程
-- Blender 使用内置 `urllib.request` 访问仅监听 `127.0.0.1` 的 Backend Service；请求带随机 Token
-- 常驻 Backend Service 复用 Torch、CUDA、BEN2 与最近使用的 DA3 模型，连续执行时不再重复加载
-- 多个 Blender 实例自动连接同一个共享 Backend Service；`AI Backend` 面板显示状态、端口、客户端与模型缓存，并提供安装、启动、清理、重启和停止控制
-- Backend Environment、模型和任务结果默认保存在 `~/.snapform`，可由多个 Blender 版本共享
+- 在独立 Environment 中通过常驻 Service 运行 Torch、DA3 与 BEN2，避免污染 Blender Python 进程
+- Blender 使用内置 `urllib.request` 访问仅监听 `127.0.0.1` 的 Service；请求带随机 Token
+- 常驻 Service 复用 Torch、CUDA、BEN2 与最近使用的 DA3 模型，连续执行时不再重复加载
+- 多个 Blender 实例自动连接同一个共享 Service；`AI Service` 面板显示状态、端口、客户端与模型缓存，并提供安装、启动、清理、重启和停止控制
+- Environment、模型和任务结果默认保存在 `~/.snapform`，可由多个 Blender 版本共享
 - 支持 DA3 Small、Base、Large 1.1、Giant 1.1 和 Nested Giant Large 1.1
 - 支持 BEN2 Base 单图背景剔除测试，输出透明 PNG 与推理耗时
 - 支持单张 JPG、JPEG、PNG、WEBP 图片或常见视频文件输入
 - 视频按顺序截取前若干帧，可设置参与重建的最大帧数
-- `AI Backend > Models` 默认折叠，展开后可逐项查看和下载所有可用模型
-- Backend Environment 已就绪时不额外占用面板空间；模型列表每个模型只占一行
+- `Models` panel 默认折叠，展开后可逐项查看和下载所有可用模型
+- Environment 已安装时不额外占用面板空间；模型列表每个模型只占一行
 - `Debug` 默认折叠，内部的 `DA3 Output Test` 与 `BEN2 Removal Test` 也分别默认折叠
 - 使用一个输出类型下拉菜单和一个 `Generate Output` 按钮
 - 只显示当前格式的专属参数；GLB 与 PLY 设置不会同时出现
@@ -42,7 +42,7 @@
 - 转换对话框选择推理模式、处理分辨率与背景移除；细分和置换方式在 Geometry Nodes 修改器中调整
 - Debug 的 DA3 输出或 BEN2 背景剔除完成后只打开对应 job 文件夹，不修改当前场景
 - 完整保留每次任务生成的所有官方文件
-- 安装和模型下载使用后台子进程；推理提交给常驻 Backend Service，状态栏实时显示阶段、百分比进度条与取消按钮
+- 安装和模型下载使用后台子进程；推理提交给常驻 Service，状态栏实时显示阶段、百分比进度条与取消按钮
 - 后台任务运行时，Install、Download 和 Export 按钮保持原位置并变灰，任务完成后恢复
 
 ## 使用
@@ -55,9 +55,9 @@
 3. 在 Extension Preferences 中确认 Storage Root 与 Device。Device 是正式功能
    （Image Empty 右键菜单）使用的推理设备，默认取本机最快的 CUDA/MPS，否则 CPU，且只列出
    本机支持的设备。
-4. 在 `AI Backend` 点击 `Install Backend`。首次安装会下载 Python、PyTorch、FastAPI、Uvicorn；
-   DA3、BEN2 源码包与 uv 已内置在扩展中，安装时从 `~/.snapform/vendor/` 解包使用，
-   并在 Backend Environment 就绪后自动下载 `DA3 Small` 和 `BEN2 Base` 推荐模型。Backend Environment 安装
+4. 在 `AI Service` 点击 `Install Environment`。首次安装会下载 Python、PyTorch、FastAPI、Uvicorn；
+   DA3、BEN2 源码包与 uv 已内置在扩展中，安装时从 安装任务的临时目录中使用，安装结束后自动清理，
+   并在 Environment 安装后自动下载 `DA3 Small` 和 `BEN2 Base` 推荐模型。Environment 安装
    固定显示 `Environment`、`PyTorch`、`AI components` 三个用户阶段；xFormers（macOS 跳过）、
    FastAPI 等内部安装步骤合并在 `AI components` 中。耗时最长的 PyTorch 与 AI 组件占主要进度
    区间。安装完成后直接写入 Environment Manifest，不再额外导入全部组件进行验证。推荐模型属于安装
@@ -65,21 +65,21 @@
    状态文字使用 `阶段/总数 阶段名 | 当前操作 | 预计剩余时间`，依赖安装会结合预设耗时与实际
    进度修正预期；模型下载根据字节数和速度计算剩余时间，例如
    `Downloading DA3 Small | 14.2 MB/s | About 2 min left`。重试或切换镜像时进度不会倒退。
-    Backend Environment 就绪后即使模型下载中断也不影响 Backend Service 使用，可稍后在 `Models` 面板单独补下。
+    Environment 安装后即使模型下载中断也不影响 Service 使用，可稍后在 `Models` 面板单独补下。
     安装不做启动网络预检：pip 安装失败会自动依次重试清华、阿里镜像，模型下载由 worker
     自行探测回退到 HF 镜像；需要手动指定镜像时可通过 `PIP_INDEX_URL` 环境变量覆盖。
 5. 在 3D View 按 `N`，打开 `SnapForm` 页签。
-6. 如需其他模型，展开 `AI Backend > Models`，找到模型并点击该行的 `Download`。
+6. 如需其他模型，展开 `Models` panel，找到模型并点击该行的 `Download`。
 7. 展开默认收起的 `Debug`，选择 `Output Type` 和本次执行使用的模型。
 8. 选择一张图片或一个视频文件。视频可设置从头截取的帧数，然后点击 `Generate Output`。
-9. 测试背景剔除时，确认 `AI Backend > Models` 中的 `BEN2 Base` 已就绪，然后在 `Debug` 的
+9. 测试背景剔除时，确认 `Models` panel 中的 `BEN2 Base` 已就绪，然后在 `Debug` 的
    `BEN2 Removal Test` 区域选择单张图片并点击 `Remove Background`。
    完成后会打开 job 文件夹，其中的 `foreground.png` 带透明 Alpha；状态栏显示
    BEN2 推理、模型加载与任务总耗时。当前测试固定关闭较慢的 foreground refinement。
 
 ## Image Empty 去背景
 
-1. 确认 `AI Backend > Models` 中的 `BEN2 Base` 已就绪；首次安装 Backend 时会默认下载。
+1. 确认 `Models` panel 中的 `BEN2 Base` 已就绪；首次安装 Environment 时会默认下载。
 2. 在 3D View 选中 Image Empty，右键打开 `SnapForm` 子菜单并选择 `Remove Background`。
 3. 完成后以 Fake User 保留原 Image datablock，新建并 Pack 一张透明 PNG 到当前 `.blend`，然后只把
    当前 Empty 的 `data` 换成新图；Empty 的 Transform、显示尺寸、Offset 及其他设置保持不变。
@@ -107,16 +107,16 @@ Cyclic 沿用原 Empty 的设置。序列帧无法被 Blender 整体 Pack，因
      Resolution Scale，再钳制到 `252–1008`，最后对齐到最接近的 `14` 倍数。Resolution Scale 以百分比
      显示，范围为 `1–100%`，默认 `100%`；界面只在标签中实时显示最终 Process Res。
      转换导出 `mini_npz`，使用前需要在
-     `AI Backend > Models` 下载所选模型，并固定使用 `process_res_method="upper_bound_resize"`；设备和参考视图策略
+     `Models` panel 下载所选模型，并固定使用 `process_res_method="upper_bound_resize"`；设备和参考视图策略
      继续使用场景设置。Model 下拉菜单只列出已经下载的 DA3 模型；若没有可用模型，对话框会引导到
-     `AI Backend > Models` 下载。
+     `Models` panel 下载。
     - `Original`：直接把原图作为深度贴图，不显示估算参数。仅在开启 `Remove Background` 时运行 BEN2
       取得前景 Alpha；视频或序列帧按需同时抽取原始帧与前景序列，把原始帧作为 `.depth` 序列。
    `Original` 是默认深度来源。选择 `AI Generated` 时，其 Model、Use Ray Pose 与 Resolution Scale
    参数会集中显示在独立边框中。`Remove Background` 与 `Unshaded` 直接显示，不再使用 Options 折叠；
    `Keep Original` 默认关闭，并在分割线下方保持为最后一项。仅当开启 `Remove Background` 时才需要
    `BEN2 Base`，并把 `.foreground` 的 Alpha 作为独立
-   Mask，不在 Backend Service 中改写深度值。保存 `.foreground` 时保留 BEN2 Alpha，但 RGB 使用未经修改的原始输入；
+   Mask，不在 Service 中改写深度值。保存 `.foreground` 时保留 BEN2 Alpha，但 RGB 使用未经修改的原始输入；
    因此材质直接用 `.foreground` 同时提供颜色和 Mask，不再额外加载原图 Image Texture。
     Image Empty 引用视频或序列帧时，AI Generated 会按 Empty 的 Image Frames 数值逐帧估计
     深度（未设置时为完整帧数，显式设为 1 时只处理 1 帧），起始帧跟随 Empty 的 Offset，与背景蒙版范围一致；
@@ -167,11 +167,11 @@ Cyclic 沿用原 Empty 的设置。序列帧无法被 Blender 整体 Pack，因
    `Convert to Depth Plane`，当前不处理视频或序列帧。
    对话框中的 Resolution Scale 与 Depth Plane 使用相同设计：原图长边乘以 `1–100%` 的比例后，
    将实际 Process Res 钳制在 `252–1008` 并按 `14` 对齐。
-2. Backend Service 请求 DA3 的 `depth`、`conf` 与 `intrinsics`。仅在开启 `Remove Background` 时运行 BEN2 取得
-   前景 Alpha，并在输出前删除包含背景顶点的三角面；关闭时不加载 BEN2。Depth 不做 smoothing，Backend Service
+2. Service 请求 DA3 的 `depth`、`conf` 与 `intrinsics`。仅在开启 `Remove Background` 时运行 BEN2 取得
+   前景 Alpha，并在输出前删除包含背景顶点的三角面；关闭时不加载 BEN2。Depth 不做 smoothing，Service
    反投影深度网格，建立源三角面，计算 confidence percentile 与 camera-space edge stretch，并写入
    基于原图像素坐标的源 `UVMap`。这些步骤只准备修改器的输入网格，不执行 Relax、拓扑修复、平滑、
-   小岛清理或最终 UV 重投影。运行时显示的六个 `Preparing surface data` 步骤均指这段 Backend Service 端源数据准备。
+   小岛清理或最终 UV 重投影。运行时显示的六个 `Preparing surface data` 步骤均指这段 Service 端源数据准备。
 3. Blender 把勾选 `Usage > Modifier` 的 `O DA3 Surface` 节点组直接作为 Geometry Nodes 修改器
    添加到 Surface，不另设修改器名称。节点组内没有子节点组，依次完成：
    - 修改器顶层依次显示 `Resolution`、`Relax Iterations`、`Smooth`；默认展开的 `Culling` Panel
@@ -192,9 +192,9 @@ Cyclic 沿用原 Empty 的设置。序列帧无法被 Blender 整体 Pack，因
    修改器关闭 `show_group_selector`。`Fix Topology` 位于默认折叠的 `Options` Panel。
    节点图按 Culling、Remesh、Topology Fix、Island Cleanup 与 UV 分区摆放；各区就近使用独立的
    Group Input，并隐藏没有连线的接口，避免跨越整个节点图的输入连线。
-5. Backend Service 准备过程固定显示 6 个编号阶段：验证 DA3 数据、反投影、准备 DA3 与可选 BEN2 数据、构建原始
+5. Service 准备过程固定显示 6 个编号阶段：验证 DA3 数据、反投影、准备 DA3 与可选 BEN2 数据、构建原始
    源三角面、源 UV/attributes、写出网格。状态栏显示 `Preparing surface data n/6: ...`。
-6. Backend Service 在 job 根目录写出 `mesh.npz` 与 `texture.png`。NPZ 保存 camera-space `vertices`、
+6. Service 在 job 根目录写出 `mesh.npz` 与 `texture.png`。NPZ 保存 camera-space `vertices`、
    `faces`、`uv`、`intrinsics`、`image_size` 与有效深度中位数 `reference_depth`。Blender 读取这些
    数据后直接创建 Surface 与原图材质，不需要 Open3D 或 OpenCV 进入 Blender Python 环境。
    Surface 保留下列结构化 attributes：
@@ -205,7 +205,7 @@ Cyclic 沿用原 Empty 的设置。序列帧无法被 Blender 整体 Pack，因
    缩放及父级关系产生的世界变换保持一致。更近的顶点沿 Empty 局部 `+Z` 方向凸出，三角面正面朝向
    观察相机，启用 Backface Culling 时可从正面看到。
 8. 转换对话框不再提供后处理参数，只保留模型与 Resolution Scale 设置、`Create Matching Camera`、
-   `Remove Background`、`Unshaded`，以及分割线下方的 `Keep Original`。背景移除默认关闭；开启后 Backend Service
+   `Remove Background`、`Unshaded`，以及分割线下方的 `Keep Original`。背景移除默认关闭；开启后 Service
    使用 BEN2，并在写出 Surface 前直接删除背景三角面，不再由 Geometry Nodes 的 Background 开关处理。
    `Unshaded` 使用与 Depth Plane 相同的 Emission/Transparent 材质路径；普通材质的
    Bump Scale 按 `abs(object.scale.z) × camera scale_z` 设置，并在材质组内乘以固定基准 `0.001`，
@@ -232,9 +232,9 @@ depth、confidence、intrinsics、extrinsics 与 confidence percentile。当前
 
 所有任务使用统一的状态栏进度显示。变化中的阶段说明显示在右侧的进度条内部，取消按钮
 位于进度条右侧。状态字段支持阶段、当前操作与预计剩余秒数，界面统一组合为紧凑文案并保证
-进度单调递增。任务进程与 Backend Service 请求在后台启动，按钮点击后立即进入进度状态。Image Depth 的阶段包括 Backend Environment 启动、输入准备、模型加载、深度估算、缓存
+进度单调递增。任务进程与 Service 请求在后台启动，按钮点击后立即进入进度状态。Image Depth 的阶段包括 Environment 启动、输入准备、模型加载、深度估算、缓存
 写出和面片构建。进度更新会强制刷新状态栏与窗口，无需移动鼠标即可实时显示。安装中断后残留的
-半成品 Backend Environment 会在下次安装前自动清理，不会因为中断而无法再次安装。
+半成品 Environment 会在下次安装前自动清理，不会因为中断而无法再次安装。
 
 导入过程精确保留 NPZ 内深度值之间的差值。例如深度 `2.0` 和 `5.5` 在
 `Displacement Strength = -1` 时，沿局部 Z 轴相差 `3.5 Blender Unit`。它不会把数值压缩到
@@ -267,10 +267,11 @@ Displacement 设置为 `Displacement Only`，AI Generated 与 Original 都使用
 通过 image_user 的 Frames / Offset / Start 把第 i 帧映射到场景 `Start+i` 帧，并启用 Auto Refresh。
 颜色贴图到 Principled BSDF 之间使用独立的 Shader Node Group。Surface 使用 `O DA3 Surface Layer`；
 Depth Plane 使用 `O DA3 Depth Plane Layer` 材质组，并把背景剔除、背景深度与材质置换 Attribute
-读取全部收进组内。两者都依次接收 `Color`、`Alpha`、Float 类型的 `Depth`、`Bump Scale`。
-`O DA3 Surface Layer` 只输出 `Color`、`Roughness`、`Alpha` 与 `Normal`，不创建 Displacement 节点或输出；
-`O DA3 Depth Plane Layer` 另外输出 `Displacement`。Surface 把原图 Color 同时送入 `Color` 与 `Depth`，
-保持图像 Bump 效果。外层材质只保留贴图、材质组、Principled BSDF 与 Material Output，方便继续调整。
+读取全部收进组内。两者都接收 `Color`、`Alpha` 与 `Bump Scale`，只有 `O DA3 Depth Plane Layer`
+额外接收 Float 类型的 `Depth`。
+`O DA3 Surface Layer` 只输出 `Color`、`Roughness`、`Alpha` 与 `Normal`，以原图 Color 保留 Bump 效果，
+不创建 Displacement 节点或输出；`O DA3 Depth Plane Layer` 另外输出 `Displacement`。外层材质只保留贴图、
+材质组、Principled BSDF 与 Material Output，方便继续调整。
 Depth Plane 的 Bump Height 直接使用材质组的 `Color` 输入，只受独立的 `Bump Scale` 影响，不使用深度贴图，
 也不经过 `Displacement` 模式开关、`Depth Scale` 或 `Background Depth`；材质 Displacement 仍使用这些参数处理后的深度。
 无论选择哪种置换方式，原始彩色贴图都会连接
@@ -319,7 +320,7 @@ Blender 为 Packed Image 或序列帧生成的输入副本也归档到对应 job
 
 日志、运行中的状态文件、归档输入与输出产物均直接放在 job 根目录。各类任务名称为：
 
-- `install-runtime`
+- `install-environment`
 - `download-model`
 - `export-reconstruction`
 - `generate-depth-plane`
@@ -333,28 +334,28 @@ DA3 官方 exporter 产生的 `gs_ply/`、`depth_vis/`、`exports/mini_npz/` 会
 
 ```text
 export-reconstruction_20260807-153000-123456/
-├── export-reconstruction_20260807-153000-123456.log
-├── export-reconstruction_20260807-153000-123456.json
+├── job.log
+├── status.json
 └── scene.glb
 
 export-reconstruction_20260807-153000-123456/
-├── export-reconstruction_20260807-153000-123456.log
-├── export-reconstruction_20260807-153000-123456.json
+├── job.log
+├── status.json
 └── *.ply
 
 export-reconstruction_20260807-153000-123456/
-├── export-reconstruction_20260807-153000-123456.log
-├── export-reconstruction_20260807-153000-123456.json
+├── job.log
+├── status.json
 └── *.jpg
 
 export-reconstruction_20260807-153000-123456/
-├── export-reconstruction_20260807-153000-123456.log
-├── export-reconstruction_20260807-153000-123456.json
+├── job.log
+├── status.json
 └── results.npz
 
 remove-background_20260807-153000-123456/
-├── remove-background_20260807-153000-123456.log
-├── remove-background_20260807-153000-123456.json
+├── job.log
+├── status.json
 ├── foreground.png            单图结果
 ├── foreground.0001.png…      视频/序列帧结果
 ├── frame.0001.jpg…           视频/序列帧的源帧副本
@@ -393,15 +394,13 @@ Point Cloud GLB 任务会关闭其默认附带的深度预览，使五种输出
 官方格式与限制可参阅
 [DA3 Python API 文档](https://github.com/ByteDance-Seed/Depth-Anything-3/blob/main/docs/API.md)。
 
-## AI Backend
+## AI Service
 
-AI Backend 是统一上位概念，由两部分组成：Backend Environment 是磁盘上的 Python、依赖和模型执行环境；
-Backend Service 是使用该环境启动、接收 Blender 任务的常驻 HTTP 进程。环境的
-`environment_manifest.json` 使用 `environment_manifest_revision` 判断安装配方是否匹配；Service 的
-`/health` 使用 `job_protocol_version` 判断 Blender 与服务之间的任务协议是否匹配。两者生命周期不同，
-因此分别维护版本，而不合并成一个 Schema。
+Environment 指磁盘上已安装的 Python、依赖及模型执行组件；Service 是由 Environment 启动、接收 Blender 任务的
+常驻 HTTP 进程。`manifest.json` 记录当前 Environment 的安装信息；Service 的 `/health` 返回进程状态和
+实例标识。项目发布前不维护安装清单或任务协议的兼容版本号。
 
-Extension 本身不包含 Torch。`Install Backend` 使用 `uv` 创建独立 Python 3.12
+Extension 本身不包含 Torch。`Install Environment` 使用 `uv` 创建独立 Python 3.12
 环境，并安装。机器上即使没有安装 `uv` 或 Python 也没关系：安装程序由 Blender
 自带的 Python 启动，缺 `uv` 时会解包扩展内置的对应平台二进制，再用它下载
 Python 3.12 与全部依赖。`uv` 会缓存在扩展存储目录下，后续安装直接复用。
@@ -421,7 +420,7 @@ Windows 上代理若只在系统设置里而未写入环境变量，安装程序
 - 固定到已验证 commit 的 Depth Anything 3
 - 固定到已验证 commit 的 BEN2
 - FastAPI 0.139.2 与 Uvicorn 0.51.0
-- DA3 与 BEN2 源码包随扩展打包，安装时复制到 `~/.snapform/vendor/` 后由 uv 本地安装
+- DA3 与 BEN2 源码包随扩展打包，安装时复制到临时目录后由 uv 本地安装，完成后立即清理
   （无需访问 GitHub）；SnapForm 直接调用 DA3
   底层 export 接口，`gs_ply` 导出不会触发 `gs_video` 渲染，因此不需要 gsplat
   与 C++ 编译工具链
@@ -433,12 +432,12 @@ Windows 上代理若只在系统设置里而未写入环境变量，安装程序
   并核对覆盖文件是否仍适用
 - `addict` 2.4.0（补充 DA3 上游包元数据暂未声明的运行依赖）
 
-安装 Backend Environment 时会自动选择 PyTorch 后端：检测到 NVIDIA 驱动则安装 CUDA 12.8 版本，否则安装
+安装 Environment 时会自动选择 PyTorch 后端：检测到 NVIDIA 驱动则安装 CUDA 12.8 版本，否则安装
 CPU 版；macOS 始终安装 CPU 版 PyTorch（MPS 包含其中）。CPU 可以用于验证，但实际推理通常很慢。
 Extension Preferences 的 `Device` 决定正式功能的推理设备，默认取本机最快的 CUDA/MPS，否则
 CPU；Debug 面板的 `Debug Device` 只影响 Debug 任务。两处设备选项都只列出本机支持的设备：
-Windows 不显示 MPS，机器上没有可用 NVIDIA 驱动时不显示 CUDA。Backend Environment 安装完成时会检测真实
-可用的设备并写入 `environment_manifest.json`，设备列表以该检测结果为准。
+Windows 不显示 MPS，机器上没有可用 NVIDIA 驱动时不显示 CUDA。Environment 安装完成时会检测真实
+可用的设备并写入 `manifest.json`，设备列表以该检测结果为准。
 CUDA 12.8 的 PyTorch wheel 自带 CUDA 运行库，无需安装 CUDA Toolkit；只需要
 NVIDIA 驱动 ≥ 570（数据中心显卡可用更老驱动）。驱动不满足或没有 NVIDIA 显卡时，
 设备会自动回退到 CPU（macOS 为 MPS），只有显式选择 CUDA 才会报错。
@@ -448,39 +447,39 @@ macOS（Apple Silicon）会自动从 PyPI 安装 CPU 版 PyTorch，推理设备
 Mac（x86_64）轮子，Intel Mac 暂不支持。DA3 射线位姿估计中的 3×3 QR 分解在 MPS
 上尚未实现，SnapForm 的覆盖文件会单独把该分解放到 CPU 执行，其余推理仍走 MPS。
 
-Extension 启用后只会查找已有的共享 Backend Service，不会主动启动新进程。第一次执行 AI 操作或在侧边栏
-手动点击 `Start` 时才会启动 Backend Service。Backend Service 只绑定回环地址，并让操作系统分配动态端口；第一个实例把
-端口、进程和随机 Token 写入 `host.json`，其余 Blender 通过标准库
-`urllib.request` 连接同一个 Backend Service。`host.lock` 保证同一 Storage Root 同时只有一个 Backend Service，Token
-则阻止同机其他进程直接调用接口。Backend Service 全局同时只执行一个 AI 任务。
+Extension 启用后只会查找已有的共享 Service，不会主动启动新进程。第一次执行 AI 操作或在侧边栏
+手动点击 `Start` 时才会启动 Service。Service 只绑定回环地址，并让操作系统分配动态端口；第一个实例把
+端口、进程和随机 Token 写入 `service.json`，其余 Blender 通过标准库
+`urllib.request` 连接同一个 Service。`service.lock` 保证同一 Storage Root 同时只有一个 Service，Token
+则阻止同机其他进程直接调用接口。Service 全局同时只执行一个 AI 任务。
 
-每个 Blender 会注册独立客户端并每 5 秒发送心跳。正常关闭 Blender 时先注销自身；如果当前 Backend Service
-就是由这个 Blender 启动的，会直接终止它，无需等待。异常退出的客户端会在 10 秒后过期；Backend Service
+每个 Blender 会注册独立客户端并每 5 秒发送心跳。正常关闭 Blender 时先注销自身；如果当前 Service
+就是由这个 Blender 启动的，会直接终止它，无需等待。异常退出的客户端会在 10 秒后过期；Service
 在最后一个客户端离开后仍会保留模型缓存等待 20 秒再退出，作为 Service 由其他进程启动等场景的兜底。
-取消任务不会重启 Backend Service，并会保留已经加载的模型；
+取消任务不会重启 Service，并会保留已经加载的模型；
 如果取消发生在一次不可中断的 Torch 调用中，任务会在该调用返回后的最近检查点结束。
 
-侧边栏 `AI Backend` 面板以 `Running (Clients: n)` 表示空闲服务，以 `Running (Busy)` 表示正在执行任务，
+侧边栏 `AI Service` 面板以 `Running (Clients: n)` 表示空闲服务，以 `Running (Busy)` 表示正在执行任务，
 并显示缓存模型和活动任务。Blender 完成结果导入时会立即释放当前任务对应的本地 Busy 快照，无需等待
-下一次 Backend Service 轮询。空闲且只有当前 Blender 连接时，可以清理模型缓存、重启或停止 Service；
+下一次 Service 轮询。空闲且只有当前 Blender 连接时，可以清理模型缓存、重启或停止 Service；
 多客户端或任务执行期间不会允许破坏共享服务。
 
 BEN2 在首次使用后保持加载；DA3 保留最近使用的一个模型。切换 DA3 模型时会释放旧模型；加载时如果
 显存不足，会先释放另一类缓存模型并重试。
 
-Environment Manifest Revision 变化时，旧 Backend Environment 需要重新执行 `Install Backend`。
-Backend Service 的启动和崩溃日志写入 `~/.snapform/ai-host.log`。
+Environment Manifest Revision 变化时，旧 Environment 需要重新执行 `Install Environment`。
+Service 的启动和崩溃日志写入 `~/.snapform/service.log`。
 
-Backend Environment、模型和任务结果默认保存在用户主目录的 `~/.snapform`：
+Environment、模型和任务结果默认保存在用户主目录的 `~/.snapform`：
 
 ```text
 ~/.snapform/
-├── runtime/
+├── .venv/
 ├── models/
 ├── jobs/
-├── ai-host.log
-├── host.json       # Backend Service 运行时存在
-└── host.lock       # Backend Service 运行时持有
+├── service.log
+├── service.json       # Service 运行时存在
+└── service.lock       # Service 运行时持有
 ```
 
 `models/` 下每个模型一个文件夹，命名统一带前缀：DA3 为 `da3_*`（如 `da3_small`、`da3_base`），
@@ -489,7 +488,7 @@ BEN2 为 `ben2_*`（如 `ben2_base`）。旧版无前缀的 DA3 文件夹会在
 不同 Blender 版本安装相同 Extension 后会共用这个目录。也可以在 Extension
 Preferences 的 `Storage Root` 中修改共享位置。不要把模型写入 Extension 安装目录，
 因为该目录可能只读，并且升级时会被替换。不要同时从多个 Blender 实例执行
-`Install Backend`；Backend Service、任务队列和模型读取可以共享。
+`Install Environment`；Service、任务队列和模型读取可以共享。
 
 ## 开发
 
@@ -511,15 +510,15 @@ uv run python pack.py
 ├── src/
 │   └── snapform/
 │       ├── blender_manifest.toml
-│       ├── ai_host.py
-│       ├── bootstrap_runtime.py
+│       ├── service.py
+│       ├── install_env.py
 │       ├── models.py
 │       ├── image_depth.py
 │       ├── operators.py
 │       ├── panel.py
 │       ├── preferences.py
 │       ├── properties.py
-│       ├── runtime.py
+│       ├── client.py
 │       └── worker.py
 └── tests/
 ```