Add comprehensive documentation for SnapForm features and workflows

- Introduced new guides for Depth Plane, Surface, and animation workflows.
- Added installation instructions and FAQs to assist users in setup and troubleshooting.
- Created a quick-start guide for first-time users to convert images to Depth Planes.
- Documented the process for removing backgrounds from images.
- Established a models and storage section to clarify data management.
- Included a stylesheets file for improved documentation styling.
- Updated mkdocs configuration for better navigation and theme settings.

docs/animation.md

@@ -0,0 +1,36 @@
+# 视频与序列帧
+
+SnapForm 可以逐帧处理视频和序列帧，并生成随场景时间播放的 Depth Plane 或透明 Image Empty。
+
+## 支持的工作流
+
+- **Convert to Depth Plane**：支持视频和序列帧。
+- **Remove Background**：支持视频和序列帧。
+- **Convert to Surface**：当前只支持单张图片。
+
+## 设置处理范围
+
+处理范围来自 Image Empty 自身的图片设置：
+
+- **Image Frames** 决定处理的帧数。
+- **Offset** 决定从源素材的哪个位置开始。
+- **Start** 决定结果从场景的哪一帧开始播放。
+- **Cyclic** 会保留到生成的颜色与深度序列中。
+
+显式把 Image Frames 设为 `1` 时，SnapForm 只处理一帧。范围超过视频长度时，SnapForm 会把窗口收回有效范围内。
+
+## 性能建议
+
+- 先用较少帧数和较低分辨率测试效果。
+- DA3 和 MoGe-2 的 Depth Plane 会逐帧推理并复用模型 Session，显存峰值主要由单帧分辨率决定。
+- 视频越长，处理时间和任务目录占用越大。
+- 任务运行期间可以从 Blender 状态栏查看进度并取消。
+
+## 保存和移动工程
+
+Blender 无法把整组动画图片序列完整打包进 `.blend`。SnapForm 因此让动画结果直接引用 Storage Root 的 Job 文件夹。
+
+!!! danger
+    删除、移动或清理仍被工程引用的 Job 文件夹，会导致动画颜色或深度序列丢失。
+
+需要把工程移动到另一台机器时，请连同对应 Job 文件夹一起复制，并在 Blender 中重新定位缺失文件。也可以先把需要长期保留的序列复制到项目自己的素材目录，再用 Blender 的外部数据工具重新映射路径。

docs/depth-plane.md

@@ -1,5 +1,8 @@
 # Depth Plane
 
+本页记录 Depth Plane 的数据、节点和材质实现。日常操作与参数说明请阅读
+[Depth Plane 使用指南](guide-depth-plane.md)。
+
 ## Image Empty 转深度面片
 
 1. 在 3D View 选中 `Object Type = Empty`、`Display As = Image` 的对象。

docs/development.md

@@ -109,6 +109,21 @@ uv run pytest tests/test_addon.py tests/test_manifest.py tests/test_pack.py -v
 uv run python pack.py
 ```
 
+本地预览用户文档：
+
+```bash
+uv run mkdocs serve
+```
+
+构建静态文档或使用 Mike 发布版本化文档：
+
+```bash
+uv run mkdocs build
+uv run mike deploy <version> -p
+uv run mike set-default <version> -p
+```
+
+
 `pack.py` 根据 `blender_manifest.toml` 分别生成 Windows、macOS 和 Linux 扩展包，例如 `dist/SnapForm.v0.12.14.windows-x64.zip`。更换 `src/snapform/wheels/` 中随扩展分发的 wheel 后，先刷新锁文件再测试：
 
 ```bash

docs/faq.md

