Palace-AI – 為AI代理構建的記憶宮殿
Palace-AI 是一個開源工具,能將程式碼庫轉化為可遍歷的“記憶宮殿”,幫助AI代理透過關聯而非搜尋來導航程式碼。它預設基於AST分析,無需API金鑰,可選LLM增強房間摘要。與傳統方法相比,可減少10-42倍的token消耗。
Palace-AI 是一個創新的開源工具,旨在改變AI代理與程式碼庫互動的方式。透過將程式碼庫轉換為可遍歷的“記憶宮殿”,它讓AI代理能夠透過關聯而非傳統搜尋來理解和導航程式碼。這種方式模仿了人類記憶的工作原理,顯著提高了效率。
該專案由RhyChaw建立,基於Python實現,並已在GitHub上釋出。Palace-AI的核心思想是:在閱讀原始碼之前,先構建一個由“房間”和“型別化關係”組成的結構圖,代理可以據此快速定位所需資訊。
主要功能
Palace-AI 提供以下關鍵功能:
- 構建記憶宮殿:使用
palace build .命令,可將當前程式碼庫掃描並生成一個PALACE.md地圖和多個房間檔案。每個房間檔案包含結構、匯出和呼叫提示。 - 查詢相關節點:透過
palace query "your topic"可以查詢與主題相關的節點。 - 統計token節省:執行
palace stats檢視與傳統全文讀取相比的token節省效果,通常可減少10-42倍。 - 圖形視覺化:使用
palace serve啟動一個圖形視覺化器。 - Claude Code整合:透過
palace install claude安裝Claude Code鉤子,自動建立CLAUDE.md和PreToolUse鉤子。
快速開始
安裝非常簡單:
pip install palace-ai
palace build .
palace query "your topic"
palace serve # 可選:圖形視覺化器預設情況下,Palace-AI 僅使用AST分析,無需任何API金鑰。如果需要更豐富的房間摘要,可以使用 --llm 選項並設定 ANTHROPIC_API_KEY 環境變數。
工作原理
傳統方法將成千上萬個token的原始碼直接放入上下文,而Palace-AI 則讓代理先讀取一個地圖檔案,然後按需訪問特定的房間檔案,最後才開啟真正需要的原始檔。這種分層導航極大地減少了token消耗,特別是在大型程式碼庫中。
許可證
該專案採用MIT許可證,完全開源。
專案狀態
目前Palace-AI處於早期階段,但已具備完整功能。GitHub倉庫包含示例(如requests庫的預建宮殿)、測試夾具以及詳細的文件。社群貢獻者可以透過GitHub參與改進。