入門

安裝只要幾分鐘。第一次掃描只會讀取:它會顯示找到了什麼、為什麼作出這樣的判定,在你確認之前不會碰任何東西。

Devbroom 可在搭載 Apple Silicon 晶片、執行 macOS 13.3 或以上版本的 Mac 上執行。

下載和安裝

從下載頁面下載 .dmg,打開它,把 Devbroom 拖到「應用程式」資料夾。然後從那裡打開 App。

Devbroom 會自行尋找新版本:啟動 8 秒後,讀取一次我們發布的 latest.json 檔案。如果有新版本,它會詢問你;選擇「安裝」後,會先驗證簽章再安裝。不會傳送任何關於你的資訊;詳情請見隱私權頁面。

選擇你的資料夾

第一次啟動時,Devbroom 會詢問你的專案放在哪裡。選擇存放程式碼的資料夾,或把它們拖進來;之後可以在「設定 › 資料夾」中加入和移除。

你不需要加入代理自己的資料夾。主資料夾中代理的資料夾(~/.claude、~/.codex 等)每次掃描都會包含。

完整磁碟取用權限

如果 macOS 保護的資料夾(例如「桌面」、「文件」或「下載項目」)無法讀取,Devbroom 會告訴你:「有 1 個資料夾需要完整磁碟取用權限。」它的按鈕會帶你前往「系統設定 › 隱私權與安全性 › 完整磁碟取用權限」,在那裡開啟 Devbroom。這項權限是可選的:沒有它,Devbroom 只是無法讀取那些資料夾。

第一次掃描

選好資料夾後掃描就會開始。它只會讀取:找出 git 儲存庫和 worktree、代理的資料夾、建置輸出和開發者快取,測量每一項在磁碟上實際佔用的空間,並檢查哪些代理仍在執行。

看懂泡泡

在「儲存空間」畫面中,找到的每樣東西都是一個泡泡,大小與它佔用的空間相當。每個泡泡都會得到判定並歸入對應的群組:

群組 意思
READY可清理 所有檢查都已通過。一開始就已選取,準備清理。
REVIEW需查看 值得先看一眼。只有選擇「仍要加入」才會清理。
BLOCKED已鎖定 正在使用或含有工作內容。無法選取。
UNKNOWN不確定 證據不足。無法選取,永遠不會算作可清理。

按一下泡泡,就能看到其判定背後的理由:屬於哪個代理、是否正在使用、是否含有未儲存的工作。「查看內容」會顯示該資料夾裡有什麼。所有判定請見判定頁面。

清理

  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 會離開 Dock,繼續在選單列中執行;要完全結束,請按 ⌘Q。

Pro

掃描、判定、清理、放回、命令列和 MCP 都是免費的。自動維護、分析和工作階段工具屬於 Pro。前 14 天 Pro 的所有功能都已開啟;不需信用卡、帳號或電子郵件。試用結束後不會刪除任何東西:你的規則會暫停,歷史紀錄會保留。Pro 一次付費 $29,可用於 2 台 Mac;詳情請見價格頁面。

最後更新: 2026年10月7日