AppSweep

一个 macOS 13+ 桌面工具，用于卸载 App，并扫描当前用户目录下「已删除 App」留下的偏好设置、缓存、容器和其他残留文件。

功能

• 扫描 /Applications 和用户级应用目录中的已安装 App。
• 展示 App 图标、体积和相关残留文件。
• 单独区分「App」和「残留文件」结果。
• 支持搜索扫描结果。
• App 行背景会参考 App 图标主色调。
• 残留文件支持全选、取消全选和批量移动到废纸篓。
• 删除 App 后做增量更新，避免每次都完整重新扫描。
• 对 com.apple、系统组件、常见系统容器做更严格过滤，降低误删风险。

安全边界

AppSweep 默认只处理当前用户可访问范围内的应用和残留文件。删除动作使用移动到废纸篓，而不是直接永久删除。

以下内容会尽量排除：

• Apple 系统组件和 com.apple 系统服务。
• 当前仍安装 App 对应的容器、偏好设置和缓存。
• macOS 常见共享容器、系统扩展和系统工具相关目录。

清理前仍建议检查路径，尤其是大型目录和不熟悉的 bundle identifier。AppSweep 是辅助工具，不替代用户判断。

安装

从 GitHub Releases 下载最新 DMG：

AppSweep-0.1.0.dmg

安装步骤：

1. 打开 DMG。
2. 将 AppSweep.app 拖到 Applications。
3. 如果 macOS 阻止直接打开，请右键 AppSweep.app，选择「打开」，并在系统提示中确认。

使用

1. 打开 AppSweep.app。
2. 点击「扫描」。
3. 在左侧选择「App」或「残留文件」分组。
4. 通过搜索框过滤结果。
5. 勾选需要清理的 App 或残留文件。
6. 点击移动到废纸篓的操作按钮。
7. 在 Finder 废纸篓中确认后，再清空废纸篓。

如果只想清理已删除 App 的残留文件，可以展开「残留文件」分组，使用全选按钮后批量移动到废纸篓。

权限说明

AppSweep 不请求管理员权限，也不直接删除系统目录。它只能处理当前用户有权限访问和移动的文件。

如果某些 App 位于受保护位置，或残留文件属于其他用户，移动到废纸篓可能失败。这种情况需要手动处理，或使用系统提供的卸载方式。

构建

cd AppUninstaller
./scripts/package-app.sh

生成文件：

dist/AppSweep.app

如果本机 Command Line Tools 存在 Swift SDK 小版本不匹配问题，可以指定已安装 SDK：

APPSWEEP_SDK=/Library/Developer/CommandLineTools/SDKs/MacOSX15.4.sdk \
  ./scripts/package-app.sh

生成 DMG

./scripts/package-dmg.sh

生成文件：

dist/AppSweep-0.1.0.dmg

自动化检查

逻辑测试：

swift run AppUninstallerLogicTests

发布构建：

swift build -c release