卸载 VoiceStudio¶

VoiceStudio 完全本地化——它没有账户、没有云端状态，也没有后台服务。卸载只需删除应用以及它在你的机器上写入的文件夹。本页列出了每个平台上所有这些文件夹，并附带一个脚本，可以帮你查找并删除它们（先进行预演）。

TL;DR（占用空间的大头）： 值得删除的两个文件夹是模型缓存（Hugging Face 权重——数 GB）和托管的 Python 环境（应用文件夹内的 runtime/project/.venv——数 GB）。其他都是小文件。

在应用内操作（最简单——无需仓库）¶

设置 → 存储 → 删除所有数据。 它会列出此安装拥有的每个文件夹及其真实大小，让你选择（单独）是否也删除共享的 Hugging Face 模型缓存，要求你输入 DELETE，然后删除所有内容并退出。

Electron 版本会在窗口退出后通过其签名的桌面助手完成删除，因为 Chromium 在应用打开时会锁定其 profile 目录的部分内容。相同的所有权检查和模型缓存选择仍然适用。

如果你是安装 .dmg / .exe / AppImage / .deb，则此为正确路径——你没有仓库，所以下面的脚本对你不可用。

你可能并不需要卸载。 就在它上方，重置并删除能按你喜欢的任意规模完成同样的工作——并让你得到一个可用的应用，而不是什么都没有。参见下面的重置而非卸载。

重置而非卸载¶

设置 → 存储 → 重置并删除会将 VoiceStudio 的一部分——或全部——恢复到初始状态，而不移除应用。每个选项在确认前都会显示其真实大小，完成后应用会自动重启。

“精确选择要删除的内容”会打开与各复选框相同的列表，因此你可以只删除模型权重、只删除某个卡住的辅助引擎，或只删除历史记录——凡是真正有问题的东西。

它刻意不碰的两样东西：

• 你的存储位置。 如果你将 VoiceStudio 指向了自定义的数据或模型目录，重置设置会保留该指针。清除它会让已经下载的数 GB 权重遗留在应用不再查找的路径中。
• 托管的 Python 环境。 “VoiceStudio 所做的一切”仍会为你留下一个可用的应用，并会在首次运行界面重新启动。如果你希望解释器也被删除，那就是删除所有数据——见上一节。

共享的 Hugging Face 模型缓存在适用之处会单独说明：在 macOS 和 Linux 上，它是其他 AI 工具也使用的标准缓存，因此删除它可能会删除 VoiceStudio 从未下载过的模型。（在 Windows 以及便携式安装中，缓存是 VoiceStudio 自己的——没有什么可共享的，应用也会说明这一点。）

单命令卸载器（从克隆仓库运行）¶

从克隆仓库或源码压缩包运行：

# macOS / Linux — 打印它将要删除的内容及大小，然后停止：
scripts/uninstall.sh

# 在你阅读预演输出后，实际删除：
scripts/uninstall.sh --yes

# Windows (PowerShell) — 先预演，然后删除：
powershell -ExecutionPolicy Bypass -File scripts\uninstall.ps1
powershell -ExecutionPolicy Bypass -File scripts\uninstall.ps1 -Yes

如果你选择了匿名分析（仅在这种情况），删除运行会在移除数据前发送最后一次不附带额外内容的 app_uninstalled ping——应用版本、操作系统名称和随安装生成的随机 id，仅此而已——并在控制台说明。采用 2 秒超时的尽力发送：网络不通绝不会阻塞卸载。如果你从未选择过（默认情况），则不会发送任何内容，也不会打印任何内容；预演运行无论如何都不会发送任何内容。

它覆盖当前的桌面应用，以及任何由最后一代 Tauri 安装（com.debpalash.omnivoice-studio）留下的内容。添加 --app（macOS/Linux）或 -RemoveApp（Windows）可以同时删除已安装的应用本身。在 Windows 上，从普通 PowerShell 窗口运行 -Yes -RemoveApp，无需管理员权限。如果以提升权限运行，脚本会在删除应用数据或启动卸载程序之前停止；预演运行仍会列出计划。如果已安装的应用需要管理员批准，其自身的卸载程序会请求批准。或者，通过 设置 → 应用 移除 VoiceStudio，然后运行不带 -RemoveApp 的 -Yes 来清理其剩余数据。

该脚本尊重你的自定义位置：如果你设置了 OMNIVOICE_DATA_DIR、OMNIVOICE_CACHE_DIR、OMNIVOICE_ENGINES_DIR、HF_HOME 或 HF_HUB_CACHE（或在设置期间选择了自定义数据/模型文件夹），请在运行前导出相同的变量，它将针对这些位置而不是默认位置。它不会触碰 VoiceStudio 文件夹之外的任何内容，并且没有 --app / -RemoveApp 时它不会删除应用本身（参见下文“删除应用”），因此即使你只是想释放磁盘空间并保留应用安装，运行它也是安全的。你移动到自定义文件夹的运行时只有在应用在其中创建它时才会被删除；仅被应用复用的现有环境则会被保留。

VoiceStudio 会写入什么，以及写在哪里¶

四类数据，最多分布在四个位置：

macOS¶

~/Library/Application Support/OmniVoice/      ← app data (voices, projects, omnivoice.db, outputs, omnivoice.log)
~/Library/Application Support/VoiceStudio/    ← app folder + the managed Python env (runtime/project/.venv)
~/Library/Logs/VoiceStudio/                   ← desktop-shell logs
~/Library/Caches/voicestudio-electron-updater/ ← downloaded updates
~/.config/omnivoice/                          ← saved env file (cache location, HF token)
~/.cache/huggingface/                         ← model weights (shared HF cache — see caveat)

