# Memory Bridge

> 记忆桥 MemoryBridge — 跨设备、跨平台的 AI 共享记忆层 | Cross-device and cross-platform shared memory for AI (CDSMP implementation)

- **Type:** MCP server
- **Install:** `agentstack add mcp-jiabaobei-memory-bridge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jiabaobei](https://agentstack.voostack.com/s/jiabaobei)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jiabaobei](https://github.com/jiabaobei)
- **Source:** https://github.com/jiabaobei/memory-bridge

## Install

```sh
agentstack add mcp-jiabaobei-memory-bridge
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 记忆桥 MemoryBridge

> 🌉 **给 AI 一个跟着你走的记忆** —— 跨设备 × 跨平台的共享记忆层
>
> CDSMP（大模型跨设备语义记忆连续性架构）的官方工程实现。
> [English](README_EN.md) · [设计 RFC](docs/RFC-001-architecture.md) · [容器一致性 RFC](docs/RFC-002-container-consistency.md) · [路线图](docs/roadmap.md) · [移动端接入](docs/mobile.md) · [隐私威胁模型](docs/threat-model.md) · [版本历程](CHANGELOG.md)

## 这解决什么问题

早上通勤时你在手机上和 AI 讨论到一半的推理，回到办公室想在 PC 上继续——
今天的做法是：翻聊天记录、复制粘贴、重新解释一遍背景。

云全量同步很重也未必安全；RAG 是"到了新设备再被动检索"；主流记忆系统
（Mem0、MemGPT/Letta 等）本质上是**单机的**。记忆桥的答案是三个差异化主张：

1. **跨设备连续性**：记忆跟着人走，而不是跟着 App 走。手机、PC、平板共享同一份语义记忆，通过增量差分同步。
2. **边缘预加载**：在你打开新设备之前，高热度的记忆已经被推送到位——切换即连续，而不是切换后等待检索。
3. **内容冻结原则**：记忆桥只提取语义关联、只调节结构参数，**永不改写你的原始记忆内容**。这正是论文所依据的 Faulty Memory 研究的结论：让 LLM 自动改写/摘要记忆，必然引入幻觉式失真。

同时，记忆桥是**跨平台**的：通过 MCP 协议，同一个记忆库可以被 Claude Code、Cursor、Cline 等任意 MCP 客户端共享使用（平台覆盖详情见下文矩阵）。

## 当前能力（v0.25）

