# EasiestArtWorkflow

**Repository Path**: ssyyw/easiest-art-workflow

## Basic Information

- **Project Name**: EasiestArtWorkflow
- **Description**: 基于comfyui和开源模型的AI美术工作流
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-07
- **Last Updated**: 2026-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasiestArtWorkflow

**即插即用的 ComfyUI 美术资产工作流仓库** —— 文生图 / 图生3D / 文生3D，含中文提示词支持。

> 📖 **本文档同时是交接文档**：新接手的 AI Agent 请先读 §0 和 §4（环境陷阱），这两节能避免绝大多数返工。

---

## §0 三十秒速览（新 Agent 必读）

### 这是什么
一个 ComfyUI 工作流仓库 + 4 个模型包 + 一键部署脚本。目标：**解压 → 一条命令 → 拖 JSON 就能出图/出模型**。

### 当前状态
| 项目 | 状态 |
|------|------|
| 19 个工作流 | ✅ 节点需求已用 `/object_info` 接口交叉验证，无缺失 |
| 4 个模型包 | ✅ 已打包并校验（`E:\AI_ModelPacks\`，49.59 GB） |
| 一键脚本 `setup_models.py` | ✅ 沙箱端到端测试通过（含幂等性） |
| 4 个节点包加载 | ✅ 在目标环境实测 0 报错（1090 节点，Trellis2 84 个） |
| 开发机导出根路径 | ✅ 已改为素材库（见 §8） |

### ⭐ 三条最重要的事实（踩过的坑，别再踩）
1. **便携版 ComfyUI 自带独立 Python**（`python_embeded\`），与 conda 环境**毫无关系**。
   节点代码在 `custom_nodes\`，但 **Python 依赖装在解释器的 site-packages** —— 换机器不会跟着走。
2. **TRELLIS2 的原生轮子只支持到 torch 2.10.0**。新版便携包自带 torch 2.14 →
   报错为 `ImportError: DLL load failed while importing _C`（**不是**"找不到模块"，极易误判）。
3. **本仓库所有脚本一律用 Python**（无 .ps1）。写含中文的脚本必须 UTF-8；
   **不要用 PowerShell 5.1 跑含中文的 `.ps1`**（会按 ANSI 解析成乱码，曾因此建出乱码目录）。

---

## §1 目录结构

```
EasiestArtWorkflow\                     ← 本仓库（放在 ComfyUIWork 下）
├── README.md                           ← 本文档
├── setup_models.py                     ← ⭐ 一键部署 + 启动
├── install_native_deps.py              ← 原生扩展安装/自动修复（被上一脚本调用）
├── extra_model_paths.yaml              ← 让 ComfyUI 从 Models\ 读模型
├── my_nodes\                           ← 4 个节点包（复制到 custom_nodes）
│   ├── ComfyUI-Trellis2\               TRELLIS 2 全链路（含 wheels\ 预编译轮子）
│   ├── ComfyUI-Hunyuan3DWrapper\       Hunyuan3D 重建
│   ├── ComfyUI-ShapE\                  Shap-E 三节点（本仓库自研）
│   └── ComfyUI-ZHPrompt\               中文提示词（本仓库自研，含 data\ 数据）
└── ComfyUI_config\
    ├── workflow_json\                  ⭐ 19 个工作流（拖进网页即用）
    ├── prompts\                        英文提示词库 + 中文模板 + 术语表
    ├── scripts\                        68 个工具脚本（见 §13）
    ├── docs\                           14 份部署记录与方案评估
    └── setup\                          环境搭建脚本 + pip freeze 快照
