govijr/fix-storage
系统工具在终端里找出 macOS 和 Linux 磁盘被什么占满,并安全清理缓存、垃圾和闲置文件。
项目介绍
fix-storage 是面向 macOS 和 Linux 的终端磁盘空间工具。它按 Finder 存储面板的方式统计磁盘,然后继续向下追踪最大的子目录,指出空间实际被谁占用;每个条目会被标记为 junk、unused、system 或不做标记,并附一行理由,例如「可用 npm install 重建」「7 个月未改动」。最近打开时间在 macOS 上来自 Spotlight,在 Linux 上来自文件访问时间。
交互界面以键盘操作为主,通过 kitty graphics 协议在终端里绘制;不支持的终端会退化为纯字符视图。Linux 上每个挂载的文件系统算一块盘,双系统的 Windows 分区和其他 Linux 安装只读展示,未挂载分区可以通过命令列出并以只读方式挂载。
安装
官方安装方式会下载并直接执行安装脚本:
curl -fsSL https://raw.githubusercontent.com/govijr/fix-storage/main/install.sh | sh
脚本把程序放进 ~/.fix-storage,并把 fix-storage 命令链接到 ~/.local/bin,不需要 sudo。需要指定版本时可用 sh -s -- --version 0.2.0。
环境要求:macOS(Apple silicon 或 Intel)或 Linux(x86_64 或 arm64),Node.js 20.11 及以上;Linux 上还需要 unzip 解包基于 Electron 的图形运行时。图形视图需要支持 kitty graphics 协议的终端,例如 Ghostty、kitty 或 WezTerm;裸服务器上使用 --plain。
快速使用
安装后执行 fix-storage 即可扫描磁盘并打开交互界面。常用的起步选项:
fix-storage --demo # 虚构磁盘,不读取也不删除
fix-storage --dry-run # 真实扫描,但删除只做模拟
fix-storage --plain # 输出文字摘要后退出
fix-storage --json # 输出 JSON 摘要后退出
fix-storage --drives # Linux:列出已挂载和未挂载的盘
界面内用方向键或 j/k 移动,→/Enter 进入目录,g 跳到主要占用者,f 只看 junk 和 unused,d/⌫ 把条目移到废纸篓;清空缓存或废纸篓需要按两次确认。所有元素也都可以点击。
macOS 上建议给终端授予完全磁盘访问权限,否则 Mail、Safari 等受保护目录的内容会被计入 System data。Linux 上以普通用户身份运行,不要加 sudo,原因相同。
删除行为与限制
缓存和废纸篓中的条目会被永久删除,其他内容移到系统废纸篓,可以恢复,空间在清空废纸篓后才释放。System data、/System、/private、钥匙串、偏好设置、Mail、Messages、Photos、Safari 数据、扫描的顶层目录以及其外的一切都不会被删除。Linux 上还排除 /usr、/etc、/var、/opt、/boot、Flatpak 自身目录、活动 swap 文件、~/.ssh、~/.gnupg、密钥环、浏览器配置,以及 Windows 或其他系统分区上的内容。--dry-run 和 --demo 不会改动磁盘。分类规则刻意保守,位于 src/core/classify.ts;项目采用 MIT 许可证。
HotRepo 点评
HotRepo 在 2026-11-20 的 TypeScript 新项目榜上记录了该仓库:178 stars,截至当天的 24 小时窗口内新增 50。逐小时采样显示,2026-11-16 至 2026-11-20 之间星数从 103 升到 178,大部分涨幅集中在最后一天。由于没有全部语言日榜名次,也没有 Hacker News 讨论可供参考,这份榜单是唯一可用的热度信号。技术上比较突出的是安全边界做得较细:明确的永不删除清单、模拟模式和一个演示磁盘,让用户可以在把破坏性终端工具指向真实数据前先评估它。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。