macOS · Textual · Pi AI 助手 · 开源

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

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

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

为什么需要它

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

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

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

1

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

2

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

3

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

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

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

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

uv tool install storage-agent-tui
# 或
pipx install storage-agent-tui

无需安装，直接体验核心交互——生成 AI 建议、按风险勾选清理项（演示数据，纯前端模拟）。

storage-agent — 优化流程 ① AI 解释并排序 → ② 分级选择清理项 → ③ 移入废纸篓

点击「① 生成建议」，AI 会用只读方式解释磁盘占用并排序候选（演示为模拟数据）。

AI 解释 → 分级选择 → 移入废纸篓可恢复，每一步都清晰可见。