如何彻底卸载数字人工具HeyGem.ai：三层清理法一次讲清
【免费下载链接】Duix-Avatar🚀 Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar
HeyGem.ai（安装名 Duix.Avatar）是一款开源数字人工具，可以离线生成会说话的视频。卸载它之后，配置、模型等残留文件仍会占用几十 GB 空间。本文思路：先定位，再分层清理，最后验证。
🧭 卸载前先摸底：它在你系统里留了什么
走完本节，你会拿到一张 HeyGem.ai 在磁盘里的完整分布图，后面删除时不会误伤。
它主要有三类残留：Electron 配置目录（存放设置、日志、本地数据库）、模型数据目录（存放数字人作品和音色模型）、日志文件。位置如下：
| 系统 | 配置与日志目录 | 数据目录（模型/作品） |
|---|---|---|
| Windows | C:\Users\<用户名>\AppData\Roaming\Duix.Avatar | D:\duix_avatar_data |
| macOS | ~/Library/Application Support/Duix.Avatar | ~/duix_avatar_data |
| Linux | ~/.config/Duix.Avatar | ~/duix_avatar_data |
日志和本地数据库 biz.db 都放在配置目录里。早期版本在 Windows 上的配置目录可能叫heygem.ai，见到也按残留处理。
先确认应用已彻底退出，在终端跑一条查进程的命令：
# Windows PowerShell tasklist | findstr /I "Duix"macOS / Linux 换成ps aux | grep -i duix，无输出即已退出。
🧹 三层递进清理：从程序本体到残留文件
本节结束，程序本体、数据、系统配置三个层面会被逐一清掉，空间基本都能释放。
第一层：用系统卸载移除程序本体
做完这层，应用本体和它在系统里的登记信息就没了。
- Windows：设置 → 应用 → 安装的应用 → 搜索 "Duix.Avatar" → 卸载。
- macOS：在“应用程序”文件夹里把/Applications/Duix.Avatar.app拖进废纸篓，清空废纸篓。
- Linux（AppImage）：直接删掉那个 AppImage 文件即可。
第二层：清掉数据目录，释放大头空间
做完这层，GB 级的模型与作品占用的空间被释放。注意：下面两个目录里都是你本地生成的内容（作品视频、音色模型、日志），删了就找不回来，想保留的先复制出去。
Windows 下以管理员身份打开 PowerShell 执行：
Remove-Item -Recurse -Force "$env:APPDATA\Duix.Avatar" Remove-Item -Recurse -Force "D:\duix_avatar_data"macOS / Linux 执行：
# 跨平台：数据目录 rm -rf ~/duix_avatar_data # macOS：配置目录 rm -rf "$HOME/Library/Application Support/Duix.Avatar" # Linux：配置目录 rm -rf ~/.config/Duix.Avatar第三层：注册表、快捷方式与启动项清场
做完这层，系统侧看不见的残留也清零了。
- 注册表（Windows 存放软件配置的系统数据库）：按 Win+R 输入
regedit，用 Ctrl+F 搜 "Duix.Avatar"。通常卸载器已清掉卸载项，若仍见HKCU\Software\Duix.Avatar之类子键，右键删除。改注册表前请先在菜单里导出备份。 - 快捷方式：检查桌面、
开始菜单\程序及AppData\Roaming\Microsoft\Windows\Start Menu\Programs下的 Duix.Avatar.lnk，见到即删。 - 启动项：任务管理器 → 启动应用，如有 Duix.Avatar 条目则禁用。
- Docker：如果你用 Docker 装过模型推理服务（deploy/ 里有现成的 compose 文件），清理后记得把 face2face 和 TTS 的容器、镜像一并删掉，否则还占着几个 GB。
✅ 验证收尾：三问确认无残留
最后问三个问题，答案都是“没有”，这次 HeyGem.ai 彻底删除才算完成。
- 还有进程吗？重跑一遍查进程命令，若仍出现 Duix.Avatar 进程，先结束它。
- 还有文件吗？做一次全盘搜索：
# macOS / Linux find ~ -iname "*duix*" -o -iname "*heygem*" 2>/dev/nullWindows 用资源管理器分别在 C 盘、D 盘搜索 "duix" 和 "heygem"。
- 还有启动入口吗？桌面、开始菜单、任务管理器启动项（macOS 看“系统设置 → 通用 → 登录项”）里都应找不到它。
完成检查清单：
- 系统“已安装的应用”里不再有 Duix.Avatar
duix_avatar_data数据目录已删除- 配置目录（AppData / Application Support / ~/.config）已删除
- 注册表中搜不到 Duix.Avatar 相关条目
- 桌面与开始菜单快捷方式已移除
- Docker 容器与镜像已删除（如使用过）
⚡ 常见卡点速解
权限不足删不掉Windows 下右键 PowerShell 选“以管理员身份运行”再删；macOS 给删除命令加sudo或先在访达里解锁目录。仍不行时，可翻 doc/常见问题.md 排查文件是否还被服务占用。
文件被占用，删除失败多半是应用没退干净。确认进程已退出；用 Docker 服务的话先停掉容器；再删一次，仍失败就重启电脑后再删。
删完空间没少多少回到D:\duix_avatar_data和配置目录里按大小排序找大文件，voice 子目录下的音色模型单个就可能有好几个 GB。
清理前记得把还想要的作品视频或音色样例备份出来。三问都通过后，HeyGem.ai 卸载就真正干净了。
【免费下载链接】Duix-Avatar🚀 Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
