如何在 Mac 上卸载 Pieces

移除 Pieces 或 Pieces OS 前，两者都先备份，存储说明列出 ~/Library/com.pieces.os 存片段、对话、引擎数据和 Long-Term Memory，~/Library/com.pieces.pfd 存桌面设置、日志。要保留原始 Long-Term Memory 数据时，Personal Cloud 快照不能替代完整手动数据库副本。

停止两个应用，复制数据

先结束工作并停止使用 Pieces OS 的集成，退出桌面应用，再从 Pieces 菜单栏图标选 Quit，把两个现有目录完整复制到所有同步和待删除目录之外并核对。Cask 列出的 ~/Library/Application Support/com.pieces.x 和 ~/Library/Application Support/com.pieces.os 也先复制所需状态，其他 Pieces 集成还要这些数据时就保留。

Mac 卸载说明通过访达移除两个应用，要完整移除本地产品，先完成备份和服务处理，再把「应用程序」中的 Pieces 桌面应用和 Pieces OS 应用移到废纸篓，实测和 cask 的 OS 应用包是 Pieces OS.app，当前文档称 PiecesOS。只移除桌面应用不代表 OS 引擎或集成已经不在。

直接安装的 OS 服务仍加载时，先查看真实启动条目，再卸载已知产品 label：

launchctl bootout "gui/$(id -u)/com.pieces.os.launch"

确认停止后，再在访达核对归属的 ~/Library/LaunchAgents/com.pieces.os.launch.plist，服务不存在可能表示已经卸载，其他错误不能当成功，其他 LaunchAgents 和集成设置保留。Homebrew 安装则用下方普通卸载的服务处理。

用 Homebrew 安装时

桌面 cask依赖 Pieces OS，桌面普通卸载退出 com.pieces.x，OS 普通卸载退出 com.pieces.os 并卸载 com.pieces.os.launch，这些不依赖 zap。备份后移除两个管理的应用：

brew uninstall --cask pieces pieces-os

桌面 zap 列出 ~/Library/Application Support/com.pieces.x、~/Library/com.pieces.pfd、~/Library/HTTPStorages/com.pieces.x、~/Library/Preferences/com.pieces.x.plist 和 ~/Library/Saved Application State/com.pieces.x.savedState。OS zap 列出 ~/Library/Application Support/com.pieces.os、~/Library/com.pieces.os、~/Library/LaunchAgents/com.pieces.os.launch.plist 和 ~/Library/Preferences/com.pieces.os.plist，里面含保存的内容，不只是缓存。

自己运行 brew uninstall --cask --zap pieces pieces-os 不会读取 Mole 的勾选，只有完整清单通过选择、归属和安全检查时，Mole 才用 zap，否则选中的残留仍由 Mole 自己移进废纸篓，OS 的普通服务卸载不依赖数据选择，其他集成还要引擎数据时就保留。

查看结果

pgrep -ifl pieces
ls -ld "$HOME/Library/com.pieces.os" "$HOME/Library/com.pieces.pfd" "$HOME/Library/LaunchAgents/com.pieces.os.launch.plist"
launchctl list | grep -F com.pieces.os.launch

进程无匹配只表示没有参数匹配这个模式，有结果时先看路径，打印目录或 plist 表示仍在，主动保留时属于正常结果。Launchd 读取成功且无错误时，无匹配行只表示这个列表里没有匹配任务，不代表所有集成都已移除，路径不存在的错误只说明那处项目已不在，其他读取错误仍无法判断，也不能验证数据库恢复。

Mole 会列出什么

精确应用 ID 支持目录和偏好设置按各自默认选择规则处理，要留状态时先备份并取消勾选。Cask 列出的 ~/Library/com.pieces.os 和 ~/Library/com.pieces.pfd 数据目录需要确认，关闭「卸载时一并移除数据和配置」时起初不勾选，开启后，合格且未共用的行可能预选，其他已安装 Pieces 集成和共用归属可能影响资格。移除一个应用不会自动移除两个产品组件。

这次检查覆盖了什么

2026 年 9 月 22 日，把官网下载的 Pieces 6.1.0 桌面应用和 Pieces OS 12.6.2 拷进「应用程序」，启动后分别移除应用及选中的 ~/Library/com.pieces.pfd、~/Library/com.pieces.os 数据。OS 启动 plist 和首次运行启动项移除，label 只留下 disabled，没有 plist，已有数据库恢复、第三方集成清理和 Homebrew 没有测试。