```

---

## §2 目标环境布局

```
<任意目录>\
├── ComfyUI_windows_portable\           ← 解压的便携版 ComfyUI
│   ├── ComfyUI\  (含 main.py)
│   └── python_embeded\                 ← 它自带的 Python（独立于 conda！）
├── Models\                             ← 4 个模型包解压到这里
└── EasiestArtWorkflow\                 ← 本仓库
```

**`setup_models.py` 会自动**：定位 `main.py` → 复制 4 个节点包 → 复制 yaml →
建目录联结 → 体检模型 → 检查/安装依赖 → 启动 ComfyUI。

---

## §3 部署

### 方式 A：一键（推荐）

```powershell
python EasiestArtWorkflow\setup_models.py
```

依次执行 6 步并启动 ComfyUI：

| 步骤 | 动作 |
|------|------|
| 1 | 定位 ComfyUI 根目录 + **自动识别 `python_embeded`** |
| 2 | 复制 4 个节点包到 `custom_nodes\`（已存在则跳过）|
| 3 | 复制 `extra_model_paths.yaml` 到 ComfyUI 根目录 |
| 4 | 为 `Models\*` 建目录联结（`mklink /J`）|
| 5 | 体检 4 个模型包 + 检查 Python 依赖，缺失自动 `pip install -r` |
| 6 | **调用 `install_native_deps.py`** —— 装 triton/cumesh 等原生扩展，并自动循环补齐普通依赖 |
| → | 启动 ComfyUI（`--lowvram --disable-smart-memory --cache-none`）|

**幂等**：重复执行不会重复复制、不会重建已有链接。

| 参数 | 作用 |
|------|------|
| `--no-launch` | 只部署不启动 |
| `--check-only` | 只体检，不改动任何文件 |
| `--port 8189` | 换端口 |
| `--skip-deps` | 跳过依赖检查 |
| `--no-install` | 只报告缺失依赖 |
| `--extra "..."` | 追加 main.py 参数 |

### 方式 B：手动

```powershell
# 1) 节点包
copy EasiestArtWorkflow\my_nodes\*  ComfyUI\custom_nodes\
# 2) 路径配置
copy EasiestArtWorkflow\extra_model_paths.yaml  ComfyUI\
# 3) 目录联结（或让 extra_model_paths.yaml 覆盖标准类型）
python EasiestArtWorkflow\setup_models.py --no-launch
# 4) 依赖（两个大包必须装，否则节点加载失败）
pip install -r ComfyUI\custom_nodes\ComfyUI-Trellis2\requirements.txt
pip install -r ComfyUI\custom_nodes\ComfyUI-Hunyuan3DWrapper\requirements.txt
# 5) 原生扩展 + 自动补齐
python EasiestArtWorkflow\install_native_deps.py
# 6) 启动
cd ComfyUI
python main.py --lowvram --disable-smart-memory --cache-none
```

---

## §4 ⚠️ 环境陷阱（新 Agent 重点，全部真实踩过）

### 4.1 两套 Python，别搞混

| 解释器 | 说明 |
|--------|------|
| `<便携包>\python_embeded\python.exe` | **便携版默认用它**（`run_nvidia_gpu.bat` 调的就是它）|
| conda 环境 `comfyui` | 只有**显式用 conda 的 python 启动**才用它 |

**实测依赖可见性**（同一批包，三个解释器三种结果）：

| 解释器 | Python | triton | cumesh | o_voxel | flex_gemm | nvdiffrast |
|--------|--------|--------|--------|---------|-----------|-----------|
| 开发机 conda `comfyui` | 3.12.13 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 开发机 `python_embeded` | 3.13.12 | ❌ | ❌ | ❌ | ❌ | ❌ |
| 目标机 `python_embeded` | 3.13.14 | ✅ | ✅ | ✅ | ✅ | ✅ |

**结论**：**节点代码跟着 `custom_nodes\` 走，Python 依赖不跟着走**。
换环境必须在**目标环境的解释器**里重装依赖。

### 4.2 torch 版本必须匹配原生轮子（最隐蔽）

`ComfyUI-Trellis2\wheels\Windows\` 下的轮子只覆盖 **Torch270 / Torch280 / Torch2100**
（最高 **torch 2.10.0**）。新版便携包自带 **torch 2.14** → 症状：

```
ImportError: DLL load failed while importing _C: 找不到指定的程序。
```

（`.pyd` 链接 torch 2.10 符号，在 2.14 上找不到 → 系统级 DLL 错误，**不是** Python 层 ImportError）

**修复**（已验证官方有 cp313 轮子、sm_120 支持正常）：

```powershell
python_embeded\python.exe -m pip install torch==2.10.0+cu130 torchvision torchaudio `
  --index-url https://download.pytorch.org/whl/cu130
```

### 4.3 Windows 上 triton 的包名不同

```powershell
pip install triton-windows      # ✅ 提供 triton 模块
pip install triton              # ❌ Windows 上无官方轮子
```

### 4.4 TRELLIS2 的依赖是"打地鼠"

