nan
4a69d162a0
Some checks failed
构建扩展 / build (push) Failing after 24s
- 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.
54 lines
2.0 KiB
Markdown
54 lines
2.0 KiB
Markdown
# 模型、设备与存储
|
|
|
|
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 后，确认你检查的是当前目录中的日志。
|