disktree:Shopify CEO 用 Rust 写的磁盘树图,把「AI Agent 吃了多少硬盘」画了出来

硬盘满了这件事,最近几年悄悄换了一副面孔。

以前占满盘的是电影、系统镜像、虚拟机;现在更常见的是另外几样东西:.codex/worktrees、.claude、node_modules、target,还有一堆你说不清是哪个 agent 在哪天建出来的沙盒快照。它们不像电影那样有个你记得住的名字,也不像系统垃圾那样乖乖待在废纸篓里——它们散在家目录深处,每一层都长得差不多。

disktree 就是冲着这件事来的。作者是 Tobias Lütke(GitHub 账号 tobi),Shopify 的联合创始人兼 CEO。项目 2026 年 9 月 24 日建仓,到 11 月 1 日已经攒下 3,860 星、244 个 fork,语言是 Rust,MIT 许可。

它把整个磁盘画成一张嵌套的矩形地图(treemap),面积等于每样东西真正占的块数,然后让你在上面点、标记、复核、提交。整个过程里磁盘剩余空间一直显示在侧栏上——这是它和其他清理工具最不一样的地方。

它是什么,写给谁

官方介绍只有一句:a treemap for finding and removing what fills your disk, for Omarchy。三个信息量在这里:树图、找回并删掉、以及「for Omarchy」。

Omarchy 是 DHH(David Heinemeier Hansson,Ruby on Rails 作者)做的 Arch 系桌面发行版,用 Hyprland 平铺窗口管理器加 Quickshell 桌面壳,主打「大厨替你做主」的 omakase 风格。disktree 原本就是长在这个桌面里的:通过 gpui-omarchy 接入 Omarchy 的主题系统,配色会跟着你的桌面主题走。

但作者显然没打算把它锁在一个桌面里。现在的 release 页面上,三大平台、两种架构一共六种构建:

  • Linux:x86_64-linux.tar.gz / aarch64-linux.tar.gz(解压后跑 ./install.sh)
  • macOS:x86_64-macos.zip / aarch64-macos.zip(解压拖进 Applications,要 macOS 11 以上)
  • Windows:x86_64-windows.zip / aarch64-windows.zip(解压跑 disktree.exe)

技术栈是 Rust + GPUI——Zed 编辑器团队那套 GPU 加速的 Rust UI 框架。仓库里 crates/disktree-app/Cargo.toml 明确写着 gpui-kit = "=0.6.6" 和 gpui-omarchy = "0.1.3",连等号都钉死了版本。整个仓库 71 个文件、44 个 .rs,分三个 crate:disktree-core(扫描、树、布局、删除守卫,不含 UI)、disktree-app(界面)、disktree-scan(远程扫描器的独立二进制),再加一个 xtask 负责打包。

有个细节值得单独说一句:0.11.0 这一版,下载量最高的构建是 Windows 版(5,101 次),其次是 Apple Silicon 的 macOS 版(1,672 次)和 ARM 版 Windows(1,662 次),Linux x86_64 反而只有 1,066 次。一个为 Omarchy 而生的工具,最受欢迎的版本是它「顺便支持」的那个平台。

作者自己那张截图,比 README 更有说服力

README 顶部的截图是作者本机扫出来的真实结果。把它放大看,能读到不少东西。

disktree 把家目录画成树图,右侧面板列出可回收的大项

界面分为三块:左边是树图,右上是被选中项的信息,右下「Worth a look」是它认为可以放手的清单,底部是磁盘余量表。截图来自项目仓库 assets/screenshot.png。

顶栏一行:881 GiB · 390 万文件 · 49.84 万个目录;右下角磁盘表显示还剩 107 GiB,全盘 952 GiB。状态栏最右边写着扫描耗时:scan 3.9M entries · 1.0 s。

真正有意思的是右侧「Worth a look」那一栏——它列出「看起来可以放手」的大块头,按大小排序,每条后面标着理由:

  • .codex/worktrees:94 GiB,标注是 3 个 worktree
  • tobi/.cache:69 GiB,regenerable
  • .microsandbox/…:20 GiB,regenerable
  • src/tries 里 30 天以上的内容:20 GiB,40 个实验
  • .herdr/worktrees:17 GiB,3 个 worktree
  • .microsandbox-h…:17 GiB,build output

六条里有五条是 AI 编码工具留下的东西,加起来 168 GiB,占这次扫描的 881 GiB 将近两成。一个 94 GiB 的 .codex/worktrees,意味着 OpenAI Codex 在这台机器上留下的代码副本,比大多数人的整块硬盘还大。

这不是巧合,是设计。翻 crates/disktree-core/src/classify.rs 就能看到,作者把「agent 写出来的空间」当成了一等公民,单独开了一个颜色类别叫 Agent scratch:

