如何在 Mac 上卸载 Paseo

卸载 Paseo 前，先备份配置、会话和需要的工作树文件，官方配置说明把默认资料目录放在 ~/.paseo，新工作树放在其中的 worktrees 目录，本页覆盖 Mac 桌面应用，独立服务或远端主机是另外的安装。

先退出，再移除应用

先正常结束 Agent 和工作区命令，保存修改并退出 Paseo，移除应用前核对剩余服务进程来自这份桌面应用，而且使用的是准备停用的资料目录。应用在「应用程序」、使用默认 ~/.paseo 时，用包内命令只停止这一份本地服务：

"/Applications/Paseo.app/Contents/Resources/bin/paseo" daemon stop --home "$HOME/.paseo"

检查命令结果，确认这一份服务已退出，再把 Paseo.app 移到废纸篓，命令失败时先保留应用和数据，解决服务停止问题后继续。独立安装、使用其他资料目录或远端主机的服务不在这条命令的范围内。官方的 --force 选项允许正常停止超时后强制清理进程树，可能中断未保存的工作，Homebrew 卸载会使用它，两种卸载方式都先保存并结束任务。Paseo 服务控制说明

核对本机数据

保存工作、停止桌面服务后，在 Finder 按 Shift + Command + G 打开 ~/Library/Application Support/Paseo、~/Library/Logs/Paseo 和 ~/Library/Preferences/sh.paseo.desktop.plist，先把要留的本地状态复制到准备删除的目录之外，再把不再需要的项目逐项移到废纸篓。~/.paseo 或自定义资料目录里还有要留的工作树、会话，或仍被其他保留的服务使用时都留下；文件和 Git 状态妥善保存、没有保留的服务再用它时，用 Finder 的「前往文件夹」打开它的父目录，资料文件夹隐藏时按 Shift + Command + . 显示，只把这份停用的资料文件夹移到废纸篓，仓库和独立 Agent 的档案留着。

  • ~/.paseo 可以保存配置和工作树，PASEO_HOME 或 --home 能更改位置，移除整个文件夹可能丢掉本地工作内容。
  • ~/Library/Application Support/Paseo 在测试中保存桌面数据，其中的 Electron 缓存子目录分开列出。
  • ~/Library/Logs/Paseo 和 ~/Library/Preferences/sh.paseo.desktop.plist 保存日志与配置。
  • Agent 档案、仓库和独立服务主机上的数据要单独决定是否保留。

检查卸载结果

pgrep -ifl paseo
command -v paseo
launchctl list | grep -F sh.paseo.desktop.ShipIt
ls -ld /Applications/Paseo.app "$HOME/.paseo" "$HOME/Library/Application Support/Paseo"

pgrep 没有输出只表示没有找到这个名称，不代表所有辅助进程都已退出，有输出时核对它的实际可执行文件路径，ls 提示路径不存在只说明这一处没有了，权限错误仍无法判断，留下的文件夹也可能是你要保留的数据。

command -v 只显示当前 shell 的命令路径，没有结果不排除其他安装，launchctl 显示当前用户域的任务，没有匹配行不代表独立服务已停止，权限错误仍无法判断。

用 Homebrew 安装时

Mac cask 的普通卸载会卸下 sh.paseo.desktop.ShipIt、退出应用、运行包内的 paseo daemon stop --force，并移除 cask 管理的命令，先保存运行中的工作，zap 还包含 ~/.paseo、桌面数据、日志、更新器缓存、偏好设置和 Apple 共享文件列表条目，范围比移除应用更大。

不运行 zap 时，用下面的命令卸载：

brew uninstall --cask paseo

Mole 会先核对 Homebrew 的整份删除清单，涉及未勾选的数据、共享文件或无法确认的内容时跳过 --zap，已勾选的残留仍由 Mole 清理。自行运行 brew uninstall --cask --zap paseo 会执行 Homebrew 的完整 zap 清单，不会读取 Mole 的勾选状态。

当前 cask。

Mole 会列出什么

Mole 默认勾选应用、精确偏好设置和可归属缓存，~/Library/Application Support/Paseo 会列出来供你检查，本地 Homebrew 目录提供该 zap 路径时，~/.paseo 也可能列出，不要认为每个官网下载的安装都会列到它。「卸载时一并移除数据和配置」关闭时待确认行不预选，开启后符合条件的自有数据可以预选，要留本地状态、工作树或仍被保留服务使用的资料目录，就核对后取消勾选。

这次检查覆盖了什么

2026 年 9 月 25 日，从官网 Mac 包拷出的 Paseo 0.9.2 用 Mole 开发构建测试，缓存的 Homebrew zap 条目提供了隐藏资料目录项，所选数据已移除，没有覆盖已有工作树、独立服务、远端主机或运行中的供应商任务。

逐款软件检查的记录方法。