Фраза ai-memory для coding agents обозначает хорошо известный вид отказа. Сеанс CLI для программирования завершается, другой агент открывает ту же рабочую копию, а полезный контекст исчезает. Репозиторий akitaonrails/ai-memory устраняет этот пробел с помощью постоянной вики, наблюдений за жизненным циклом и ограниченной передачи контекста. В этой статье рассматриваются только документация репозитория и вопросы, на которые следует ответить, прежде чем сохранять историю проекта локально.
Репозиторий появился в снимке GitHub Daily Trending, предоставленном для 2026-08-18. Это контекст, актуальный на указанную дату, а не утверждение о долгосрочной популярности. Снимок GitHub API указывает на публичный репозиторий Rust в ветке main с MIT license. Видимый на момент исследования список релизов включал v1.28.0, опубликованный 2026-08-17. Эти значения могут меняться, поэтому воспринимайте их как зафиксированные по времени данные из источника.
Модель памяти: вики рядом с рабочей копией
В README описывается общая вики, сформированная на основе очищенных наблюдений за жизненным циклом. Её страницы представлены в виде Markdown-файлов в git-репозитории. В архитектурной документации Markdown описан как источник истины, а SQLite — как индекс и операционное хранилище. В руководстве по использованию сказано, что сервис не затрагивает файлы в репозитории кода пользователя; вики и её каталог данных отделены.
Эта граница важна, когда агент вспоминает прежнее решение. Текущая рабочая копия, тесты и поведение во время выполнения остаются авторитетным источником сведений о коде. Вики может сохранить решение, неудачный подход или вопрос для следующего сеанса. Историческая страница остаётся историческим свидетельством, а не разрешением изменять код или раскрывать секрет.
Что пересекает границу сессии
Документированный путь жизненного цикла может фиксировать ограниченные промпты, события жизненного цикла инструментов, контрольные точки сжатия и границы сессий. При запуске следующей сессии ожидающую передачу контекста можно представить поддерживаемому клиенту. Необязательный лаунчер управляемых рабочих потоков добавляет переносимый журнал видимых событий и нативное возобновление работы для каждого harness. В README Codex указан среди клиентов в матрице поддержки, однако это остаётся заявлением репозитория, а не независимым тестом совместимости.
Полезная передача контекста должна быть достаточно краткой, чтобы её можно было проверить. Для реального проекта запишите:
Цель и точная часть процесса оформления заказа, подлежащая изменению;
уже принятые решения и причины каждого из них;
команды или тесты, которые успешно выполнены, завершились с ошибкой или ещё требуют запуска;
Открытые вопросы, известные риски и следующие безопасные действия;
ссылки на соответствующие файлы или обсуждение задачи без копирования секретов.
Это рекомендация по написанию текста, а не утверждение о том, что ai-memory генерирует каждый элемент автоматически. Функционал и поведение клиента различаются в зависимости от интеграции, поэтому перед использованием той или иной функции ознакомьтесь с соответствующими примечаниями службы поддержки.
Поиск и воспроизведение информации не являются интеллектуальным анализом кода
В описанном пути поиска используются FTS5, объявленные сущности, расширение связанных страниц и опциональный векторный поиск. Необязательный LLM ранжировщик может изменить порядок ограниченного набора заголовков и фрагментов текста. Ничто из этого не заменяет рабочую копию или инструмент структурного анализа кода. Прежде чем действовать на основе старой страницы, сопоставьте её с текущим исходным кодом, результатами сборки, тестами и наблюдаемым поведением во время выполнения.
Это важно, когда в передаче контекста говорится, что существуют символ, зависимость или значение конфигурации. Рассматривайте страницу как указатель для дальнейшего изучения. Её ранг, пространство имён, закрепление или тег source-of-truth не доказывают, что текст актуален.
Локальные данные и конфиденциальность: ознакомьтесь с моделью угроз
SECURITY.md сопровождающего прямо говорит о своих limit. В нём описывается однопользовательская служба для рабочей станции или домашней лаборатории. Файлы вики и база данных SQLite размещаются в одном каталоге данных, контролируемом пользователем операционной системы. Новые каталоги и файлы Unix получают разрешения только для владельца, однако существующие установки не подвергаются chmod автоматически. Windows использует ACL файловой системы.
В той же политике говорится, что v1 не добавляет шифрование данных в состоянии покоя. Пользователи базы данных обеспечивают атрибуцию, а не приватную память: ACL для отдельных пользователей или проектов отсутствуют. Таким образом, общий сервер остаётся одним доменом trust. Если операторы не должны видеть историю друг друга, документированной границей являются отдельные серверы или каталоги данных, а не настройка, превращающая вики в многопользовательское хранилище.
Сетевое предоставление доступа требует отдельной проверки. В кратком руководстве по началу работы по умолчанию используется loopback. Привязка к адресу, отличному от loopback, требует токена аутентификации и стандартных средств сетевой защиты; аутентификация по bearer-токену не шифрует соединение, поэтому политика рекомендует TLS-прокси. Список разрешённых host защищает от неожиданного заголовка Host, но не заменяет правила брандмауэра.
Сбор данных является выбором, а не бесплатной функцией обеспечения конфиденциальности. Проект документирует исключения для сбора данных на основе путей и двойное согласие на использование текста ассистента или Stop. Санитизация выполняется по мере возможности. Если вы активируете поставщика LLM, захваченный или отредактированный вручную контент может быть отправлен этому поставщику во время консолидации, проверки, встраивания или, при необходимости, переранжирования. Политика безопасности рекомендует отключать функцию переранжирования в облаке или использовать локального провайдера, если запросы или отозванные фрагменты должны оставаться на сервере.
Прежде чем активировать обработчик событий, задайте себе четыре вопроса: какие тела событий сохраняются, где хранится резервная копия каталога данных, кто может связаться с сервером и какой поставщик получает текст. Сохраните ответы в руководстве по реализации проекта. Не вставляйте API-ключи или необработанные расшифровки в передачу контекста лишь для удобства следующей сессии.
Консервативное развёртывание для команды разработчиков
Начните с одной рабочей станции с привязкой к loopback и режимом без LLM. Проверьте файлы вики и созданную передачу контекста после короткой задачи, не содержащей конфиденциальных данных. Добавьте исключения для сбора данных для каталогов, которые никогда не должны попадать в локальный буфер. Затем решите, оправдывают ли сводки, эмбеддинги или переранжирование использование внешнего провайдера, и задокументируйте это решение.
Только после того, как локальный сценарий будет понятен, следует рассматривать развёртывание в LAN или домашней лаборатории. Создайте токен, настройте список разрешённых host, разместите TLS перед сервисом и проверьте владельца файловой системы для каталога данных и резервных копий. В общей среде проверяйте атрибуцию и помните, что политика по-прежнему описывает один домен trust. Эти проверки основаны на опубликованной модели угроз; они не являются сертификацией безопасности.
Где подходит OdiRouter, а где нет
OdiRouter не является проектом ai-memory. В его официальной документации есть отдельное руководство по настройке Codex CLI с поставщиком OdiRouter и Responses API. Это руководство актуально, если вы отдельно выбираете, каким образом Codex отправляет запросы к модели, однако оно не подтверждает, что OdiRouter хранит, передаёт или поддерживает передачи ai-memory.
Для этого независимого пути настройки ознакомьтесь с текущим OdiRouter Codex CLI guide. Политику обработки данных службы памяти и политику обработки данных поставщика моделей следует рассматривать как два отдельных пункта проверки.
Чего не подтверждают имеющиеся данные
Репозиторий и сохранённые страницы OdiRouter не содержат подтверждённых данных о трафике, объёме ключевых запросов, количестве обратных ссылок, темпах внедрения, бенчмарках, требованиях к оборудованию, цене или независимой оценке безопасности для этой статьи. Они также не доказывают совместимость с любым CLI для программирования или любым поставщиком моделей. Не восполняйте эти пробелы счётчиками GitHub или значком релиза.
Источники и примечание по сопровождению
При изменении проекта используйте первичные файлы:
README и матрица поддержки: https://github.com/akitaonrails/ai-memory/blob/main/README.md
Архитектура: https://github.com/akitaonrails/ai-memory/blob/main/docs/ARCHITECTURE.md
Руководство по использованию и конфиденциальности: https://github.com/akitaonrails/ai-memory/blob/main/docs/usage.md
Политика безопасности: https://github.com/akitaonrails/ai-memory/blob/main/SECURITY.md
License: https://github.com/akitaonrails/ai-memory/blob/main/LICENSE
Перед изменением этой страницы повторно проверьте README, SECURITY.md и примечания к релизу. Новый релиз может изменить поведение хуков или границы данных, а датированный контекст Trending никогда не должен становиться постоянным утверждением.