delete_project 工具詳解 · Codebase Memory

指令用途

隨時間增長，開發者本機上可能會累積數十個已經完成、甚至已被刪除的舊專案圖譜快取。如果不進行清理，本地 SQLite 資料庫的體積會不斷增大，消耗不必要的硬碟空間。

delete_project 專為 圖譜索引卸載與空間清理 而生。它允許開發者與 AI 助手，在不需要手動操作 SQLite 或刪除實體檔案的情況下，透過單一 MCP 指令直接將指定的專案 ID 及其關聯的所有圖節點（Nodes）、關係邊（Edges）從本地快取資料庫中完全抹除，釋放磁碟空間。

運作流程

參數接收：接收 projectId（目標專案的唯一識別標誌）作為輸入。
級聯刪除 (Cascading Delete)：
- 刪除專案節點。
- 級聯清除與該專案相關的所有 Directory, File, Class, Method 等節點。
- 刪除所有關聯的關係邊。
資料庫壓縮 (Vacuum)：自動執行 SQL VACUUM 指令，將釋放出來的磁碟空間退還給作業系統。
輸出成功狀態。

實戰對話範例

範例：刪除過期的舊專案索引

You:

/opsx:explore "我的 CommerceMonorepo 專案已經開發完成了，本地不再需要它。請幫我刪除它的 codebase-memory 索引。"

AI:
好的，為了幫您釋放本地硬碟空間，我將調用 delete_project 工具，從 codebase-memory 全域快取庫中清除 CommerceMonorepo 專案的所有圖譜數據。

CM 呼叫: delete_project(projectId: "CommerceMonorepo")
CM 回傳:
```
{
  "status": "deleted",
  "projectId": "CommerceMonorepo",
  "nodesDeleted": 1824,
  "edgesDeleted": 4921,
  "spaceReleasedBytes": 14208000,
  "vacuumExecuted": true
}
```
分析：
刪除操作已成功執行！
- 從資料庫中清除了 1,824 個節點與 4,921 條關係邊。
- 執行了 VACUUM 壓縮，為您的硬碟釋放了約 13.5 MB 的空間。
該專案現在已完全從快取中清除。接下來您希望我們列出剩餘的專案清單嗎？