@@ -0,0 +1,57 @@
+# 常见问题
+
+## 找不到 SnapForm 右键菜单
+
+SnapForm 菜单只会在选中 Image Empty 时出现。确认对象类型是 Empty，并且显示方式为 Image。普通 Mesh、图片编辑器中的图片或未选中的 Image Empty 都不会显示入口。
+
+## 转换入口是灰色的
+
+通常有以下原因：
+
+- Environment 尚未安装。
+- 默认必需模型尚未就绪。
+- 另一个 SnapForm 任务正在运行。
+- Surface 的输入不是单张图片。
+
+如果子菜单显示 **Install Environment** 或 **Download Required Models**，先完成对应操作。
+
+## Environment 安装失败
+
+- 海外源访问不稳定时尝试 **Install Environment (Mirror)**。
+- 检查 Blender 的 **Online Access** 是否开启。
+- 确认 Storage Root 有足够空间且可写。
+- 查看 Storage Root 下的 `install.log`。
+
+安装模型失败不会删除已经成功创建的 Environment。可以稍后使用 **Download Required Models** 或 Models 面板重试。
+
+## 模型下载很慢或失败
+
+模型会尝试 Hugging Face 和 OmooLab 备用来源。检查网络、代理和磁盘空间后重新点击 Download。模型直链连接或长时间无数据时会自动尝试下一来源。
+
+## 第一次转换较慢
+
+第一次任务需要启动 Job Server 并把模型载入内存。Server 运行且模型仍在缓存中时，后续同类任务通常会更快。
+
+## Depth Plane 太平或深度方向反了
+
+在 Geometry Nodes 修改器中调整 **Depth Scale**。增大绝对值会加强深度，使用负值可以反转前后关系。
+
+## Surface 边缘破碎或细节太多
+
+先调整 **Depth Continuity** 清理断层，再提高 **Resolution** 简化网格，并用 **Smooth** 稳定表面。必要时尝试另一个模型或降低输入分辨率。
+
+## 动画面片不播放
+
+检查源 Image Empty 的 **Image Frames** 是否大于 `1`，并确认场景时间正在变化。生成后的动画还需要对应 Job 文件夹存在；文件被移动或删除时应重新定位序列。
+
+## 可以删除 jobs 文件夹吗
+
+静态图的部分结果会 Pack 到 `.blend`，但视频与序列帧会直接引用 Job 文件。只有确认没有工程继续引用对应目录时才应删除。
+
+## 如何完全撤销一次转换
+
+转换完成后直接按 `Ctrl+Z`。SnapForm 会把网格、材质、图片和修改器的创建合并为一次 Blender Undo 操作。
+
+## 从旧版本升级后功能不可用
+
+如果 Environment 声明或依赖发生变化，请重新执行一次 **Install Environment**。从 0.12.0–0.12.5 升级到 0.12.6 或更高版本时需要重建 Environment。

docs/features.md

@@ -1,7 +1,7 @@
-# 功能与使用
+# 功能参考
 