`nodes.py` 顶层 import 了 `triton / cumesh / o_voxel / flex_gemm / nvdiffrast / pymeshlab`，
缺一个就**整个包 IMPORT FAILED**（连带 7 个工作流全废）。修完原生扩展后还会缺普通包
（实测依次缺 `plyfile` → `zstandard` → `easydict`）。

**用 `install_native_deps.py` 的自动修复循环**，它会反复真实 import，缺啥装啥：
```powershell
python install_native_deps.py          # 含自动修复
```

### 4.5 中文路径与编码

- 中文路径（`素材库`、`术语表`）**可以正常用**，已实测落盘 ✅
- **含中文的脚本不要写成 `.ps1` 交给 PowerShell 5.1 跑** → 按 ANSI 解析成乱码（曾建出 `ShapE_鑽夌閾捐矾` 乱码目录）
- 用 `write` 工具写文件（自动 UTF-8 无 BOM）；`.ps1` 若必须存在则要 UTF-8 **带 BOM**

### 4.6 ComfyUI 输出路径

ComfyUI 只能有**一个输出根目录**（`--output-directory`），要分流只能用子路径前缀：

| 类型 | 前缀 |
|------|------|
| 3D 模型 | `AA_3D模型/AB_输出产物/AI_Born/...` |
| 图片 | `AA_图片资产/AB_输出产物/AI_Born/...` |

配法：启动加 `--output-directory "E:\Documents\素材库"`，工作流里的前缀已按上表配好。

---

## §5 ⭐ 工作流总表（19 个）

文件名前缀 = **实际使用的模型/节点**（由脚本按 `CheckpointLoaderSimple` 与节点类型自动判定，
不是手工标注）。`+` 表示同时需要。

| 工作流 | 所需模型包 | 说明 |
|--------|-----------|------|
| `[Anime] t2i_anime_single.json` | `1_T2I` | Animagine 动漫出图（**最快，15 秒/张**）|
| `[SDXL] t2i_single.json` | `1_T2I` | SDXL 纯文生图 |
| `[SDXL] t2i_sheet_4view.json` | `1_T2I` | 四视图拼图（⚠️ **不可用于 3D**，仅供看图）|
| `[SDXL+LoRA] t2i_single_lightning.json` | `1_T2I` | 4 步极速出图 |
| `[TRELLIS2] mesh_only.json` | `0_3D` + `1_T2I` | 图片 → 白模 |
| `[TRELLIS2] mesh_only_lowpoly.json` | 同上 | 低面数版 |
| `[TRELLIS2] mesh_with_texturing.json` | 同上 | 图片 → **带贴图模型** ⭐ |
| `[TRELLIS2] mesh_with_texturing_fast.json` | 同上 | 快速版（贴图分辨率降档）|
| `[SDXL+TRELLIS2] chain.json` | 同上 | 标准质量链路 |
| `[SDXL+TRELLIS2] chain_fast.json` | 同上 | 快速链路 |
| `[SDXL+TRELLIS2+翻译] chain_zh.json` | 同上 + 可选 `3_Translate` | ⭐ **中文一句话 → 带贴图 3D** |
| `[ShapE] shape_draft.json` | `2_ShapE` | ⭐ **7 秒出 3D 草稿**，支持文本/图片，自带顶点色 |
| `[Hunyuan3D] mini_shape_only.json` | `0_3D` | 仅生成几何 |
| `[Hunyuan3D] mini_face_ctrl.json` | `0_3D` | 面部控制 |
| `[Hunyuan3D] mv_3view.json` | `0_3D` | 三视图 → 3D |
| `[Hunyuan3D] mv_3view_quality.json` | `0_3D` | 高质量三视图 |
| `[Hunyuan3D] mv_3view_raw.json` | `0_3D` | 原始三视图（需自备图）|
| `[Hunyuan3D] mv_4view.json` | `0_3D` | 四视图 → 3D |
| `[Hunyuan3D] mv_4view_quality.json` | `0_3D` | 高质量四视图 |

> **已删除**：`[Hunyuan3D] mini_8g.json`（依赖未安装的 `ComfyUI_essentials`，从未验证成功）

### 按用途选链路

| 你想要 | 用这个 | 8GB 卡实测耗时 |
|--------|--------|---------------|
| 快速看形态/配色 | `[ShapE] shape_draft` | **7 秒** |
| 出一张好看的图 | `[Anime] t2i_anime_single` | 15 秒 |
| 中文一句话出带贴图模型 | `[SDXL+TRELLIS2+翻译] chain_zh` | 4~8 分钟 |
| 有参考图出模型 | `[TRELLIS2] mesh_with_texturing` | 3~5 分钟 |
| 严格三视图重建 | `[Hunyuan3D] mv_3view` | 需 12GB+ 显存 |