/// Space agents write into: worktrees, sandboxes, experiments.
AgentScratch,

它认的目录名是这样的:

.codex | .claude | .herdr | .pi | .cursor | .aider
| .gemini | .continue | .windsurf | .microsandbox | .omp
| .agents | .openai | tries | worktrees | experiments
| scratch | playground  => Category::AgentScratch

也就是说,市面上的磁盘分析工具还在把 ~/.cache 当成唯一的「垃圾堆」时,这个工具的分类表里已经排进了 Codex、Claude Code、Cursor、Aider、Gemini CLI、Continue、Windsurf,以及 tries、worktrees、experiments、playground 这些 agent 最爱建的目录名。

这就是这个项目真正踩中的痛点:AI agent 是这一代电脑上增长最快的磁盘消费者,而在此之前没有任何一个工具承认过这件事。

颜色说的是「这是什么」,斜纹说的是「能不能删」

树图上的每个小方块同时承载两条独立的信息,这是它最容易看漏、也最值得学的设计。

颜色代表数据的种类,图例一共八项(另有一个 Other 兜底):Code(源码与检出)、Agent scratch(agent 工作区)、Toolchains(编译器与包管理器)、Synced(同步盘)、Git(版本库对象库)、Media(图片、音乐、视频、游戏、模型)、Documents(文档、下载、桌面)、Cache(缓存与可再生状态)。颜色越深表示嵌套越深。

斜纹代表可回收,和颜色无关,可以叠加在任何颜色上。判定理由分九种:regenerable(可再生)、sync history(同步历史)、package store(包存储)、build output(构建产物)、reinstallable(可重装依赖)、sandbox layers(沙盒镜像层)、snapshots(快照)、trash(废纸篓)、temporary(临时)。

所以你可以一眼看到「一大块蓝色的东西里,有一半是斜纹的」——蓝色的意思是源码,斜纹的意思是这部分能拿回来。这两个问题——它是什么、我能不能删——本来就是清理工具存在的全部理由,作者把它们压进了同一张图里。

分类靠目录名匹配,认不出的名字继承父目录的种类;顶层目录认不出时,取它最大的那个可识别子目录的种类(README 举的例子很形象:~/world 里主要是 .git,那它就算 git)。

「看起来像可以删」和「确实可以删」之间,它选了后者

这是我认为整个项目最见功力的地方。

很多清理工具判断「这是构建产物」的方式,是看目录名是不是 target——然后你项目里某个叫 target 的素材目录就没了。disktree 的做法是再看一眼它的邻居:

// Too common to trust alone: only a build directory beside a manifest.
"target" if has_sibling("Cargo.toml") => Reclaim::BuildOutput,
"node_modules" if has_sibling("package.json") => Reclaim::Reinstallable,
// ~/Library/Logs, told apart from a project's logs by its neighbour.
"logs" if has_sibling("Application Support") => Reclaim::Temporary,

target 旁边必须有 Cargo.toml 才算 Rust 构建目录;node_modules 旁边必须有 package.json 才算可重装依赖;连 Logs 都要靠旁边是不是有 Application Support 来区分「这是 macOS 的系统日志」还是「这是你某个项目的 logs 目录」。

更细的一条:layers 和 snapshots 这两个名字,只有在父目录被判定为 Agent scratch 时,才被认为是「沙盒镜像层」和「快照」——因为它们太通用了,不加前提就敢标「可删」,出事只是时间问题。

整个判定策略可以概括成一句话:宁可漏判,不能误判。漏判的代价是用户多占几 GB,误判的代价是删掉别人的东西。

删除被拆成三步,没有一步是「一键」

流程是这样的:

  1. 标记:空格或 x 标记光标下的方块,标记后方块变琥珀色(危险色),里面的所有内容一起变色——删目录本来就会带走内容。标记可逆,再按一次就取消。已经在标记目录里的东西不能再单独标记,面板会提示你去取消外层那个。
  2. 复核:按 c 进复核页,列出所有被标记的路径和合计大小,可以在这里逐条取消。
  3. 提交:三档选择。默认移到回收站(macOS 是系统废纸篓,等于 Finder 的「移到废纸篓」;其他地方依次尝试 trash-put、gio trash、内置 XDG 回收站),这一档不需要额外确认,因为还能捞回来。第二档永久删除,rm -rf 语义,永远先弹窗,弹窗里写清楚要删什么、能腾回多少。

删完之后它会自动重扫一遍,让屏幕上的数字和磁盘对得上,然后告诉你实际腾回了多少。

