v0.2.2·Rust + GPUI·macOS · Linux · Windows · GPL-3.0

看清谁占满了硬盘,安全腾出呼吸空间。

将本地磁盘、Docker 存储与远程 SSH 服务器绘制成按真实占用缩放的 GPUI 树状图。内置 O(1) AI Watchdog 守护与 MCP 服务智能诊断——任何删除均需由你确认后才执行。

下方支持「交互演示」与「macOS 实机截图」随时切换 — 也可点击快速开始按步骤上手

curl -fsSL https://ruum-updates.jsonlee12138.com/install.sh | sh
ruum模拟数据
ruum / Users / dev263 GiB · 4,184,346 个文件 · 63.0 秒
斜纹 = 可安全清理
当前选中可安全重建

Library/Caches

15.0 GiB

~/Library/Caches

占比5.7%
文件数184,920
最近修改11m ago
类型Cache
Git 状态:Not a repository
值得关注82.1 GiB
磁盘 · /dev/disk3s554.0 GiB 可用 → 77.4 GiB 清理后可用
四大核心优势

为 AI 时代开发机与生产服务器而造。

把数百 GB 的隐藏占用、Docker 冗余层与远程服务器瓶颈一次性摊开在眼前,同时用 Rust 硬边界守住代码、数据卷与服务器安全。

01 · AI 智能分析与 MCP

Watchdog 低开销守护 + 8 工具原生 stdio MCP 服务。

O(1) 后台守护进程在不遍历目录的情况下监测可用容量,低空间时调用你配置的 AI CLI(Agy / Pi / Codex / Custom)生成清理建议,同时为 AI Agent 提供 8 个标准化 MCP 工具。

  • 原生系统服务:launchd (macOS)、systemd --user (Linux)、无 UAC 自启 (Windows)
  • AI 清理建议强制弹出独立 Confirm Cleanup 窗口,并附带 Git 脏状态警告
  • 写操作 MCP 工具无桌面确认与系统指纹/密码鉴权时默认 Fail-closed 拒绝执行
{
  "mcpServers": {
    "ruum": {
      "command": "ruum",
      "args": ["mcp"]
    }
  }
}
Headless stdio MCP · zero GUI startupHuman-gated
暴露的 8 个 MCP 工具 (8)ruum mcp
工具名称作用范围安全边界
list_volumesLocal / SSHRead-only mount probe; zero file walk
scan_directoryLocal / SSHRead-only scan; cached in session
inspect_subtreeLocal / SSHRead-only tree lookup & substring search
find_reclaimableLocal / SSHHeuristics: caches, build dirs, stale worktrees
check_git_safetyLocal onlyHook-free Git status; rejects ssh_host
plan_removalLocal / SSHDry-run against safety guards; never deletes
trash_pathsLocal / SSHGUI Confirm Cleanup checkbox approval required
delete_permanentlyLocal onlyGUI approval + OS native auth (Touch ID)
02 · 远程 SSH 诊断

免 sudo 自动部署静态 musl 扫描器。

输入任意 SSH 主机别名即可连接。打包版本内嵌 x86_64/aarch64 静态 musl 助手并自动上传至 ~/.cache/ruum/ssh/,通过单条压缩流实时绘图,不在远端内存驻留目录树。

  • 遇到嵌套挂载点自动止步,断连立即干净退出,零残留进程
  • 远程会话 GUI 严格只读导出,彻底禁用直接删除与本地显隐操作
  • 导出删除脚本默认仅预览,加 --delete 后强制比对内核 hostname 与 machine-id
01
探测与上传
识别远端架构,上传哈希校验的静态 musl 扫描器至用户缓存目录
02
有界压缩流
单条 SSH 压缩通道逐条回传,远端零目录树内存堆积
03
HostIdentity 校验
脚本执行前校验真实 hostname 与 /etc/machine-id,防删错机
终端一条命令直连远程
ruum ssh user@server /var  # && --check for headless summary
03 · Docker 空间与卷保护

精准清理镜像、容器与构建缓存,本地卷锁定只读。

本机 Docker Desktop / OrbStack 与远程 SSH dockerd 共用一套探测引擎(docker_adapter),准确区分镜像共享层与独立可回收构建缓存。

  • 四态精准探测:未安装 / 服务未启动 / Socket 权限不足 / 完整可用
  • 清晰标出 Build Cache 中「与镜像共享」与「可安全回收」的真实字节
  • Local Volumes 在 UI 与删除适配器层双双锁定只读,绝不误删数据库卷
Images 镜像可安全清理

未使用 / 悬空镜像可勾选

Containers 容器可安全清理

已停止 / 退出容器候选

Build Cache 构建缓存可安全清理

精确拆分独享与共享层

Local Volumes 本地卷受保护 · 只读

永久隔离,禁止任何自动清理

04 · GPUI 原生可视化

颜色区分「是什么」,斜纹标识「能不能删」。

基于 Rust 与 GPUI GPU 原生渲染。面积严格对应真实占用块大小(Windows 管理员模式下直读 NTFS MFT 主文件表),斜纹将数据类型与可清理状态完全解耦。

  • 支持记忆化放大目录范围:从 ~ 扩展到 / 时复用已扫描子树,不重复遍历
  • 硬链接多路径去重,自底向上汇总时仅统计一次真实 inode 占用
  • 实时可用空间预测条自动合并嵌套标记,绝不重复计算可释放容量
分类语义色板10 categories
代码
Agent 临时区
工具链
容器
同步盘
Git
媒体
缓存
文档
其他
45° 斜纹 = 可安全重建的缓存、构建产物、Worktree 或包存储
工程级安全防线

把安全写进 Rust 核心护栏,而不只靠界面弹窗。

每一次清理在触碰磁盘前都会经过核心安全校验,越界即自动中止。

GUARD · 01

系统目录与挂载点硬拒绝

根目录、用户主目录、/usr、/etc、/nix/store、Homebrew 前缀及 Windows 系统目录无条件禁止删除。

GUARD · 02

Docker 本地卷只读锁

本地数据卷在核心层即排除在清理范围之外,数据库与持久化挂载点无法被选中或误删。

GUARD · 03

云盘零回拉与硬链接去重

绝不触发 iCloud Drive / Dropbox 云端占位文件下载,自动跳过 Time Machine 本地快照并去重硬链接。

GUARD · 04

免 Hook 只读 Git 脏检查

禁用 fsmonitor、Git hooks 与自定义过滤器,安全检查未提交改动、stash 与未推送分支。

GUARD · 05

人工勾选 + 系统原生鉴权

默认优先移入系统废纸篓;永久删除与写操作 MCP 必须经过弹窗勾选确认与 Touch ID 等系统认证。

GUARD · 06

Ed25519 + SHA-256 + Sigstore 验签

所有发行版均附带签名 manifest、SHA256SUMS 与可通过 gh attestation verify 核验的构建溯源证明。

15 秒极速上手

让本地开发机与远程服务器重新拥有呼吸空间。

单文件同时包含桌面端可视化界面、SSH 扫描引擎、Watchdog 守护与 stdio MCP 服务。

curl -fsSL https://ruum-updates.jsonlee12138.com/install.sh | sh