| 能力 | 说明 | 状态 |
|---|---|---|
| 容器一致性（各端 schema 可声明可对账） | 容器清单 `schema.py` 实读库结构生成本端身份证（schema 版本 / 节点边字段 / 边类型枚举 / 三存储平面 / 迁移登记）；`membridge schema` 查看本端、`--peer` 与对端双向对账，缺列按迁移登记自动 ALTER 补齐；差分包携带 `edges_v2` 五元组（含 kind/evidence）随包对账——**v0.14 的类型化边跨端往返不再退化** | ✅ v0.16 |
| 三存储平面声明（mem0 借鉴） | manifest 声明 graph（edges）/ vector（nodes.embedding）/ kv（meta）三平面，实读表结构判定，缺平面即指纹不同、体检可查 | ✅ v0.16 |
| seq 版本协商（rig 借鉴） | 发包 seq 单调递增，接收端按设备记 `sync_watermark` 水位线（只增不减），重复/乱序包内容指纹去重天然幂等 | ✅ v0.16 |
| 通道密钥随通道走（各端零输入） | 通道目录里的 `channel.key` 随网盘同步到各端，首次发布自动生成——跨端共享不必再记、再传、再复述任何口令；`--passphrase` 仍优先，严格端到端加密一字未改 | ✅ v0.17 |
| 设备心跳（谁在通道里一眼可查） | 每端只写自己的 `devices/.json`（设备名 / 平台 / 最后活跃 / 节点数 / 容器指纹），只写自己的文件 → 无共享可变状态 → 零冲突；`init` 即登记，没发过包的设备不再隐身 | ✅ v0.17 |
| `membridge sync` 一键双向 | 先取回他端记忆、再发布本机新记忆，输出一行汇总；网页 / 手机 / 平板无计划任务也能对齐，各端共享节奏统一 | ✅ v0.17 |
| 网盘三端直达（双网盘主备分明：坚果云主通道 + OneDrive 备胎） | 无头端三步接线：rclone 就位（Linux 容器自动装）→ 授权（凭据只落盘权限 600 永不打印）→ 首次拉取。坚果云走 WebDAV + 应用密码（全端可达，无浏览器往返）；OneDrive 走 OAuth token（备胎，坚果云出问题时顶上，不是淘汰）。同一通道目录可两家同时接、主通道先跑；`--role` 可显式定主备。PC / Mac 已装网盘客户端则探测即指向、零配置。`netdisk-sync` 一条命令逐家完成「文件夹级双向 + 包级同步」，电脑、手机平板、网页端容器三端自动双向；`channel --move` 一条命令迁通道宿主（v0.20）；旧版 rclone 自动降级双向复制（v0.21）；体检识别桌面客户端直连、`--dir` 省略时回落已配置通道（v0.22） | ✅ v0.22 |
| 交接班（交接卡 + 工作台） | 第三种记忆类型 `kind=handover`：任务告一段落、上下文将满、或切换设备前写一张交接卡（`goal:/done:/failed:/next:/refs:` 行前缀约定；`failed` 行用硬句式留下「试过什么；因为什么；除非什么否则别重试」）。全库最新未过期交接卡成为**工作台**：注入时恒定在场、不走相关性检索——交接卡是状态声明，不是检索命中；新卡自动取代旧卡（取代是推导出来的，零新增状态位，跨设备同步后各端自动收敛到同一张卡）；超 7 天未更新自动降级为普通记忆（过期工作台比没有更危险）；交接卡触点边权重结构衰减，防止其连成超级枢纽抬排名；`membridge handoff` 查看工作台，`membridge handoff-hint` 打印常驻交接提示，随身记页面内置交接卡表单 | ✅ v0.15 |
| 类型化边 + 证据 | 边带 `kind`（semantic / cooccur / entity）+ 极短 `evidence`——每条边可回答「为什么相关」；存量库打开自动迁移（旧边标 semantic），只加结构不碰内容 | ✅ v0.14 |
| 实体锚点边 | 零依赖正则抽取代码符号 / 文件路径 / 仓库 / 标签为确定性锚点，共享同一锚点即连边——不靠字面巧合，中英混写也能连上 | ✅ v0.14 |
| 整簇预加载 | `preload --cluster`：连通分量把记忆切簇，按「当前最热节点所在簇」整簇加载——到新设备，整条任务线的上下文已就位 | ✅ v0.14 |
| 召回理由标注 | `context` 注入时标注极短命中路径（向量 / 关键词 / 图谱）——一眼判断该不该信这条记忆；`hybrid_search` 兼容封装，行为不变 | ✅ v0.14 |
| 通道归一（多设备指向同一云盘通道） | 通道身份证 `channel.json`：首设备创建，后续设备 `init` / 同步时**自动认领**；分裂（本机与通道身份证不一致）显式告警，先到先得不改写；`membridge channel` 一屏体检（本机通道 / 身份证 / 通道内出现过的设备）；OneDrive 多根目录识别（`OneDrive - 个人` 等变体）；doctor 通道健康告警。**纯元数据：不含口令、不碰记忆内容** | ✅ v0.13 |
| 网关可观测 + IP 白名单 | 基站常驻服务的排障刚需：运行时长 / 请求数 / 写入数 / 检索命中数实时可查（`/health` + 随身记页面）；`--allow` 按 IP/网段白名单放行，口令 + 白名单双保险 | ✅ v0.12 |
| 手机 / 平板接入 | `membridge gateway` 基站模式：家里一台常开设备跑网关，手机经口令保护的 HTTP 读写记忆库（内置随身记网页，可加主屏幕；iOS 快捷指令直连），纯标准库零新依赖；**旧手机可当 24 小时低功耗基站**（5–10 瓦），还能与 OlliteRT 本地模型拼成零云端个人 AI 栈，见 [移动端指南](docs/mobile.md) | ✅ v0.11 |
| Markdown 导出视图 | `membridge export` 把整座库渲染成人类可读的 Markdown（场景分组 + fact/procedure 分节 + 出处）——**只读视图，永不回写**，记忆可审计、可进 Git、可带走 | ✅ v0.10 |
| 常驻召回提示 | `membridge recall-hint` 打印一行提示，自愿粘贴进 CLAUDE.md / AGENTS.md——「任务前主动召回」代替「被动等想起」；只打印不代写宿主文件 | ✅ v0.10 |
| 三路混合检索 + RRF | 向量 + 关键词（字面命中兜底）+ SAN 图谱一跳三路召回，按排名做 RRF 融合（k=60）——多路共识天然加分，无新参数可调 | ✅ v0.9 |
| 预算注入 + 沉默契约 | Path A 注入受 token 预算约束，超预算条目注入**原文前缀**（截断 ≠ 改写，内容冻结无损）；无高质量命中时明确返回「本轮不干预」，不硬凑弱命中 | ✅ v0.9 |
| MCP 工具描述瘦身 | 三个工具的描述各压缩到一行——工具描述常驻每个客户端会话，省 token 从描述面开始 | ✅ v0.9 |
| 缺口发现 | 零命中查询记入本地（纯元数据），`doctor` 显示缺口并提示——系统只提醒，内容永远由用户写 | ✅ v0.9 |
| 可选 kind 标注 | `fact`（稳定事实）/ `procedure`（试过什么、结果怎样）可选标注，纯可选不强制 | ✅ v0.9 |
| 增量建边 | 写入时只计算新节点与既有节点的关联（O(n)，不再每次全量 O(n²) 重算）；`membridge rebuild-edges` 提供全量重建出口 | ✅ v0.8 |
| 工程健壮性 | SQLite WAL 并发 + 单事务原子提交（add+建边、差分应用）；差分包"数据错误跳过 / 环境错误保留重试"分流 | ✅ v0.8 |
| token 经济 | MCP 工具收敛为 3 个（context 并入 search）、检索相对阈值滤除弱命中、超长记忆写入软引导拆分 | ✅ v0.8 |
| doctor 库位置健康 | 库位于临时/生成目录、多库分裂（默认库与环境变量库并存）、设备名未设置——显式告警 | ✅ v0.8 |
| 存储与检索优化 | embedding 以 float32 BLOB 存储（体积降为 JSON 的 1/3～1/5，旧库打开自动迁移），检索两阶段 + 进程内向量缓存 | ✅ v0.8 |
| 一键接入平台 | `membridge init` 自动检测并配置主流 AI 平台（MCP 自动写入 / WorkBuddy 技能自动安装 / 其余打印指南）；第一步云盘未检测到时走交互式引导接线（安心文案 + 逐步配坚果云主通道 + 连接达标门槛，留「稍后配置」出口；v0.25） | ✅ v0.2/v0.25 |
| 全自动同步 | 云盘自动选定（多盘按优先级）、口令由系统生成并托管（用户无感，v0.23 起托管覆盖 Windows / Linux / macOS 全平台）、按重要程度自动上云（全平台计划任务每 15 分钟，v0.24 起含文件夹级双向轮），零点击 | ✅ v0.5/v0.6/v0.23/v0.24 |
| 环境变量口令 | 口令支持 `MEMBRIDGE_PASSPHRASE` 环境变量（优先级：参数 > 环境变量 > 保险库），自动化/CI 场景免交互 | ✅ v0.7 |
| 便携免安装 | `membridge.exe` 单文件构建（scripts/build_exe.bat），拷到任何 Windows 机器即用，无需 Python | ✅ v0.4 |
| 嵌入一致性握手 | 差分包内嵌嵌入器指纹，两端模型不一致即拒绝同步——排除记忆语义漂移 | ✅ v0.4 |
| SAN 语义关联网络 | 记忆条目 + 语义向量 + 关联边（`w_ij = λ·共现 + (1-λ)·余弦`） | ✅ v0 已实现 |
| Path A 记忆注入 | 高置信记忆序列化为上下文块拼入 prompt（显式、可审计） | ✅ v0 已实现 |
| MCP Server | 任意 MCP 客户端即插即用；`--http` 远程模式供扣子 Coze 等平台接入 | ✅ v0 已实现 |
| DSS 增量同步 | 语义指纹 + 边差异量化（ε=0.01），只传差异不传全量 | ✅ 已实现 |
| 网盘中转传输 | 差分包写入百度网盘同步盘/坚果云/OneDrive 等同步文件夹即可跨设备，默认端到端加密，网盘服务商只见密文 | ✅ v0 已实现 |
| PAMS 隐私门控 | L1 迁移标签（local 节点永不离开设备）+ L2 场景域隔离 | ✅ v0 已实现；L3 差分隐私后置 |
| TMT 热度与预加载 | recency × frequency 启发式，热度 Top-K 预加载候选 | ✅ v0 启发式；边缘驻留 Phase 3 |
| AEE 自适应进化 | α/π_nav/θ_window 等结构参数自适应 | 📋 Phase 4（接口已预留） |
| Path B 隐藏状态融合 | 隐藏状态注入层间激活 | 🧪 Phase 4（experimental 分支） |

