核心用法
Muninn 是一款面向 AI 代理的高级项目级记忆系统，采用 Context Exchange Protocol (CXP) 实现高性能、低 Token 消耗的上下文管理。作为 MCP（Model Context Protocol）服务器运行，它强制实施「Brain-First」工作流：每次会话启动必须调用 brain_check 定向，编码前使用 search_context 语义搜索，决策通过 add_memory 持久化到本地。
显著优点
- 隐私优先架构：所有数据存储于本地
.muninn/目录，零网络传输，采用 Rust 编译的高性能 CXP 引擎本地处理语义搜索与索引 - Token 效率：精准检索所需代码片段，避免加载大文件，显著降低上下文窗口开销
- 透明可控：记忆以标准 Markdown 存储，可随时审查、编辑或删除
- 防僵尸进程：v2.3.1 版本优化进程管理，提升系统稳定性
潜在局限
- 仅支持本地项目：无法跨设备同步记忆（设计上的隐私权衡）
- Node.js 依赖：需要本地 Node 环境运行
- 强制工作流："Brain-First" Gate Keeper 可能增加初始交互步骤
- 社区生态较新：CXP 协议为标准 Markdown 之外的新兴规范
适合人群
对代码隐私极度敏感的开发者、企业内网环境、处理商业机密或知识产权项目的 AI 辅助编程场景。
常规风险
- 本地磁盘损坏可能导致记忆丢失（需配合常规备份）
- 多代理协作时若未统一索引状态可能出现上下文分歧
- 语义搜索质量依赖本地索引构建时机，建议定期
reindex_context