macOS · Textual · Pi AI 助手 · 开源

安全、可解释的存储优化终端工具

AI 帮你解释并排序空间占用,你决定清理什么。所有操作移入废纸篓, 可随时恢复——从第一步到最后一步都清晰可见。

brew tap Airine/storage-agent
brew trust Airine/storage-agent
brew install storage-agent-tui
storage-agent

为什么需要它

① AI 解释并排序

磁盘容量、缓存与风险来自本地确定性扫描;AI 只负责解释占用构成、说明每项该不该删,并给出优先顺序。模型只读、无工具权限。

② 三档风险分级

safe 普通确认即可清理;review 需要你理解内容并非纯缓存;protected(如 Documents 下的项目)需 macOS 管理员身份验证。

③ 移入废纸篓,可恢复

所有清理都移动到 macOS 废纸篓而不是永久删除,配套 SQLite 审计日志与撤销入口,清空废纸篓前随时可以反悔。

三步完成一次优化

1

生成 AI 建议

启动 TUI 后点击「① 生成建议」,AI 解释最大占用并排序候选。

2

选择清理项

在候选表中按风险加入清理清单,绝对敏感路径会被安全规则直接拒绝。

3

确认并恢复

输入确认文字后移入废纸篓;需要时在 History & Undo 里一键恢复。

安装方式

🍺 Homebrew(推荐)

来自自定义 tap,自动管理 Python 依赖。

brew tap Airine/storage-agent
brew install storage-agent-tui
tap 仓库 →

🐍 PyPI

通过 uv / pipx 安装,隔离环境、开箱即用。

uv tool install storage-agent-tui
# 或
pipx install storage-agent-tui
PyPI 页面 →