AI之道
痛点
磁盘在胀，但你不敢乱删
空间满了，却不知道该删什么。缓存、日志、残留分散在 $HOME · 一键清理爽，误伤更疼
-
看不清
几十GB到底被谁占了
-
不敢动
删了什么、能不能回滚，心里没底
-
难编排
脚本和CI接不上交互式全家桶
安全
破坏性操作，故意不顺手
「安全优先」写在默认行为里，不写在免责声明末尾
- 路径校验删除前重过保护清单与白名单
- plan → apply过期或路径变了就重验
- 默认可恢复进废纸篓 · 永久删除要 --permanent
- 口径诚实不把进废纸篓夸成已释放磁盘
- 操作日志vole history可回看
- 先展示再删不会扫描完就直接删除
- 勾选后执行图形界面由你确认再清理，不擅自动手
- 单一Rust二进制无bash运行时依赖，装上就能跑
- 协议可编排冻结Plan / Report · CLI与桌面共用
功能
日常维护，一条链路
看清占用 → 清理 / 卸载 → 有界优化 · 菜单或子命令任选
-
$ vole clean行为可预期深度清理
531条TOML规则 · 先 --plan，再 --apply
-
$ vole uninstall不留空壳智能卸载
清掉App与用户域残留 · 同样plan → apply
-
$ vole optimize跳过有说明有界优化
无sudo主路径 · 做不到的会跳过并说明
-
$ vole analyze洞察先于清理磁盘洞察
从 $HOME下钻体积，找真正占位者
-
$ vole status人也读，机器也读实时监控
CPU / 内存 / 磁盘概览 · 可 --json
-
$ vole history可审计历史与补全
操作可回看 · shell补全与白名单
用法
三步：看清 → 确认 → 执行
-
预览
vole clean --plan，不出手
-
确认
看plan，排除不该动的路径
-
执行
vole clean --apply <plan.json>（默认废纸篓）
安装CLI
装上，先跑一次预览
brew tap wukongnotnull/vole https://github.com/wukongnotnull/vole
brew install vole预编译包 · 源码构建（Rust 1.97+）
安装后建议
vole clean --plan
对比
同源安全基因，Vole更克制
规则与保护路径同源 · 交付、恢复与编排，Vole更适合先看再删
查看对比表
| 维度 | Vole | Mole |
|---|---|---|
| 实现 | 纯Rust单一二进制，装上就能跑 | Bash + Go脚本套件 |
| 清理 | plan → apply，默认进废纸篓 | dry-run + 深度流水线 |
| 依赖 | 无第三方CLI | 部分场景需额外工具 |
| 编排 | 冻结协议，CLI / App / 脚本同一套 | 交互式全家桶，脚本更重 |
规则与安全语义源自 tw93/Mole · Vole CLI独立衍生，不隶属Mole
隐私与开源
你的文件，不需要离开你的Mac
日常扫描与清理在本地完成，Vole不靠上传你的文件来判断什么该删，项目代码公开可查，清理逻辑与安全边界不必藏在黑盒里
- 本地运行
- 开源透明
- 无后台偷偷上传
适用人群
如果你也这样使用Mac，Vole正适合你
- 磁盘经常告急，却不知道空间去了哪里
- 卸载过很多App，担心残留越积越多
- 经常使用Xcode、Rust、Node.js等开发工具
- 想清理Mac，但拒绝把决定权交给“一键加速”
- 在意隐私，希望清理过程尽量留在本地
- 喜欢开源软件，也想同时拥有命令行与图形界面
FAQ
常见问题
会自动删除文件吗？
不会。先展示候选，由你确认后再执行。
删错了还能恢复吗？
默认进废纸篓。永久删除必须显式选择。
会上传我的文件吗？
日常扫描与清理在本地完成，不依赖云账号。
收费吗？许可证是什么？
GPL-3.0。可免费下载和使用。Fork请改名，并注明来源。
不确定该不该删时怎么办？
CLI只跑vole clean --plan。App先看候选，不勾选就不删。
规则能改吗？
可以。TOML规则可禁用，也可用VOLE_RULES_DIR自管。
可以写脚本对接吗？
可以。--json / --json-stream对齐冻结协议。
为什么需要“完全磁盘访问”？
macOS会保护部分用户目录。授予后扫描更完整；不开启也可以用，但结果可能较少。
一定要启用Root特权助手吗？
不需要。它只处理部分系统路径。不启用时会跳过这些路径并明确提示。
App的「优化」做什么？
执行范围明确的系统维护任务，让Mac保持清爽状态。不勾选就不会做。
「净化」是什么？
定位陈旧的项目构建物，帮开发者找回被开发缓存吞掉的空间。
能找出落灰的安装包吗？
可以。App能快速找出已经落灰的 .dmg、.pkg等安装文件。
怎么看整机状态？
App的状态页一眼了解CPU、内存、磁盘与整机健康情况。CLI可用vole status。