调研时间:2026-08-12 | 调研范围:8 个 AI Agent Memory 项目
| 项目 | ⭐ | 活跃度 | 核心定位 | 架构 |
|---|---|---|---|---|
| agentmemory | 26.9k | ✅ Active | 通用 Agent 记忆层 | iii engine + SQLite |
| Memorix | 625 | ✅ Active | 项目级记忆系统 | SQLite + Orama |
| Memoria | 574 | ✅ Active | Git 式记忆版本控制 | MatrixOne DB |
| claude-memory-compiler | 1.3k | 🟡 Warm | 个人知识编译器 | Claude hooks + Markdown |
| SwarmClaw | 642 | 🟡 Warm | 多 Agent 运行时 | Next.js + Electron |
| Agent-KB | 450 | 🔬 Research | 学术知识库框架 | JSON KB + smolagents |
| MemoryCustodian | 20 | 🟡 Warm | 仓库原生记忆 | Plain Markdown |
| GoodMemory | 16 | ✅ Active | 可审计记忆层 | SQLite on Bun |
| MisakaNet | 389 | ✅ Active | 集体失败记忆 | Git + Python (zero-dep) |
定位: "Your coding agent remembers everything. No more re-explaining."
核心卖点:
- 54 个 MCP 工具,6 个资源,3 个提示,15 个技能
- 12 个自动 hooks 实现零配置捕获
- 混合搜索:BM25 + 向量 + 知识图谱 + RRF
- 4 层记忆整合(工作记忆、情景记忆、语义记忆、程序记忆)
- Ebbinghaus 曲线记忆衰减
- 隐私优先:API key 和 secrets 存储前剥离
- 基准测试:95.2% R@5 on LongMemEval-S (ICLR 2025)
- Token 节省:
170K tokens/yr ($10/yr) vs 19.5M+ 全量上下文
架构:
- iii 引擎替代传统基础设施(Express, Postgres+pgvector, SSE/Socket.io)
- SQLite + iii-engine(无需外部数据库)
- 175 源文件,~39,200 LOC,1,596+ 测试
- 130 REST 端点,端口 3111
可借鉴:
- ✅ 4 层记忆整合模型符合认知科学
- ✅ 基准测试方法论提供可信度
- ✅ Token 节省叙事有说服力
- ✅ 17+ Agent 兼容性是分发优势
⚠️ iii 引擎抽象有供应商锁定风险
定位: "One project memory system" — 跨会话、IDE 切换、Agent 交接持久化。
核心卖点:
- 6 层记忆模型:观察、推理、Git、代码、精选长期、紧凑连续
- "Memory Autopilot" 通过
memorix context "..."自适应任务类型 - Git Memory 将 commits 转换为可搜索的工程事实
- Reasoning Memory 存储推理、替代方案、权衡和风险
- 内置编排:任务规划、Worker 交接、文件锁、验证门
- 捆绑
memcode终端编码 Agent - 15+ Agent 集成(MCP、插件、hooks、规则、技能)
架构:
- SQLite 规范存储 + Orama 搜索
- 本地优先,无需模型密钥即可通过本地全文检索工作
- 运行模式:stdio MCP、HTTP (3211)、Docker、CLI、SDK
- TOML 配置
可借鉴:
- ✅ Git Memory 层(commit 派生事实)独特
- ✅ Reasoning Memory(设计推理、替代方案、权衡)少见
- ✅ 编排层(交接、锁、验证门)独特
- ✅
memcode捆绑 Agent 是聪明的分发策略 - ✅ Transfer export/import 实用
定位: "The World's First Git for AI Agent Memory." — 为记忆管理带来 Git 风格版本控制。
核心卖点:
- Git 级版本控制:零拷贝分支、即时快照、时间点回滚
- 自治理:自动矛盾检测、低置信度隔离、审计追踪
- 隐私优先,可选本地嵌入
- 9 个核心记忆工具 + 7 个快照/分支工具 + 3 个维护工具
- 5 种记忆类型:语义、档案、程序、工作、情景
架构:
- 云/远程模式:MCP stdio → CLI → HTTP/REST → Cloud API
- 自托管/嵌入模式:MCP → 本地 MCP Server → MatrixOne DB
- 背后有 arXiv 论文 (2604.03927)
可借鉴:
- ✅ Git 风格分支用于记忆实验真正创新
- ✅ 治理/冷却系统防止记忆操作失控
- ✅ Steering rules 模式(平台特定规则文件)实用
- ✅ 学术论文背书是可信度差异化
- ✅ 对比 Letta、Mem0、传统 RAG 的框架好
定位: 受 Karpathy 的 LLM Knowledge Base 架构启发。用 Claude Code 对话作为原始数据,编译成结构化知识文章。
核心卖点:
- Hooks 自动在会话结束和压缩前捕获对话
- flush.py 用 Claude Agent SDK 提取知识;下午 6 点后触发编译
- compile.py 将日志转换为带交叉引用的概念文章
- query.py 通过索引引导检索(无 RAG)
- lint.py 执行 7 项健康检查:断链、孤儿、矛盾、过时
- 核心洞察:"在个人规模(50-500 篇文章),LLM 读取结构化 index.md 优于向量相似性"
架构:
- Claude Code hooks 自动捕获
- Claude Agent SDK 知识提取
- 简单 Markdown 索引文件检索(无向量 DB)
- AGENTS.md 作为完整技术参考
可借鉴:
- ✅ "个人规模无 RAG" 论点值得研究
- ✅ lint.py 概念(断链、孤儿、矛盾)对知识库卫生有价值
- ✅ 日志编译管道是干净的模式
- ✅ AGENTS.md 作为技术参考值得采用
- ✅ 极简主义是特性——更少组件意味着更少故障模式
定位: "A practical Claude Code and LangChain alternative" — 自托管 AI Agent 运行时和多 Agent 框架。
核心卖点:
- 24+ LLM 提供商集成
- Agent 委托给 Claude Code、Codex、OpenCode、Gemini、Cursor 等
- 心跳循环、调度、后台作业、监督器恢复
- 编排:分支、重复循环、并行分支、显式连接、重启安全状态
- 结构化会话:模板、协调员、参与者、操作员控制
- 连接器:Discord、Slack、Telegram、WhatsApp、Teams、Matrix
- 对话到技能学习(从聊天草拟可重用技能)
- 桌面应用(macOS、Windows、Linux)
架构:
- Next.js 前端 + React Flow 可视化构建器
- Electron 桌面应用
- SQLite 持久化
- Docker 支持
可借鉴:
- ✅ "虚拟公司" Agent 模式有创意
- ✅ 对话到技能学习是实用的知识提取方法
- ✅ 结构化会话模型设计良好
- ✅ 桌面应用分发降低采用摩擦
- ✅ 质量中心/评估实验室概念对生产系统有价值
定位: ICML 2025 CFAgentic Workshop Best Paper Runner-Up。跨域经验利用框架。
核心卖点:
- 分层记忆:工作记忆、情景记忆、语义知识库
- 跨域适应性(QA、编码、规划)
- 模块化设计便于基准集成
- 基于 smolagents (HuggingFace) 和 OpenHands
架构:
- JSON 知识库 + 结构化字段
- Agent KB 服务检索
- 双知识库:Agent 经验 + 搜索 Agent 经验
可借鉴:
- ✅ 双知识库模式(Agent + 搜索经验)有趣
- ✅ 学术论文背书对企业采用有可信度
- ✅ 基准驱动评估(GAIA、SWE-bench)方法严谨
- ✅ 模块化设计便于基准集成
定位: "Durable, repo-native project memory for coding agents" — 避免上下文膨胀。
核心卖点:
- 清单优先加载:Agent 读取清单,然后简介,然后仅任务相关文件
- 纯 Markdown 存储:可检查、可 diff、可提交、可回滚
- 离线优先,仅标准库:常规操作无需网络
- Agent 无关:Codex、Claude Code、Gemini、通用 Agent
- 可选模块:
rules/、profiles/、areas/、archive/ - 受保护维护:确定性 CLI 检查、破坏性操作预览优先
架构:
docs/memory/目录结构- 平台引导文件(AGENTS.md、CLAUDE.md)保持精简
- Python 仅标准库 CLI
- 语义审查在归档前保留不变量
可借鉴:
- ✅ "完全避免 RAG" 哲学是有效的反定位
- ✅ 清单优先加载模式有效防止上下文膨胀
- ✅ 每条目 120 token 指南是聪明的反膨胀机制
- ✅ 破坏性操作预览优先是安全模式
- ✅ "平台引导保持精简" 原则架构干净
定位: "Local-first, auditable memory layer for AI apps and coding agents." 明确说明不是 LLM、Agent 框架、向量数据库或通用 RAG。
核心卖点:
- 持久记忆 API:remember、recall、buildContext、feedback、forget、exportMemory
- 为 Codex 和 Claude Code 安装 Agent 记忆
- 写入定制:RememberProfile、rememberRules、annotations
- 本地优先 SQLite on Bun,可选 Postgres
- 4 种写入模式:off、observe、review、selective
- 多语言支持
架构:
- 4 作业模型:解析记忆 → 构建上下文 → 记录信号 → 审计/纠正/导出
- App/Agent 拥有认证、UI、模型调用;GoodMemory 拥有记忆循环和存储边界
- 基准:LoCoMo 0.8805 准确率
可借鉴:
- ✅ "这不是什么" 框架立即消除混淆
- ✅ 4 种写入模式(特别是 "review" 队列)对生产实用
- ✅ 严格基准方法论(区分生产 vs 历史 vs 内部)建立信任
- ✅ 记忆循环抽象(解析→构建→记录→审计)是干净模式
- ✅ 显式存储契约防止歧义
7/8 项目默认本地存储(SQLite 或 Markdown),拒绝云托管记忆作为默认。
对 MisakaNet 的启示: 我们的 git clone 模式完全符合这一趋势。
所有项目都支持 MCP;Agent 兼容性是基本要求。
对 MisakaNet 的启示: 我们已有 MCP 支持,但工具数量(4 个)远少于 agentmemory(54 个)。
从简单(claude-memory-compiler 的文章)到复杂(Memorix 的 6 层、agentmemory 的 4 层)。
对 MisakaNet 的启示: 我们的 "failure → lesson" 模型简单但专注,这是优势。
Memoria(记忆的 Git)和 Memorix(Git Memory 层)都使用 Git 概念。
对 MisakaNet 的启示: 我们天然 Git-backed,但没有显式强调这一优势。
claude-memory-compiler 和 MemoryCustodian 明确避免向量数据库。
对 MisakaNet 的启示: 我们的 BM25 零依赖检索符合这一立场,但需要更明确表达。
Memoria 和 Agent-KB 引用论文;agentmemory 提供基准。
对 MisakaNet 的启示: 我们有 PR Genius 效率分析(p=0.032),但没有正式论文。
破坏性操作预览优先、治理冷却、低置信度隔离。
对 MisakaNet 的启示: 我们的 DCO 和 CI 门控是安全机制,但缺少记忆层面的治理。
桌面应用(SwarmClaw)、捆绑 Agent(Memorix 的 memcode)、广泛 Agent 兼容性(agentmemory 的 17+)驱动采用。
对 MisakaNet 的启示: 我们需要更多 Agent 集成(目前只有 Cursor、Claude Code)。
-
显式强调 Git-backed 优势
- 当前 README 没有突出 "Git-backed" 这一独特卖点
- 建议在定位声明中加入 "Git-backed, auditable, zero-dependency"
-
添加 lint.py 概念
- 参考 claude-memory-compiler 的知识库健康检查
- 可以扩展现有的
check_lesson_quality.py
-
强化 "反 RAG" 立场
- 参考 MemoryCustodian 的 "manifest-first" 和 "stdlib-only"
- 明确表达 "零依赖检索" 是设计选择,不是限制
-
添加 "这不是什么" 框架
- 参考 GoodMemory 的 "what this is NOT" 定位
- 明确区分 MisakaNet vs 通用记忆系统
-
添加治理/冷却机制
- 参考 Memoria 的
memory_governance冷却系统 - 可以限制 lesson 提交频率,防止 spam
- 参考 Memoria 的
-
添加记忆版本控制
- 参考 Memoria 的 Git 式分支/合并/回滚
- 可以扩展 lesson 的版本管理
-
添加 Reasoning Memory
- 参考 Memorix 的推理、替代方案、权衡存储
- 可以在 lesson 中添加 "替代方案" 和 "权衡" 字段
-
添加写入模式
- 参考 GoodMemory 的 4 种写入模式
- 可以控制 lesson 的自动捕获行为
-
添加桌面应用
- 参考 SwarmClaw 的 Electron 应用
- 可以提供更好的本地体验
-
添加学术论文背书
- 参考 Agent-KB 和 Memoria 的论文
- 可以将 PR Genius 效率分析扩展为正式研究
-
添加更多 Agent 集成
- 参考 agentmemory 的 17+ Agent 兼容
- 当前只有 Cursor、Claude Code,需要扩展
-
添加知识图谱
- 参考 agentmemory 的知识图谱层
- 可以建立 lesson 之间的关系网络
大多数竞品试图成为 "通用记忆系统",而 MisakaNet 专注于 "失败恢复"。这是优势:
- 更简单的产品叙事
- 更清晰的价值主张
- 更容易被 Agent 理解和使用
只有 MisakaNet 和 Memoria 使用 Git 作为核心存储,但 Memoria 是数据库-backed,而 MisakaNet 是纯 Git。这是真正的差异化:
- 零基础设施依赖
- 完全可审计
- 天然版本控制
- 社区可贡献
Agent-KB 和 Memoria 有学术论文,但工程实现较重。MisakaNet 是工程导向,但缺少学术背书。PR Genius 效率分析(p=0.032)是好的开始,但需要更多。
agentmemory 通过 17+ Agent 兼容性获得 26.9k stars。MisakaNet 需要更多集成渠道:
- 更多 IDE 支持(VS Code、JetBrains)
- 更多 Agent 框架(LangChain、CrewAI)
- 更多部署方式(Docker、Cloud)
MisakaNet 在 "失败恢复" 这一细分领域有独特定位,但需要:
- 更明确地表达独特优势:Git-backed、零依赖、可审计
- 借鉴竞品的安全模式:治理冷却、预览优先、低置信度隔离
- 扩展 Agent 兼容性:从 2-3 个扩展到 10+ 个
- 添加学术背书:将效率分析扩展为正式研究
- 强化反 RAG 立场:明确表达设计选择
核心信息: MisakaNet 不是通用记忆系统,而是专注、轻量、可审计的失败恢复知识层。这是优势,不是限制。
报告生成时间:2026-08-12 10:30 CST 数据来源:GitHub README、shields.io badges、gh CLI