muninn

核心用法

Muninn 是面向 AI 智能体的通用上下文记忆层，通过 MCP（Model Context Protocol）协议与代理集成。其核心采用 Context Exchange Protocol (CXP) 引擎，提供三大强制工作流：

1. brain_check — 会话启动时加载本地项目索引，完成空间定位
2. search_context — 语义检索替代文件通读，精准定位相关代码片段
3. add_memory — 将架构决策、修复记录、用户偏好持久化为 Markdown 格式记忆

项目初始化后，所有数据存储于 .muninn/ 目录（项目级）或 ~/.muninn/（全局配置），以纯文本 Markdown 形式透明可审计。

显著优点

• 隐私优先架构：零网络传输承诺，索引与推理完全本地执行，Rust 编译的高性能引擎保障速度
• Token 效率：语义检索替代大文件读取，显著降低上下文窗口消耗与 API 成本
• 透明可控：记忆文件为可读 Markdown，支持人工审计、编辑、版本控制
• MCP 标准化：作为 MCP 服务器运行，与兼容客户端无缝集成
• 增量索引：pfeilschnell indexing 支持快速增量更新

潜在局限

• 单点依赖：完全本地架构意味着无云端备份，设备故障可能导致记忆丢失
• 项目级隔离：跨项目记忆共享需手动配置，缺乏原生全局知识图谱
• 生态锁定：深度绑定 MCP 协议，非 MCP 环境需额外适配层
• 维护负担：reindex_context 需手动触发，大型项目可能产生索引滞后

适合人群

• 注重代码隐私的企业开发者与独立工程师
• 上下文窗口敏感的长期 AI 辅助编程场景
• 需要可审计 AI 决策链的合规敏感行业
• 已采用 MCP 工具链的技术团队

常规风险

• 数据持久化风险：本地存储无自动备份，建议配合 Git 追踪 .muninn/memories
• 索引漂移：频繁代码变更后若未及时 reindex，检索召回率下降
• 记忆膨胀：无自动过期策略，长期项目可能累积冗余记忆需人工清理
• 二进制信任：muninn-core NPM 包内含 Rust 编译的二进制文件，需验证来源签名