指令用途

Codebase Memory 在本地端的 SQLite 中可以管理多個不同專案（Repositories）的知識圖譜。在進行多專案協作或切換開發目錄時，AI 助手需要先了解當前本機系統已經為哪些專案建立了快取索引，以便進行選擇或清理。

list_projects 專為 多專案圖譜清單查詢 而設計。它能列出當前本地快取資料庫中管理的所有專案 ID、根目錄路徑、最後一次掃描的更新時間，方便進行全域的索引維護。

運作流程

1. 快取讀取：查詢本地 SQLite 全域管理資料表。
2. 狀態提取：提取各專案的元數據（更新時間、檔案總數）。
3. 回傳與展示：回傳 JSON 清單。

實戰對話範例

範例：查詢本機已索引的專案清單

• You:

  /opsx:explore "請幫我看看我的電腦上已經為哪些專案建立了 codebase-memory 索引。"

• AI:

  好的，我將調用 list_projects 工具，拉取本機所有已快取的專案圖譜清單。

  CM 呼叫: list_projects()
  CM 回傳:

  [
    {
      "projectId": "CommerceMonorepo",
      "projectRoot": "D:/Repo/CommerceMonorepo",
      "lastUpdated": "2026-07-15T10:30:00Z",
      "fileCount": 1824
    },
    {
      "projectId": "TechSpecs",
      "projectRoot": "D:/Repo/TechSpecs",
      "lastUpdated": "2026-07-16T11:02:00Z",
      "fileCount": 248
    }
  ]

  分析：
  您的電腦上目前為兩個專案建置了圖譜快取：

  1. CommerceMonorepo：昨日更新，包含 1,824 個檔案。
  2. TechSpecs：剛剛更新，包含 248 個檔案。

  這能讓您在多個專案間快速切換，無需重複執行全量建置。接下來您需要對其中某個專案進行索引清理嗎？