## 与同类项目的差异

| | 记忆桥 | OpenMemory (mem0) | MemGPT/Letta | memU |
|---|---|---|---|---|
| 跨应用共享（MCP） | ✅ | ✅ | — | ✅（宿主适配器） |
| **跨设备同步**（手机↔PC↔边缘） | ✅ 核心能力（端到端加密、网盘只见密文） | ❌ 单机 | ❌ | 依赖其云托管 |
| 切换前**预加载**（零等待） | ✅ | ❌ 被动检索 | ❌ | ❌ |
| **内容冻结**（不重写记忆） | ✅ 架构级约束 | ❌ LLM 摘要改写 | 部分 | ❌（LLM 自动蒸馏入库） |
| 记忆人类可审计 | ✅ v0.10 Markdown 导出视图 | ❌ | ❌ | ✅（Markdown 即记忆） |
| 隐私分级（迁移标签 + 场景域） | ✅ | 部分 | ❌ | ❌ |

> memU 值得尊敬：它的「技能自动提炼」（会话历史自动变成可复用技能）与
> 「服务端零 LLM」都很出色。分歧在记忆内容的来源——memU 让 LLM 蒸馏生成，
> 记忆桥坚持明面上的显式写入（`memory_add`），经验沉淀用
> `kind=procedure` 标注（见下方约定），幻觉没有进库通道。

