Обновление сайта Neotoma с учетом отзывов разработчиков о выпуске

Я переработал сайт Neotoma. Старая одностраничная стена текста теперь представляет собой визуальную презентацию, подкрепленную полной документацией, руководствами по интеграции для конкретных инструментов и подробными сведениями об архитектуре. Большая часть изменений связана с тем, что тестировщик сказал или на чем застрял во время выпуска для разработчиков.

Что мне рассказал отзыв

С момента объявления о выпуске для разработчиков я собрал отзывы примерно от дюжины тестировщиков через звонки, чат, электронную почту и записи экрана. Настроение было обнадеживающим. Один человек назвал это «очень актуальной проблемой» и отметил, что «большинство людей сейчас решают свои проблемы». Другой сказал, что это похоже на проблему, которую стоит решить. Кого-то другого просто выкачали, и он вышел на волю.

Но самый полезный отзыв был о том, где люди застряли:

«Для кого это и зачем мне это использовать?»

Несколько человек спросили об этом напрямую. Старый сайт отличался архитектурой и абстракциями. Тестировщикам в первую очередь нужна была острая, специфическая боль. Один сравнил это с продажей витаминов вместо обезболивающего. Другой прямо спросил: «Я один из тех, для кого это?» Сайту нужно было ответить на этот вопрос в первые несколько секунд.

Новые страницы вариантов использования для инженеров инфраструктуры искусственного интеллекта, разработчиков агентных систем и отдельных операторов AI-native, а также сравнение моделей памяти являются прямыми ответ.

«Это заменяет мою существующую память или живет рядом с ней?»

Технический тестер спросил, должна ли Neotoma быть основной системой памяти или находиться рядом с такими вещами, как автопамять Клода Кода. Другой спросил, как работает прием: регулярное выражение, оценка ИИ или агент, заполняющий параметры инструмента? На старом сайте ничего подобного не было. Архитектура и механика были разбросаны по README и репозиториям.

Новая страница моделей памяти и пошаговое руководство для разработчиков решают оба вопроса.

«Как мне это настроить с помощью моего инструмента?»

Один из тестировщиков запускал Neotoma с CLI, но спросил: «Значит, он не работает с OpenClaw?» потому что список клиентов на сайте был неясен. Другой столкнулся с ошибкой «модуль не найден» при попытке запустить API. Третий потратил час на чтение документации по новой виртуальной машине и отметил неработающую ссылку в указателе документации, а также неожиданные всплывающие окна с разрешениями macOS. Инструкции по установке были скрыты и различались в зависимости от инструмента, а в фрагменте установки на сайте отсутствовала прямая ссылка на то, что происходит после инициализации.

Новая страница установки и руководства по интеграции для Курсор, Claude, Claude Code, ChatGPT, Codex и OpenClaw решают эту проблему.

Положительный сигнал под всем этим: несколько тестировщиков заставили Neotoma работать и проверили, что она правильно сохраняет и извлекает данные. Один подтвердил, что он «сохраняет данные, когда я спрашиваю, и могу проверить с помощью CLI». Ядро работает. Сайт и онбординг не помогли.

Домашняя страница

Домашняя страница теперь имеет девять отдельных разделов вместо одной длинной прокрутки. Три, которые наиболее непосредственно реагируют на обратную связь:

Таблица гарантий памяти

Таблица гарантий памяти — это ответ на вопрос «чем это отличается?» Сравнение памяти платформы (Claude, ChatGPT), поисковых систем (Mem0, Zep, LangChain Memory), файловых подходов (Markdown, магазины JSON) и Neotoma по 12 свойствам:

