搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

govijr/fix-storage

系统工具

在终端里找出 macOS 和 Linux 磁盘被什么占满,并安全清理缓存、垃圾和闲置文件。

178
14
TypeScript
MIT
创建于 6 天前

项目介绍

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 生成,更新于 ,以项目官方文档为准。