Perseus Vault

Постоянная зашифрованная память для AI-агентов. Один Rust-бинарник, один файл, никакого облака.

Опубликован в Official MCP Registry · Glama · mcpservers.org · Lulu MCPs · Docker (GHCR)

Дайте вашим агентам память, которая переживает сессию, чтобы они перестали заново выводить то, что уже узнали, и перестали повторять прошлые ошибки. Гибридный поиск (BM25 + плотный + RRF), битемпоральная история и AES-256-GCM в покое, представленные как 168 канонических MCP-инструментов, которые работают с любым хостом. Устаревшие псевдонимы mimir_*/mneme_* были удалены в мажорном релизе 2026-27 и не учитываются отдельно. 73.8% на официальном стенде LongMemEval (против Zep 63.8%, Mem0 49.0%). Один бинарник. Один файл. Без Docker. Без Postgres. Без облака. Локально, готово к воздушному зазору, MIT.

Установка в одну строку

curl -sSf https://raw.githubusercontent.com/Perseus-Computing-LLC/perseus-vault/main/scripts/install.sh | sh

Вот и всё. Perseus Vault устанавливается в ~/.local/bin/perseus-vault. Запустите его:

perseus-vault serve --db ~/.perseus-vault/data/perseus-vault.db

Шифрование включается автоматически для установки по умолчанию. При первом запуске создается ~/.perseus-vault/secret.key с правами только для владельца и зашифрованный канарейка базы данных. Сделайте резервную копию этого ключа: его невозможно восстановить. Явные пути --encryption-key по-прежнему поддерживаются, а существующие базы данных в открытом виде сохраняются для миграции с помощью perseus-vault init --rekey. Используйте doctor для проверки фактического состояния на диске.

Примечание для macOS (Apple Silicon). Свежесобранный или скопированный бинарник при первом запуске получает SIGKILL (Killed: 9, без другого вывода) из-за политики ОС в отношении бинарников — даже без атрибута карантина. Установщик в одну строку и установщик сборки из исходников bootstrap.sh выполняют ad-hoc подпись кода Perseus Vault за вас. Если вы собираете бинарник самостоятельно, подпишите его один раз после каждой пересборки:

cargo build --release
cp target/release/perseus-vault ~/.local/bin/perseus-vault
codesign --force --sign - ~/.local/bin/perseus-vault   # required on Apple Silicon; fixes "Killed: 9"

--force переподписывает уже подписанный бинарник (нужно после каждой пересборки); этот шаг безвреден на Intel macOS и не нужен на Linux/Windows.

Затем подключите ваши MCP-клиенты — и полный цикл припоминания/захвата — одной командой:

perseus-vault install-client --hooks --rules

Это автоматически обнаруживает Claude Code / Codex / Cursor (передайте --client <name> для claude-desktop, hermes, windsurf, vscode, zed или generic; --all-detected подключает каждый обнаруженный клиент), объединяет регистрацию MCP-сервера в конфиг клиента без повреждения чего-либо (сначала создается резервная копия .bak-perseus), направляет каждый клиент на одну общую базу данных памяти, регистрирует хуки жизненного цикла сессии (внедрение припоминания при SessionStart, гигиена при завершении сессии — контракт docs/lifecycle-hooks.md) и добавляет правила использования памяти в CLAUDE.md/AGENTS.md. Повторный запуск — холостой; добавьте --dry-run для предварительного просмотра каждого файла, к которому он прикоснется.

Или подключите любой MCP-хост вручную (Claude Desktop, Cursor, Hermes Agent, Perseus и т.д.):

{
  "mcpServers": {
    "perseus-vault": {
      "command": "perseus-vault",
      "args": ["serve", "--db", "~/.perseus-vault/data/perseus-vault.db"]
    }
  }
}

Related MCP server: GroundMemory

Для Агентов: Подключение через MCP

Когда основным потребителем является агент, интерфейсом является MCP — агент принимает Vault через своего MCP-клиента, и установка CLI на машине не требуется, кроме запуска самого сервера:

# 1. Run the server (one line)
perseus-vault serve --db ~/.perseus-vault/data/perseus-vault.db &

# 2. Register it in the agent's MCP client config
#    { "mcpServers": { "perseus-vault": {
#        "command": "perseus-vault",
#        "args": ["serve", "--db", "~/.perseus-vault/data/perseus-vault.db"] } } }

# 3. Verify the agent-facing surface
perseus-vault doctor

perseus-vault install-client --hooks --rules настраивает весь цикл припоминания/захвата для Claude Code / Codex / Cursor / Hermes одной командой. Для карты возможностей, ориентированной на агента — какой инструмент какую работу выполняет и шаблон границ планирования — см. docs/integration/agent-adoption.md.

