0xCodez/cleanly

Cleanly 是一款面向 Windows 10/11 与 macOS 的桌面磁盘清理工具，先展示可回收空间，再执行删除。它面向想要清理缓存、临时文件和旧下载，又不愿订阅、看广告或被“恐吓式”营销的用户。项目使用 TypeScript/Electron，React 界面与主进程扫描器负责实际文件操作（README）。

功能与流程

核心流程是一次扫描：统计可回收空间，并清理其中被判定为安全的部分。清理类别包括临时文件、多个浏览器（含多配置）的缓存、应用缓存、崩溃报告、更新残留、开发者缓存、废纸篓/回收站和旧下载。每组都会标注 Safe、Review 或 Permanent，由用户决定是否清理（功能说明）。

除清理外，它还提供以气泡大小展示文件夹占用的空间图、大文件与完全重复文件查找、启动项开关，以及已安装应用列表——在 Windows 上调用应用自带的卸载程序，在 macOS 上移到废纸篓。Protection 页面只检查系统自带安全功能（Defender/防火墙或 Gatekeeper、XProtect、SIP）是否开启；README 明确它不能替代杀毒软件（README）。

安全模型及其边界

文档设计区分缓存与用户文件：缓存和临时文件会被永久删除，因为移到废纸篓并不能释放空间；大文件、重复文件、旧下载和应用会进入系统废纸篓，可以恢复。清理器只接受已知类别，把每个路径解析成真实完整形式，并拒绝磁盘根目录、用户主目录本身、Windows、Program Files、回收站/系统卷目录、网络路径、符号链接和目录联接。24 小时内改动过的临时文件和被锁定的文件会被跳过并报告。启动项修改使用与任务管理器相同的设置，因此可以恢复（安全说明）。

以上是作者声明的规则；README 没有提供独立测试结果，也没有对删除逻辑的审计。

使用前提与首次启动问题

Windows 版面向 Windows 10/11 x64（安装包或便携版），macOS 版同时提供 Apple Silicon 和 Intel 构建（下载）。构建尚未使用付费的 Microsoft/Apple 证书签名，因此 Windows SmartScreen 和 macOS Gatekeeper 会在首次启动时告警。macOS 上 README 要求用终端命令清除隔离属性——只有信任来源时才应执行。macOS 版还需要从“应用程序”目录运行。从源码构建需要 Node.js 22 或更高版本；macOS 分发包的构建只能在 Mac 上进行（构建说明）。仓库未声明许可证，如果打算复用或再分发代码，这一点值得注意（仓库）。

可选的 Assistant 会使用用户自己的 API key，把文件名、路径和大小（不包括文件内容）发送给 Claude 或 ChatGPT。应用不做分析统计，扫描完全在本地进行（隐私说明）。