复核页还有两个出口,思路挺新:s 把清单存成文本文件(一行一个路径);a 把清单复制成给编码 agent 的一段 prompt——内容是「把这些路径删掉腾出空间,但删之前先逐个检查:这段 git 工作有没有别处的备份、这个工具是不是该用它自己的清理命令,除此之外什么都别碰」。名字里带换行的路径会被排除在清单之外、在 prompt 里转义,防止它冒充成另一个路径。

换句话说,它不介意把「执行」这一步交给你或者交给 agent,它只坚持一件事:决定权必须在人看过之后。

它明确拒绝做的事

删除守卫全在 crates/disktree-core/src/removal.rs,README 说每一条都有测试。列几条:

  • 只能删扫描根之下的路径;文件系统根、扫描根、你的家目录本身,一律拒绝。
  • 挂载点拒绝;内部含挂载点的目录也拒绝(删它会伸进另一个文件系统)。永久删除遇到挂载边界会停下,不会往下钻。
  • 装着家目录或系统树的目录拒绝。macOS 上 /Users 和 / 在同一个卷,/opt 装着 Homebrew,都属于这一类。
  • 系统目录(/usr、/etc、/boot、/var/lib、/nix/store、/gnu/store、Homebrew 前缀……)即使权限允许也拒绝——那些归包管理器管,该用 pacman、paccache 或 journalctl --vacuum。
  • 符号链接只解除链接,不跟随。
  • 任何东西都不经过 shell——一个叫 -rf 的文件就是个文件。
  • 选中一个 git 检出时,不会执行它定义的程序:git 被调用时关掉了 fsmonitor、hooks 和 pager;如果这个仓库自定义了 filter driver,就干脆不问它状态,显示「changes unknown」。

Windows 上还有一整套对应规则:Windows 目录、Program Files、ProgramData、系统卷信息、恢复分区、引导、页面与休眠文件,以及任何装着用户配置文件的目录(C:\Users 及其下每一个配置文件夹),都拒绝——因为提权运行的 disktree 可能以另一个账号跑,能碰到所有人。

这些规则听起来保守到啰嗦,但清理工具的全部信誉就押在这上面:它不是一个让你「放心一键清空」的工具,而是一个让你在删之前看清、并且后悔得起的工具。

SSH 模式:服务器上的盘,只能看不能删

这是另一个别人少做的功能:disktree ssh dev /var 可以直接把远程服务器的磁盘画成同一张树图。实现上有几个讲究。

Linux 构建(make build / cargo xtask portable)会把 x86-64 和 ARM64 两个静态扫描器直接追加在可执行文件尾部。连上去以后,它先探测服务器的系统和 CPU,只在缓存缺失或损坏时才上传对应那个——上传带校验和、原子安装,不用 sudo、不改系统包、不依赖服务器的 glibc 版本。缓存放在 ~/.cache/disktree/ssh/<sha256>/,内容寻址。作者还特意解释了一句为什么不走 Cosmopolitan:现有的 Rust / rayon / rustix 扫描器没有可用的稳定 Cosmopolitan 目标。

远程模式是只读的:没有回收站、没有删除按钮、没有「移除模式」选项,相关快捷键全部禁用,连「在文件管理器中显示」和 git 检查都关掉(免得远程路径误操作到本机)。

要删东西只能导出。按 c 复核以后,可以导出清单、导出脚本,脚本跑起来不带参数时只预览不执行,确认后加 --delete 才会连到那台机器上执行。执行前它会比对服务器真实的内核 hostname 和 machine ID——不是 SSH 别名——对不上就中止。脚本还会拒绝系统路径、扫描根、家目录及其祖先、符号链接或已改动的规范路径、以及任何含挂载点的路径。

安全边界也写得很实在:连接是一条压缩的 SSH,stdin 传一个有界的 JSON 请求、stdout 回紧凑的后序记录;Linux 端的 helper 有 1 GiB 地址空间上限、关掉 core dump、五分钟超时;文件内容从不过线,路径从不拼进远程 shell 命令。

装起来大概要几分钟

三种平台各自最短的路:

Arch / Omarchy(最省事):

yay -S disktree-bin    # 预编译;或 yay -S disktree 从源码构建

这两个包在 AUR 上,当前版本 0.11.0-1,维护者是 douglasdemoura,注意它们互相冲突,装一个就行。

Linux 其他发行版:下载 disktree-*-x86_64-linux.tar.gz(ARM 用 aarch64),解压后在里面跑 ./install.sh,或者直接把 disktree 丢到 PATH 上。make install 会在 ~/.local 下放三样东西——可执行文件、一个桌面入口(会出现在启动器和文件管理器的「打开方式」里,但不会抢占默认关联)、一个图标,全程不需要 root。

