Memorix:跨 Agent 记忆桥 — 让 AI 记住项目的一切,无论新开窗口还是更换编程工具

0 阅读6分钟

前言

最近在 GitHub 上发现了一个很有意思的项目 Memorix(跨 Agent 记忆桥),解决了我用多个 AI 编程工具时一直很头疼的问题。

如果你用 Cursor、Windsurf、Claude Code 等 AI 编程工具,一定遇到过这些问题:

对话 50 轮后上下文爆炸,新开窗口后 AI 忘记之前所有讨论
在 Cursor 里修的 bug,切换到 Claude Code 后完全不知道
12 个 MCP 服务器配置,要在 7 个 IDE 之间手动复制粘贴
每个 IDE 的规则文件格式不同,无法互通

GitHub: github.com/AVIDS2/memo…

Memorix 是什么

一句话:跨 Agent 的记忆桥梁 + 工作区同步引擎,让 7 个 AI 助手共享记忆、配置、规则。

没有 Memorix有 Memorix
50 轮对话后上下文爆炸,重启后从零开始新窗口秒速恢复上下文
换 IDE在 Cursor 修的 bug,Claude Code 不知道知识自动跨 IDE 共享
MCP 配置手动复制粘贴 12 个服务器到 7 个 IDE一条命令全部同步
规则文件.cursor/rules/*.mdc 无法用于 Claude Code自动转换成 CLAUDE.md 格式

核心功能

1. 解决上下文爆炸问题

最常见的痛点:

你和 AI 对话了 50 轮,上下文已经爆炸(token 超限)
必须重启新窗口,但之前的讨论全部丢失
又要花 10 分钟重新解释架构、技术栈、踩过的坑...

Memorix 的解决方案:

对话过程中,AI 自动存储重要决策、bug 修复、gotchas
→ memorix_store 分类存储(决策、问题解决、陷阱等)

上下文爆炸,开新窗口:
→ AI 调用 memorix_search("项目关键词")
→ 3 秒内恢复所有重要上下文
→ 继续工作,零重复解释!

2. 跨 IDE 记忆共享(独有)

支持 7 个主流 AI IDE

  • Cursor
  • Windsurf
  • Claude Code
  • Codex (OpenAI CLI)
  • VS Code Copilot
  • Kiro (Amazon)
  • Antigravity (Google)

所有 IDE 共享同一份记忆数据(~/.memorix/data/):

场景:你用 Windsurf 写后端,用 Claude Code 做代码审查

Windsurf: 你修复了支付模块的竞态条件 bug
→ Memorix 存储为 🟡 problem-solution

Claude Code: "审查一下支付模块"
→ AI 调用 memorix_search("支付") → 找到竞态条件修复记录
→ "我看到最近修复了一个竞态条件,让我验证一下是否正确..."
→ 知识无缝跨 IDE 传递!

2. 工作区一键同步(独有)

这是 Memorix 的最大差异化功能

MCP 配置迁移:

你在 Cursor 里配了 12 个 MCP 服务器,现在想试试 Kiro。

你:"帮我把工作区同步到 Kiro"
→ memorix_workspace_sync 扫描 Cursor 的 MCP 配置
→ 自动生成 Kiro 格式的 .kiro/settings/mcp.json
→ 智能合并(永远不覆盖你的配置)
→ Kiro 秒速就绪,2 分钟搞定!

规则格式互转:

.cursor/rules/*.mdc ↔ CLAUDE.md ↔ .kiro/steering/*.md
自动转换 7 种 IDE 的规则文件格式

技能同步:

SKILL.md 文件跨 IDE 复制
新团队成员的 AI 立刻了解项目模式

3. 自动生成项目技能(独有)

积累了足够多的开发记录后:

你:"生成项目技能"
→ memorix_skills 按实体聚类观察记录
→ 自动生成 SKILL.md:
  - auth-module-guide.md — JWT 设置、刷新流程、常见陷阱
  - database-migrations.md — Prisma 模式、回滚策略
→ 可以同步到任何 IDE:Cursor、Claude Code、Kiro...
→ 新人的 AI 立刻了解你的项目模式!

4. 9 种记忆分类

AI 的每个重要发现都会被分类存储:

图标类型场景
🎯session-request本次会话的原始目标
🔴gotcha"永远不要用字符串拼接路径"
🟡problem-solution"这个 bug 是因为竞态条件"
🔵how-it-works"支付模块的工作流程是..."
🟢what-changed改了什么代码/配置
🟣discovery新发现
🟠why-it-exists设计背后的原因
🟤decision"我们决定用 JWT + refresh token"
⚖️trade-off"选 Prisma 而不是 TypeORM 因为..."

5. 自动记忆钩子(独有)

memorix hooks install  # 一条命令安装

→ 隐式捕获:"我决定用...""这个 bug 是因为..."
→ 会话开始自动注入高价值记忆
→ 中英文双语关键词匹配
→ 智能过滤(30s 冷却,跳过 ls/cat/pwd)

6. 可视化看板(独有)

memorix_dashboard 打开 Web UI (localhost:3210):

  • D3.js 力导向知识图谱
  • 观察记录浏览器(类型过滤 + 搜索高亮)
  • 记忆衰减面板(哪些记忆在变旧)
  • 项目切换器
  • 批量清理工具
  • 明暗主题,支持中英文

7. Token 高效搜索

采用 3 层渐进式披露设计(参考 claude-mem):

L1: memorix_search → 紧凑索引(~50 token/条)→ AI 扫一眼 ID
L2: memorix_timeline → 时间线上下文
L3: memorix_detail → 完整详情(~500 token/条)→ 按需展开

比直接 dump 全部记忆节省约 10 倍 token!

30 秒上手

{
  "mcpServers": {
    "memorix": {
      "command": "npx",
      "args": ["-y", "memorix@latest", "serve"]
    }
  }
}

加到你 IDE 的 MCP 配置文件,重启就好。无需 API Key,无需云服务,100% 本地运行。

技术实现

  • 语言: TypeScript
  • 搜索引擎: Orama(BM25 全文 + 可选向量搜索)
  • 向量搜索: fastembed (ONNX) 或 transformers.js,本地运行
  • 持久化: JSON + JSONL 文件
  • 测试: 422 个测试全部通过 (vitest)
  • 构建: tsup,npm 包大小 ~760KB
  • 协议: MCP (Model Context Protocol)

与竞品对比

功能Mem0mcp-memory-serviceclaude-memMemorix
支持 Agent 数SDK13+ (MCP)仅 Claude7 个
跨 Agent 记忆共享
工作区同步✅ MCP+规则+技能
规则格式转换✅ 7 种格式
技能自动生成
自动记忆钩子✅ 中英文
可视化看板云端 UI✅ Web UI + D3.js
知识图谱✅ MCP 官方兼容
混合搜索✅ BM25 + 向量
Token 高效✅ 3 层渐进
隐私云端本地本地100% 本地
成本按量付费$0$0$0

Memorix 是唯一同时桥接记忆和工作区的工具。

与 mem0/mcp-memory-service/claude-mem 不是竞争关系,而是互补:

  • 它们:单 Agent 内的记忆管理(做得很好)
  • Memorix:跨 Agent 的记忆桥梁 + 工作区同步引擎(独有功能)

我的使用体验

试用了一周,主要感受:

  1. 上下文爆炸问题解决了 - 50 轮对话后重启,3 秒恢复上下文
  2. 成本优化很实用 - Cursor 额度用完,切换到 Windsurf 无缝继续
  3. 跨 IDE 协作真的有用 - 在 Cursor 修的 bug,切换到 Claude Code 后立刻能搜到
  4. 工作区同步很省时 - 从 Cursor 迁移到 Kiro 只花了 2 分钟,12 个 MCP 配置全部同步
  5. 规则格式转换很方便 - .cursor/rules/*.mdc 自动转成 CLAUDE.md,不用手动改
  6. 自动生成技能很实用 - 积累了 50+ 条观察记录后,一条命令生成项目技能文档
  7. Dashboard 很直观 - 可以看到哪些记忆在被频繁使用,哪些在变旧

未来的延展性

Memorix 的架构是泛化的,未来可以延展出更多功能:

  • 知识沉淀:从观察记录自动生成项目文档、测试用例、代码审查清单
  • 团队协作:可选的云端同步模式(Git-based 或自建服务器)
  • AI 辅助决策:AI 做架构决策时自动搜索历史 trade-offs
  • 项目健康度分析:显示知识覆盖度、高频 gotchas、需要重新审视的决策
  • 跨项目知识复用:通用知识(如 JWT 最佳实践)可以在多个项目间共享

链接

如果你也在用 AI 编程工具,推荐试试。有什么使用心得欢迎评论区交流!