muninn

核心用法

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

核心用法

Muninn 作为 MCP（Model Context Protocol）服务器运行，为 AI Agent 提供项目级持久化记忆能力。其强制推行的 "Brain-First" 工作流要求 Agent 在每次会话开始时调用 brain_check 加载本地项目索引，再通过 search_context 进行语义搜索，而非直接读取大文件，最后用 add_memory 沉淀关键决策。这种设计显著压缩上下文窗口，降低 token 消耗。

显著优点

1. 零数据外泄架构：所有索引与记忆存储于本地 .muninn/ 目录，无网络传输，隐私合规性极佳（GDPR 数据最小化原则通过）。
2. 高性能语义引擎：基于 Rust 编译的 CXP 引擎提供亚秒级语义检索，远超传统文本搜索。
3. 透明可审计：记忆以 Markdown 格式存储，用户可随时查看、编辑或删除，无黑箱。
4. Agent 工作流固化：自动向 CLAUDE.md/.cursorrules 注入规则块，确保团队协作一致性。

潜在局限

• 来源可信度风险：维护者为个人开发者 BlackKnight，无公开 GitHub 仓库，属 T3 来源等级，需用户自行审查。
• 二进制依赖：核心功能依赖本地 CXP 二进制文件，尚未提供 SHA256 校验机制，存在潜在供应链风险。
• 生态锁定：规则块注入可能与其他类似工具冲突，迁移成本需评估。
• 许可证模糊：当前声明为 UNLICENSED，商业使用存在法律不确定性。

适合人群

• 对代码隐私极度敏感的开发者（企业内网、商业机密项目）
• 需要长期维护复杂代码库的 AI 辅助编程用户
• 追求 token 效率的 Claude/Cursor 重度用户

常规风险

1. 进程管理：使用 child_process.execFile 调用 CXP 引擎，虽设 60 秒超时与 SIGKILL，仍需确保二进制来源可信。
2. 文件系统写入：初始化时会修改项目根目录的 Agent 配置文件，建议在版本控制中审查变更。
3. 版本更新：个人维护项目可能存在更新延迟或弃用风险，建议锁定版本使用。