## 领域收敛：外置记忆路线正在被前沿研究背书

记忆桥的三个差异化主张不是孤立的设计选择。2026 年的前沿工作正从三个独立方向
收敛到同一条路线：

- **Metis（记忆基础模型，arXiv 2607.26760）** 把历史压进模型内部参数，
  但论文自己承认：固定容量必然遗忘、参数态**难以审计、难以精确删除、隐私
  边界难保证**，并给出混合蓝图——低频、可审计、超长历史继续留在外部存储，
  由外部系统负责容量、可解释检索与纠错。这正是记忆桥所在的生态位：
  原生记忆是互补者，不是替代者。
- **Proactive Memory Agent（Meta，arXiv 2607.08716）** 证明长程任务的
  关键不是"存更多"，而是"哪条记忆应该在什么时候重新进入决策回路"——
  其核心载体就是一个独立于模型的**外置结构化记忆库** + 守门策略，且消融显示
  「把沉默当作动作」比全量暴露更稳。记忆桥 v0.9 的沉默契约与相对阈值
  过滤与之同构。
- **Perplexity Portable Computer**（本地 Agent，零 token 成本）的工程纪律
  ——极小系统提示、极少核心工具、按需加载——验证了记忆桥「极度省 token」
  原则的普适性；其"敏感内容不出设备 + 出口显式门控"与 PAMS 设计哲学一致。

