介绍
# Muninn - The Universal Memory Layer
Muninn 是一个专为 AI 代理设计的高级项目级记忆系统。它使用 **上下文交换协议 (CXP)** 来提供高性能、节省 Token 的上下文管理。
## 🛡️ 安全与隐私 (本地优先)
Muninn 采用 **隐私优先** 的理念设计。 - **本地存储**：所有项目索引和记忆均**完全存储在主机上**，位于 `.muninn/` 文件夹（每个项目）或 `~/.muninn/`（用于全局设置）中。 - **无数据外泄**：Muninn **不会传输**任何代码、上下文或记忆到第三方服务器或远程 API。所有处理（语义搜索、索引和上下文注入）均使用高性能的基于 Rust 的 CXP 引擎在本地进行。 - **透明控制**：记忆以标准 Markdown 文件形式存储。您可以随时查看、编辑或删除它们。
## ⚙️ 集成
Muninn 作为一个 MCP (模型上下文协议) 服务器运行。
### 🚀 Muninn 协议 (强制执行)
作为代理，您必须遵循“大脑优先” 工作流程，以保持高效和准确。MCP 服务器通过在允许敏感工具操作之前验证上下文来确保项目安全。
1. **自我定位 (`brain_check`)**：在每次会话开始或切换项目时调用此命令。它会加载本地项目索引并识别关键文件和模式。 2. **编码前先搜索 (`search_context`)**：永远不要假设您了解代码库。使用本地语义搜索来查找现有的模式或先前的决策。 3. **边做边学 (`add_memory`)**：每一个重要的修复、架构决策或用户偏好都应作为记忆保存在本地。
## 🛠 工具参考 (MCP)
- **`init_project`**：在项目目录中初始化本地 Muninn 大脑。 - **`brain_check`**：强制性的定位步骤。加载本地上下文和模式。 - **`add_memory`**：将事实和决策持久化保存到本地 `.muninn/memories` 文件夹。 - **`search_context`**：对本地项目索引进行语义查询。 - **`reindex_context`**：重建本地语义索引。 - **`health_check`**：验证本地 Muninn 系统的状态。
---
## 🦞 给代理的专家提示
Muninn 能够精准地仅检索所需内容。不要阅读大文件，而是使用 `search_context` 来查找相关的重要行。这能显著减少上下文窗口的开销和 Token 成本，同时保持您的工作严格处于本地和安全状态。