Linux（AppImage / .deb）¶

~/.omnivoice/                                 ← app data (voices, projects, omnivoice.db, outputs, omnivoice.log)
~/.config/VoiceStudio/                        ← app folder, desktop logs, AND the managed Python env (runtime/project/.venv)
~/.cache/voicestudio-electron-updater/        ← downloaded updates
~/.config/omnivoice/                          ← saved env file (cache location, HF token)
~/.cache/huggingface/                         ← model weights (shared HF cache — see caveat)

当设置了 $XDG_CONFIG_HOME / $XDG_CACHE_HOME 时，它们会取代上面的 ~/.config / ~/.cache。

Windows¶

%APPDATA%\OmniVoice\                           ← app data (voices, projects, omnivoice.db, outputs, omnivoice.log)
%APPDATA%\VoiceStudio\                         ← app folder, desktop logs, AND the managed Python env (runtime\project\.venv)
%LOCALAPPDATA%\voicestudio-electron-updater\   ← downloaded updates
%USERPROFILE%\.config\omnivoice\               ← saved env file (cache location, HF token)
%LOCALAPPDATA%\OmniVoice\hf_cache\             ← model weights (VoiceStudio uses a short path here to dodge MAX_PATH)

Tauri 时代安装遗留的目录¶

如果你在 Electron 桌面应用之前使用过 VoiceStudio，以下目录可能也存在；脚本也会一并删除：

macOS:   ~/Library/Application Support/com.debpalash.omnivoice-studio/, ~/Library/Logs/OmniVoice/,
         ~/Library/Logs/com.debpalash.omnivoice-studio/
Linux:   ~/.local/share/com.debpalash.omnivoice-studio/, ~/.local/state/VoiceStudio/
Windows: %LOCALAPPDATA%\com.debpalash.omnivoice-studio\, %LOCALAPPDATA%\OmniVoice\Logs\

在 Windows 上，如果未设置 HF_HOME，VoiceStudio 会将模型缓存重定向到 %LOCALAPPDATA%\OmniVoice\hf_cache（而不是 ~/.cache/huggingface），以免过深的模型路径触发 260 字符的 MAX_PATH 限制。

自定义 / 便携式位置¶

• 自定义文件夹： 如果你在设置中选择了自定义的数据或模型文件夹（或设置了 OMNIVOICE_DATA_DIR / OMNIVOICE_CACHE_DIR / HF_HOME / HF_HUB_CACHE），你的数据会存放在那里，而不是上面的默认位置。你移到另一块驱动器的 Python 运行时会位于你选择的 VoiceStudio 文件夹中。如果在首次运行设置时选择了该文件夹，你的数据和模型也会存放在其中（data、models），并作为单独选项提供。
• 便携模式： 所有内容都位于应用二进制文件旁边的 OmniVoiceStudio-Data/ 文件夹中——删除这一个文件夹即可完成清理。
• 应用托管的引擎附带组件： 如果 VoiceStudio 安装了 IndexTTS 2.5、CosyVoice 或其他附带组件，其独立的 venv 位于上方应用数据文件夹下的 engines/ 中，并会随之一同删除。通过 OMNIVOICE_INDEXTTS_DIR 设置的用户自行管理的 IndexTTS 检出副本，仅在其解析后的路径位于应用数据文件夹之外时才会被保留。清理前请确认解析后的路径：应用数据文件夹内的任何内容都会随文件夹一起删除；对于外部检出副本，请单独决定保留或删除。

共享 HF 缓存注意事项： ~/.cache/huggingface/ 是标准的 Hugging Face 缓存，由任何使用 huggingface_hub 的工具（其他 ML 应用、transformers 等）共享。如果你使用其他 Hugging Face 工具，删除整个文件夹也会一并删除它们的缓存模型。若只想删除 VoiceStudio 的模型，请删除 ~/.cache/huggingface/hub/ 下你识别出的 models--* 子文件夹，或者干脆不管它——这只是缓存，任何工具都会重新下载所需内容。正因如此，卸载脚本会打印缓存大小，并单独询问是否删除。

删除应用本身¶

以上步骤清除的是数据；删除已安装的应用则按各平台的常规步骤进行：

• macOS： 将 /Applications 中的 VoiceStudio.app 拖到“废纸篓”。
• Windows： 设置 → 应用 → 已安装的应用 → VoiceStudio → 卸载（或通过“添加或删除程序”）。非提升权限的安装项显示为 VoiceStudio（当前用户），该用户无需管理员批准即可将其删除。
• Linux（AppImage）： 删除 .AppImage 文件。如果你已将其集成到菜单中（例如使用 AppImageLauncher 或手写的 .desktop 文件），还需要删除 ~/.local/share/applications/*voicestudio*.desktop（或旧版安装遗留的 *omnivoice*.desktop）以及 ~/.local/share/icons/ 下的任何图标。
• Linux（.deb）： sudo apt remove voicestudio-electron（这会删除程序；上面列出的数据文件夹属于用户数据，会保留在原处——你可以用脚本或手动删除它们）。也可能安装了较旧的 Tauri 时代软件包：sudo apt remove voicestudio，或更名之前的 omnivoice-studio——它们是独立的软件包。

日后重新安装¶

重新安装前并不需要执行上面的任何步骤——全新安装会按需重建 Python 环境并重新下载模型。如果你想在重新安装后保留声音配置文件和项目，请保留 ~/Library/Application Support/OmniVoice/（macOS）/ ~/.omnivoice/（Linux）/ %APPDATA%\OmniVoice\（Windows）；若想真正彻底清理，也可一并删除。