CleanDev

CleanDev 是一款原生 macOS 桌面应用，用于发现并清理本机 Python 与 Node.js 开发依赖。

功能

• 扫描 PATH、Homebrew、pyenv 与 Conda 中的 Python 全局包
• 扫描 PATH、Homebrew、nvm、fnm 与 Volta 中各 Node.js 版本的 npm 全局包
• 通过 Spotlight 快速定位虚拟环境和项目顶层 node_modules
• 展示每项磁盘占用、版本与真实路径，并支持 Finder 定位和筛选
• 项目环境移入废纸篓（可恢复）；全局包通过对应的 pip / npm 正常卸载

CleanDev 不启用 App Sandbox，因为它的核心能力需要读取用户选择的开发目录，并调用本机已有的包管理器。项目环境删除前还会再次验证目标必须是包含 pyvenv.cfg 的目录或名称严格等于 node_modules 的目录。

安装

1. 从 GitHub Releases 下载最新的 CleanDev-*-macOS.zip。
2. 解压后将 CleanDev.app 移入“应用程序”目录。
3. 首次启动时按系统提示授予需要扫描的文件夹访问权限。

官方 Release 使用 Developer ID 签名并通过 Apple 公证，最低支持 macOS 14。

本地运行

swift run CleanDev

要求 macOS 14 或更新版本以及 Xcode 16 或更新版本。

项目结构

Sources/CleanDev/
├── App/       # 应用入口与窗口配置
├── Models/    # 扫描结果与界面状态
├── Services/  # 发现、统计、卸载与安全校验
└── Views/     # Firecrawl 风格 SwiftUI 界面

测试

swift test

构建签名应用

./Scripts/build-app.sh

脚本会优先使用 APPLE_SIGNING_IDENTITY；未设置时会自动选择钥匙串中的 Developer ID Application 证书。产物位于 build/CleanDev.app。

Apple 公证

公证脚本使用以下环境变量，不会将凭据写入仓库：

• APPLE_ID
• APPLE_TEAM_ID
• APPLE_APP_SPECIFIC_PASSWORD

./Scripts/notarize.sh

参与贡献

参见 CONTRIBUTING.md。安全问题请按 SECURITY.md 私密报告。

License

MIT