Я переработал сайт [Neotoma](https://neotoma.io). Старая одностраничная стена текста теперь представляет собой визуальную презентацию, подкрепленную [полной документацией](https://neotoma.io/docs), руководствами по интеграции для конкретных инструментов и [подробными сведениями об архитектуре](https://neotoma.io/architecture). Большая часть изменений связана с тем, что тестировщик сказал или на чем застрял во время выпуска для разработчиков.

![Скриншот: герой домашней страницы Neotoma — значение реквизита и сеанс агента без уровня состояния](/images/posts/neotoma-site-overhaul-home-hero.png "скриншот")

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

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

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

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

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

Новые страницы вариантов использования для [инженеров инфраструктуры искусственного интеллекта](https://neotoma.io/ai-infrastructure-engineers), [разработчиков агентных систем](https://neotoma.io/agentic-systems-builders) и [отдельных операторов AI-native](https://neotoma.io/ai-native-operators), а также [сравнение моделей памяти](https://neotoma.io/memory-models) являются прямыми ответ.

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

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

Новая [страница моделей памяти](https://neotoma.io/memory-models) и [пошаговое руководство для разработчиков](https://neotoma.io/developer-walkthrough) решают оба вопроса.

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

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

Новая [страница установки](https://neotoma.io/install) и руководства по интеграции для [Курсор](https://neotoma.io/neotoma-with-cursor), [Claude](https://neotoma.io/neotoma-with-claude), [Claude Code](https://neotoma.io/neotoma-with-claude-code), [ChatGPT](https://neotoma.io/neotoma-with-chatgpt), [Codex](https://neotoma.io/neotoma-with-codex) и [OpenClaw](https://neotoma.io/neotoma-with-openclaw) решают эту проблему.

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

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

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

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

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

![Снимок экрана: таблица сравнения гарантий памяти на домашней странице Neotoma](/images/posts/neotoma-site-overhaul-memory-guarantees-table.png "скриншот")

| Недвижимость | Описание |
| -------- | ----------- |
| [Детерминированная эволюция состояния](https://neotoma.io/memory-guarantees#deterministic-state-evolution) | Одни и те же наблюдения всегда создают одно и то же состояние объекта независимо от порядка. Устраняет ошибки упорядочивания и делает переходы между состояниями тестируемыми. |
| [Версионная история](https://neotoma.io/memory-guarantees#versioned-history) | Каждое изменение создает новую версию вместо перезаписи. Более ранние состояния остаются доступными. |
| [Воспроизводимая временная шкала](https://neotoma.io/memory-guarantees#replayable-timeline) | Полную последовательность наблюдений можно воспроизвести с самого начала, чтобы реконструировать любое историческое состояние. |
| [Проверяемый журнал изменений](https://neotoma.io/memory-guarantees#auditable-change-log) | Каждая модификация записывает, кто ее сделал, когда и из какого источника. |
| [Ограничения схемы](https://neotoma.io/memory-guarantees#schema-constraints) | Сущности соответствуют определенным типам и правилам проверки. Неверно сформированные данные отклоняются, а не принимаются молча. |
| [Риск тихой мутации](https://neotoma.io/memory-guarantees#silent-mutation-risk) | Могут ли данные изменяться без явного уведомления. Платформенный, поисковый и файловый подходы несут в себе этот риск. Неотома предотвращает это. |
| [Риск противоречивых фактов](https://neotoma.io/memory-guarantees#conflicting-facts-risk) | Могут ли противоречивые утверждения сосуществовать незаметно. Neotoma помечает и разрешает конфликты вместо того, чтобы сохранять оба. |
| [Реконструкция воспроизводимого состояния](https://neotoma.io/memory-guarantees#reproducible-state-reconstruction) | Полное текущее состояние может быть восстановлено только на основе необработанных входных данных, так же, как бухгалтерская книга балансируется до нуля на основе своих записей. |
| [Возможность проверки человеком](https://neotoma.io/memory-guarantees#human-inspectability) | Вы можете точно изучить, что изменилось между любыми двумя версиями, и проследить происхождение каждого факта. |
| [Нулевая настройка](https://neotoma.io/memory-guarantees#zero-setup-onboarding) | Работает ли память с первого сообщения без установки. В памяти платформы это есть. Неотома нет. |
| [Поиск семантического сходства](https://neotoma.io/memory-guarantees#semantic-similarity-search) | Поиск соответствующего контекста по смыслу, а не по точному совпадению. И поисковые системы, и Neotoma обеспечивают это, но в разных масштабах. |
| [Прямое редактирование человеком](https://neotoma.io/memory-guarantees#direct-human-editability) | Можно ли открыть хранилище памяти в стандартном редакторе и изменить его напрямую. В файловых системах это есть. Неотома нет. |

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

### До и после

![Снимок экрана: раздел «До/после», показывающий ответы «не удалось» или «успешно»](/images/posts/neotoma-site-overhaul-before-after-section.png "скриншот")

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

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

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

### Для кого это

![Скриншот: три карточки аудитории с иллюстрациями на домашней странице Neotoma](/images/posts/neotoma-site-overhaul-audience-cards.png "скриншот")

Три карточки аудитории со специальными иллюстрациями: [инженеры инфраструктуры искусственного интеллекта](https://neotoma.io/ai-infrastructure-engineers), [строители агентных систем](https://neotoma.io/agentic-systems-builders) и [отдельные операторы, работающие с искусственным интеллектом](https://neotoma.io/ai-native-operators). Каждый из них ссылается на специальную страницу с режимами сбоя, типами данных и шаблонами схем, специфичными для этой аудитории. Это прямой ответ на вопрос: «Я один из тех, для кого это?»

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

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

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

![Снимок экрана: страница руководства для разработчиков, показывающая примеры многосессионного MCP](/images/posts/neotoma-site-overhaul-developer-walkthrough.png "скриншот")

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

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

![Снимок экрана: страница моделей памяти, показывающая платформу, извлечение, файловую и детерминированную память](/images/posts/neotoma-site-overhaul-memory-models.png "скриншот")

На странице [модели памяти](https://neotoma.io/memory-models) сравниваются четыре подхода: [память платформы](https://neotoma.io/platform-memory), [восстановительная память](https://neotoma.io/retrival-memory), [память на основе файлов](https://neotoma.io/file-based-memory) и [детерминированная память](https://neotoma.io/deterministic-memory). Вот где вопрос «должен ли Неотома заменить или дополнить мою существующую память?» вопрос получает ответ. У каждой модели есть отдельная подстраница, на которой объясняется, что это такое, где работает и где ломается.

### Фундаменты

![Снимок экрана: страница Foundation, показывающая обязательства по обеспечению конфиденциальности, детерминированные и кроссплатформенные обязательства](/images/posts/neotoma-site-overhaul-foundations.png "скриншот")

[Основы](https://neotoma.io/foundations) подробно описывают [конфиденциальность в первую очередь](https://neotoma.io/privacy-first), детерминированность и [кроссплатформенность](https://neotoma.io/cross-platform). Страница, посвященная конфиденциальности, отвечает тестировщикам, которые скептически относились к передаче личных данных в облачные инструменты искусственного интеллекта. Neotoma работает на вашем компьютере. Ваши данные остаются локальными.

### Архитектура

![Снимок экрана: страница архитектуры, показывающая диаграмму потока состояний](/images/posts/neotoma-site-overhaul-architecture-state-flow.png "скриншот")

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

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

Полная таблица конечных точек [REST API](https://neotoma.io/api), каталог [действия MCP](https://neotoma.io/mcp) и [ссылка на командную строку](https://neotoma.io/cli). Страница API содержит описания и параметры для каждой конечной точки. На странице MCP перечислены все 24 действия. Страница CLI охватывает все 38 команд.

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

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

- [ChatGPT](https://neotoma.io/neotoma-with-chatgpt)
- [Клод (Десктоп)](https://neotoma.io/neotoma-with-claude)
- [Код Клода](https://neotoma.io/neotoma-with-claude-code)
- [Кодекс](https://neotoma.io/neotoma-with-codex)
- [Курсор](https://neotoma.io/neotoma-with-cursor)
- [OpenClaw](https://neotoma.io/neotoma-with-openclaw)

![Скриншот: Руководство по интеграции Neotoma с Claude Code](/images/posts/neotoma-site-overhaul-integration-guide-claude-code.png "скриншот")

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

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

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

![Скриншот: страница аудитории инженеров инфраструктуры искусственного интеллекта, показывающая режимы сбоев и общие закономерности данных](/images/posts/neotoma-site-overhaul-audience-detail-ai-infrastructure.png "скриншот")

**[Инженеры инфраструктуры искусственного интеллекта](https://neotoma.io/ai-infrastructure-engineers).** Болевые точки, такие как невоспроизводимые запуски агентов, невидимые изменения состояния и отсутствие следов происхождения. Распространенные режимы отказа с конкретными значками. Типы данных, с которыми работают эти группы (состояние сеанса, конвейеры, оценки, журналы аудита), а также типы сущностей, которые встречаются чаще всего (agent_session, действие, конвейер, оценка).

**[Строители агентных систем](https://neotoma.io/agentic-systems-builders).** Аналогичная структура сосредоточена на платформах агентов, многоэтапных рабочих процессах и наблюдаемости. Режимы сбоя, такие как изменение состояния без вывода сообщений между сеансами, рабочие процессы, которые невозможно воспроизвести, и потеря контекста, когда один агент переключается на другого.

**[Отдельные операторы, работающие с искусственным интеллектом](https://neotoma.io/ai-native-operators).** Сосредоточено на ежедневном опыте потерянных обязательств, потере контекста между инструментами и личных данных в непрозрачной памяти поставщика. Это страница для тестировщика, который спросил: «Я один из тех, для кого это?»

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

![Снимок экрана: страница установки агента с инструкциями по копированию и вставке и демонстрацией сеанса агента](/images/posts/neotoma-site-overhaul-agent-install.png "скриншот")

Это новинка с момента объявления релиза разработчиком. Вместо чтения документации и настройки вручную вы копируете одно приглашение со [страницы установки](https://neotoma.io/install), вставляете его в свой инструмент 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](https://neotoma.io), попросите своего агента [установить](https://neotoma.io/install) с инструкциями по копированию и вставке и поделитесь своим отзывом. Откройте проблему на [GitHub](https://github.com/markmhendrickson/neotoma) или свяжитесь напрямую.