症狀#

• 系統經常提示「磁碟空間不足」
• 無法下載或安裝新應用程式
• 沒有進行大量檔案下載或安裝
• 磁碟使用率突然飆升到 90% 以上

第一階段：尋找大目錄#

使用 du 命令逐一檢查家目錄下的大型目錄：

1
du -h -d 1 ~ | sort -hr | head -20

發現驚人結果：

1
39G   ~/.gemini        ← 異常！

.gemini 目錄佔用了 39GB，這顯然不正常。這是 Google Gemini CLI 的配置和資料目錄，一般情況下應該只有幾百 MB。

第二階段：深入調查 Gemini 目錄#

繼續深入調查 .gemini 目錄的子目錄：

1
du -h -d 1 ~/.gemini/antigravity | sort -hr

結果令人震驚：

1
39G   ~/.gemini/antigravity
2
38G   ~/.gemini/antigravity/browser_recordings  ← 罪魁禍首！
3
239M  ~/.gemini/antigravity/brain
4
99M   ~/.gemini/antigravity/conversations

第三階段：找到根本原因#

browser_recordings 目錄佔了整整 38GB！這是 Google Antigravity 的瀏覽器自動化錄製功能產生的檔案。

詳細分析：

1
find ~/.gemini/antigravity/browser_recordings -type f | wc -l
2
# 結果：558,225 個檔案！

1
ls -lh ~/.gemini/antigravity/browser_recordings/

總計：558,225 個錄製檔案，累積佔用 38GB！

問題所在#

1. 無自動清理機制：錄製檔案會無限累積，從不自動刪除
2. 沒有內建清理指令：Gemini CLI 並未提供任何清理 browser_recordings 的官方指令
3. 大量小檔案：每次互動產生數千個小檔案
4. 使用者不知情：背景靜默運行，沒有容量警告
5. 長期累積效應：從 11 月到 1 月，累積了 2 個多月的資料

為什麼需要手動清理？#

重要提醒：Gemini CLI 目前並未提供任何內建的清理指令或自動清理機制。官方文件中也沒有提到 browser_recordings 的管理方式，因此我們只能透過手動方式清理這些累積的檔案。

清理 Gemini 瀏覽器錄製檔案#

刪除 3 天前的舊錄製檔案（保留最近的工作記錄）：

1
find ~/.gemini/antigravity/browser_recordings \
2
  -maxdepth 1 -type d -mtime +3 \
3
  -exec rm -rf {} \;

注意事項：

• 刪除 558,225 個檔案需要數分鐘
• 使用 -mtime +3 保留最近 3 天的錄製
• 可以調整天數根據需求

效果：

• 釋放空間：37.5GB
• browser_recordings: 38GB → 860MB
• 刪除檔案數：約 540,000 個
• 保留最近 2 天的錄製記錄

最終數據對比#

總釋放空間：37.5GB

清理效果#

1
清理前：browser_recordings 目錄
2
  ├── 558,225 個檔案
3
  └── 佔用 38GB
4

5
清理後：保留最近 3 天的錄製
6
  ├── ~18,000 個檔案
7
  └── 佔用 860MB

1. 大量小檔案的影響#

一個 37GB 的大檔案 vs. 558,225 個小檔案：

• 檔案系統開銷：每個檔案都需要 inode 和目錄項
• 刪除時間：刪除大量小檔案需要數分鐘（vs. 秒級刪除單一大檔案）
• 備份困難：Time Machine 或其他備份工具處理大量小檔案效率極低
• 空間統計誤差：ls 顯示的檔案大小 vs. 實際佔用的磁碟空間可能有差異

2. AI 工具的隱性成本#

像 Gemini Antigravity 這類 AI 開發工具，為了提供智能功能需要：

• 記錄所有互動歷史
• 儲存截圖和 DOM 快照
• 保存網路請求和回應
• 建立索引用於 AI 分析

使用者往往不知道這些背景操作的空間成本。

1. 定期清理腳本#

建立每週自動執行的清理腳本：

1
#!/bin/bash
2
echo "開始清理 Gemini 舊錄製..."
3

4
# 清理 Gemini 舊錄製（保留 7 天）
5
find ~/.gemini/antigravity/browser_recordings \
6
  -maxdepth 1 -type d -mtime +7 \