v0.9 即是一次对照这三份研究的集中借鉴（检索质量 / token 经济 / 缺口发现），
全部只落在检索、注入与调度层——**不改写任何记忆内容**，详见
[路线图「借鉴版」一节](docs/roadmap.md)。

第四个数据点来自开源竞品 **memU**（NevaMind-AI）：它同样坚持**记忆服务端
零 LLM**——「什么值得记」的判断交还给宿主 Agent，记忆服务只做存储、嵌入、
检索这件确定性的事。这与记忆桥核心的分工完全同构。路线分歧在两点：
memU 用 LLM 蒸馏**生成**记忆内容（记忆桥拒绝：内容冻结），跨设备走其
云托管（记忆桥坚持端到端加密的自持通道）。v0.10 借鉴了它「记忆就是文件」
的可审计性（`membridge export`，只读视图永不回写），见
[路线图「memU 借鉴版」一节](docs/roadmap.md)。

第五个数据点来自端侧：**边缘设备正在成为 AI 基础设施的一等公民**。
Ornith-1.5 的 9B 量化版（约 1.5GB）已能在手机上直接运行；OlliteRT 把
旧手机变成了 24 小时在线的局域网模型服务器。当手机同时装得下模型与
服务，记忆桥的基站模式恰好补上这块拼图缺的「记忆」——一部旧手机跑
OlliteRT（本地推理）+ `membridge gateway`（记忆底座），就是完全自持、
零云端的个人 AI 栈（配方见 [移动端指南](docs/mobile.md)）。边界仍然
清晰：本地模型在宿主侧，记忆层核心零 LLM。

第六个数据点来自参数派内部：**连高通也在实践「冻结本体 + 外挂记忆」**。
Qualcomm AI Research 的 MoNe（ICML 2026）给冻结的模型骨干外挂「在线可写
的神经记忆」，上下文写入一次、提问不再重读——其架构纪律与记忆桥同构：
本体冻结，只外挂可写。分歧只在记忆住在哪：MoNe 把历史写进权重（参数态），
而 Metis 已承认这条路线难审计、难精确删除、隐私边界难保证；记忆桥坚持
把记忆留在人人可审计的外部存储。**冻结是这个领域两派共同的纪律，区别
只在冻什么——他们冻模型，我们冻内容。**

## 平台覆盖（跨平台记忆共享）

用户只需运行 **`membridge init`**：自动检测本机已安装的平台并接入（幂等安全，重复执行无副作用）。

| 接入方式 | 覆盖的平台 | 状态 |
|---|---|---|
| **init 自动配置（MCP）** | ZCode、Claude Code、Claude 桌面版、Cursor、Cline、Windsurf、VS Code（Copilot MCP）、Gemini CLI、通义千问 Code | ✅ v0.2 |
| **init 技能自动安装（SKILL.md）** | WorkBuddy（`~/.workbuddy/skills`）、Claude 技能目录 | ✅ v0.2 |
| **远程 MCP（HTTP 模式）** | 扣子 Coze 等支持远程 MCP 的平台（`membridge mcp --http` 后经 URL 接入） | ✅ v0.2 |
| **init 手动指南** | 字节 Trae 等界面化 MCP 平台（init 打印逐步指引） | ✅ v0.2 |
| **CLI / SDK** | 任意能调用命令行的环境（剪贴板兜底：`membridge context ""`） | ✅ v0 |
| **手机 / 平板（网关基站模式）** | `membridge gateway`：iOS / Android / 平板的浏览器（内置随身记页面）与快捷指令等任意 HTTP 客户端；Android 也可 Termux 跑完整节点（[移动端指南](docs/mobile.md)） | ✅ v0.11 |
| **浏览器插件** | 豆包、Kimi、ChatGPT 网页版等封闭 Web 助手 | 📋 Phase 1+ |