Недвижимость	Описание
Детерминированная эволюция состояния	Одни и те же наблюдения всегда создают одно и то же состояние объекта независимо от порядка. Устраняет ошибки упорядочивания и делает переходы между состояниями тестируемыми.
Версионная история	Каждое изменение создает новую версию вместо перезаписи. Более ранние состояния остаются доступными.
Воспроизводимая временная шкала	Полную последовательность наблюдений можно воспроизвести с самого начала, чтобы реконструировать любое историческое состояние.
Проверяемый журнал изменений	Каждая модификация записывает, кто ее сделал, когда и из какого источника.
Ограничения схемы	Сущности соответствуют определенным типам и правилам проверки. Неверно сформированные данные отклоняются, а не принимаются молча.
Риск тихой мутации	Могут ли данные изменяться без явного уведомления. Платформенный, поисковый и файловый подходы несут в себе этот риск. Неотома предотвращает это.
Риск противоречивых фактов	Могут ли противоречивые утверждения сосуществовать незаметно. Neotoma помечает и разрешает конфликты вместо того, чтобы сохранять оба.
Реконструкция воспроизводимого состояния	Полное текущее состояние может быть восстановлено только на основе необработанных входных данных, так же, как бухгалтерская книга балансируется до нуля на основе своих записей.
Возможность проверки человеком	Вы можете точно изучить, что изменилось между любыми двумя версиями, и проследить происхождение каждого факта.
Нулевая настройка	Работает ли память с первого сообщения без установки. В памяти платформы это есть. Неотома нет.
Поиск семантического сходства	Поиск соответствующего контекста по смыслу, а не по точному совпадению. И поисковые системы, и Neotoma обеспечивают это, но в разных масштабах.
Прямое редактирование человеком	Можно ли открыть хранилище памяти в стандартном редакторе и изменить его напрямую. В файловых системах это есть. Неотома нет.

Каждая строка ведет на специальную страницу объяснений с примерами «до» и «после», а также кодом CLI. Один из тестировщиков заметил, что «общее хранилище со схемами не решено» и что ответом могут быть популярные схемы. Таблица гарантий — это мой ответ: вот конкретные свойства, здесь каждый подход работает, а здесь нет.

До и после

Вступительная анимация циклически повторяет один и тот же вопрос, приводя к двум результатам. Без Неотомы: «Контракта для Кляйна не найдено». С Неотомой: «Net-30, подписанный 12 октября, автоматически продлевает первый квартал». Поочередно чередуются одиннадцать сценариев, каждый из которых с первого взгляда демонстрирует реальный режим отказа.

Под анимацией четыре карточки неудач разбивают сценарии по типам данных: финансовые факты, люди и отношения, обязательства и задачи, события и решения. У каждой карточки есть конкретное повествование: устаревшие контакты передаются не тому человеку, забытые сроки вызывают напоминания о старых задачах, противоречивые записи, в которых два агента читали разные версии одного и того же контракта и ни один из них не знал о существовании другого.

Это был прямой ответ на отзыв «витамины против обезболивающих». Старый сайт лидировал с архитектурой. В этом разделе рассказывается о том, что нарушается без детерминированного состояния и чего это вам стоит.

Для кого это

Три карточки аудитории со специальными иллюстрациями: инженеры инфраструктуры искусственного интеллекта, строители агентных систем и отдельные операторы, работающие с искусственным интеллектом. Каждый из них ссылается на специальную страницу с режимами сбоя, типами данных и шаблонами схем, специфичными для этой аудитории. Это прямой ответ на вопрос: «Я один из тех, для кого это?»

Документация

На старом сайте все было встроено. Тестировщикам, которым нужна была глубина, пришлось обратиться в репозиторий. Теперь есть специальные страницы, организованные в виде боковой панели навигации.

Пошаговое руководство для разработчиков

Пошаговое руководство для разработчиков — это многосессионный сценарий, который проходит через основной цикл: сохраняет архитектурное решение в сеансе 1, извлекает его и действует на его основании во втором сеансе, обрабатывает конфликтующее обновление в сеансе 3, а затем проверяет полный след наблюдения. Все они используют MCP (протокол контекста модели) и хранят вызовы с реальными примерами запросов/ответов. Это напрямую решает вопрос приема: агент вызывает инструмент MCP со структурированными параметрами, Neotoma сохраняет наблюдение. Никаких скрытых вызовов моделей ИИ, никакого извлечения регулярных выражений.