---

## §6 模型包清单（`E:\AI_ModelPacks\`）

| 包 | 压缩 | 解压 | 内容 |
|----|------|------|------|
| `0_3D_Hunyuan_TRELLIS2.zip` | 18.08 GB | 22.44 GB | Hunyuan3D-2mini（DiT×3+VAE×3）+ TRELLIS.2-4B-FP8 + dinov3 + TRELLIS-image-large |
| `1_T2I_SDXL_Animagine.zip` | 14.70 GB | 17.11 GB | SDXL base + Animagine XL 4.0 + **SDXL VAE(fix)** + Lightning LoRA + ControlNet OpenPose |
| `2_3D_ShapE.zip` | 8.90 GB | 10.88 GB | Shap-E 文生3D + 图生3D |
| `3_Translate.zip` | 7.92 GB | 10.49 GB | Qwen2.5-3B / 1.5B + opus-mt-zh-en |
| **合计** | **49.59 GB** | **60.92 GB** | |

**内部结构已按 ComfyUI 规范排好**，四个包都解压到同一个 `Models\`，互不覆盖：

```
Models\checkpoints\  vae\  loras\  controlnet\  diffusion_models\
       visualbruno\  facebook\  microsoft\  shap-e\  translate\
```

> Hunyuan 打包时**跳过 5 个重复的 `.ckpt`**（同目录有同名 `.safetensors`），省约 9 GB。
> `hunyuan3d-vae-v2-mini-withencoder` 只有 `.ckpt`，已保留。

---

## §7 使用方法

### 7.1 快速验证部署是否成功

1. 拖入 `[ShapE] shape_draft.json`
2. 「② 生成网格」提示词填 `a tall square stone tower with a pointed roof`
3. seed 下拉选 `randomize` → Queue
4. 约 7 秒后「④ 3D 预览」出现塔楼

**预期**：面数 1.7~7 万、`watertight=True`、含顶点色、Y-up 且底部贴地。

### 7.2 中文提示词（`chain_zh.json`）

在 `★ 中文提示词` 节点里：

| 参数 | 填什么 |
|------|--------|
| **目标_只改这一栏** | ⭐ 中文，如 `女骑士` / `宝箱` / `一名身着麻布衣服的农民` |
| 风格模板 | 8 套：米哈游 / 帝国时代 / 艾尔登法环 / 写实CG × 人物/物件 |
| 翻译后端 | `qwen3b` 首选 / `qwen15` 省内存 / `opusmt` 最省 |
| 额外描述_可选 | 补充细节：`细致金属盔甲，头盔，长剑` |

**翻译机制**：术语表（192 条）**段内最长优先匹配** → 命中即精确替换；未命中的自由文本才交给翻译模型。

**术语表**（改完即时生效，无需重启）：
```
EasiestArtWorkflow\my_nodes\ComfyUI-ZHPrompt\data\术语表_zh_en.txt
```
遇到译错的词，加一行 `中文=English` 即可。模板同理在 `data\zh_templates\`。

> **模板已做防过拟合**：模板只描述"怎么画"（画风/光照/配色/画质），**不含任何装备材质**。
> 想给角色加盔甲武器，写在「额外描述」里，不会污染其他对象。

### 7.3 Shap-E 要点

| 节点 | 关键参数 | 说明 |
|------|---------|------|
| 加载管线 | `unload_unused` | 4GB 卡开 true |
| 生成网格 | `seed` | **下拉选 randomize = 连续抽卡**（同提示词造型差异极大：面数差 4 倍、粗细差 3 倍）|
| | `image`（可选）| 接上就自动走图生3D，不用改设置 |
| 导出模型 | `up_axis_fix` | 默认 `Z-up 转 Y-up`，**不要改**，否则模型躺倒 |
| | `ground_align` | 默认 true，底部对齐 y=0 |

**Shap-E 输出的是逐顶点色（`vertex_channels`），不是贴图**——官方展示之所以有颜色正是用了这条通道。
导出节点已自动：修正朝向 + 写 NORMAL + 补材质（`metallicFactor=0`，否则 Blender 里发黑）。

---

## §8 参数与性能备忘（8GB RTX 5060 实测）

### 启动参数（必加）
```powershell
python main.py --lowvram --disable-smart-memory --cache-none --output-directory "E:\Documents\素材库"
```
`--disable-smart-memory` **必加**，否则显存颠簸：SDXL 从 0.6 s/step 恶化到 53 s/step。

### 实测性能
| 项目 | 值 |
|------|-----|
| Animagine 28 步出图 | 15 秒（0.6 s/step）|
| ControlNet + Animagine | **53 s/step（8GB 不可用）** |
| TRELLIS 2 几何 | 80~110 秒 |
| TRELLIS 2 贴图 512/1024 | 83 秒；1024/2048 → 246 秒 |
| Shap-E 草稿 | 5~17 秒（峰值显存 2.39 GB，**4GB 卡可跑**）|
| Hunyuan mini 三视图端到端 | 495 秒 |

### 输出路径（已配置）
| 类型 | 前缀 |
|------|------|
| 3D（T2I 路线 + ShapE 路线）| `AA_3D模型/AB_输出产物/AI_Born/...` |
| 图片（SDXL + Animagine）| `AA_图片资产/AB_输出产物/AI_Born/...` |

---

## §9 验证与自检（给 Agent 的命令）

```powershell
# ① 只体检，不改任何文件
python EasiestArtWorkflow\setup_models.py --check-only