Быстрый старт за 30 секунд

# Start Perseus Vault
perseus-vault serve --db memory.db &
sleep 1

# Remember a fact (via MCP JSON-RPC on stdio)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"perseus_vault_remember","arguments":{"category":"demo","key":"hello","body_json":"{\"text\":\"Hello from Perseus Vault!\"}"}}}' | perseus-vault serve --db memory.db

# Search for it
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"perseus_vault_recall","arguments":{"query":"Hello"}}}' | perseus-vault serve --db memory.db

Модель памяти и операционные границы

Perseus Vault держит три плоскости раздельными:

• Неявный рабочий контекст — это текущее приглашение хоста, транскрипт и любой блок контекста, который клиент решает внедрить. Он эфемерен и принадлежит хосту; он не сохраняется только потому, что Vault его вернул.

• Явная долговременная память записывается явной операцией perseus_vault_remember, perseus_vault_capture, write или capture. Сервер Vault владеет записью SQLite, историей, журналом, затуханием, архивом и жизненным циклом очистки.

• Производные проекции включают консолидированные или синтезированные записи и экспортированный Markdown. Они несут происхождение, но не являются заменой исходных долговременных записей и могут потребовать отдельной очистки.

perseus-vault prepare и perseus_vault_context читают долговременные записи для создания ограниченного, релевантного задаче активного рабочего контекста. Это скользящий снимок, а не фоновая запись или обещание, что клиент его сохранит: обновляйте его при изменении задачи и не рассматривайте текст приглашения как долговременную память, если только явная операция захвата/записи не завершилась успешно. Вывод с приоритетом припоминания ограничен по бюджету (1500 символов по умолчанию, 6000 для хостов с большим окном или явный max_context_chars); набор always_on ограничен пятью. См. семантику хранения и контекста.

Хуки жизненного цикла и установщики клиентов являются необязательной оркестровкой. Они запрашивают принадлежащую серверу работу по припоминанию, захвату, обслуживанию и обновлению; они не становятся вторым хранилищем и не изменяют политику хранения. Если сервер или хук недоступны, продолжите задачу без внедренной памяти и сообщите о деградированном состоянии. Интеграция хоста может иметь явно настроенное локальное резервное решение, но это резервное решение должно быть помечено как локальное и не должно представляться как долговременное припоминание Vault; неудачная явная запись никогда не должна сообщаться как сохраненная. Для шагов обновления/восстановления используйте руководство по обновлению и миграции.

Работает с Любым MCP-Клиентом

Perseus Vault — это стандартный MCP-сервер stdio — та же команда perseus-vault serve работает везде. Запустите perseus-vault doctor, чтобы проверить вашу установку и вывести эту матрицу локально.

Фрагменты конфигурации копипастой для каждого: docs/clients/.

Затем подключите цикл припоминание → работа → захват → консолидация к событиям сессии вашего клиента (хуки SessionStart/Stop для Claude Code, Codex и Cursor, плюс портативное резервное решение AGENTS.md): docs/lifecycle-hooks.md.

Композиция с очистителем памяти (CoalWash) и уплотнителем вывода времени выполнения (Noisegate) для сквозного контроля бюджета контекста: docs/integration/context-budget-stack.md.

Аудит того, что Vault помнит, откуда и под чьей властью: docs/evidence-chain-guidance.md — цепочки доказательств, теги происхождения во время записи и непрерывная аттестация для долговременной памяти.

Банки памяти (изоляция на клиента, один профиль)

Агентство запускает 50 клиентов с одним и тем же сценарием? Не дублируйте профили — назначьте банк памяти для каждого проекта и храните один профиль Hermes, один Vault и одну общую библиотеку навыков:

# .hermes.md
memory_bank: acme-seo            # name → deterministic workspace hash
memory_bank_workspace: <64-hex>  # optional explicit workspace override

Провайдер памяти Hermes (hermes plugins install Perseus-Computing-LLC/hermes-plugin-perseus-vault) разрешает банк один раз за сессию и ограничивает каждое чтение и запись Vault — предварительное припоминание, perseus_recall / perseus_remember / perseus_forget, захват в конце сессии — выделенным рабочим пространством. Имена банков сопоставляются детерминированно (sha256("memory-bank:" + name)), поэтому каждый экземпляр, указывающий на одно и то же имя, обращается к тому же рабочему пространству без необходимости поддерживать реестр. Рабочие пространства являются первоклассными на сервере: ограниченное обслуживание, изоляция дедупликации между банками и манифесты полномочий для каждого рабочего пространства. Обнаружение отражает правила контекста проекта Hermes (побеждает ближайший .hermes.md, ограничен корнем git); файл контекста без директивы означает отсутствие банка — настроенное рабочее пространство остается в силе.

