企业官网建设流程全解析

把旧记忆搬进Mnemosyne：mem0、Hindsight、Honcho等系统导入工具完全指南

【免费下载链接】mnemosyneZero-cloud AI memory that works everywhere. SQLite-backed. One pure-Python dependency.项目地址: https://gitcode.com/gh_mirrors/mnemosyne5/mnemosyne

如果你还在用mem0、Hindsight、Honcho这类 AI 记忆平台，又想换到零云、本地优先的Mnemosyne 记忆系统，这篇指南能帮你把旧记忆完整搬进新库。Mnemosyne 基于 SQLite、纯 Python 实现，内置 8 个官方导入器（importer），支持从 mem0、Letta、Zep、Cognee、Honcho、SuperMemory、Hindsight、Holographic 直接迁移，也支持 JSON 文件导入和 AI 代理辅助导出，全程保留时间戳、元数据和身份标签。

为什么选择 Mnemosyne 记忆导入方案

换记忆系统最大的痛点是：旧数据格式各异，手动复制既慢又容易丢元数据。Mnemosyne 的导入器统一了这个问题：

• 🔹保留时间戳：历史记忆的时间不丢失，时间衰减召回照常工作
• 🔹保留元数据：tags、categories、importance、author 等信息映射到新库
• 🔹保留身份：user_id / peer_id / app_id 映射为 author_id、channel_id 等
• 🔹先试后搬：支持--dry-run演练模式，只验证不写入，安心试跑

导入器源码位于 mnemosyne/core/importers/，入口文件 importers/init.py 维护着所有支持供应商的注册表PROVIDERS。

支持哪些记忆系统：8 个供应商一览

Mnemosyne 官方导入器覆盖的供应商如下（数据来自 docs/api-reference.md）：

每个供应商的解析逻辑独立成文件，例如 importers/mem0.py、importers/hindsight.py、importers/honcho.py，方便按自己用的平台查细节。

最快上手：三条导入命令

1️⃣ 从供应商 API 直接导入

装好 Mnemosyne 后，一条命令从 mem0 云端拉取全部记忆：

hermes mnemosyne import --from mem0 --api-key sk-xxx

不确定自己环境支持哪些供应商？先看清单：

hermes mnemosyne import --list-providers

2️⃣ 从 JSON 导出文件导入

如果你已经从旧平台导出了 JSON（或者用下面介绍的"脚本生成"方式导出），直接：

mnemosyne import <file.json>

文件导入器会自动识别常见包装格式（results、memories、data等外层键），字段也做了兼容：content、memory、text任一存在即可（见 importers/base.py 中的import_from_file）。

3️⃣ Hindsight 专属命令

Hindsight 导入有独立 CLI，支持文件和本地 API 两种来源：

mnemosyne import-hindsight export.json [bank] mnemosyne import-hindsight http://localhost:8888 [bank]

它会把记忆直接写入情景存储（episodic memory），专门保留历史时间戳，避免污染工作记忆会话。

导入前必做：--dry-run 安全演练

正式搬库前，强烈建议先跑一次演练模式——只执行"提取 → 校验 → 转换"，不落库：

hermes mnemosyne import --from mem0 --api-key sk-xxx --dry-run

完成后查看stats确认数量符合预期：

hermes mnemosyne stats

整个导入流水线（extract → validate → transform → import）定义在 importers/base.py 的BaseImporter.run()中，任何一条记忆失败都会记入errors列表并在结果里汇总，不会静默丢失。

没有开放 API？让 AI 代理帮你导出

对于没有程序化导出接口的系统，Mnemosyne 内置了智能迁移（Agentic Importer），见 importers/agentic.py：

• 生成迁移脚本：hermes mnemosyne import --from zep --generate-script，自动产出一份可直接运行的 Python 导出脚本
• 生成 AI 指令：把生成的指令粘贴给你的 AI 助手（如 Claude），它会按标准流程导出 JSON，你再import进来

mem0、Letta、Zep、Cognee、Honcho、SuperMemory 都有现成的脚本模板，其余供应商会生成通用模板，只需替换提取逻辑。

导入结果的五个关键数字

每次导入返回统一的ImporterResult统计：

• total：源端找到的记忆总数
• imported：成功写入
• skipped：重复或空内容被跳过
• failed：写入失败
• errors：错误明细（最多展示 20 条）

看到这五个数字，你就能判断迁移是否完整。若skipped偏多，多半是旧库里本身有重复，属正常现象。

常见问题速查

Q：导入后召回效果和原来一样吗？记忆内容和元数据都保留了；向量索引由 Mnemosyne 自己的嵌入引擎重建（Holographic 导入时不搬运 HRR 向量，而是重新生成）。

Q：旧平台还在用，能增量导入吗？可以重复执行导入命令，内容哈希去重会跳过已存在的记忆。

Q：想分库管理旧记忆怎么办？导入支持--session、--channel等覆盖参数，也可配合mnemosyne bank create work建独立记忆库隔离迁移数据。

更多命令细节见官方文档 docs/cli-reference.md 与 docs/api-reference.md。换库不折腾，一条命令把 mem0、Hindsight、Honcho 的旧记忆全部搬进 Mnemosyne。 🚀

【免费下载链接】mnemosyneZero-cloud AI memory that works everywhere. SQLite-backed. One pure-Python dependency.项目地址: https://gitcode.com/gh_mirrors/mnemosyne5/mnemosyne