> 对完全封闭、不支持任何外部接入的 App，兜底方案是"剪贴板/分享"通道
> （`membridge context` 复制粘贴），永远可用。

## 快速开始

```bash
git clone https://github.com/jiabaobei/memory-bridge.git
cd memory-bridge
pip install -e .
membridge init               # 强制完成云盘通道配置（默认必做，检测已装同步盘自动配好；
                             # 没有则引导免费云盘；确要跳过需显式确认），
                             # 随后自动接入本机各 AI 平台
python examples/demo.py      # 90 秒看懂：手机记忆 → 差分包 → PC 无缝继续
```

> 为什么第一件事是配云盘？**记忆不上云，跨设备无从谈起。** 早上手机上的讨论，
> 只有进了云盘通道，办公室的电脑才能接着继续。按论文测算你的记忆一年仅约 1GB，
> 任何免费云盘都够用；且同步的是端到端加密的差分包——云盘服务商也看不到内容。

### CLI

```bash
membridge init                                           # 一键接入本机检测到的 AI 平台
membridge add "用户在开发记忆桥项目" --tags dev          # 写入记忆（可选 --kind fact / procedure / handover）
membridge search "记忆桥" -k 3                          # 三路混合检索（向量 + 关键词 + 图谱，RRF 融合；--scope tag:dev 范围直达）
membridge context "继续早上的讨论"                       # 输出 Path A 上下文块（最新交接卡恒定注入在【工作台】小节；无命中时明确"本轮不注入"）
membridge handoff                                       # 查看当前工作台：最新交接卡原文与生效状态
membridge handoff-hint                                  # 打印常驻交接提示（自愿粘贴进 CLAUDE.md / AGENTS.md）
membridge preload 我的手机                               # 预加载候选（PAMS 门控）
membridge delta phone.db --out delta.json               # 生成到另一设备的差分包
membridge apply delta.json                              # 并入差分包
membridge publish --dir "D:\百度网盘同步盘\membridge" --passphrase 我的口令   # 发到网盘通道
membridge fetch   --dir "D:\百度网盘同步盘\membridge" --passphrase 我的口令   # 从网盘取回
membridge stats                                         # 记忆库概况
membridge channel                                       # 通道一致性体检：本机与其他设备是否指向同一云盘通道
membridge gateway                                       # 手机/平板接入网关（基站模式，口令保护；--allow 加 IP 白名单）
membridge gateway-token                                 # 显示网关访问口令（配置手机时用）
membridge export                                        # 导出人类可读的 Markdown 视图（--out 落盘）
membridge recall-hint                                   # 打印常驻召回提示（自愿粘贴进 CLAUDE.md / AGENTS.md）
membridge rebuild-edges                                 # 全量重建语义关联边（常规 add 只增量建边）
membridge doctor                                        # 环境自检（库位置健康 + 通道健康 + 记忆缺口提醒）
membridge autosync                                      # 自动同步（init 已注册计划任务，每 15 分钟自动运行）
membridge show-passphrase                               # 配对新设备时查看同步口令（系统已替你生成并托管）
membridge set-passphrase                                # 手动设置/修改同步口令（一般不需要）
```

口令也可由环境变量 `MEMBRIDGE_PASSPHRASE` 提供，免得每次手输。

#### 经验沉淀约定（配合 `kind` 标注）

解决完一个难题、调通一个坑，值得存一条**经验**记忆，未来遇到同类任务
直接命中：

```bash
membridge add "部署到 arm64 会段错误，换 x86 镜像后通过" --kind procedure --tags dev
```

`--kind procedure` = 「试过什么、结果怎样」；`--kind fact` = 稳定事实。
纯可选标注，不改变任何默认行为。

#### 交接班约定（`kind=handover`，v0.15）

Agent 的上下文有限，长任务靠反复压缩续命，而压缩是有损的——
「方案B被否决」或许留下了，「为什么被否决」往往先丢。记忆桥的答案：
**收工方显式写一张交接卡，完整历史仍由记忆库承载**。

