如何在 Mac 上卸载 Handy

卸载 Handy 前先备份转写文字、录音和自定义模型，官方仓库的数据说明说 Settings › About 会显示 App Data Directory 路径，复制后可在访达打开，Mac 通常为 ~/Library/Application Support/com.pais.handy。

保存历史，关闭启动项

历史说明支持复制所需转写文字，并从 History 顶部打开录音目录，先结束转写、保存文字并找到那些录音。如果启用了开机启动，按高级设置说明在 Settings › Advanced › App 关闭 Launch on Startup，再退出 Handy。

把整个现有应用数据目录和另设的录音位置复制到所有同步和待删除目录之外，核对所需文件，里面的 models 存下载的语音模型文件。仓库也列出共用模型缓存 ~/.cache/huggingface/hub，这个共用目录和其他工具的模型保留，备份完成后再在访达把「应用程序」中的 Handy.app 移到废纸篓。

用 Homebrew 安装时

Mac cask没有另外声明服务卸载步骤，不带 zap 时移除管理的应用：

brew uninstall --cask handy

Zap 另处理 ~/Library/Application Support/com.pais.handy、~/Library/Caches/com.pais.handy、~/Library/WebKit/com.pais.handy 和 ~/Library/LaunchAgents/Handy.plist，支持目录可能含历史和模型，移除前先复制。启动 plist 是独立项目，先在 Handy 关闭开机启动再退出，不把不带 zap 的命令当作已卸载这个启动项。

自己运行 brew uninstall --cask --zap handy 不会读取 Mole 的勾选，只有完整清单通过选择、归属和安全检查时，Mole 才用 zap，否则选中的残留仍由 Mole 自己移进废纸篓，共用 Hugging Face 缓存不在这个 cask 的 zap 清单里。

查看结果

pgrep -ifl handy
ls -ld "$HOME/Library/Application Support/com.pais.handy" "$HOME/Library/LaunchAgents/Handy.plist"

进程无匹配只表示没有参数匹配这个模式，打印目录或 plist 表示仍在，主动保留历史时属于正常结果，留下的 plist 另核归属和启动状态。路径不存在的错误只说明那处项目已不在，其他错误仍无法判断，这些检查也不能验证转写恢复。

Mole 会列出什么

精确应用 ID 支持目录和 WebKit 行默认勾选，包括支持目录里的数据，还要历史或模型时先备份并取消勾选。只由 cask 补出的启动项需要确认，关闭「卸载时一并移除数据和配置」时起初不勾选，开启后，合格且未共用的应用数据可能预选，共用模型缓存另行保留。

这次检查覆盖了什么

2026 年 9 月 22 日，把官网下载的 Handy 0.9.7 拷进「应用程序」，启动后移除应用、支持目录和 WebKit 数据，记录中的复查没有留下应用任务。已有历史恢复、已下载模型恢复和 Homebrew 没有测试。