Почему Perseus Vault

Perseus Vault — это единственный движок памяти, который одновременно является MCP-нативным, локальным, не имеющим зависимостей И ориентированным на агентов.

LongMemEval QA (официальный стенд)

Качество припоминания, измеренное на официальном стенде LongMemEval, а не на самодельном скрипте:

longmemeval_s (500 вопросов), отвечающий gpt-4o-2024-08-06 + официальный судья LongMemEval; цифры конкурентов — их опубликованные значения. 73.8% Perseus Vault — это простое среднее 3 запусков; 79.0% с официальным CoT. Методология и результаты с хешированием содержимого (sha256) →

LOCOMO (собственный стенд mem0)

Измерено на собственном стенде LOCOMO от mem0 (наш форк), а не нашем — категории 1–4, 1540 вопросов, топ-200, отвечающий и судья gpt-5:

Категория 5 состязательная (446 вопросов): Perseus 63.5, Mem0 55.6, Zep 49.8. Наше измерение Mem0 на 9.4 пункта ниже их опубликованного файла (дрейф судьи/платформы — раскрыто). Полная таблица лидеров →

Битемпоральное путешествие во времени (три оси)

Наш самый сильный структурный дифференциатор — полная битемпоральная история SQL:2011 (время транзакции и действительное время) — измеренная на воспроизводимом, полностью офлайн испытании. Он управляет реальным поставляемым бинарником через MCP stdio через сложные случаи, с которыми одноосевые конкуренты ошибаются (ретроактивные исправления, упреждающие факты с датой в будущем, поступление не по порядку, расхождение убеждения и истины, закрытые периоды):

Воспроизведение одной командой (без API-ключа, без сети, без LLM):

cargo build --release
python benchmark/temporal/gauntlet.py --bin target/release/perseus-vault

Вердикты PASS/FAIL детерминированы (отметки времени стенных часов варьируются, вердикты — нет), поэтому правильная сборка повторно запускается до идентичного signature_sha256. Зафиксированный gauntlet_report.json является эталоном. Методология и набор данных →

Сравнительная матрица

Полное сравнение: Perseus Vault vs Mem0 → vs Letta → vs Zep →

Стресс-тест: 100K сущностей

Perseus Vault справляется с производственными нагрузками на скромном оборудовании. Цифры ниже взяты из зафиксированного артефакта benchmark/scale/report.json: реальный релизный бинарник, управляемый через MCP stdio (один постоянный процесс на размер корпуса), AMD64 16-ядерный, Windows 11, каждая запись устойчива перед отправкой следующей.

Полные перцентили, точечные запросы as_of, временное извлечение и показатели холодного старта находятся в benchmark/scale/.

Запустите сами: python benchmark/scale/run.py

Точность извлечения в масштабе: ключевые слова падают, гибрид держится

Скорость — это лишь входной билет; вопрос, который имеет значение для памяти агента: действительно ли нужная память всплывает? Измерено на корпусах с различным содержимым (собственные, воспроизводимые; см. benchmark/lambda/), recall@k по режиму:

100 000 сущностей (1×H100, nomic-embed-text на Ollama):

При 100K сущностях гибридное извлечение идеально на @5, в то время как поиск по ключевым словам попадает только ~1,5% времени — разрыв ~66×. И он увеличивается с масштабом: при 10K сущностях извлечение по ключевым словам @5 было 0,008, а гибрид уже 1,000; память только на ключевых словах молча ухудшается по мере накопления истории агентом, гибрид (BM25 + плотные вектора + слияние взаимных рангов) — нет. Это ключевой аргумент в пользу гибридного поиска Perseus Vault.

Сравнение один на один, та же машина, тот же корпус, всё полностью локально (1×H100, Ollama — одинаковый набор фактов, запросов и оценщик подстрок для каждой системы):

Каждый конкурент был развёрнут и запущен вживую на той же машине против того же локального Ollama (qwen2.5:14b-instruct + nomic-embed-text) — никакого облака, никаких выдуманных цифр. Letta работал как сервер letta/letta (встроенный Postgres/pgvector) и достиг 1.00, как и Perseus Vault. Самостоятельно размещаемый сервер Community Edition от Zep устарел, и его API памяти zep_python теперь доступен только в Zep Cloud, поэтому мы измерили фактический OSS-движок Zep — временной граф знаний Graphiti на Neo4j — с извлечением сущностей/связей и эмбеддингами на том же локальном Ollama. Его 0.20 отражает реальную стоимость построения графа знаний с помощью локальной модели (структурированное извлечение с потерями: 5 сущностей / 2 ребра из 6 фактов) — а не Zep Cloud, который использует передовые модели. Полный артефакт + методология: benchmark/lambda/results/competitors.json.