-本文档面向开发者和需要了解内部实现细节的用户，从原 README 迁移而来。普通用户请阅读项目根目录的
-`README.md`。
+本页记录完整功能行为和实现边界，主要供开发、测试与故障排查使用。第一次使用 SnapForm 时，请从
+[安装与首次配置](installation.md)或[五分钟上手](quick-start.md)开始。
 
 `SnapForm` 是一套从图片快速构建空间结构的 Blender Extension。目前以
 [Depth Anything 3](https://github.com/ByteDance-Seed/Depth-Anything-3)

docs/guide-depth-plane.md

@@ -0,0 +1,57 @@
+# Depth Plane
+
+Depth Plane 将图片转换为带位移的立体面片。它适合快速场景搭建、2.5D 合成、立体插画以及视频素材。
+
+## 创建 Depth Plane
+
+1. 选中 Image Empty。
+2. 在 3D View 中右键，选择 **SnapForm > Convert to Depth Plane**。
+3. 选择深度来源和需要的选项。
+4. 确认后等待任务完成。
+
+## 选择 Depth From
+
+### MoGe-2
+
+默认推荐。MoGe-2 会估算尺度一致的深度、法线和有效区域，通常适合单张图片和逐帧动画。模型越大，细节潜力和资源占用通常越高。
+
+- **Resolution Level** 越高，处理更细致，也会更慢并占用更多内存。
+- 第一次使用建议保持默认值 `5`。
+
+### DA3
+
+适合尝试不同的深度估算结果。DA3 使用 **Resolution Scale** 控制处理尺寸；界面会显示实际 Process Res。
+
+- 较低比例适合预览和显存有限的设备。
+- 较高比例可能保留更多细节，但不保证每张图片都更好。
+
+### Original
+
+直接把原图亮度作为深度来源，不运行深度估算模型。它适合已经准备好灰度高度图或手绘深度图的情况。
+
+## 转换选项
+
+- **Remove Background**：转换期间使用 BEN2 去除背景，让 Alpha 同时控制可见区域和背景深度。
+- **Shadeless**：让贴图颜色不受场景灯光影响，适合插画、合成和需要保持原图观感的场景。
+- **Keep Original**：保留源 Image Empty。默认关闭，转换成功后由新网格替代原对象。
+
+## 调整结果
+
+生成对象的 Geometry Nodes 修改器提供以下常用参数：
+
+- **Displacement**：`Geometry` 直接移动网格；`Material` 保持平面并使用材质置换。
+- **Subdivision**：控制网格密度。数值越高，深度细节越多，场景也越重。
+- **Background Depth**：设置背景区域的位置。
+- **Depth Scale**：控制深度强度；负值可以反转前后关系。
+
+调整时建议先降低 Subdivision 提高交互速度，确定 Depth Scale 后再提高细分。
+
+## 动画输入
+
+Depth Plane 支持视频和序列帧。处理范围跟随 Image Empty 的 **Image Frames** 与 **Offset**，生成后的颜色和深度会随场景帧播放。
+
+动画结果会引用任务目录中的图片序列。移动工程或清理磁盘前，请先阅读[视频与序列帧](animation.md)和[模型、设备与存储](models-and-storage.md)。
+
+## 进一步了解
+
+需要查看节点、数据字段、色彩空间和位移计算方式时，请阅读[Depth Plane 实现参考](depth-plane.md)。

docs/guide-surface.md

@@ -0,0 +1,46 @@
+# Surface
+
+Surface 从单张图片构建带透视关系的纹理网格。它适合建筑、室内、街景和需要匹配原始观察视角的画面。
+
+!!! warning
+    Surface 当前只支持单张图片。视频和序列帧请使用 [Depth Plane](guide-depth-plane.md)。
+
+## 创建 Surface
+
+1. 选中只包含一帧的 Image Empty。
+2. 在 3D View 中右键，选择 **SnapForm > Convert to Surface**。
+3. 选择模型和转换选项。
+4. 确认后等待网格、材质和 Geometry Nodes 修改器创建完成。
+
+## 模型与分辨率
+
+默认的 **MoGe-2 ViT-S Normal** 适合多数图片。MoGe-2 使用 **Resolution Level**，DA3 使用 **Resolution Scale**。提高分辨率会增加耗时和内存占用，建议先用默认值判断整体结构。
+
+如果某个模型名称后显示 **(Missing)**，请先在 3D View 的 **SnapForm > Models** 面板下载它。
+
+## 转换选项
+
+- **Create Matching Camera**：创建与图片投影相匹配的透视相机。相机会成为 Surface 的子级，移动 Surface 时仍保持对应关系。
+- **Remove Background**：在生成网格前删除背景三角面。转换后关闭节点中的 Mask 也不会恢复这些面。
+- **Shadeless**：让贴图颜色不受场景灯光影响。
+- **Keep Original**：保留源 Image Empty。
+
+## 调整网格
+
+生成对象的 Geometry Nodes 修改器负责剔除深度断层、合并网格、修复拓扑、平滑和重新投影 UV。常用参数包括：
+
+- **Iterations**：控制重拓扑迭代次数。设为 `0` 可以跳过迭代，便于观察原始结构或提高速度。
+- **Resolution**：控制合并后的网格密度。值越大，结果越简化。
+- **Smooth**：控制表面平滑程度。
+- **Depth Continuity**：剔除深度断层处的面。提高数值会更积极地清理边缘。
+- **Confidence**：DA3 Surface 可用，用于过滤低置信度区域。
+
+先调整 Culling 让主体边缘干净，再调整 Resolution 和 Smooth，通常更容易获得稳定结果。
+
+## 匹配相机的使用方式
+
+开启 **Create Matching Camera** 后，切换到生成的相机视图即可重新对齐原图构图。Surface 与相机存在父子关系，建议把二者作为一个整体移动或缩放。
+
+## 进一步了解
+
+需要查看源网格属性、重拓扑过程、相机匹配和材质法线实现时，请阅读[Surface 实现参考](surface.md)。

docs/index.md

@@ -1,10 +1,54 @@
-# SnapForm 文档
+# SnapForm
 
-技术内容已按主题拆分：
+把图片里的空间感带进 Blender。
 
-- [功能与使用](features.md)：能力概览、安装使用和 Image Empty 去背景
-- [Depth Plane](depth-plane.md)：深度面片的数据、节点与材质流程
-- [Surface](surface.md)：透视网格、Geometry Nodes 后处理与材质法线
-- [输出格式](outputs.md)：Debug 原始 API 返回与 Depth、Surface 任务产物
-- [Job Server](server.md)：Environment、模型缓存、任务目录与运行机制
-- [程序设计、开发与许可证](development.md)：模块边界、调用流程、项目结构、常用命令与许可证
+SnapForm 是一款 Blender 扩展，可以把照片、视频或序列帧转换为带真实深度变化的立体面片。你只需导入图片、选中 Image Empty，然后从右键菜单选择需要的结果。
+
+- 用 **Depth Plane** 快速得到可调节的浮雕式面片
+- 用 **Surface** 从单张图片生成透视纹理网格
+- 用 **Remove Background** 一键获得透明前景
+- 处理视频和序列帧，生成可随时间播放的 Depth Plane
+- 使用 Geometry Nodes 继续调整深度、细分、重拓扑与平滑效果
+
+!!! info "运行环境与 Blender 分离"
+    SnapForm 的 AI 计算运行在独立环境中，不会把 ONNX Runtime 等计算依赖装进 Blender Python。首次配置完成后，日常操作都可以从 Image Empty 的右键菜单完成。
+
+## 从这里开始
+
+<div class="grid cards" markdown>
+
+-   **安装 SnapForm**
+
+    下载与你的系统匹配的扩展包，完成环境和默认模型配置。
+
+    [阅读安装指南](installation.md)
+
+-   **五分钟上手**
+
+    从导入一张图片开始，完成第一次 Depth Plane 转换。
+
+    [开始第一个作品](quick-start.md)
+
+-   **选择合适的结果**
+
+    了解 Depth Plane、Surface 和去背景之间的区别。
+
+    [查看工作流对比](workflows.md)
+
+-   **遇到问题？**
+
+    检查模型下载、菜单状态、动画文件和运行日志。
+
+    [查看常见问题](faq.md)
+
+</div>
+
+## 使用要求
+
+- Blender 4.5 或更高版本
+- Windows x64、macOS Apple Silicon 或 Linux x64
+- 首次安装环境与模型时需要网络连接
+- 正式使用前需要安装独立 Environment，以及默认的 MoGe-2 和 BEN2 模型
+
+!!! tip
+    不确定从哪里开始时，先使用默认设置将一张人物或物体照片转换为 Depth Plane。它速度快、参数直观，也最适合熟悉 SnapForm 的基本工作方式。

docs/installation.md

@@ -0,0 +1,53 @@
+# 安装与首次配置
+
+SnapForm 的安装分为两步：先安装 Blender Extension，再安装独立运行环境和默认模型。第二步只需在首次使用或环境版本发生变化时执行。
+
+## 安装 Blender Extension
+
+1. 下载与你的系统匹配的 ZIP 文件：
+   - `SnapForm.v版本号.windows-x64.zip`
+   - `SnapForm.v版本号.macos-arm64.zip`
+   - `SnapForm.v版本号.linux-x64.zip`
+2. 打开 Blender，进入 **Edit > Preferences > Extensions**。
+3. 点击右上角菜单，选择 **Install from Disk**。
+4. 选择下载的 ZIP 文件并完成安装。
+
+!!! warning
+    不要解压扩展包。Blender 需要直接安装 ZIP 文件，并且安装包必须与你的操作系统匹配。
+
+## 检查扩展偏好设置
+
+在 SnapForm 的扩展偏好设置中可以看到两个选项：
+
+- **Storage Root**：保存运行环境、模型和任务文件的位置。默认是用户目录下的 `.snapform`，一般无需修改。
+- **Device**：正式转换任务使用的计算设备。SnapForm 默认选择本机可用的最快设备；如果 GPU Provider 不可用，会使用 CPU。
+
+如果准备把 Storage Root 放到其他磁盘，建议在首次安装 Environment 之前修改。更换目录后，旧目录中的环境和模型不会自动移动。
+
+## 安装 Environment
+
+打开 3D View，按 `N` 显示侧栏并切换到 **SnapForm** 页签。在 **Job Server** 面板中选择一个安装入口：
+
+- **Install Environment**：使用官方源，适合能稳定访问 GitHub、Python 下载源和 PyPI 的网络。
+- **Install Environment (Mirror)**：使用国内镜像下载 uv、Python 和 Python 包。
+
+安装程序会依次准备 uv、独立 Python 和运行包。Environment 完成后，SnapForm 还会下载日常功能需要的 **MoGe-2 ViT-S Normal** 与 **BEN2 Base**。
+
+!!! note
+    两个安装按钮只影响 Environment 的下载源。模型会按自己的下载源与备用镜像规则获取。
+
+安装过程中请保持 Blender 打开。状态栏会显示当前阶段、进度和下载速度。首次安装耗时取决于网络与磁盘速度。
+
+## 确认安装完成
+
+完成后可以用以下方式确认：
+
+- **Job Server** 不再显示 “Environment is not installed”。
+- 展开 **Models** 面板，MoGe-2 ViT-S Normal 和 BEN2 Base 显示 **Ready**。
+- 选中 Image Empty 后，右键菜单中的 **Convert to Depth Plane**、**Convert to Surface** 和 **Remove Background** 可以点击。
+
+如果 Environment 已安装但默认模型缺失，Image Empty 的 **SnapForm** 右键子菜单会显示 **Download Required Models**。点击一次即可补齐缺失项。
+
+## 下一步
+
+继续阅读[五分钟上手](quick-start.md)，用一张图片完成第一次转换。

docs/models-and-storage.md

@@ -0,0 +1,53 @@
+# 模型、设备与存储
+
+SnapForm 把运行环境、模型和任务结果放在 Blender 之外，多个 Blender 版本可以共享同一套数据。
+
+## Models 面板
+
+打开 3D View 侧栏中的 **SnapForm > Models**，可以查看和下载模型。
+
+- **Ready** 表示模型文件已经就绪。
+- **Download** 用于按需下载模型。
+- 默认安装会准备 MoGe-2 ViT-S Normal 和 BEN2 Base。
+- DA3 与更大的 MoGe-2 模型需要时再下载即可。
+
+较大的模型不一定适合所有图片。建议先用默认模型完成构图，再针对细节与性能需求比较其他模型。
+
+## Device
+
+扩展偏好设置中的 **Device** 控制 Depth Plane、Surface 和 Remove Background 等正式任务。
+
+- Windows 通常优先使用 DirectML。
+- Apple Silicon macOS 通常优先使用 CoreML。
+- Provider 不可用时会回退到 CPU。
+
+Debug 面板中的 **Debug Device** 只影响 Debug 任务，不会覆盖正式任务的 Device。
+
+## Storage Root
+
+默认 Storage Root 是 `~/.snapform`，主要包含：
+
+```text
+~/.snapform/
+├── .venv/           # 独立 Python Environment
+├── models/          # 模型文件
+├── jobs/            # 每次任务的结果
+├── install.log      # Environment 安装日志
+└── server.log       # Job Server 日志
+```
+
+更改 Storage Root 相当于切换到另一套环境、模型和任务数据。SnapForm 不会自动移动旧目录。
+
+## Job 文件夹
+
+每个任务会在 `jobs/` 下创建一个独立目录。单张图生成的关键贴图通常会 Pack 到 `.blend`；视频和序列帧则继续引用 Job 目录中的文件。
+
+可以清理已经确认不再使用的任务目录，但清理前应检查是否有 `.blend` 仍引用其中的序列帧。
+
+## 日志
+
+遇到安装或 Server 问题时：
+
+- 在扩展偏好设置中点击 **Open Server Log** 查看运行日志。
+- Environment 安装问题查看 Storage Root 下的 `install.log`。
+- 修改 Storage Root 后，确认你检查的是当前目录中的日志。

docs/outputs.md

@@ -1,5 +1,8 @@
 # 输出格式
 
+本页说明任务文件的字段与序列化约定，主要用于开发与数据检查。普通使用者只需了解
+[模型、设备与存储](models-and-storage.md)中的 Job 文件夹说明。
+
 ## Debug
 
 Debug 用于直接比较 DA3、MoGe-2 与 BEN2 模型 API 的返回效果，不复用 Depth、Surface 或 Geometry

docs/quick-start.md

@@ -0,0 +1,48 @@
+# 五分钟上手
+
+这个流程会把一张图片转换为可继续编辑的 Depth Plane。
+
+## 1. 导入图片
+
+在 3D View 中选择 **Add > Image > Reference**，导入一张图片。Blender 会创建一个显示方式为 Image 的 Empty。
+
+建议第一次尝试使用主体清晰、前后景关系明确的图片。人物、产品、建筑立面和插画通常都比较适合。
+
+## 2. 打开 SnapForm 菜单
+
+保持 Image Empty 处于选中状态，在 3D View 中点击右键，选择 **SnapForm > Convert to Depth Plane**。
+
+如果菜单不存在，请确认当前对象是 Image Empty；如果转换入口是灰色，请先完成[安装与首次配置](installation.md)。
+
+## 3. 使用默认设置转换
+
+第一次使用建议保留默认设置：
+
+- **Depth From**：MoGe-2 ViT-S Normal
+- **Resolution Level**：5
+- **Remove Background**：关闭
+- **Shadeless**：关闭
+- **Keep Original**：关闭
+
+点击确认后，状态栏会显示模型加载和处理进度。首次推理需要加载模型，之后连续处理通常会更快。
+
+## 4. 查看和调整结果
+
+转换完成后，原 Image Empty 会被新的网格对象替代。打开 Geometry Nodes 修改器，可以调整：
+
+- **Displacement**：选择直接改变几何，或改用材质置换。
+- **Subdivision**：控制面片细分程度。
+- **Background Depth**：控制透明区域或背景区域的深度。
+- **Depth Scale**：放大、减小或反转深度变化。
+
+如果希望保留原 Image Empty，转换前开启 **Keep Original**。
+
+## 5. 让画面不受灯光影响
+
+希望颜色尽量贴近原图时，在转换对话框中开启 **Shadeless**。需要让结果参与场景光照、阴影和材质表现时，则保持关闭。
+
+## 接下来可以尝试
+
+- 主体需要透明背景：[转换时去除背景](remove-background.md)
+- 想要更强的透视结构：[转换为 Surface](guide-surface.md)
+- 输入是视频或序列帧：[制作动画 Depth Plane](animation.md)

docs/remove-background.md

@@ -0,0 +1,36 @@
+# 去除背景
+
+Remove Background 使用 BEN2 为 Image Empty 生成透明前景，不创建网格。它适合在转换前检查抠图效果，或继续把结果当作普通 Image Empty 使用。
+
+## 使用方法
+
+1. 选中 Image Empty。
+2. 在 3D View 中右键，选择 **SnapForm > Remove Background**。
+3. 等待状态栏提示任务完成。
+
+SnapForm 会创建新的透明颜色图，并把当前 Empty 切换到新图。对象的 Transform、显示尺寸、Offset 和其他显示设置保持不变。
+
+## 在转换时去除背景
+
+Depth Plane 和 Surface 的转换对话框也提供 **Remove Background**：
+
+- Depth Plane 会使用透明 Alpha 区分前景和背景深度。
+- Surface 会在写出网格前删除背景三角面。
+- 深度估算仍使用未经抠图的原始 RGB，避免透明区域提前影响模型判断。
+
+## 图片、视频和序列帧
+
+普通图片会得到一张透明 PNG。视频或序列帧会得到透明图片序列，并从源 Empty 的 Start 位置开始播放。处理范围跟随 **Image Frames** 和 **Offset**。
+
+!!! note
+    动画结果引用 Storage Root 中任务目录里的序列帧。不要在仍使用这些素材时删除对应的 Job 文件夹。
+
+## 常见问题
+
+### Remove Background 是灰色的
+
+确认 Environment 已安装，且 **MoGe-2 ViT-S Normal** 与 **BEN2 Base** 都显示 Ready。正式功能会等默认必需模型全部就绪后启用。
+
+### 透明边缘需要调整
+
+当前正式入口不提供 BEN2 refinement 参数。可以在结果材质中继续处理 Alpha，或在外部图像软件中修整生成的颜色图。

docs/server.md

@@ -1,5 +1,8 @@
 # Job Server
 
+本页记录 Environment、模型缓存和 Job Runtime 的内部设计。安装或使用遇到问题时，请先查看
+[安装与首次配置](installation.md)和[常见问题](faq.md)。
+
 ## 运行架构
 
 SnapForm 在独立的 Python 3.12 Environment 中运行 HTTP Job Server，Blender 只通过标准库 HTTP Client 提交和轮询任务，不把计算依赖载入 Blender Python。Server 只监听 `127.0.0.1`，由外置 BlendJob wheel 提供的 `ServerController` 保存随机端口与 Instance ID；专属本地进程协议不使用额外 Token 鉴权。

docs/stylesheets/extra.css

@@ -0,0 +1,13 @@
+:root {
+  --md-text-font: "Open Sans", "Noto Sans SC", "Microsoft YaHei", sans-serif;
+  --md-code-font: "Cascadia Code", "SFMono-Regular", Consolas, monospace;
+}
+
+.md-typeset h1 {
+  font-weight: 700;
+  letter-spacing: -0.02em;
+}
+
+.md-typeset .grid.cards > ul > li {
+  border-radius: 0.5rem;
+}

docs/surface.md

@@ -1,5 +1,8 @@
 # Surface
 
+本页记录 Surface 的网格、相机、Geometry Nodes 和材质实现。日常操作与参数说明请阅读
+[Surface 使用指南](guide-surface.md)。
+
 ## Image Empty 转透视网格
 
 1. 在 3D View 选中仅包含一帧的 Image Empty，右键打开 `SnapForm` 子菜单并选择

docs/workflows.md

@@ -0,0 +1,27 @@
+# 选择转换方式
+
+SnapForm 提供三种日常工作流。选择结果时，先考虑你需要的是可调节的“深度面片”、带透视结构的“空间网格”，还是只需要透明前景。
+
+| 工作流 | 适合场景 | 输入 | 结果 | 主要优点 |
+| --- | --- | --- | --- | --- |
+| Depth Plane | 人物、产品、插画、动态背景、快速场景搭建 | 图片、视频、序列帧 | 带深度位移的平面 | 快速、可动画、Geometry Nodes 参数直观 |
+| Surface | 建筑、室内、街景、需要匹配视角的单图 | 单张图片 | 透视纹理网格 | 空间感更强，可创建匹配相机 |
+| Remove Background | 抠出人物或物体，继续作为 Image Empty 使用 | 图片、视频、序列帧 | 带透明 Alpha 的颜色图 | 不创建网格，保留 Empty 的位置和显示设置 |
+
+## 什么时候选择 Depth Plane
+
+Depth Plane 把估算深度作为面片位移，特别适合需要快速获得层次感、又希望继续用少量参数控制结果的场景。它也支持视频和序列帧，是制作动态立体素材的首选。
+
+[阅读 Depth Plane 指南](guide-depth-plane.md)
+
+## 什么时候选择 Surface
+
+Surface 会根据模型估算的相机和深度构建透视网格。相较 Depth Plane，它能更自然地表达近大远小和画面内部的空间关系，但目前只支持单张图片。
+
+[阅读 Surface 指南](guide-surface.md)
+
+## 什么时候只去除背景
+
+如果只想把 Image Empty 换成透明前景图，不需要任何几何结构，直接选择 **Remove Background**。对象的 Transform、显示尺寸和 Offset 会保留。
+
+[阅读去除背景指南](remove-background.md)