Модели памяти

На странице модели памяти сравниваются четыре подхода: память платформы, восстановительная память, память на основе файлов и детерминированная память. Вот где вопрос «должен ли Неотома заменить или дополнить мою существующую память?» вопрос получает ответ. У каждой модели есть отдельная подстраница, на которой объясняется, что это такое, где работает и где ломается.

Фундаменты

Основы подробно описывают конфиденциальность в первую очередь, детерминированность и кроссплатформенность. Страница, посвященная конфиденциальности, отвечает тестировщикам, которые скептически относились к передаче личных данных в облачные инструменты искусственного интеллекта. Neotoma работает на вашем компьютере. Ваши данные остаются локальными.

Архитектура

Страница architecture описывает поток состояний (источник, наблюдение, объект, снимок объекта), уровни и то, как гарантии применяются на каждом этапе. Это было одно из самых востребованных дополнений.

Справочные страницы

Полная таблица конечных точек REST API, каталог действия MCP и ссылка на командную строку. Страница API содержит описания и параметры для каждой конечной точки. На странице MCP перечислены все 24 действия. Страница CLI охватывает все 38 команд.

Руководства по интеграции

Шесть страниц, посвященных конкретным инструментам, каждая из которых описывает настройку от установки до первого сохранения:

Это прямой ответ на вопрос «работает ли это с X?» и «как мне это настроить с помощью моего инструмента?» В каждом руководстве описывается конфигурация, пример первого запуска и чего ожидать. Страница ChatGPT является наиболее подробной, поскольку настройка пользовательского GPT содержит больше всего шагов. Страница OpenClaw существует потому, что тестер специально спросил, поддерживается ли она, а старый сайт был неоднозначным.

Варианты использования

Три специальные страницы для аудитории теперь освещают и объясняют, для кого предназначена Neotoma, предоставляя рекомендации по таргетингу, которых не хватало на старой домашней странице:

Инженеры инфраструктуры искусственного интеллекта. Болевые точки, такие как невоспроизводимые запуски агентов, невидимые изменения состояния и отсутствие следов происхождения. Распространенные режимы отказа с конкретными значками. Типы данных, с которыми работают эти группы (состояние сеанса, конвейеры, оценки, журналы аудита), а также типы сущностей, которые встречаются чаще всего (agent_session, действие, конвейер, оценка).

Строители агентных систем. Аналогичная структура сосредоточена на платформах агентов, многоэтапных рабочих процессах и наблюдаемости. Режимы сбоя, такие как изменение состояния без вывода сообщений между сеансами, рабочие процессы, которые невозможно воспроизвести, и потеря контекста, когда один агент переключается на другого.

Отдельные операторы, работающие с искусственным интеллектом. Сосредоточено на ежедневном опыте потерянных обязательств, потере контекста между инструментами и личных данных в непрозрачной памяти поставщика. Это страница для тестировщика, который спросил: «Я один из тех, для кого это?»

Установка под управлением агента

Это новинка с момента объявления релиза разработчиком. Вместо чтения документации и настройки вручную вы копируете одно приглашение со страницы установки, вставляете его в свой инструмент AI, а агент выполняет все остальное: устанавливает пакет, запускает инициализацию, настраивает соединение MCP и сохраняет ваши первые данные.

Приглашение предназначено для Claude Code, Codex, Cursor и OpenClaw. Он сообщает агенту установить Neotoma с помощью npm install -g neotoma, инициализировать его, а затем связать соответствующее руководство по интеграции для этого инструмента. Агент сканирует ваш локальный контекст и память платформы, просматривает то, что он нашел, и сохраняет только то, что вы одобряете.