Windows:解压 disktree-*-x86_64-windows.zip,直接跑 disktree.exe。想让它读整块 NTFS 盘的主文件表(而不是逐个目录遍历),需要用管理员身份运行——这条路在 400 万文件的 C:\ 上实测 3.4 秒,对比 WizTree 的 11.2 秒、普通遍历的约 20 秒。没有管理员权限时它会老老实实遍历,侧栏会给你一个「以管理员身份重启」的按钮,走 UAC 重开同一个目录。

自己编译的话要求 Rust 1.97 以上、Wayland 或 X11 会话,以及一块 GPUI 能驱动的 GPU(Vulkan)。仓库里 rust-toolchain.toml 钉死了 1.97,用 rustup 的话首次构建会自动拉对版本。

常用命令就四条:

disktree            # 先选本机 / SSH 源,再选根目录
disktree ~          # 直接扫家目录
disktree --disk     # 扫家目录所在的那整块盘
disktree ~/src      # 扫任意目录

三个必须提前知道的坑

一、macOS 会说这个 App「已损坏」。没签名没公证的包会被 Gatekeeper 拦下,提示「已损坏,无法打开」或「无法验证」。App 本身没问题,是浏览器给下载文件打了隔离标记。清一次就好:

xattr -dr com.apple.quarantine /Applications/disktree.app

或者先双击一次,然后到「系统设置 › 隐私与安全性」里点「仍要打开」。

二、macOS 不给「完全磁盘访问」,扫出来的数就是假的。没有这个权限,邮件、信息、Safari、其他 App 的数据和废纸篓都会被系统藏起来,disktree 只能把它们算成「读不到」。设置面板里会给你一个直达按钮。从终端启动的话,要授权的是那个终端。

顺带三个 macOS 特有的口径差异,别拿去对系统报告:克隆文件(APFS 让副本共享数据块,Finder 里「制作副本」就会产生)会被每份都按全量算,所以总数可能大于你真删完能腾出的空间;Time Machine 本地快照不是文件,不会出现在图里,它们藏在「扫描总量」和「磁盘已用」的差值里;只有云端的目录(iCloud Drive、Dropbox 这类已驱逐到服务器的)不会被打开,扫描绝不会把实体下载下来。

三、Hyprland 下它会被切成一块。Hyprland 会给新窗口平铺,而它设计上是给一个宽敞窗口用的。给它一条浮动规则:

windowrule = float, class:^(disktree)$
windowrule = size 1400 900, class:^(disktree)$

顺手值得看的:这个仓库的工程习惯

就算不用这个工具,仓库里也有两样东西值得打开看一眼。

一个是 AGENTS.md。它不是「给 AI 的提示词」,而是一份工作契约:命令清单、代码规范,以及 11 条不可违背的不变量。比如「尺寸一律来自 st_blocks * 512」「合计是推导出来的,从不单独记录」「只有自己的扫描和每个子目录的任务都完成,一个目录才能被构建——提前构建会静默丢掉整棵子树,这事已经发生过一次」「状态栏绝不报告它测不到的节省量」。把「踩过的坑」写进不变量,比写在 commit message 里有用的多。

另一个是测试。它的窗口测试是真的画帧、真的按键:其中一个是标记一个目录、确认删除、然后检查那些文件真的没了,而旁边的邻居一个都没动。lint 门槛同样狠:clippy::all 和 clippy::pedantic 都是 error,-D warnings,每一条豁免都要在 Cargo.toml 里写明理由,不许悄悄放过。

一句话

disktree 不是「又一个 Disk Inventory X」。它做对的事情是三件:把「AI agent 吃了你多少硬盘」变成一张能看的图、把「可回收」的判定做得比同行保守一档、把删除拆成标记–复核–提交三步、并且默认走回收站。硬盘常年九成满、又不敢用一键清理的人,是它最合适的用户;想找个按钮按下去就自动清空的人,会嫌它啰嗦——而这恰恰说明它没做错。

项目地址:github.com/tobi/disktree(搜 disktree 也能找到,三大平台构建都在 releases 页面)。

参考来源

  • 仓库 README 与 AGENTS.md 原文:github.com/tobi/disktree
  • 分类与回收判定规则源码:crates/disktree-core/src/classify.rs;依赖版本:crates/disktree-app/Cargo.toml
  • 版本、下载量、提交与贡献者数据:GitHub API(截至 2026-11-01)
  • AUR 包信息:aur.archlinux.org/packages/disktree、disktree-bin
  • Omarchy 发行版背景:omarchy.org
  • 作者身份:GitHub 账号 tobi 公开资料(Tobias Lütke,Shopify)

本文为项目介绍与使用梳理,未在本机安装实测;文中性能与体积数字均引自项目 README 和作者本机截图,界面截图来自仓库 assets/screenshot.png。

腾讯云精选福利

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注