mcpField
M
memory-bridge

memory-bridge

github.com/ruvnetAgent 工作流80.1k744 次安装今天更新
代码仓库

关于 memory-bridge

memory-bridge 是一项技能，可将 Claude Code 自动记忆文件导入 AgentDB，供跨会话和项目的语义搜索使用。它支持去重；加载 ruvector 时，也可为导入的记忆建立索引。

主要功能

  1. 01导入当前项目或所有项目的记忆
  2. 02生成 ONNX 嵌入向量
  3. 03在 AgentDB 中存储并去重
  4. 04跨记忆来源搜索
  5. 05会话开始时自动导入

适用场景

  1. 01将现有 Claude Code 记忆导入 AgentDB
  2. 02跨项目和会话搜索记忆
  3. 03清理近似重复的记忆条目

MCP 相关

通过 Ruflo MCP 工具检查桥接状态、导入记忆并执行统一搜索。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ruvnet/ruflo --skill memory-bridge

安装后在 Claude Code 中输入/memory-bridge确认已加载。

详细介绍

Memory Bridge

将 Claude Code 的原生自动记忆文件导入 AgentDB，以便跨会话和项目进行语义搜索。

功能

Claude Code 将记忆保存为 ~/.claude/projects/*/memory/*.md 中的 Markdown 文件。此桥接工具会：

  1. 读取所有记忆文件（当前项目或所有项目）
  2. 生成 384 维 ONNX 嵌入（all-MiniLM-L6-v2）
  3. 使用 HNSW 索引将记忆存储在 AgentDB 的 claude-memories 命名空间中
  4. 与现有条目去重（余弦相似度 > 0.95）
  5. 支持跨所有记忆来源的统一语义搜索

步骤

  1. 检查桥接状态： mcp__plugin_ruflo-core_ruflo__memory_bridge_status({}) 确认 Claude 文件数、AgentDB 条目数、SONA 状态和连接状态。

  2. 导入记忆：

    • 当前项目：mcp__plugin_ruflo-core_ruflo__memory_import_claude({})
    • 所有项目：mcp__plugin_ruflo-core_ruflo__memory_import_claude({ allProjects: true })

    CLI 替代方式：

    node .claude/helpers/auto-memory-hook.mjs import-all

  3. 验证导入： mcp__plugin_ruflo-core_ruflo__memory_bridge_status({}) 确认条目数与预期文件数相符。

  4. 去重（如果使用 --dedupe）： 搜索近似重复的条目（余弦相似度 > 0.95）并合并，同时保留最新版本。

  5. 测试统一搜索： mcp__plugin_ruflo-core_ruflo__memory_search_unified({ query: "test query", limit: 3 }) 结果包含来源标注：claude-code、auto-memory 或 agentdb。

自动导入

桥接工具会通过 SessionStart 钩子在 session-start 时自动运行。只有在以下情况下才需要手动调用：

  • 首次导入所有项目
  • 在常规会话之外批量更改记忆后
  • 在模型更新后强制重新生成嵌入

与 ruvector 集成

加载 ruflo-ruvector 后，桥接的记忆也会由 ruvector 建立索引，以支持：

  • 混合搜索（稀疏 + 稠密，使用 RRF）
  • 跨记忆条目的图 RAG 多跳查询
  • 在不同会话间共享 Brain 知识

评论

支持 Markdown