AvatarHub 使用手册
从装机到直播出镜的完整指南:系统要求、安装激活、四大场景上手、更新与故障排查。
01产品概览
AvatarHub 是本地部署的实时数字人引擎:声音克隆、实时换脸、数字人直播、克隆音同传四大能力装在你自己的电脑或服务器上,数据不出机房。核心链路:说话 → 语音识别 → 大模型 → 克隆音合成 → 实时口型 / 换脸 → 直播推流或视频通话。
- 声音克隆:10 秒样本零样本克隆,多语种真实合成。
- 实时换脸:直播 / 视频通话实时出镜,支持 OBS 虚拟摄像头。
- 数字人直播:克隆音 + 实时口型的数字人,支持互动问答。
- 克隆音同传:说中文,对方听到你自己音色的外语。
02系统要求
| 项目 | 最低 | 推荐 |
|---|---|---|
| 操作系统 | Windows 10 (x64) | Windows 11 (x64) |
| 显卡 | NVIDIA 4 GB 显存(仅声音克隆) | NVIDIA 8 GB+(实时换脸 / 数字人);24 GB(同传全家桶) |
| 内存 | 16 GB | 32 GB |
| 磁盘 | SSD 预留 40 GB | SSD 预留 80 GB |
| 网络 | 首次安装需联网下载组件 | 50 Mbps+(组件下载更快) |
macOS 12+(Apple Silicon / Intel)版本为轻量控制台 / 远程接入:换脸、数字人等重推理仍需 Windows / 服务器 N 卡,Mac 端连接远程引擎使用,即将上线。
03下载与安装
- 1下载安装包(约 1 分钟)
在本页点击下载按钮,获取 AvatarHub-Setup-x.x.x.exe(约 45 MB 的,AI 组件稍后按需下载)。 下载完成后可核对本页给出的 校验值:在 PowerShell 运行 certutil -hashfile 安装包路径 SHA256,比对是否一致。
- 2运行安装程序(约 1 分钟)
双击安装包,一路点 下一步 即可。按用户安装、免管理员权限,可自选安装目录。安装完成后,桌面与开始菜单会出现 AvatarHub 图标。 常见卡点:最常见卡点: 提示「已保护你的电脑」——这是 Windows 对新发布程序的例行提醒,不是病毒报警。点 更多信息 → 仍要运行 即可;不放心可先核对 再放行。
- 3首次启动 · 硬件检测(约 2 分钟)
双击打开 AvatarHub,会自动检测你的显卡,并推荐适合的功能(入门 / 标准 / 旗舰),不用敲一行命令。 入门档(4–6 GB [[显存]]):声音克隆、图片 / 视频换脸。 标准档(8 GB+ 显存,RTX 3060 起):实时换脸、数字人直播。 旗舰档(24 GB 显存,RTX 4090 / 5090):实时高清 + 克隆音同传全家桶。
- 4组件自动下载(约 10–30 分钟(视网速))
确认档位后,向导自动下载所需 AI 组件与模型。全程 校验、支持。组件体积按档位约 10–60 GB,建议预留 80 GB SSD 空间;下载期间可以先熟悉界面。 常见卡点:下载慢或中断了?直接关掉重开 AvatarHub 即可——会从断点继续,已完成的部分不会重下。弱网建议换更稳的网络再继续。
- 5激活或开始试用(约 1 分钟)
在 设置 → 授权 输入订单号即可(自动取回已签授权);没有订单也可以直接开始 14 天免费试用,无需登记任何信息。
- 6验证安装(约 5–10 分钟)
启动器点 启动全部,等待各服务就绪灯变绿;点 一键体检 全绿即安装成功。再做个 10 分钟:控制台上传一段 10 秒清晰人声 → 克隆 → 试听,出声即一切正常。
04激活与试用
- 14 天免费试用:安装后无需任何操作即可开始试用全部已下载功能。
- 在线激活:购买后在「设置 → 授权」输入订单号,自动取回已签授权,立即生效。
- 授权与硬件绑定:更换整机请提前联系客服迁移授权。
查看授权状态:控制台「设置 → 授权」页展示当前版本、授权类型与到期时间。
05快速上手 · 克隆声音并对话
- 1上传声音样本
控制台 → 角色/声音 → 上传一段约 10 秒的清晰人声(少杂音、别太短)。
- 2克隆并试听
点 克隆 → 试听,满意后 激活 该角色。
- 3开始对话
进入对话页(电脑)或手机页(同一 WiFi 下手机访问),打字或按住麦克风说话,数字人用克隆音 + 口型实时回应,支持中途打断。
06直播 / 视频通话换脸出镜
- 1装虚拟设备
安装 OBS Studio()与 VB-Cable(),只需装一次。
- 2准备出镜角色
控制台新建 / 激活 一个出镜角色(上传要变成的人脸)。
- 3设备体检并开播
开播页点 设备体检,麦克风 / 摄像头 / 虚拟声卡 三盏灯全绿 后点 一键开播。
- 4在目标软件选择虚拟设备
微信 / 抖音 / Zoom 里把摄像头选成 OBS Virtual Camera,麦克风选成 CABLE Output。
07手机同传(说中文 · 对方听外语)
- 1电脑启动同传服务
启动器 启动全部,确认 实时同传 服务运行中。
- 2手机扫码连接
电脑打开扫码页会显示两个二维码,做同传扫 【① 做同传】;手机需与电脑连 同一 WiFi。
- 3信任本机证书
手机提示「连接不是私密」属正常(本机自签证书):点 高级 / 显示详情 → 继续前往。
- 4一键准备
点 🚀 一键准备 → 允许麦克风,顶部引导条 变绿即可说话;需要出镜再点 📷 开摄像头。
08软件更新与回滚
- 产品内自更新:发现新版本时,启动器版本号处会亮起 v当前 → v新版,点击一键升级:下载 → 自动安装 → 自动重启,约 1–3 分钟。
- 数据全保留:升级只更换控制台程序(几十 MB),已下载的 AI 组件与角色数据全部保留。
- 安全校验:更新清单带 ,篡改包一律拒绝安装。
- 一键回滚:新版本不满意可在「软件更新」里回滚到上一版本,同样保留数据。
- 直播避让:直播 / 同传进行中不会应用更新,结束后自动继续。
每个版本的具体更新内容见官网下载页「版本更新」版块。
09故障排查
| 现象 | 处理 |
|---|---|
| 控制台打不开 | 启动器「一键体检」定位;重启服务;页面硬刷新 Ctrl+F5 |
| 某服务红灯 / 未就绪 | 多为显存不足或模型没加载完:稍等或重启该服务;关闭不用的扩展功能 |
| 显存爆(OOM) | 只跑核心功能(关扩展);高清口型最吃显存,可降档 |
| 手机连不上 | 手机与电脑必须同一 WiFi;防火墙放行提示按引导允许 |
| 「连接不是私密」提示 | 正常(本机自签证书),点高级 → 继续前往即可 |
| 麦克风开不了 | 浏览器地址栏 🔒 → 网站设置 → 麦克风 → 允许 → 刷新 |
| 同传没字幕 | 确认「实时同传」服务在运行(启动器绿灯) |
| 换脸显示原图 | 确认已激活出镜角色且换脸服务在跑 |
10术语表
教程中带虚线下划线的术语,悬停或点击即可查看解释;此处汇总全部术语,方便打印留档与快速查阅。
| 术语 | 含义 |
|---|---|
| 薄核心安装包 | 安装器本体仅约 45 MB;几十 GB 的 AI 组件与模型在首次启动时按需下载,不用一次性下载完整包。 |
| SHA-256 | 文件的唯一「数字指纹」。算出的校验值与官网公布一致,即可确认安装包完整、未被篡改。 |
| SmartScreen | Windows 内置的程序信誉提示:对发布不久的安装包会例行提醒「已保护你的电脑」,这不是病毒报警。核对 SHA-256 后点「更多信息 → 仍要运行」即可。 |
| 首启向导 | 第一次打开 AvatarHub 时的引导流程:自动检测硬件、推荐功能档位、下载所需组件,全程无需命令行。 |
| 档位 | 按显卡能力划分的功能等级(入门 / 标准 / 旗舰),决定可开启哪些 AI 功能与组件下载体积。装后可在「设置 → 硬件档位」随时查看。 |
| 显存 | 显卡的专用内存(VRAM)。AI 模型加载在显存里运行——显存越大,可同时开启的功能越多、画质档位越高。 |
| 断点续传 | 下载中断后从已完成的位置继续,已下载的部分不会重下。网络波动、关机重开都不影响进度。 |
| 在线激活 | 在「设置 → 授权」输入订单号,客户端自动取回已签名的授权文件并生效,无需手动粘贴一长串激活码。 |
| 冒烟测试 | 用最短路径验证核心功能可用:克隆一段 10 秒声音并试听,出声即代表「语音识别 → 合成 → 播放」整条链路正常。 |
| OBS 虚拟摄像头 | OBS Studio 提供的「虚拟摄像头」:把 AI 处理后的画面伪装成一个摄像头设备,微信 / 抖音 / Zoom 里直接选它即可出镜。 |
| VB-Cable 虚拟声卡 | 虚拟声卡驱动:把 AI 处理后的声音变成一个「麦克风」设备(CABLE Output),聊天软件选它作麦克风即可让对方听到处理后的声音。 |
| Ed25519 签名 | 更新清单的防伪数字签名。客户端只接受官方私钥签发的更新,被篡改的更新包会被直接拒绝。 |
| 一键诊断包 | 客户端内置的故障收集器:约 3–10 秒自动收集脱敏日志并直传客服,生成 6 位诊断码。联系客服时报码即可远程定位,无需手动发文件。 |
11获取帮助
- AI 客服:官网右下角对话气泡,7×24 秒回,安装 / 使用 / 报价都能答。
- Telegram 人工客服:@WJKJ2026(工作时间内 5 分钟响应)。
- 远程代部署:99 USDT 预约远程上机,装好即用。
- 诊断码:客户端生成 6 位码,报码即可远程定位问题。
手册没覆盖到?问右下角 AI 客服,或联系 @WJKJ2026。