把 Duix.Avatar（原名 HeyGem）的 lite 版本，从「照着教程敲半小时」变成「双击两个 bat」。
本包不含任何模型、镜像或客户端程序，只有配置文件、预检脚本和排错文档。所有二进制都由你的电脑从官方源直接获取。
整理：AINoSleep · 更多工具与教程 → https://ainosleep.com/duix （本包与硅基智能 / Duix.com 官方无关，问题请到上面的页面反馈，不要去打扰原项目作者）
官方部署流程有四个坑，这个包把它们都填了：
| 坑 | 本包的处理 |
|---|---|
| 完整版要下 40.7 GB | 换成 lite 单镜像，只要 5.00 GB |
| 数据目录写死在 D 盘 | .env 里自选盘符，脚本自动建目录联接桥接过去 |
| 环境哪里不对只能靠猜 | 8 项预检，直接告诉你缺什么、怎么补 |
| 报错信息全是英文堆栈 | docs/常见报错.md 按症状索引 |
这三样必须你自己装，任何压缩包都代替不了：
- NVIDIA 显卡 + 驱动 ≥ 525，显存 ≥ 8 GB — https://www.nvidia.cn/drivers/lookup/
- WSL2 — 管理员身份运行
wsl --install，然后重启电脑 - Docker Desktop — 设置里勾上
Use the WSL 2 based engine
另需：Windows 10 Build 19042 以上、内存 ≥ 16 GB（推荐 32 GB）、目标盘空闲 ≥ 20 GB。
不确定自己够不够？直接跑第 1 步，脚本会逐项告诉你。
从网上下载的压缩包会被 Windows 打上 Mark of the Web 标记，解压出来的每个脚本都会继承它，双击时可能被拦下、或者提示「Windows 已保护你的电脑」。
所以解压前先做这一步：
右键 duix-config-pack.zip → 属性 → 常规页底部
→ 勾选「解除锁定」→ 确定 → 再解压
没有「解除锁定」这个勾选框，说明系统没给它加标记，直接解压即可。
不想解除锁定也行——本包所有脚本都是纯文本，可以先在 GitHub 上逐行读完再决定： https://github.com/AINoSleep/duix-config-pack
这也是它放 GitHub 而不是只挂网盘的原因：让你能先看再跑。
1. 双击 1-环境预检.bat 看看缺什么，按提示补齐
2. 编辑 deploy\.env 改 DUIX_DATA 到你想存数据的盘（可跳过，默认 D 盘）
3. 双击 2-一键部署.bat 拉镜像 + 起服务，约 5 GB 下载
4. 装官方客户端 见下方链接，选 lite-setup 那个
客户端要自己去官方下载（本包不转发二进制）：
- Releases 页面：https://github.com/duixcom/Duix-Avatar/releases
- 选
Duix.Avatar-x.x.x-lite-setup.exe（约 202 MB），不要选普通版
停止服务：双击 3-停止服务.bat。数据不会被删。
这是选择 lite 最重要的一件事，装之前先看清楚：
| 功能 | lite | 完整版 |
|---|---|---|
| 上传音频 → 对口型生成视频 | ✅ | ✅ |
| 输入文字 → 自动配音生成视频 | ❌ | ✅ |
| 声音克隆 | ❌ | ✅ |
| 下载体积 | 5.00 GB | 40.7 GB |
| 显存要求 | 8 GB | 12 GB+ |
原因：lite 只启动视频生成一个服务，没有 TTS（fish-speech）和 ASR（fun-asr）。而客户端的配音功能依赖 127.0.0.1:18180 的 TTS 服务。
所以 lite 的正确用法是：你自己录好口播音频（或用任意 TTS 工具生成），再让它对口型。
要完整功能，用官方的 docker-compose.yml，代价是多下 35.7 GB。
duix-config-pack/
├─ 1-环境预检.bat → scripts/precheck.ps1
├─ 2-一键部署.bat → scripts/deploy.ps1
├─ 3-停止服务.bat
├─ deploy/
│ ├─ docker-compose-lite.yml 卷路径参数化 + 锁定镜像 tag
│ └─ .env.example 数据目录与端口配置
├─ scripts/
│ ├─ common.ps1 输出与检测辅助
│ ├─ precheck.ps1 8 项环境预检
│ └─ deploy.ps1 建目录 / 桥接 / 拉镜像 / 起服务
├─ docs/
│ ├─ 路径说明.md D 盘硬编码是怎么回事，没有 D 盘怎么办
│ └─ 常见报错.md 按症状索引的排错表
└─ 第三方许可与来源.md ⚠️ 商用前必读
Duix.Avatar 的宣传和它自己的协议文本是互相矛盾的：
| 文件 | 说法 |
|---|---|
README_zh.md |
支持全球免费商用，10 万用户 / 1000 万美元才需授权 |
LICENSE |
月活 超过 1000 就要申请商业授权 |
| 《模型社区许可协议》PDF | 仅限非商业用途；商用需书面授权；自然人不得申请 |
如果你打算拿它做带货视频、接单、或任何形式的变现，请自己先把这三份文件读一遍，必要时咨询律师。细节见 第三方许可与来源.md。
另外，中国大陆的《互联网信息服务深度合成管理规定》要求深度合成内容添加标识。用它生成的视频对外发布时，记得加标注。
用别人的脸做数字人，务必先拿到对方书面授权。
本包的问题（脚本报错、文档写错）→ https://ainosleep.com/duix
Duix.Avatar 本身的问题（生成效果、模型报错）→ https://github.com/duixcom/Duix-Avatar/issues
请不要把本包的问题提到原项目仓库。