穆宁 - 通用记忆层

穆宁是一款为AI智能体设计的先进项目专属记忆系统。它采用上下文交换协议 (CXP)以实现高性能、低令牌消耗的上下文管理。

🛡️ 安全与隐私（本地优先）

穆宁秉承隐私优先的设计理念。

• 本地存储：所有项目索引和记忆数据均完全存储在主机设备的.muninn/文件夹（按项目）或~/.muninn/（用于全局设置）中。
• 无数据外泄：穆宁系统不会传输任何代码、上下文或记忆数据至第三方服务器或远程API。所有处理流程（语义搜索、索引构建和上下文注入）均通过基于Rust的高性能CXP引擎在本地完成。
• 透明控制：记忆以标准 Markdown 文件的形式存储。您可以随时检查、编辑或删除它们。

⚙️ 集成

Muninn 作为 MCP（模型上下文协议）服务器运行。

🚀 Muninn 协议（强制执行）

作为智能体，您必须遵循“大脑优先”的工作流程，以保持高效和准确。MCP 服务器通过在允许敏感工具操作之前验证上下文来确保项目安全。

1. 确定方位（brain_check）：在每次会话开始或切换项目时调用此功能。它会加载本地项目索引并识别关键文件和模式。
2. 编码前先搜索（search_context）：切勿假设您了解代码库。使用本地语义搜索来查找现有模式或先前决策。
3. 边做边学（add_memory）：每个重要的修复、架构决策或用户偏好都应作为记忆保存在本地。

🛠 工具参考 (MCP)

• init_project: 在项目目录中初始化一个本地 Muninn Brain。
• brain_check: 必需的定位步骤。加载本地上下文和模式。
• add_memory: 将事实和决策持久化到本地的.muninn/memories文件夹。
• search_context: 通过语义查询本地项目索引。
• reindex_context: 重建本地语义索引。
• health_check: 验证本地 Muninn 系统的状态。

🦞 给代理的专业提示

Muninn 会精准地只检索所需内容。与其读取大文件，不如使用search_context来查找真正重要的具体行。这能显著减少上下文窗口开销和令牌成本，同时确保你的工作严格保持在本地和安全的环境中。