核心用法
Muninn 是一个面向 AI Agent 的通用上下文记忆系统，采用 Context Exchange Protocol (CXP) 协议，以 MCP (Model Context Protocol) 服务器形态运行。其核心工作流遵循强制性的「Brain-First」模式：
1. Orient (`brain_check`)：每次会话启动或项目切换时调用，加载本地项目索引
2. Search (`search_context`)：编码前执行语义检索，避免重复造轮子
3. Learn (`add_memory`)：将关键决策、修复方案、用户偏好持久化为 Markdown 格式的记忆文件
工具集涵盖项目初始化、上下文检索、索引重建、健康检查等完整生命周期管理。
显著优点
- 本地优先架构：所有索引与记忆存储于
.muninn/目录，零网络传输，零第三方依赖 - 高性能引擎：Rust 编译的 CXP 引擎（2026-02-10 版本），语义搜索与上下文注入均在本地完成
- Token 效率：精准检索替代全文件读取，显著降低上下文窗口开销与 API 成本
- 可审计透明：记忆文件为标准 Markdown，支持人工查阅、编辑、删除
- 僵尸进程防护：v2.1.7 引入鲁棒的进程管理机制
局限性与风险
- 初始化成本：每个项目需单独执行
init_project，无全局自动发现机制 - 索引维护负担：代码库大幅变更后需手动触发
reindex_context - 依赖 Node 环境：虽核心为 Rust，但安装链路依赖 npm 分发
- 无协作同步：纯本地设计导致多设备/多用户场景下记忆无法自动同步
- 单点故障：
.muninn/目录损坏或误删将导致项目上下文丢失
适用人群
- 注重代码隐私、拒绝云端同步的企业开发者
- 处理大型代码库、需精准上下文控制的 AI 辅助编程用户
- 对 token 成本敏感、追求极致上下文效率的 Agent 开发者
常规风险提示
记忆文件以明文 Markdown 存储，虽便于审计，但若项目目录被纳入版本控制，存在敏感信息（如 API 密钥模式、架构决策）意外泄露的风险。建议将 .muninn/ 加入 .gitignore。