Каждое руководство по интеграции содержит ссылку на приглашение на установку, поэтому путь подключения одинаков, независимо от того, с какого инструмента вы начинаете. Цель состоит в том, чтобы перейти от нуля к работающей настройке Neotoma с сохранением реальных данных менее чем за пять минут, даже не читая документацию по конфигурации.

Языковая поддержка

Сайт и весь контент публикаций теперь автоматически переводятся на 12 языков: арабский, бенгальский, каталанский, французский, немецкий, хинди, индонезийский, китайский, португальский, русский, испанский и урду. На каждой странице есть переключатель языка, а макеты с письмом справа налево подходят для арабского языка и урду.

Это важно, поскольку версия для разработчиков достигла тестировщиков за пределами англоязычных рынков. Вместо того, чтобы объединять документацию на одном языке, каждая страница — домашняя страница, гарантии памяти, руководства по интеграции, страницы вариантов использования и публикации — доступна во всех 12 локалях. Переводы генерируются автоматически и могут быть не идеальными, но они снижают барьер для любого, кто оценивает Neotoma на своем основном языке.

Что дальше

В результате капитального ремонта сайта устранены пробелы в представлении и документации. Следующий этап работы направлен на устранение недостатков продукта, обнаруженных тестировщиками.

Внедрение через агента. Текущий процесс установки позволяет выполнить настройку, но он пассивный. Устанавливаешь, инициализируешь, начинаешь хранить. Следующая версия будет представлять собой управляемый процесс обнаружения, в котором ваш агент сканирует ваши локальные файлы, предлагает наиболее ценных кандидатов и восстанавливает временную шкалу на основе ваших собственных данных в течение первых нескольких минут. Цель — конкретный момент, когда вы увидите, как разбросанные файлы проекта превращаются в структурированную временную шкалу, где каждое событие отслеживается до определенного источника. В этот момент становится очевидной разница между Неотомой и чат-памятью.
Экспорт записей Markdown. Некоторые разработчики, особенно из Claude Code, ожидают, что память будет представлена в виде файлов уценки, которые они смогут просматривать и редактировать напрямую. Neotoma использует SQLite в качестве канонического хранилища, что дает вам детерминированные запросы и ограничения схемы, но означает, что вы не можете просто открыть файл в своем редакторе. Я добавляю команду для экспорта ваших записей в виде файлов уценки на диске, организованных по типу объекта, с метаданными и происхождением. SQLite остается каноническим. Файлы уценки представляют собой удобное для чтения зеркало, обеспечивающее прозрачность и возможность проверки.
Более плавный удаленный доступ для ChatGPT и Claude. Руководства по интеграции уже существуют, но пути удаленной настройки для ChatGPT (пользовательский GPT с конечной точкой API) и Claude (рабочий стол с удаленным MCP) требуют дополнительной проверки и отладки, прежде чем они станут такими же гладкими, как локальные пути для Cursor и Claude Code. Я хочу обеспечить надежную комплексную работу и обновить руководства, добавив более четкие инструкции и способы устранения неполадок.

О чем я хочу получить отзыв

Релиз для разработчиков все еще активен. Если вы попробуете установить Neotoma и работать через сайт, хочу знать:

Позиция ясна? Когда вы попадаете на домашнюю страницу, понимаете ли вы, что делает Neotoma и чем она отличается от того, что вы уже используете?
Помогает ли вам таблица гарантий памяти решить, подходит ли Neotoma для вашего рабочего процесса?
Ясен ли путь установки и адаптации? Можете ли вы перейти с сайта на рабочую установку, не упираясь в стену?
Соответствуют ли руководства по интеграции вашему инструменту?

Посетите neotoma.io, попросите своего агента установить с инструкциями по копированию и вставке и поделитесь своим отзывом. Откройте проблему на GitHub или свяжитесь напрямую.

Ключевые выводы