Memory Ferry

Memory Ferry · 记忆摆渡 — это слой долговременной памяти и переиспользуемых навыков (Skills) для ИИ-агентов, работающий по принципу local-first и охватывающий несколько устройств. Поместите обычную папку Vault в iCloud Drive, OneDrive, Dropbox, Syncthing или на подключённый NAS, а затем подключите Codex, Claude Code, Cursor, OpenCode, DeepSeek Harness, Gemini CLI, GitHub Copilot CLI и MiniMax Code к одной и той же памяти.

Китайская документация · Руководство пользователя на английском · Китайское руководство пользователя

Версия 0.6.0-beta.1 не обеспечивает сквозное шифрование. Никогда не храните пароли, API-ключи, токены, закрытые ключи, коды восстановления и другие секреты.

Зачем это нужно

• Кроссплатформенность: синхронизируйте обычные файлы без управляющего сервера или фонового процесса базы данных.

• Кросс-агентность: единый контракт MCP и CLI вместо привязки памяти к конкретному вендору моделей.

• Работа в офлайне: каждая запись — это независимое неизменяемое JSON-событие, которое синхронизируется позднее.

• Устойчивость к конфликтам: параллельные добавления никогда не перезаписывают друг друга; обновления сходятся детерминированно.

• Переиспользуемые Skills: копируйте один источник Vault в каталоги Skills конкретного агента по хэшу содержимого в macOS и Windows.

• Низкая стоимость: используйте уже имеющиеся у вас хранилище и ПО для синхронизации.

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

Панель управления доступна только через loopback, открывается в браузере, поддерживает английский и китайский языки, управляет несколькими Vaults, подключает и отключает агентов, безопасно переносит содержимое 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.

• Устаревший псевдоним CLI agent-vault остаётся доступным в течение миграционного периода беты.

Сделайте резервные копии важных 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 и уведомления о лицензиях третьих сторон.