Memory Ferry

Memory Ferry · 记忆摆渡 ist eine lokale, geräteübergreifende Langzeitgedächtnis- und wiederverwendbare Skill-Ebene für AI-Agenten. Legen Sie einen gewöhnlichen Vault-Ordner in iCloud Drive, OneDrive, Dropbox, Syncthing oder in ein eingehängtes NAS und verbinden Sie dann Codex, Claude Code, Cursor, OpenCode, DeepSeek Harness, Gemini CLI, GitHub Copilot CLI und MiniMax Code mit demselben Gedächtnis.

中文说明 · Englische Benutzeranleitung · 中文使用手册

Version 0.6.0-beta.1 bietet keine Ende-zu-Ende-Verschlüsselung. Speichern Sie niemals Passwörter, API-Schlüssel, Tokens, private Schlüssel, Wiederherstellungscodes oder andere Geheimnisse.

Warum es das gibt

• Computerübergreifend: Synchronisieren Sie gewöhnliche Dateien ohne gehostete Kontrollebene oder Datenbank-Daemon.

• Agentenübergreifend: Stellen Sie einen einzigen MCP- und CLI-Vertrag bereit, statt das Gedächtnis an einen Modellanbieter zu binden.

• Offline-freundlich: Jeder Schreibvorgang ist ein unabhängiges, unveränderliches JSON-Ereignis, das später synchronisiert wird.

• Konflikt-tolerant: Gleichzeitige Hinzufügungen überschreiben einander nie; Aktualisierungen konvergieren deterministisch.

• Wiederverwendbare Skills: Kopieren Sie eine einzige Vault-Quelle anhand des Inhalts-Hash in agentenspezifische Skill-Verzeichnisse auf macOS und Windows.

• Geringe Kosten: Nutzen Sie Speicher- und Synchronisierungssoftware, die Sie bereits betreiben.

Related MCP server: ClawMem MCP Server

Unterstützte Agenten

Schnellstart

Erfordert Node.js 20 oder neuer:

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

Verwenden Sie während der Beta-Phase das explizite @beta-Tag. Aktualisieren oder deinstallieren Sie mit:

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

Das Dashboard ist nur über Loopback erreichbar, öffnet sich in Ihrem Browser, unterstützt Englisch und Chinesisch, verwaltet mehrere Vaults, verbindet oder trennt Agenten, migriert Vault-Inhalte sicher und gleicht Skills bei laufendem Betrieb alle fünf Minuten ab.

Windows-Portable-App

Die Windows-x64-Version ist eine portable MemoryFerry.exe: Es sind weder ein Installer noch eine separate Node.js-Installation erforderlich. Legen Sie die EXE in einen dauerhaften Ordner und doppelklicken Sie darauf. Sie startet ohne Konsolenfenster und öffnet das Dashboard in Ihrem Browser. Verwenden Sie die mitgelieferte MemoryFerry-CLI.cmd, wenn Sie Befehlszeilenausgabe benötigen.

Die Beta ist nicht kommerziell codesigniert, daher zeigt Windows möglicherweise eine Warnung vor einem unbekannten Herausgeber an. Überprüfen Sie die enthaltene SHA-256-Datei und lassen Sie SmartScreen aktiviert.

Speichermodell

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

Geräteidentität, Uhren, Ereignis-Caches und optionale Ollama-Embedding-Indizes bleiben außerhalb des synchronisierten Ordners. Der Vault enthält keine aktive SQLite-Datenbank, kein WAL und keine Sperrdatei.

Upgrade-Kompatibilität

Memory Ferry erkennt bestehende Installationen von Agent Vault Sync:

• agent-vault.json wird akzeptiert und ein neues Begleitmanifest memory-ferry.json wird erstellt, ohne die alte Datei zu löschen.

• Der Zustand von ~/.agent-vault-sync wird nach ~/.memory-ferry migriert, wenn der neue Zustand nicht existiert.

• Die Umgebungsvariablen AGENT_VAULT_* bleiben als Fallback für ihre MEMORY_FERRY_*-Entsprechungen erhalten.

• Wenn ein Agent erneut verbunden wird, wird der alte verwaltete Eintrag agent-vault entfernt und memory-ferry geschrieben.

• Der alte CLI-Alias agent-vault bleibt während der Beta-Migrationsphase verfügbar.

Sichern Sie wichtige Vaults vor dem Upgrade und lassen Sie Ihren Synchronisierungsclient zu Ende laufen, bevor Sie denselben Vault auf einem anderen Computer öffnen.

Optionale semantische Erinnerung

Wenn lokales Ollama verfügbar ist, vermischen recall und context semantische Ähnlichkeit mit Unicode/CJK-Textbewertung. Setzen Sie MEMORY_FERRY_EMBED=off oder übergeben Sie --no-semantic, um eine rein textbasierte Suche zu verwenden. Embedding-Indizes bleiben lokal und werden repariert, bevor die erste Abfrage nach Cloud-Synchronisierung oder Migration zurückkehrt.

Entwicklung

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

Windows-Releases werden in GitHub Actions gebaut und per Smoke-Test geprüft. Siehe CONTRIBUTING.md, SECURITY.md und architecture.md.

Lizenz

MIT. Standalone-Releases enthalten außerdem Node.js und Lizenzhinweise Dritter.