Memory Bridge 用于把 Claude Code 的原生自动记忆导入 AgentDB,并支持跨会话、跨项目的统一语义搜索。
用途
Claude Code 将记忆以 Markdown 文件形式存储在 ~/.claude/projects//memory/.md。Memory Bridge 读取这些记忆文件(可针对当前项目或全部项目),生成 384 维的 ONNX 嵌入(all-MiniLM-L6-v2),并将其存储到 AgentDB 的 claude-memories 命名空间中,使用 HNSW 索引。通过这种方式,原本分散在各项目目录下的记忆可以被集中检索。
主要能力
- 读取所有记忆文件,支持当前项目或全部项目。
- 生成 384 维 ONNX 嵌入(all-MiniLM-L6-v2)。
- 存入 AgentDB 的 claude-memories 命名空间并使用 HNSW 索引。
- 对已有条目去重(余弦相似度大于 0.95 视为重复)。
- 支持跨所有记忆来源的统一语义搜索。
使用方式
-
检查桥接健康状态: mcp__plugin_ruflo-core_ruflo__memory_bridge_status({}) 验证内容包括:Claude 文件数量、AgentDB 条目数、SONA 状态、连接状态。
-
导入记忆: 当前项目: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
-
验证导入: mcp__plugin_ruflo-core_ruflo__memory_bridge_status({}) 确认条目数量与预期文件数量一致。
-
去重(如果使用 --dedupe): 搜索近似重复条目(余弦相似度大于 0.95)并合并它们,保留最新版本。
-
测试统一搜索: mcp__plugin_ruflo-core_ruflo__memory_search_unified({ query: "test query", limit: 3 }) 结果会包含来源标注:claude-code、auto-memory 或 agentdb。
自动导入
该桥接会通过 SessionStart 钩子在会话开始时自动运行。仅在以下情况需要手动调用:
- 首次导入全部项目。
- 在正常会话之外进行了大量记忆变更之后。
- 在模型更新后强制重新生成嵌入。
与 ruvector 的集成
当加载 ruflo-ruvector 时,桥接后的记忆也会被 ruvector 索引,从而支持:
- 混合搜索(稀疏 + 稠密,结合 RRF)。
- 跨记忆条目的 Graph RAG 多跳查询。
- 跨会话的 Brain 知识共享。
适用场景与限制
适用于需要将 Claude Code 记忆集中管理、跨项目检索或与 ruvector 生态集成的场景。使用去重功能时需要传入 --dedupe 参数。具体平台要求、性能数据、收费方式等信息暂未提供。