# VuGen 用户文档

> 生成引擎扩展包 · Generation engine packs
>
> 本文档随产品迭代更新。**这是首版，覆盖安装与上手；深入用法会陆续补。**
> 有写错或没写到的，欢迎提 issue。

## 这是什么

打包好的 ComfyUI Python 内核加工作流，为 VuuMake 各应用提供生图、生视频、生音乐、生 3D 的能力。加一个引擎就是加一个工作流和对应模型，在设置里直接添加。

## 能做什么

- 内核（core）体积以 GB 计，含运行时；任务包（pack）只是一份工作流 API JSON，以 KB 到 MB 计
- 任务包用 requires_core 声明依赖哪个内核，引擎按能力泛化命中而非写死 id
- manifest 遵循 vugen-manifest.schema.json，参数暴露白名单决定用户能调什么

## 安装

VuGen 不是一个单独的 App，而是各应用共用的生成能力来源，按需装：

1. 从[下载页](https://vuumake.com/products/vugen.html)取发布物——版本永远是最新的，
   页面上的清单每次构建都从 <https://huggingface.co/VuNiti/VuGen> 重新枚举
2. **先装一个内核**（`VuGen_Engine_…`，GB 级，含 ComfyUI Python 运行时）
3. 再按用途加任务包（`VuGen_SDXL_…`、`VuGen_H3_Turbo_…` 等，KB 到 MB 级）

任务包在 manifest 里用 `requires_core` 声明依赖哪个内核；内核不在就装不上，
这是设计如此，不是缺陷。

## 怎么被用到

装好之后不需要在界面里"选引擎"：VuuPix 等应用按**能力**去匹配——
你要的是"能跑 t2i、支持 16:9、可商用"，而不是某个写死的引擎 id。
新装的任务包条件更优就自然被选中，调用方一行都不用改。

## 改名说明

这套系统早期叫 **GenPack**，现已统一改名为 **VuGen**：HF 仓库、发布物前缀、
能力命名空间（`vugen:<id>.<能力>`）都是新名，是永久改名。
只有 HF 上遗留的 `MusicCore_GenPacK_V100.zip` 还带旧名，下次发版会自然消失。

## 相关

- [产品页](https://vuumake.com/products/vugen.html)
- [全部文档索引](https://vuumake.com/api/docs/index.json)
- [开放协议与 Schema](https://github.com/VuNiti/VuuMakeWebsite/tree/main/schemas)