# ② 检查原生扩展状态（含真实 import 测试）
python EasiestArtWorkflow\install_native_deps.py --dry-run

# ③ 确认节点包是否加载成功（权威方法：查 ComfyUI 自己的注册表）
#    启动 ComfyUI 后访问： http://127.0.0.1:8188/object_info
#    正常应返回 1000+ 节点；搜索 "Trellis2" 应有 84 个
#    启动日志里出现 "IMPORT FAILED" 即为失败

# ④ 校验工作流节点完整性
python EasiestArtWorkflow\ComfyUI_config\scripts\validate_workflows.py
```

**判断节点包是否加载成功的可靠依据**：
- 启动日志 `Import times for custom nodes:` 段落，**无 `(IMPORT FAILED)`**
- `/object_info` 里能搜到对应节点名

> `Note` / `PrimitiveNode` / `Reroute` 是**前端专用节点**，不会出现在 `/object_info` 里，
> 用接口核对时显示"缺失"属**误报**，不要据此判断。

---

## §10 故障排查

| 现象 | 原因 | 处理 |
|------|------|------|
| 节点输入类型显示 `UNKNOWN` | ComfyUI 没重启 / 浏览器缓存 | 重启服务 + `Ctrl+F5` |
| `(IMPORT FAILED)` Trellis2 | 缺原生扩展或依赖 | 跑 `install_native_deps.py`（含自动修复）|
| `DLL load failed while importing _C` | **torch 版本与轮子不匹配** | 降级 torch 到 2.10.0+cu130（§4.2）|
| `No module named 'triton'` | 未装或装错包名 | `pip install triton-windows` |
| 工作流报"模型找不到" | 模型包没解压/路径不对 | `setup_models.py --check-only` 看体检 |
| 出图是黑图 | 缺 SDXL VAE | 确认 `Models\vae\sdxl_vae_fp16_fix.safetensors` |
| 采样慢到几十秒/步 | 缺 `--disable-smart-memory` | 加参数 |
| Shap-E 模型躺倒 | 未做 Z-up→Y-up | 导出节点 `up_axis_fix` 用默认档 |
| 3D 输出是平板 | 输入图**黑底** | **必须用纯白背景**（黑底实测输出平面度 0.44%）|
| 出图是分格转面表 | 提示词含 `reference sheet` | 用 `prompts\` 里的模板 |
| 生成物全是盔甲头盔 | 模板过拟合 | 已修复；装备写「额外描述」|
| 中文提示词译错 | 术语表未收录 | 加一行到 `术语表_zh_en.txt` |

---

## §11 已知问题与修复历史（避免重复排查）

| 问题 | 根因 | 修复 |
|------|------|------|
| TRELLIS2 整包加载失败 | 顶层 import 缺原生扩展 | 装 5 个 cp313 轮子 + `triton-windows` |
| `DLL load failed: _C` | torch 2.14 vs 轮子 2.10 | 降级 torch |
| 连续缺 `plyfile`/`zstandard`/`easydict` | 依赖链未完整声明 | 自动修复循环 |
| 模型在 Blender 里发黑 | 材质 `metallicFactor=1.0` + 无 HDRI | 导出节点自动置 0；旧文件用 `scripts\fix_glb_material.py` |
| Shap-E 模型躺倒 | 输出 Z-up，glTF 要 Y-up | 导出节点加 `-90°X` 旋转 + 底部对齐 |
| Shap-E 白膜无颜色 | 漏读 `vertex_channels` | 已写入 `COLOR_0` 顶点色 |
| 模板过拟合（农民变盔甲兵）| 模板硬编码 `细致金属盔甲` | 模板只留"怎么画" |
| 自然长句命中不了术语表 | 原为整段精确匹配 | 改为段内最长优先匹配 |
| 工作流命名与实际不符 | 手工标注出错 | 改为按实际底模/节点自动命名 |
| `setup_models.py` 找不到 main.py | `$PSScriptRoot` 是脚本目录而非工作区 | 改用 `SCRIPT_DIR.parent` |
| 中文 `.ps1` 建出乱码目录 | PowerShell 5.1 按 ANSI 解析 UTF-8 | 全部脚本改 Python |

---

## §12 待办与未验证项

| 项 | 说明 |
|----|------|
| **开发机 `python_embeded` 缺依赖** | 若在开发机双击 `run_nvidia_gpu.bat` 启动，TRELLIS2 会挂。用 conda python 启动则正常 |
| `[Hunyuan3D] mini_8g.json` | 已删除（依赖 `ComfyUI_essentials`，从未验证成功）|
| ControlNet OpenPose 链路 | 8GB 卡 **53 s/step 不可用**；骨架图已生成在 `test_inputs\openpose\`，等 12GB+ 卡 |
| 首选项 3B 翻译模型 | 实测 3B 不比 1.5B 好（`板甲`→`wearing a deck`），最终靠**术语表优先**架构 |
| TRELLIS-text-xlarge | 因 spconv 需 cu126 而开发机是 sm_120，评估后搁置 |

---

## §13 脚本清单（`ComfyUI_config\scripts\`，68 个，按用途分组）

| 分组 | 代表脚本 |
|------|---------|
| **工作流生成** | `gen_chain_workflow.py` `gen_t2i_workflow.py` `gen_anime_t2i_workflow.py` `gen_shape_workflow.py` `gen_mv_workflow.py` |
| **工作流修补** | `patch_output_paths.py` `patch_face_limit.py` `restore_stitch_chain.py` `build_zh_workflow.py` `rename_workflows_by_model.py` |
| **提示词/模板** | `make_zh_templates.py` `rebuild_zh_templates.py` `fix_template_overfit.py` `add_realistic_cg_prompts.py` |
| **诊断验证** | `validate_workflows.py` `verify_trellis2_nodes.py` `diag_shape_orientation.py` `trellis2_input_diag.py` `test_shape_export_fix.py` |
| **模型下载** | `download_sdxl.py` `download_shap_e.py` `download_trellis2_models.py` `download_qwen3b.py` |
| **3D 处理** | `glb_cleanup.py` `fix_glb_material.py` `glb2blend.py` `iso_sprite_render.py` `split_parts.py` |
| **打包** | `package_models.py` `package_shapE.py` `package_trellis2.py` |
| **冒烟测试** | `shap_e_draft.py` `shap_e_smoke_test.py` `trellis2_smoke_test.py` `coexist_vram_test.py` |

> 这些脚本多数面向**开发机**（硬编码 `D:\AI\...`、`E:\Documents\AI\...` 路径），
> 换到新环境时注意改路径，或只把它们当参考。

---

## §14 模型许可

| 模型 | 许可 | 商用 |
|------|------|------|
| SDXL base 1.0 | CreativeML Open RAIL++-M | ✅ |
| Animagine XL 4.0 | Fair AI Public License 1.0-SD | ✅ 需开源衍生 |
| TRELLIS 2 (visualbruno FP8) | MIT / 见原仓库 | ✅ |
| Hunyuan3D-2mini | Tencent 社区许可 | ⚠️ 查看条款 |
| Shap-E | MIT | ✅ |
| Qwen2.5 | Apache 2.0 | ✅ |
| opus-mt-zh-en | CC-BY 4.0 | ✅ |

---

*本仓库为工作流与配置集合；模型权重按上述许可分发，请自行确认商用合规性。*