入门

安装只需几分钟。第一次扫描只读取：它会显示找到了什么、为什么作出这样的判定，在你确认之前不会碰任何东西。

下载和安装

从下载页面下载 .dmg，打开它，把 Devbroom 拖到“应用程序”文件夹。然后从那里打开应用。

Devbroom 会自行查找新版本：启动 8 秒后，读取一次我们发布的 latest.json 文件。如果有新版本，它会询问你；选择“安装”后，会先验证签名再安装。不会发送任何关于你的信息；详见隐私页面。

选择你的文件夹

首次启动时，Devbroom 会询问你的项目放在哪里。选择存放代码的文件夹，或者把它们拖进来；之后可以在“设置 › 文件夹”中添加和移除。

你不需要添加智能体自己的文件夹。主文件夹中智能体的文件夹（~/.claude、~/.codex 等）每次扫描都会包含。

完全磁盘访问权限

如果 macOS 保护的文件夹（如“桌面”、“文稿”或“下载”）无法读取，Devbroom 会告诉你：“有 1 个文件夹需要完全磁盘访问权限。”点按它的按钮会带你前往“系统设置 › 隐私与安全性 › 完全磁盘访问权限”，在那里打开 Devbroom。此权限是可选的：没有它，Devbroom 只是无法读取那些文件夹。

第一次扫描

选好文件夹后扫描就会开始。它只读取：找出 git 仓库和 worktree、智能体的文件夹、构建输出和开发者缓存，测量每一项在磁盘上实际占用的空间，并检查哪些智能体仍在运行。

读懂气泡

在“存储”画面中，找到的每样东西都是一个气泡，大小与它占用的空间相当。每个气泡都会得到判定并归入对应的分组：

点按一个气泡，就能看到其判定背后的理由：属于哪个智能体，是否正在使用，是否含有未保存的工作。“查看内容”会显示该文件夹里有什么。所有判定见判定页面。

清理

1. 按下清理。Devbroom 会立即再次检查选中的项目：“正在重新检查 27 项。”
2. 预览会显示将要发生的事：“将 27 项移到废纸篓”、总大小以及每一项。你选中但未通过检查的项目会列在“已排除”下，并附上原因。
3. 确认后，这些项目会移到废纸篓。如果扫描后有任何变化，就不会动它，并告诉你为什么跳过。
4. 移到废纸篓的空间在你清倒废纸篓之前仍占用磁盘；Devbroom 会提示：“已移到废纸篓 · 清倒废纸篓后空间才会释放”。

如果你改变主意，“放回”会还原所有项目；之后也仍然可以从“历史记录”中逐个放回。永久删除是另一个单独的选择，需要按住按钮来确认。

Worktree 不会进废纸篓：它们通过 git 删除，删除前 HEAD 会先保存到一个恢复用的 ref 中，分支保留。

自动维护

在“设置 › 自动维护”中，你可以选择 Devbroom 何时自行扫描（关闭、每天或每周），以及可清理的内容达到多少 GB 时通知你。自动扫描只读取。

你还可以添加规则，例如“超过 90 天的构建文件夹”。规则默认会先询问你。选择“自动执行”后，它只会移动可清理的项目，而且只移到废纸篓；每一项都可以放回。除非你打开这些功能，否则未经你同意 Devbroom 不会改动任何东西。自动维护包含在 Pro 中。

会话

“会话”标签页按文件夹显示智能体的会话历史：哪些正在运行、占用多少空间、哪些对应的文件夹已不存在，以及按 API 标价估算的已用 token 价值，包括最近 30 天。这些数字只在你的 Mac 上计算。

• **搜索：**搜索会话中说过的内容。日志在那一刻读取，不建立任何索引；结果中看起来像机密信息的字符串会被隐藏。
• **归档对话：**把某个文件夹的 Claude Code 对话打包成归档并验证，然后把原文件移到废纸篓。项目的记忆保留在原处。已归档的对话在重新打开之前，claude --resume 无法打开它们；你可以从“历史记录”中重新打开。

用量与费用、搜索和归档包含在 Pro 中。

菜单栏

Devbroom 也常驻菜单栏：它会显示上次扫描后有多少可清理的内容，扫描进行时显示进度；你可以从那里重新扫描或停止扫描。关闭窗口后，Devbroom 会离开程序坞，继续在菜单栏中运行；要完全退出，请按 ⌘Q。

Pro

扫描、判定、清理、放回、命令行和 MCP 都是免费的。自动维护、分析和会话工具属于 Pro。前 14 天 Pro 全部功能都已开启；无需银行卡、账户或电子邮件。试用结束后不会删除任何东西：你的规则会暂停，历史记录会保留。Pro 一次性付费 $29，可用于 2 台 Mac；详见价格页面。

最后更新： 2026年10月7日