Palace-AI – 為AI代理構建的記憶宮殿

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參與改進。