Memory Ferry

Memory Ferry · 记忆摆渡 是为 AI 智能体提供的本地优先、跨设备长期记忆和可复用 Skills 层。将普通的 Vault 文件夹放入 iCloud Drive、OneDrive、Dropbox、Syncthing 或挂载的 NAS 中，然后将 Codex、Claude Code、Cursor、OpenCode、DeepSeek Harness、Gemini CLI、GitHub Copilot CLI 和 MiniMax Code 连接到同一个记忆。

中文说明 · English user guide · 中文使用手册

版本 0.6.0-beta.1 不提供端到端加密。切勿存储密码、API 密钥、令牌、私钥、恢复代码或其他机密。

为什么存在

• 跨计算机：同步普通文件，无需托管控制平面或数据库守护进程。

• 跨智能体：提供统一的 MCP 和 CLI 契约，而不是将记忆锁定在某个模型供应商。

• 离线友好：每次写入都是独立的不可变 JSON 事件，可在之后同步。

• 冲突容忍：并发新增永远不会互相覆盖；更新确定性收敛。

• 可复用 Skills：在 macOS 和 Windows 上，按内容哈希将单个 Vault 源复制到特定智能体的 Skill 目录。

• 低成本：复用您已在运行的存储和同步软件。

Related MCP server: ClawMem MCP Server

支持的智能体

快速开始

需要 Node.js 20 或更高版本：

npm install -g memory-ferry@beta

memory-ferry init "/path/to/your/synced/MemoryFerryVault"
memory-ferry agents install all
memory-ferry remember "Prefer concise answers" --kind preference --scope global
memory-ferry recall "answer style"
memory-ferry ui

在测试期间，请使用明确的 @beta 标签。升级或卸载方式如下：

npm install -g memory-ferry@beta
npm uninstall -g memory-ferry

仪表板仅回环访问，可在浏览器中打开，支持中英文，管理多个 Vault，连接或断开智能体，安全迁移 Vault 内容，并在运行期间每五分钟协调一次 Skills。

Windows 便携版应用

Windows x64 版本是便携式 MemoryFerry.exe：无需安装程序，也无需单独安装 Node.js。将 EXE 放在一个固定文件夹中，然后双击它。它启动时没有控制台窗口，并打开本地仪表板。需要命令行输出时，请使用随附的 MemoryFerry-CLI.cmd。

测试版未进行商业代码签名，因此 Windows 可能会显示未知发布者警告。请验证随附的 SHA-256 文件并保持 SmartScreen 启用。

存储模型

MemoryFerryVault/
├── memory-ferry.json
├── memory/events/<device-id>/<date>/<event-id>.json
└── skills/<skill-name>/...

设备身份、时钟、事件缓存和可选的 Ollama 嵌入索引都保留在同步文件夹之外。Vault 中不包含实时 SQLite 数据库、WAL 或锁文件。

升级兼容性

Memory Ferry 可识别现有的 Agent Vault Sync 安装：

• 接受 agent-vault.json，并创建新的 memory-ferry.json 配套清单，而不会删除旧文件。

• 当新状态不存在时，~/.agent-vault-sync 状态会迁移到 ~/.memory-ferry。

• AGENT_VAULT_* 环境变量仍是其 MEMORY_FERRY_* 替代项的备用变量。

• 重新连接智能体会删除旧的受管 agent-vault 条目并写入 memory-ferry。

• 在测试版迁移期间，旧的 agent-vault CLI 别名仍然可用。

升级前请备份重要的 Vault，并在另一台计算机上打开同一 Vault 之前，让同步客户端完成同步。

可选语义召回

如果本地 Ollama 可用，recall 和 context 会将语义相似性与 Unicode/CJK 文本评分相结合。设置 MEMORY_FERRY_EMBED=off 或传入 --no-semantic 以使用纯文本搜索。嵌入索引保留在本地，并在云同步或迁移后首次查询返回之前完成修复。

开发

npm ci
npm run test:all
npm audit --omit=dev
npm pack --dry-run

Windows 版本在 GitHub Actions 中构建并进行冒烟测试。请参阅 CONTRIBUTING.md、SECURITY.md 和 architecture.md。

许可证

MIT。独立发布版本还包含 Node.js 和第三方许可证声明。