```bash
membridge add "goal: 修好同步模块
done: 差分计算已落地
failed: 全量AST解析；依赖太重；除非放弃零依赖否则别重试
next: 收敛行前缀解析
refs: membridge/store.py" --kind handover
```

- 五行约定 `goal / done / failed / next / refs`，正文原文冻结不改写；
  `failed` 行用硬句式：**试过什么；因为什么失败；除非什么改变否则别重试**；
- 新卡自动取代旧卡——最新一张即生效的工作台，旧的自动降级为历史，
  可检索、可审计，永不删除；
- 注入时工作台恒定在场（不受沉默契约约束——它是状态声明，不是检索命中），
  检索命中的其他记忆照常走原契约；
- 超 7 天未更新的卡不再恒定注入（过期工作台比没有更危险），降级为
  普通记忆；`membridge doctor` 会提醒；
- `membridge handoff-hint` 打印常驻提示，粘贴进 CLAUDE.md / AGENTS.md，
  让宿主 Agent 养成"收工前交接、接班先看工作台"的习惯（软约束，
  与 recall-hint 同款哲学）。

> 手机侧不需要记命令：网关随身记页面内置交接卡表单，填五行点「交接班」即可。

#### 云盘差分包丢失时的补救

`publish` 只发送「本地记录中尚未发布过」的记忆。若云盘侧差分包被误删、
或同步故障清空了通道，本地仍认为已发布——此时：

```bash
membridge publish --dir "..." --force    # 忽略本地记录，重发全量重建通道
```

不加 `--force` 会输出「没有需要发布的新记忆。」，这是幂等表现，不是故障。

#### 网盘三端直达：双网盘把网页端容器拉进三端闭环（v0.18 引入，v0.20 主备分明）

各端共享的前提是「每台设备都能到达同一个网盘文件夹」。电脑有网盘客户端、
手机平板有 App，唯独网页端容器这类无头 Linux 环境没有任何网盘客户端——
`netdisk-*` 命令组补的就是这一环（经 rclone）。**两家都配，主备分明**：
坚果云作主通道（WebDAV 全端可达），OneDrive 作备胎（坚果云出问题时顶上，
不是淘汰）——始终保持一条主通道：

```bash
# 网页端容器接坚果云（主通道；无浏览器往返：账号 + 应用密码直接交入）：
#   应用密码在坚果云网页「账户信息 → 安全选项 → 第三方应用管理」生成
membridge netdisk-connect --provider jianguoyun --dir /path/to/channel \
    --webdav-user  --webdav-pass 

# 网页端容器接 OneDrive（备胎；三步：装同步工具 → 授权 → 首次拉取）：
membridge netdisk-connect --dir /path/to/channel
#   ② 会提示去有浏览器的电脑跑：rclone authorize "onedrive"
#      把得到的 {"access_token":...} 交给本端：
membridge netdisk-connect --dir /path/to/channel --paste-token '{"access_token":...}'

# 日常同步（主通道先跑、备胎殿后，再跑包级同步）：
membridge netdisk-sync --dir /path/to/channel
membridge sync --netdisk --dir /path/to/channel   # 同效

# 电脑（已装网盘客户端，零配置捷径）：
membridge netdisk-connect --dir "D:\sync\membridge"  # 探测到本机云盘目录直接指向

# 迁通道宿主（v0.20）：复制通道文件 + 改本机指向，差分包去重天然安全
membridge channel --move /path/to/new/channel

membridge netdisk-status                          # 体检：两家授权与主备角色分开报
membridge netdisk-disconnect [--provider onedrive|jianguoyun]  # 按家或全撤（幂等）
```

纪律：OAuth token / 应用密码只落盘（rclone 配置文件，权限 600，坚果云密码
先混淆再落盘），永不打印、永不写进记忆或日志；基线标记与 `devices/` 心跳
目录排除出双向同步；同一通道目录可同时接两家（状态按家登记、主备分明，
v0.18 旧接线自动兼容）；老通道与既有命令行为不变。

#### 多台设备如何一致指向同一个通道（v0.13）