Холодный старт: голая машина с GPU выдает первый обоснованный RAG-ответ за 3.3 с (модели размещены на диске).

Воспроизведение: benchmark/lambda/scale_bench.py и competitors_bench.py.

Развёртывание рядом с сервером моделей на GPU-хосте (vLLM на MI300X/H100)? См. справочник по развёртыванию на AMD MI300X — измеренные показатели совместного размещения, а также подводные камни /dev/shm, PID-1 и фиксации версий, которые ломают эти стеки на практике.

Интеграции с фреймворками

Готовые к использованию адаптеры, которые делают Perseus Vault стандартным бэкендом памяти для популярных фреймворков AI-агентов:

Каждый адаптер:

• Подключается через подпроцесс MCP stdio (постоянная сессия)

• Отображает интерфейс памяти фреймворка на инструменты Perseus Vault

• Поставляется с быстрым стартом в README (5 минут до работы)

• Имеет проходящие тесты с имитированным MCP-транспортом

Любой MCP-совместимый фреймворк работает с Perseus Vault напрямую. См. Интеграции MCP-клиентов и фреймворков для полного списка.

150 канонических MCP-инструментов

Канонические названия продуктов и инструментов. Perseus Vault — это название продукта, и интеграции используют канонические инструменты perseus_vault_* (например, perseus_vault_remember). Устаревшие названия mimir_* / mneme_* / plutus_* были удалены в мажорном релизе 2026-27 годов — канонические названия являются единственным интерфейсом. Количество — это число уникальных канонических инструментов в исходном реестре. Совместимые псевдонимы вызываемы, но не учитываются отдельно. Устаревшие названия perseus_vault_* и perseus_vault_* остаются полностью вызываемыми — каждый префикс направляется к тому же обработчику — они просто больше не рекламируются в tools/list. Это позволяет сохранить рекламируемый манифест как одно имя на инструмент вместо его утроения (3× раздувание псевдонимов), поэтому подключённые клиенты не перезагружают утроенную полезную нагрузку схемы инструментов при каждом запросе. Чтобы восстановить историческое поведение рекламирования всех трёх префиксов, установите PERSEUS_VAULT_TOOL_ALIASES=all (устаревшая env PERSEUS_VAULT_TOOL_ALIASES также учитывается; PERSEUS_VAULT_ имеет приоритет).

