Mnemosyne 跨机器记忆同步(渔芯实战 2026-08-18)
一、架构(关键:三个 db 角色分离,共用即踩坑)
旺财 Windows (sync 客户端) 玉芬 Mac (relay + 客户端)
shared surface db ◄──HTTP:8765──► sync-serve (relay)
├─ relay db(存事件密文,中转)
└─ 玉芬 sync-client(连自己 relay)
└─ shared surface db(存明文记忆)
三个 db 角色,绝不可混用:
| db | 用途 | 内容 |
|---|---|---|
| relay db | sync-serve 中转 | memory_events 事件日志(密文) |
| shared surface db | 客户端 + mnemosyne_shared_* 工具 | working_memory 记忆(明文) |
| 各客户端本地 shared db | 各自机器的记忆面 | 同上 |
relay 和 shared surface 用同一个 db 会导致:拉取事件误判 duplicate,不解密应用。
二、玉芬侧(relay 服务端)完整配置
# 1. 初始化两个独立 db
mnemosyne sync-init --db-path ~/.mnemosyne/data/sync_relay/mnemosyne.db
mnemosyne sync-init --db-path ~/.mnemosyne/data/shared/mnemosyne.db
# 2. 生成 API key(认证)
openssl rand -hex 24 > ~/.hermes/mnemosyne/sync_api_key && chmod 600
# 3. launchd 托管 sync-serve(relay)—— 必须 --behind-tls-proxy
# Label: ai.hermes.mnemosyne-sync,RunAtLoad + KeepAlive
# ProgramArguments: mnemosyne sync-serve --db-path <relay db> --host 0.0.0.0 \
# --port 8765 --api-key-file <key> --behind-tls-proxy
# 4. launchd 托管 sync-client(每 5 分钟双向)
# Label: ai.hermes.mnemosyne-sync-client,StartInterval=300
# ProgramArguments: mnemosyne sync --db-path <shared surface db> \
# --remote http://127.0.0.1:8765 --mode bidirectional \
# --api-key-file <key> --encrypt-key-file <encrypt.key>
三、客户端侧(旺财 Windows)配置
pip install mnemosyne-hermes
# 1. API key 落地
mkdir C:\Users\<用户>\.hermes\mnemosyne -Force
echo "<api_key>" > C:\Users\<用户>\.hermes\mnemosyne\sync_api_key
# 2. 初始化本地 shared db
mnemosyne sync-init --db-path C:\Users\<用户>\.mnemosyne\data\shared\mnemosyne.db
# 3. hosts 加白名单域名(管理员权限)
# C:\Windows\System32\drivers\etc\hosts 加一行:<玉芬IP> mnemosyne-sync.local
# 4. 双向同步常驻(--interval 300 常驻循环)
mnemosyne sync --db-path C:\Users\<用户>\.mnemosyne\data\shared\mnemosyne.db \
--remote http://mnemosyne-sync.local:8765 --mode bidirectional \
--api-key-file <key文件> --encrypt-key-file <encrypt.key> --interval 300
四、5 个坑(全部实测踩过)
- relay 和 shared surface db 必须分离 —— 共用导致拉取误判 duplicate,事件不解密应用。
- 客户端必须用同一把 encrypt.key —— relay 默认
require_encrypted_payloads=True,明文事件被拒。加密 key 双方共享,用--encrypt-key-file传。 mnemosyne-sync.local白名单域名 —— sync 客户端对非 loopback 的 HTTP 强制 HTTPS;源码硬编码mnemosyne-sync.local豁免,hosts 映射这个域名即可绕过,免 TLS 证书。- mv/备份 db 前必须先
PRAGMA wal_checkpoint(TRUNCATE)—— 否则 WAL 里未落盘的数据丢失,且查主文件显示"假象干净"。 - fingerprint 已记录会跳过重推 —— 客户端推过的事件在
sync_memory_state表记录 fingerprint,重推被跳过。换 relay 后需清空客户端/relay 的sync_memory_state+sync_outbox_ack+memory_events三表,强制重推。
五、验证对账
# 链路验证
mnemosyne sync-status --db-path <shared db> --remote http://127.0.0.1:8765 \
--api-key-file <key> --json
# 查 relay 事件 + shared surface 明文记忆
sqlite3 <relay db> "SELECT COUNT(*) FROM memory_events"
sqlite3 <shared db> "SELECT substr(content,1,40) FROM working_memory"
# 双向对账 = 3/3 即闭环
六、玉芬侧管理旺财记忆
玉芬读旺财记忆 = mnemosyne_shared_recall(shared surface db 明文);玉芬写记忆 = mnemosyne_shared_remember(写 shared surface,sync-client 加密推给旺财)。
⚠️ 不要用 mnemosyne_shared_remember 在 relay 未分离时写(会留 sync_surface_id=NULL 阻塞 sync)。
给旺财下发可执行指令的实战模板(2026-09-30 玉芬→旺财切智谱实测)
mnemosyne_shared_remember 是玉芬→旺财唯一的指令通道(两机无 SSH、旺财无独立飞书),content 写成自包含 P0 指令:任务 + 执行方式 A(跑脚本,写明脚本名与路径)+ 执行方式 B(手工改法的完整字段值,逐项列全——脚本通道断掉时旺财可徒手完成)+ 改前备份/改后校验要求 + 「完成后向玉芬回报」。importance=0.9、kind=meta、veracity=stated。
验证推达三步(CLI 不一定装了,走 sqlite 直查):
sqlite3 ~/.mnemosyne/data/shared/mnemosyne.db "SELECT COUNT(*) FROM memory_events"— 写入后事件数增加(payload 为 mne1: 加密切文 = 已入 outbox)launchctl kickstart -k gui/$(id -u)/ai.hermes.mnemosyne-sync-client— sync-client 若已停(launchctl list显示-)手动踢一脚;relay 服务(ai.hermes.mnemosyne-sync)应常驻有 PID- 客户端侧旺财下次会话启动时自动召回该 P0 记忆(5 分钟同步周期 + 会话注入)
⚠️ 不要用
mnemosyne_shared_remember在 relay 未分离时写(会留 sync_surface_id=NULL 阻塞 sync)。
共享记忆面当「远程派单通道」用(2026-09-30 实战补充)
跨机改配置/派任务时,shared surface 是唯一通道(玉芬↔旺财无 SSH)。写完派单记忆后别默认它已同步,按序验证:
- 推送触发:
launchctl kickstart -k gui/$(id -u)/ai.hermes.mnemosyne-sync-client(默认 5 分钟轮询太慢;实测发现 sync-client 常显示为-状态但 kickstart 后正常工作)。relay 服务ai.hermes.mnemosyne-sync常驻(有 PID 即健康)。 - 入队确认:
memory_events表(relay db 同结构在 shared db 也存在)行数应增长;payload列是mne1:gAAAAA...开头的密文——看到乱码密文=正常,别当损坏。schema 列名:event_id, memory_id, operation, timestamp, device_id, payload, event_hash, synced_at, apply_state(无content列,SELECT 别写错列名报 OperationalError)。 - 工具侧校验:写后立刻
mnemosyne_shared_recall同关键词能召回 = 落库成功。注意mnemosyne sync-statusCLI 可能在会话 env 缺MNEMOSYNE_SYNC_REMOTE而报 "No remote configured"——这是 CLI 探测限制,不代表同步链路坏了,以 1/2 两步 launchctl+sqlite 验证为准。 - shared db 里可能没有
sync_memory_state表(该表在客户端本地 db 记录已推指纹);判断"有没有推出去"看memory_events.synced_at是否被填。
七、本机多 profile 迁移 MEMORY.md → Mnemosyne(同步的前置步骤)
把多个 profile 的内置 memory(MEMORY.md)迁到各自独立的 Mnemosyne db,步骤:
- 备份:
cp MEMORY.md MEMORY.md.bak.mnemosyne_<ts> - config.yaml 加 memory 块:
memory: {memory_enabled: true, user_profile_enabled: true, provider: mnemosyne, memory_char_limit: 2200, user_char_limit: 1375}(各 profile 的 config.yaml 通常没有 memory 块,需追加) - install 插件:
mnemosyne-hermes --hermes-home /Users/hua/.hermes install --force(--force 因为 default 已装;它会自动 symlink 到所有 opted-in 的 profile) - 迁移脚本:读 MEMORY.md 按
§拆分,逐条mnemosyne.remember(sec, source=分类, scope='global', trust_tier='IMPORTED'),写占位符。脚本在~/.hermes/scripts/migrate_mnemosyne.py(Mac)/migrate_mnemosyne_win.py(Windows)。source 分类:身份/环境/项目/关系/偏好。
三个坑:
- 中文记忆必须换 embedding:默认
bge-small-en-v1.5英文优化,中文召回不准。config.yaml 设embedding_model: BAAI/bge-small-zh-v1.5。 - fastembed 缓存要软链共享:每个 profile 的 HERMES_HOME 不同,会各自下载
100MB 模型。给各 profile 建/.hermes/cache/fastembed`。cache/fastembed→ 软链到 default 的 ` - 安装目录区分:default 的 db 在
~/.hermes/mnemosyne/data/,profile 的在~/.hermes/profiles/<名>/mnemosyne/data/,靠MNEMOSYNE_DATA_DIR环境变量定位。
八、迁移后必做:运行面验证(数据完整 ≠ 系统能用,2026-11-10 新家实测)
迁移/搬家只搬了数据;运行环境(插件、嵌入库、cron 脚本)不随数据走,换机后必须单独恢复。验证分两层:
数据面(sqlite 直查,确认搬运完整)
- 各 profile db 行数与向量覆盖:
SELECT COUNT(*), SUM(CASE WHEN embedding IS NOT NULL THEN 1 ELSE 0 END) FROM working_memory— 有行无向量 = fastembed 没装/模型没下。 - L2
memory_store/、L1.bak备份、最新写入链路(最新几条应带向量)。
运行面(最容易漏,且故障是静默的)
- 插件安装状态:
hermes memory status—Provider=mnemosyne但 Plugin: NOT installed 是典型迁移缺口:数据躺在库里,但mnemosyne_recall语义检索会静默回退到 L1 文件直读,不报错、不易察觉,直到召回质量明显变差才暴露。修复:mnemosyne-hermes --hermes-home <home> install --force+pip install fastembed。⚠️ Windows 两坑:① Program Files 系统目录无管理员权限写不进,pip 落到用户 Roaming 后安装器探测不到 → 建专用 venv(<home>\.mnemosyne-venv装 mnemosyne-hermes+mnemosyne-memory+fastembed+sqlite-vec)wrapper 模式安装;② 安装器给各 profile 建 symlink 需特权、Windows 批量失败 → 手动 NTFS junction 免特权补齐:cmd //c mklink //J <profile>\plugins\mnemosyne <home>\plugins\mnemosyne。 - cron 脚本平台兼容:Mac 时代 launchd+.sh 的 cron(如 mnemosyne_health.sh 压缩守护)迁到 Windows 后每个 tick 都失败(
last_status=error: Script exited with code 1)。⚠️repeat.completed是历史累计数,会掩盖"迁移后从未成功过"——判断健康要看last_run_at是否 ≥ 迁移日期。⚠️ 另坑:迁移打包可能把脚本带成 0 字节(isfile=True 但读出为空)——移植前先验文件非空。修复:脚本换 Windows 兼容版(.py)并立即手动跑一次清积压(实测积压后果:L1 涨到 98% 无人压缩)。 - 嵌入模型缓存:新机 fastembed 缓存为空,中文
BAAI/bge-small-zh-v1.5需重新下载——国内走镜像HF_ENDPOINT=https://hf-mirror.com(实测 ~42s)或从旧机拷cache/fastembed。补嵌入缺口数要精确统计:SELECT COUNT(*) FROM working_memory wm LEFT JOIN memory_embeddings e ON e.memory_id=wm.id WHERE e.memory_id IS NULL——按表抽查估算会严重低估(实测估 41 实为 229:quant 122+zhenglishi 106+laomo 1)。 - 垃圾文件:迁移打包常带进 0 字节怪名文件(实测
memories/~),顺手清理。
修复顺序
① 插件 install(解锁语义检索,最先)→ ② fastembed + 缓存 → ③ 补嵌入 → ④ cron 脚本移植 + 手动触发 → ⑤ 清垃圾。①不修则整个 Mnemosyne 只剩"能写不能语义查"。
📎 完整命令级修复实录(venv+junction 安装、hf-mirror 下载、229 条补嵌脚本、cron 移植坑)见 references/windows-runtime-repair.md。
九、公司级资产迁移盘点(数据完整性审计另见姊妹技能)
记忆库验证只是迁移审计的一小块。全公司范围的"数据是不是都迁过来了"审计(公司树/94 git 仓/符号链接分类/数据库双层比对/打包残留识别/分级报告)照 machine-migration-audit 技能执行——git 跨机 dubious ownership 批量豁免、断链甄别(128 断链里真数据仅 7 条)等坑都在那边。