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参与改进。