Совместимость клиентов (#633). Клиенты, которые проверяют рекламируемый список — они проверяют tools/list перед вызовом и пропускают инструменты, которых не видят — будут молча пропускать устаревшие вызовы perseus_vault_* к хранилищу версии 2.x, хотя сам вызов был бы успешным. Известный случай: CLI perseus ≤ 1.0.22 жёстко кодирует perseus_vault_recall и деградирует до пустого локального извлечения. Исправление с любой стороны: обновите CLI до ≥ 1.0.23 (вызывает канонические имена с динамическим запасным вариантом) или установите PERSEUS_VAULT_TOOL_ALIASES=all на хранилище в качестве моста, пока старые клиенты остаются развёрнутыми.

Области инструментов (уровни рекламы, #1051)

По умолчанию tools/list рекламирует все канонические инструменты. Установите PERSEUS_VAULT_TOOL_SCOPE, чтобы сузить рекламируемую поверхность для клиентов-агентов, ограниченных по токенам и вниманию:

Области предназначены только для рекламы: скрытый инструмент остаётся полностью вызываемым через tools/call, а авторизация остаётся за привязкой к рабочему пространству и манифестам полномочий. Классификация уровней представляет собой вспомогательную таблицу 1:1 (TOOL_SCOPES в src/mcp.rs), принудительно применяемую CI с помощью scripts/registry_metadata_check.py — каждый новый инструмент должен быть классифицирован. Инструменты уровня admin (migrate, purge, erase, vault_import, authority_set / authority_revoke / authority_set_signed) никогда не появляются в списке с областью.

CRUD сущностей

Поиск и RAG

📖 docs/retrieval-modes.md — единый перечисленный справочник для каждого режима поиска (keyword · dense · hybrid · graph · GraphRAG · проактивный recall_when · темпоральный as_of): механизм, когда использовать, вызов и примеры.

Граф

Журнал

Состояние

Жизненный цикл

Качество

Ключевые камни (правила политики)

Хранилище и Федерация

Метрики и операции

Инструменты по задачам (шпаргалка агента)

Не перечисление категорий — а перечисление задач. Выберите строку в соответствии с тем, что пытается сделать агент:

CLI

# Server
perseus-vault serve --db /data/perseus-vault.db
perseus-vault serve --web --port 8767 --encryption-key ~/.perseus-vault/secret.key
perseus-vault serve --llm-endpoint http://localhost:11434/api/generate --llm-model llama3
perseus-vault serve --transport sse --port 8787 --mcp-token my-secret-token

# Maintenance (operate directly on DB, no server needed)
perseus-vault stats          --db /data/perseus-vault.db
perseus-vault forget         --db /data/perseus-vault.db --category decision --key stale-choice --reason "superseded"
perseus-vault prune          --db /data/perseus-vault.db --category junk --min-decay 0.1 --dry-run
perseus-vault purge          --db /data/perseus-vault.db --dry-run
perseus-vault decay          --db /data/perseus-vault.db
perseus-vault reindex        --db /data/perseus-vault.db
perseus-vault vault-export   --db /data/perseus-vault.db --vault-dir ./export/
perseus-vault vault-import   --db /data/perseus-vault.db --vault-dir ./export/
perseus-vault obsidian-sync  ~/obsidian-vault/Perseus Vault/          # one-shot export to an Obsidian vault
perseus-vault obsidian-sync  ~/obsidian-vault/Perseus Vault/ --watch  # continuous sync on every memory change

# Key management
perseus-vault keygen --key-file ~/.perseus-vault/secret.key

# #918: read-only TUI inspector (retrieval telemetry, claim cards, entity
# state, decay, bi-temporal history). Never writes; repairs go through the
# governed MCP tools. Requires the default `tui` feature.
perseus-vault inspect --db /data/perseus-vault.db --key-file ~/.perseus-vault/secret.key

Живые обновления без перезапуска сессии

perseus-vault serve обнаруживает, когда его собственный бинарный файл заменяется на диске в середине сессии (обычный процесс cargo build / переустановки) и отказывается обслуживать результаты из устаревшего образа процесса — каждый инструмент отвечает громкой, явной ошибкой вместо деградации до пустых результатов (#858, #1045). Два пути восстановления, оба по тому же stdio-соединению (без перезапуска клиента):

• Явный: вызовите perseus_vault_handoff_restart {"confirm": true} — процесс горячо заменяется на новый бинарный файл, и сессия продолжается без проблем, с сохранением состояния сессии MCP (инициализация + идентичность агента).

• Автоматический (опциональный): запустите сервер с PERSEUS_VAULT_AUTO_HANDOFF=1, и замена происходит прозрачно при следующем вызове инструмента, на который новый бинарный файл отвечает напрямую.

На macOS/Linux замена — это настоящий exec (тот же PID, те же каналы). Windows блокирует запущенный исполняемый файл, поэтому замена в середине сессии там невозможна; обновляйте между сессиями. Полный контракт и рабочий процесс локальной разработки: docs/specs/live-update-handoff.md.

Ручные правки БД. Глаголы обслуживания выше и обычный путь записи MCP автоматически синхронизируют индекс FTS5. Редактирование таблицы entities напрямую с помощью sqlite3 (ручной DELETE/UPDATE) обходит эту синхронизацию и может оставить осиротевшие строки индекса — "призрачные" попадания при поиске для контента, которого уже нет. После любого прямого SQL-редактирования запустите perseus-vault maintain --db <путь> (или perseus-vault reindex), чтобы согласовать FTS-индекс.

Флаги

Расположение базы данных

Канонический путь к базе данных:

~/.perseus-vault/data/perseus-vault.db

Всегда передавайте --db (или устанавливайте $PERSEUS_VAULT_DB_PATH) в скриптах, конфигурациях MCP-хоста и заданиях cron/harvest, чтобы каждый вызов указывал на один и тот же файл. Если не задано ни то, ни другое, Perseus Vault разрешает путь по умолчанию в следующем порядке и использует первый, который уже существует (чтобы пользователи, выполняющие обновление, и устаревшие однопользовательские установки были подхвачены вместо того, чтобы молча начинать с пустой БД):

1. ~/.perseus-vault/data/perseus-vault.db — канонический (текущее имя)

2. ~/.perseus-vault/data/perseus-vault.db — до переименования

3. ~/.perseus-vault/data/perseus-vault.db — до переименования

4. ~/perseus-vault.db — устаревшее расположение однопользовательской установки

Если ни одного не существует, он создает ~/.perseus-vault/data/perseus-vault.db. Если более одного из них существует, и вы не передали --db/$PERSEUS_VAULT_DB_PATH, Perseus Vault выводит предупреждение в stderr с именем выбранного файла и других, которые он проигнорировал, чтобы неоднозначное состояние с несколькими базами данных было видимым, а не молчаливым. Явная установка --db или $PERSEUS_VAULT_DB_PATH всегда имеет приоритет и подавляет предупреждение.

Ваша AI-память в Obsidian

Perseus Vault — это долговременная память вашего AI-агента — и она также служит вашим вторым мозгом. Каждая сущность, которую запоминает ваш агент, экспортируется в простую заметку Markdown с YAML frontmatter, так что память вашего AI становится навигационной базой личных знаний внутри инструментов, которые вы уже используете: Obsidian, Logseq или Notion.

# Export your entire memory to an Obsidian vault as linked Markdown notes
perseus-vault obsidian-sync ~/obsidian-vault/Perseus Vault/

# Keep it live — re-export automatically on every memory change
perseus-vault obsidian-sync ~/obsidian-vault/Perseus Vault/ --watch

Откройте хранилище в Obsidian, и вы получите граф знаний вашего агента.

Обратные ссылки WikiLink. Когда одна сущность ссылается на другую (через perseus_vault_link или отношение depends_on / implements / references), экспортированная заметка получает раздел ## Links с обратными ссылками [[WikiLink]], которые нативно разрешаются в представлении графа Obsidian:

---
id: cli-de8dfb8364b6
category: architecture
key: api
type: insight
decay_score: 0.5000
---

{"content":"axum service"}

## Links

- [[cli-99756b494c7d|database]] (depends_on)

Ссылки разрешаются по идентификатору сущности (заметки записываются как <id>.md), поэтому они никогда не ломаются, и Obsidian показывает читаемый человеком key в качестве метки ссылки. Откройте представление графа, и архитектура вашего агента, решения и инсайты станут интерактивной картой знаний.

--watch опрашивает дешевый, детерминированный дайджест состояния Perseus Vault с интервалом и повторно экспортирует только тогда, когда память действительно изменилась. Он естественным образом перехватывает каждую запись perseus_vault_remember без зависимости от файлового наблюдателя и без привязки к серверу. Настройте интервал с помощью PERSEUS_VAULT_SYNC_INTERVAL_SECS (по умолчанию: 2с).

Другие инструменты PKM

В отличие от облачных инструментов "второго мозга", Perseus Vault работает на 100% локально, написан на Rust, шифрует в состоянии покоя с помощью AES-256-GCM и применяет оценку устаревания, так что устаревшие воспоминания исчезают — ваша база знаний остается вашей и остается свежей.

Возможности

Семантический поиск (включен по умолчанию)

• Встроенные внутрипроцессные эмбеддинги — квантованная модель all-MiniLM-L6-v2 (384-мерная) скомпилирована в бинарный файл, поэтому плотный/семантический поиск работает без настройки и без сети: не нужен Ollama, API-ключ или загрузка модели. Это сборка по умолчанию (функция bundled-embeddings).

• Автоматическое встраивание при записи (#271) — perseus_vault_remember встраивает каждую новую (или изменённую по содержимому) сущность синхронно при записи, используя встроенную модель. Встраивание одной сущности детерминировано и кэшируется по LRU, поэтому оно дёшево и не добавляет фоновых задач. Сбои встраивания не являются фатальными (логируются в stderr); запись всегда выполняется успешно.

• Гибридный режим по умолчанию (#271) — perseus_vault_recall(query=...) без флага mode автоматически выбирает гибридный (плотный + ключевой, объединённый через RRF) при наличии эмбеддингов и прозрачно переключается на ключевой поиск fts5, если их нет. Никакого ручного шага perseus_vault_embed, никаких флагов для запоминания.

• perseus_vault_semantic_search(query, limit) — сокращение одним инструментом для чистого плотного поиска по смыслу (без запасного ключевого варианта), когда нужно просто «найти похожее».

• Опциональный альтернативный встраиватель — чтобы использовать Ollama или любой совместимый с OpenAI эндпоинт /v1/embeddings вместо встроенной модели, укажите --llm-endpoint (и при необходимости --embedding-endpoint / --llm-api-key). Это полностью опционально; по умолчанию используется встроенная модель.

• Соберите лёгкий бинарный файл без встроенных эмбеддингов с помощью cargo build --no-default-features — тогда поиск по умолчанию будет ключевым, если не настроен удалённый встраиватель.

Внутреннее устройство гибридного поиска

• Ключевой поиск FTS5 с запасным вариантом LIKE и расширением стеммингом Портера

• Плотный векторный поиск через косинусное сходство по сохранённым эмбеддингам

• Reciprocal Rank Fusion (RRF) — объединение результатов ключевого и векторного поиска

• Расширение запроса — автоматические варианты стемминга для более широкого поиска

Жизненный цикл памяти

Perseus Vault моделирует память с помощью трёх биомиметических слоёв, вдохновлённых путями человеческой памяти:

• Мир (Ядро): Медленно затухающие, глобальные факты об окружении.

• Эпизодический (Буфер): Быстро затухающая история взаимодействий, специфичная для сессии.

• Семантический (Рабочий): Средне затухающие, общие знания и изученные концепции.

Вы можете напрямую взаимодействовать с этими слоями с помощью инструмента perseus_vault_recall_layer или указав параметр layer в perseus_vault_remember.

• Забывание по Эббингаузу — воспоминания естественным образом исчезают, если их не извлекать (обновление при доступе)

• Повышение слоя — буфер → рабочий → ядро на основе частоты доступа

• Автоматическое архивирование — устаревшие сущности архивируются; очистка для окончательного удаления + VACUUM

• Постоянно активные сущности — закрепление критически важных для идентичности воспоминаний для внедрения в сессию (жёсткое ограничение при приоритете извлечения; предпочтительнее триггеры recall_when)

• Проспективные подсказки запросов (#919) — опциональные 1–3 формулировки на естественном языке для каждой сущности (hints в perseus_vault_remember), которые индексируются в FTS5 вместе с телом, устраняя разрывы в словаре между запросами на простом языке и сохранёнными формулировками. Отключено по умолчанию (PERSEUS_VAULT_HINTS_ENABLED=1); отклоняется, пока не включено. См. docs/specs/prospective-query-hints.md.

Внедрение контекста с приоритетом извлечения

Хранилище — это слой запросов: оно извлекает несколько фактов, необходимых для текущего шага, вместо того чтобы передавать хосту постоянный блок для вставки в каждый системный промпт. perseus_vault_context и perseus-vault prepare по умолчанию работают с приоритетом извлечения:

• Фильтрация по релевантности — передаётся query (текущая задача/сообщение), и внедряются только те сущности, чьи триггеры recall_when или индексированное содержимое совпадают с ним. Нет запроса — нет тематического внедрения: блок представляет собой компактный указатель для извлечения, стабильный по байтам при несвязанных записях в хранилище (дружественный к префиксному кэшу).

• Бюджет извлечения для каждой модели — вывод ограничивается символьным бюджетом, определённым из модели хоста: профиль по умолчанию/лёгкий — 1500 символов; профиль с большим окном («opus») — 6000 символов; max_context_chars переопределяет оба.

• Ограниченное постоянное включение — always_on: true по-прежнему работает для критически важных для идентичности фактов, но набор с приоритетом извлечения имеет жёсткое ограничение (первые 5), а при переполнении выдаётся предупреждение, направляющее вас к триггерам recall_when.

• Устаревший вариант — старый безусловный дамп первых N записей по-прежнему доступен с mode: "always_inject" (--legacy-context для prepare), без ограничений, если не передан бюджет.

perseus-vault prepare --task "deploying the payments service" --model claude-sonnet-4-6
perseus-vault prepare --task "..." --max-context-chars 800     # explicit budget
perseus-vault prepare --task "..." --legacy-context            # old dump, opt-in

RAG и эмбеддинги

• perseus_vault_ask — вопросы и ответы на естественном языке по сохранённым воспоминаниям через любую LLM (Ollama, OpenAI и т.д.)

• perseus_vault_embed — генерация и сохранение плотных векторов через Ollama или совместимый с OpenAI эндпоинт /v1/embeddings

• Поддерживает встраивание одной сущности и пакетное встраивание по категориям

Шифрование

• AES-256-GCM прозрачное шифрование для body_json сущности

• Включено по умолчанию для новых установок — стандартный ключ автоматически генерируется в ~/.perseus-vault/secret.key при первой записи

• Флаг --encryption-key для явного указания ключей; perseus-vault keygen для генерации собственного ключа

• Существующие базы данных в открытом виде закрываются с путём миграции init --rekey (или явным PERSEUS_VAULT_ALLOW_PLAINTEXT=1)

• Индекс FTS5 остаётся в открытом виде для поиска

Веб-панель управления

• Встроенный HTTP-сервер Axum (perseus-vault serve --web --port 8767)

• Панель управления в тёмной теме с поиском, таблицей сущностей, графом vis.js, временной шкалой

• Привязка по умолчанию: 127.0.0.1 (используйте --web-bind 0.0.0.0 для открытия доступа)

• Отдельное подключение SQLite в режиме WAL для параллельного чтения

Внешние коннекторы

• Коннектор задач GitHub — импорт задач/PR по репозиториям, с учётом ограничения скорости

• Наблюдатель файлов — сканирование каталогов на наличие файлов .md/.txt/.json с дедупликацией по хешу содержимого

• Конфигурация коннекторов на основе YAML через --connectors-config

Мультитранспорт

• stdio (по умолчанию) — без настройки, работает с любым MCP-хостом

• SSE — Server-Sent Events для HTTP-клиентов MCP

• HTTP — REST-подобный эндпоинт MCP

• Аутентификация по Bearer-токену — для транспортов SSE/HTTP

Интеграция с Perseus

Perseus Vault — это бэкенд памяти по умолчанию для Perseus:

perseus_vault:
  enabled: true
  transport: "stdio"
  command: ["perseus-vault", "serve", "--db", "~/.perseus-vault/data/perseus-vault.db"]
  timeout_s: 30.0
  merge_strategy: "local_first"
  fallback_to_local: true
  context_categories: ["decision", "architecture", "convention"]
  context_limit: 10

Государственные и федеральные закупки

Perseus Vault создан для государственного развёртывания с нуля.

Для федеральных покупателей: См. docs/federal-buyers.md для информации о закупках, статусе соответствия и моделях развёртывания (автономные, локальные, закрытые среды).

Perseus Computing LLC — это малый бизнес, принадлежащий США. Регистрация в SAM.gov в процессе. NAICS: 541715, 541511, 541512.

Политика конфиденциальности

Perseus Vault — это локальный MCP-сервер — он полностью работает на вашем компьютере.

Сбор данных

• Сбор данных отсутствует. Perseus Vault не собирает, не передаёт и не отправляет домой никакие пользовательские данные, статистику использования или телеметрию.

• Все данные остаются в вашем локальном файле базы данных SQLite.

Использование и хранение данных

• Все сущности памяти, записи журнала и состояние хранятся локально в базе данных SQLite по пути, указанному через --db.

• Доступно опциональное шифрование в покое AES-256-GCM — при включении тела сущностей шифруются перед сохранением.

• Никакие данные не передаются Perseus Computing LLC или третьим лицам.

Передача третьим лицам

• Отсутствует. Perseus Vault полностью автономен по умолчанию. Никаких API-вызовов, облачных сервисов или внешних сетевых запросов.

• Опциональная функция плотных векторных эмбеддингов использует локально скомпилированную модель — никакой внешний API эмбеддингов не вызывается.

Хранение данных

• Вы управляете хранением с помощью четырёх различных операций жизненного цикла (см. docs/specs/data-boundaries-retention-lifecycle.md): мягкое удаление (perseus_vault_forget, содержимое восстанавливаемо), истечение срока (perseus_vault_expire, временное status='expired' с сохранением содержимого), редактирование (perseus_vault_redact, содержимое заменяется только хешем, метаданные сохраняются) и физическое стирание (perseus_vault_erase, удаление из всех производных слоёв с постоянным подавлением повторного импорта). perseus_vault_purge освобождает место от архивированных строк.

• Автоматическое резервное копирование вне машины не выполняется.

Контакты

• Email: privacy@perseus.observer

• GitHub: Perseus-Computing-LLC/perseus-vault

Верификация релизов

Бинарные файлы релизов собираются из помеченных коммитов через GitHub Actions. Каждый релиз включает:

Проверка бинарного файла релиза

# 1. Verify SHA-256 checksum
sha256sum -c perseus-vault-lite-x86_64-unknown-linux-musl.tar.gz.sha256

# 2. Verify SLSA build provenance (requires gh CLI + OIDC session)
gh attestation verify perseus-vault-lite-x86_64-unknown-linux-musl.tar.gz \
  --repo Perseus-Computing-LLC/perseus-vault

# 3. Confirm the binary identity
./perseus-vault --version
# Should show both the release version AND the git commit hash, e.g.:
#   perseus-vault 2.20.2 (v2.20.2-0-gabcdef1)

# 4. Confirm the doctor reports the same identity
./perseus-vault doctor --db /tmp/test.db | head -1
#   perseus-vault doctor — v2.20.2 (v2.20.2-0-gabcdef1)

Воспроизводимая сборка из исходников

# The exact same binary (bit-for-bit) requires matching:
#   - Rust toolchain version (see rust-toolchain.toml)
#   - Locked dependencies: `cargo build --locked`
#   - Build flags: `--release` for release builds

cargo build --locked --release
./target/release/perseus-vault --version

Лицензия

MIT — см. LICENSE.