0xCodez/cleanly

选用指南

AI 根据 README 整理 · 2026/10/30 21:21:49

适用场景

适用于需要清理系统缓存、临时文件、浏览器缓存、旧下载文件，或查找大文件和重复文件的场景。

查看 README 依据

- **Cleanup** — temp files, browser caches (every profile of Chrome, Edge, Brave, Firefox, Safari…), app caches, crash reports, update leftovers, developer caches, Trash / Recycle Bin and old downloads. Every group is labelled *Safe*, *Review* or *Permanent*. - **Space Map** — your folders as glass bubbles sized by how much space they take. Drill into any folder, switch between your home folder and every drive (C:, D:, external volumes). Grab a bubble and throw it — they bump into each other.

- **Large Files & Duplicates** — find the biggest files on all your drives and exact duplicate copies, with real file icons. - **Speed** — see which apps start with your computer and switch them off. System-wide items ask for permission, exactly like Task Manager. - **Applications** — every installed app with its real icon, size and last use; uninstall with the app's own uninstaller (Windows) or move it to the Trash (macOS).

使用方式

提供图形界面，支持一键智能扫描和清理，也可通过拖拽气泡浏览文件夹。

查看 README 依据

| Windows 10/11 (x64) | [Installer](https://github.com/0xCodez/cleanly/releases/latest/download/Cleanly-setup.exe) · [Portable](https://github.com/0xCodez/cleanly/releases/latest/download/Cleanly-portable.exe) | | macOS — Apple Silicon | [Cleanly-mac-arm64.dmg](https://github.com/0xCodez/cleanly/releases/latest/download/Cleanly-mac-arm64.dmg) | | macOS — Intel | [Cleanly-mac-x64.dmg](https://github.com/0xCodez/cleanly/releases/latest/download/Cleanly-mac-x64.dmg) | ## Features - **Smart Scan** — one tap shows how much you can reclaim and cleans the safe part.

- **Cleanup** — temp files, browser caches (every profile of Chrome, Edge, Brave, Firefox, Safari…), app caches, crash reports, update leftovers, developer caches, Trash / Recycle Bin and old downloads. Every group is labelled *Safe*, *Review* or *Permanent*. - **Space Map** — your folders as glass bubbles sized by how much space they take. Drill into any folder, switch between your home folder and every drive (C:, D:, external volumes). Grab a bubble and throw it — they bump into each other.

部署要求

支持 Windows 10/11 (x64) 和 macOS（Apple Silicon 或 Intel），需要 Node.js 22 或更高版本才能从源码构建。

查看 README 依据

| Windows 10/11 (x64) | [Installer](https://github.com/0xCodez/cleanly/releases/latest/download/Cleanly-setup.exe) · [Portable](https://github.com/0xCodez/cleanly/releases/latest/download/Cleanly-portable.exe) | | macOS — Apple Silicon | [Cleanly-mac-arm64.dmg](https://github.com/0xCodez/cleanly/releases/latest/download/Cleanly-mac-arm64.dmg) | | macOS — Intel | [Cleanly-mac-x64.dmg](https://github.com/0xCodez/cleanly/releases/latest/download/Cleanly-mac-x64.dmg) | ## Features - **Smart Scan** — one tap shows how much you can reclaim and cleans the safe part.

- **macOS:** open the `.dmg`, drag Cleanly to **Applications**, then run once in Terminal: ```bash xattr -cr /Applications/Cleanly.app ``` ## Build from source Requires Node.js 22 or newer. ```bash npm install # dependencies and the Electron binary npm run dev # run the app with hot reload npm run demo # UI only, in the browser at http://localhost:5174, with demo data (your disk is not touched) npm run dist:win # Windows installer + portable exe (x64) npm run dist:mac # macOS .dmg + .zip for arm64 and x64 (runs on a Mac only) ```

已知限制

构建未签名，首次启动时系统会警告；系统文件夹和正在使用的文件不会被清理。

查看 README 依据

- Scanning happens entirely on your computer. - The Assistant is optional. When you use it, only file **names, paths and sizes** are sent to the provider you chose — never file contents. Your API key is encrypted with your system's keychain (Electron `safeStorage`). - No analytics or tracking in the app. ## First launch The builds are not signed with paid Microsoft / Apple certificates yet, so your system will warn you the first time: - **Windows:** if SmartScreen appears, click **More info → Run anyway**.

- **System folders are off limits.** Drive roots, your home folder itself, Windows, Program Files, `$RECYCLE.BIN`, System Volume Information, network paths, symlinks and junctions are refused — including tricks like Windows short names (`DOCUME~1`) and trailing dots. - **Files in use are skipped.** Temp files touched in the last 24 hours and locked files are left alone and reported. - **Reversible speed tweaks.** Startup items are switched off with the same setting Task Manager uses; nothing is deleted, and you can switch them back on any time. ## Privacy