0 · 三分钟看懂：安装中心干什么
安装中心解决两件事：① 装/更新「功能包」（代码，很小）；② 下「模型文件」（很大，几十 GB）。它是整套工作台的「补给站」——新电脑第一次用、或者某个功能提示「模型缺失」，都来这里点一下。
入口在哪
- 工作台首页顶部导航 →
🧩 安装中心 - 直链：
http://127.0.0.1:8090/setup（各功能页顶栏也有入口）
页面分三段
| 区块 | 是什么 | 你要做什么 |
|---|---|---|
| ① 功能包 | 每个功能的代码包（引擎包、素材包、写歌、小说、配音、直播切片、小红书…），几 KB ~ 几 GB | 「未安装」→ 点「安装」；「有更新」→ 点「更新」 |
| ② 模型文件 | AI 权重（写歌 3 个共 ~13.3GB、配音/字幕 ~6.4GB 等），按功能分组显示 | 缺哪个点「下载缺失」，支持断点续传 |
| ③ 说明 | 口径提示，例如「本机已有」是什么意思 | 看一遍就不困惑了 |
「功能包」和「模型」是分开的：包小、经常更新；模型大、很少变。所以升级一个功能通常只需要下几 MB 的包，不用重下几十 GB 的模型。
① 功能包：安装 / 更新
干什么用的每个功能就是一个「包」。装完之后对应功能的页面才能打开、才有点数计费、才有返回栏。
常见包一览
| 包 | 作用 | 体积 |
|---|---|---|
| engine 引擎包 | ComfyUI + Python 运行时（写歌、短剧、小红书出图、换脸共用） | 约 2.7GB |
| media 素材包 | ffmpeg/ffprobe + 离线依赖（字幕打轴、去重、去水印、体检要用） | 约 444MB |
| music 写歌包 | 写歌模块代码 + 风格池 + 声线池 + 工作流 | 不到 200KB |
| novel 小说包 | 小说工作台后端 + 页面 + 敏感词库 | 约 90KB |
| voice 配音包 | 配音/字幕素材（模型走「模型文件」区单独下） | 几 KB |
| prompts_lib / tpl_lib | 提示词库、模板库 | 几十 KB |
| slice / xhs / copy / … | 直播切片、小红书、文案工坊、批量封面、图片工具、资产库、文档箱、提示词管理器 | 每个几十 KB |
怎么装 / 更新
- 看「① 功能包」列表里的状态：未安装 / 已装 1.0.1 / 有更新（本地 1.0.1 → 最新 1.0.3）
- 点右边的「安装」或「更新」按钮 → 显示进度（下载 → 校验 → 解压 → 替换）
- 更新时会自动保留你的数据：作品的 output、历史、config、缓存都在保留名单里，不会被覆盖
- 个别包更新后需要重启对应服务，页面会提示；也可以直接「重启前端」
更新机制是「补丁式」：下载 → SHA256 校验 → 解压到新目录 → 替换 → 旧版本留一份可回滚。中途失败不会把现有功能弄坏。
不要手动去网站点下载 zip 再解压——那会下到「下载文件夹」里，还得自己解压归位。用这里的按钮才是一步到位。
② 模型文件：缺哪下哪（断点续传）
干什么用的AI 效果靠权重文件。缺模型时功能会提示「模型缺失 / 未就绪」，来这里点一下下载即可。
当前分组
| 分组 | 包含 | 体积 | 谁需要 |
|---|---|---|---|
| music（写歌） | DiT fp16（4.7GB）+ 文本编码器 int8（8.8GB）+ VAE（0.2GB） | 约 13.3GB | AI 写歌 |
| voice（配音/字幕） | ASR 语音识别 paraformer（0.8GB）+ Breeze TTS 音色模型（约 5.6GB） | 约 6.4GB | 有声书配音、字幕打轴、AI 配音 |
怎么下
- 看每组的「文件 0/3 · 0.00 / 13.34 GB」进度
- 点「⬇ 下载缺失」→ 开始按文件下载（支持断点续传，断了再点会接着下）
- 全部到位后状态变成「✅ 就绪」，对应功能直接可用
「本机已有，无需下载」是什么？开发机上模型放在运行目录（如
D:\AI-MusicStudio\comfyui\models、E:\AI-Media\models），安装中心会同时检查这些老目录，所以显示「本机已有」。发给别人的新电脑上会显示「下载缺失」，点一下就能下——两边都对，不是 bug。下载大模型时，别同时跑写歌/短剧这类吃显卡的任务（会抢显存/带宽）。夜里挂着下最省事。
③ 更新：用户端怎么拿到新版本
干什么用的我这边改完功能会打包发布，你那边的「功能包」列表就会显示「有更新」，点一下自动升级。
- 打开安装中心 → 看每行的版本号（本地 vs 最新）
- 点「更新」→ 自动：下载补丁 → SHA256 校验 → 解压 → 替换 → 保留你的作品数据
- 如果页面提示「服务需重启」，点一下重启即可（不影响你的作品，作品都在数据目录）
手机/浏览器端也是同一套：服务端升级后，用户刷新页面就是新版；本地端则通过这里的「更新」按钮拉补丁。
更新前建议别在跑任务（尤其出歌/短剧/配音），等任务跑完再更新，避免中途重启打断任务。
④ 需要多少硬盘？
| 项目 | 体积 |
|---|---|
| 功能包（全部模块代码） | 约 3.2GB（其中引擎包 2.7GB） |
| 写歌模型 | 约 13.3GB |
| 配音 + 字幕模型 | 约 6.4GB |
| 出图/一致性（小红书、首帧） | 约 11GB |
| 视频（短剧 · WAN2.2） | 约 20GB（4 个 GGUF 量化权重） |
| 口型（Wav2Lip / MuseTalk / LatentSync） | 约 9.3GB |
| 作品输出（按你自己用） | 每首歌 3~10MB，每集短剧几百 MB |
建议给工具所在盘留 ≥80GB 空闲，跑短剧/批量生成时更宽裕。
不需要的功能可以不装模型：不装视频模型就不用短剧，不装配音模型就不用有声书——按需下载是刻意的设计。
⑤ 检查更新：一键对比魔搭远端版本
干嘛用不用一个个翻，一键看哪些功能包有新版本。
怎么用
- 顶部「🔄 检查更新」→ 逐个功能包对比魔搭（ModelScope）远端版本。
- 列出可更新项（本地版本 → 远端版本），可单个更新或「▶ 全部更新」，带进度条。
- 已是最新的包显示「已最新 / 所有功能包都已是本机最新版本 ✅」。
实测：共 20 个功能包参与对比；此前配音包 1.0.0 → 1.0.3 更新成功。
⑥ 常见问题 FAQ
1）点了「安装/下载」没反应？
先看按钮下面有没有进度行：有进度＝在跑。若提示「未登录」，先在右上角登录（手机号 + 登录码）。
2）下载卡在 99% 或断了？
下载支持断点续传，再点一次同一个按钮会从断点继续；不必重头下。
3）更新后功能打开是空白/报错？
先 Ctrl+F5 强刷页面；还不行就看功能页的「后台日志」区，通常是该功能的后端服务没起来（点一下对应入口会自动拉起）。
4）显示「本机已有，无需下载」，但我其实没下过？
说明模型在开发机老目录里被复用，可以直接用；发给别人的机器才会显示要下载。
5）「有更新」但我不想升级怎么办？
可以不动——已装版本继续能用。但新功能/修好的 bug 只有升级后才生效。
6）断电/断网中断安装会不会弄坏？
不会。下载是临时文件 + 校验后才替换；替换前会备份旧版本，中途失败旧版还在。
教程随功能更新 · 安装中心（/setup）