7
  -exec rm -rf {} \;
8

9
# 顯示結果
10
echo "清理完成！當前 Gemini 目錄大小："
11
du -sh ~/.gemini
12
du -sh ~/.gemini/antigravity/browser_recordings
13

14
echo "完成時間：$(date)"

使用 crontab 設定每週日執行：

1
crontab -e
2
# 新增：每週日凌晨 3 點執行
3
0 3 * * 0 ~/scripts/gemini-cleanup.sh >> ~/logs/gemini-cleanup.log 2>&1

2. 監控 Gemini 目錄大小#

建立快速檢查命令的 alias：

1
# 加入 ~/.zshrc 或 ~/.bashrc
2
alias geminicheck='du -sh ~/.gemini && du -sh ~/.gemini/antigravity/browser_recordings'
3
alias geminifiles='find ~/.gemini/antigravity/browser_recordings -type f | wc -l'

3. 配置 Gemini 設定#

如果不需要瀏覽器錄製功能，可以在設定中停用：

1
# 編輯 Gemini 設定
2
nano ~/.gemini/antigravity/user_settings.pb
3

4
# 或透過 GUI：
5
# Settings → Browser → Disable Recording

4. 設定容量警報#

使用 macOS 內建的磁碟空間通知，或建立自訂腳本：

1
#!/bin/bash
2
THRESHOLD=80  # 使用率門檻 80%
3
USAGE=$(df -h / | tail -1 | awk '{print $5}' | sed 's/%//')
4

5
if [ $USAGE -gt $THRESHOLD ]; then
6
    osascript -e "display notification \"磁碟使用率 ${USAGE}%，請檢查空間\" with title \"磁碟警告\""
7
fi

方法 1：定期自動清理（推薦）#

使用前面提供的自動化清理腳本，透過 cron 定期清理舊檔案：

1
# 每週清理一次，保留最近 7 天
2
0 3 * * 0 ~/scripts/gemini-cleanup.sh

方法 2：限制目錄寫入權限（進階）#

如果完全不需要錄製功能，可以將目錄設為唯讀：

1
# 先清空目錄
2
rm -rf ~/.gemini/antigravity/browser_recordings/*
3

4
# 設為唯讀（需要時可以改回來）
5
chmod -w ~/.gemini/antigravity/browser_recordings

注意：這可能會導致 Gemini CLI 在嘗試寫入時出現錯誤訊息，但不會影響其他功能。

方法 3：使用符號連結到 /tmp（實驗性）#

將錄製目錄連結到臨時目錄，系統重啟時自動清理：

1
# 備份並移除原目錄
2
mv ~/.gemini/antigravity/browser_recordings ~/.gemini/antigravity/browser_recordings.bak
3

4
# 建立符號連結到臨時目錄
5
ln -s /tmp/gemini_recordings ~/.gemini/antigravity/browser_recordings

建議：目前最可靠的方式是使用定期自動清理腳本，直到 Google 官方提供正式的清理或停用選項。

關鍵教訓#

1. 定期檢查 AI 工具目錄：特別是 ~/.gemini、~/.cursor、~/.anthropic 等目錄
2. 了解工具的隱性成本：使用 AI 工具前，了解其資料儲存機制
3. 設定自動化清理：因為沒有官方清理工具，必須使用 cron 定期清理舊檔案
4. 監控而非被動反應：建立主動監控機制，而非等到空間不足才處理
5. 向官方反饋：這是 Gemini CLI 的設計缺陷，應該要有自動清理或容量限制機制

給其他使用者的建議#

如果你也使用 Gemini CLI 並遇到磁碟空間不足的問題，不妨檢查一下 ~/.gemini/antigravity/browser_recordings 目錄，很可能會發現驚人的空間佔用。在官方提供正式的解決方案之前，建議：

• ✅ 立即檢查目錄大小
• ✅ 設定定期清理腳本
• ✅ 監控磁碟空間使用狀況
• ✅ 考慮向 Google 反饋這個問題

希望這個案例能幫助遇到類似問題的開發者快速定位和解決問題，也期待 Google 未來能在 Gemini CLI 中加入適當的資料管理機制。