核心思路：**通道的「身份」记在通道自己身上，而不是记在每台设备上**——
认领代替记路径。你唯一要做的，是让各台设备的通道文件夹落在**同一个会被
云盘同步的位置**（例如都用 `D:\OneDrive\membridge`，或都用坚果云的
`我的坚果云\membridge`）。之后：

- **首个设备**发布记忆时，会在通道目录写一份**通道身份证** `channel.json`
  （通道 ID / 创建设备 / 创建时间 / 嵌入器指纹）——**纯元数据，不含口令、
  不含任何记忆内容**；
- **之后的每台设备**运行 `membridge init`（或第一次 `publish`/`fetch`/
  `autosync`）时，检测到目录里已有身份证就**自动认领**同一通道，并输出
  「已加入既有通道（由某设备创建）」——不需要你手动记路径、不需要复制配置；
- 若某台设备被误配到**另一个**通道（本机记录的通道 ID 与身份证对不上），
  `membridge channel` / `doctor` / `publish` / `fetch` / 自动同步都会**显式
  告警**（先到先得不改写，避免两台设备互相覆盖身份证）；
- 随时用 `membridge channel` 一屏体检：本机通道、通道身份证、通道里出现过
  的其他设备。

> 手机 / 平板不需要通道——它们经 `membridge gateway` 基站模式直连家里那台
> 常开设备（见 [移动端指南](docs/mobile.md)），天然只指向那一个库。

### 手动接入 MCP 客户端（`membridge init` 已覆盖的平台可跳过）

个别平台如需手动配置，Claude Code：

```bash
claude mcp add memory-bridge -- membridge mcp
```

Cursor / 其他 MCP 客户端（`mcp.json`）：

```json
{
  "mcpServers": {
    "memory-bridge": {
      "command": "membridge",
      "args": ["mcp"],
      "env": { "MEMBRIDGE_DB": "D:/mem/my.db", "MEMBRIDGE_DEVICE": "我的PC" }
    }
  }
}
```

可用工具：`memory_add`（Add，可选 `kind` 标注：fact / procedure / handover）、
`memory_search`（Search，三路混合检索；已知记忆在哪可用 `scope` 范围直达，
如 `tag:dev`；`as_context=true` 直接返回带预算的 Path A 注入块——最新交接卡
恒定注入在【工作台】小节，无高质量命中时明确告知本轮不注入）、
`memory_preload`（Preload）——严格限定在 UEP 权限边界内，没有"改写记忆"的工具。

## 架构一览

```
              ┌────────────────────────────────────────────────┐
              │           跨平台接入层（连接器）                  │
              │  MCP Server │ CLI │ 平台技能（WorkBuddy 等）     │
              │   手机/平板（网关 ✅）│ 浏览器插件（计划中）        │
              └───────────────────────┬────────────────────────┘
                                      │ 仅开放 Add / Search / Preload
   ┌──────────────────────────────────▼───────────────────────────────────┐
   │                 CDSMP 六阶段流水线（记忆桥核心）                        │
   │                                                                      │
   │   感知 ──▶ 蒸馏 ──▶ 缓存 ──▶ 同步 ──▶ 注入 ──▶ 反馈                   │
   │            SAN    TMT    DSS    Path A    AEE(Phase 4)               │
   │                                                                      │
   │        PAMS 三级隐私隔离（贯穿所有阶段的数据出口）                       │
   └──────────────────────────────────┬───────────────────────────────────┘
                                      │ DSS 差分包（默认端到端加密）
                                      │ 通道：网盘中转 ✅ / 局域网直连 / 实时中继（Phase 2）
                        ┌─────────────▼──────────┐
                        │  本设备记忆库（SQLite）   │◀──▶ 手机 / 平板 / 边缘网关
                        └──

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jiabaobei](https://github.com/jiabaobei)
- **Source:** [jiabaobei/memory-bridge](https://github.com/jiabaobei/memory-bridge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-jiabaobei-memory-bridge
- Seller: https://agentstack.voostack.com/s/jiabaobei
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.