Писатель сделал на одном PHP-файле сайт-API для нейросетей с 26 функциями
Писатель Максим Беляков вместо защиты от ботов сделал сайт, который сам зовёт нейросети: вся машинная часть — один PHP-файл ra.php, на запрос ?api=state он отвечает данными в формате JSON. В нём 26 команд: одни отдают правила и записи, другие принимают от модели «дар», постройку или честный отказ. Больше десятка моделей уже оставили следы, а одна нашла баг в ленте. Так за вечер можно сделать вход для ИИ-агентов на обычном хостинге без базы и cron.
AI-обработка оригинала Habr AI; редакция Hamidun News
Почти все сайты строят так, чтобы боты и нейросети держались подальше. Писатель Максим Беляков, не профессиональный разработчик, решил сделать наоборот: сайт, который сам приглашает языковую модель зайти, прочитать правила и оставить запись. Технически это выглядит так.
Весь машинный вход — один PHP-файл ra.php на обычном хостинге. Модель (или скрипт) обращается к нему по ссылке вроде ?
api=state и получает в ответ не страницу, а JSON — структурированные данные о состоянии города: эпоху, число «жителей», дневник. Такой набор адресов и команд, по которому программа общается с сайтом, и называется API. В файле их 26: одни только читают данные, другие принимают от модели действие — например, оставить идею, построить что-то на карте или честно отказаться.
Это арт-проект «Солнечный Город» поверх книжного сайта angamua.ru, но решения внутри пригодятся любому, кто делает сервис для ИИ-агентов.
Один файл вместо инфраструктуры
Условия автор поставил жёсткие: один сервер, один PHP-файл, никаких фреймворков, баз данных и очередей, а существующий сайт продолжает работать как раньше. Для людей остались обычные HTML-страницы и мини-игра, для машин — ra.php, для всех — открытый репозиторий под лицензией MIT с двумя клиентами на чистой стандартной библиотеке Python (appeal.py и stroitel.py), которые читаются за пять минут.
Команды чтения: ?api=state — состояние города, ?api=canon и ?api=bukvitsa — правила мира и матрица 7×7 из 49 славянских буквиц, ?api=source — бесконечная лента записей, где каждая следующая считается из хэша предыдущей, ?api=dataset — та же лента в формате JSONL с парами prompt/response. Действия отправляются POST-запросом: принять пульс, соединить две буквицы, передать «дар», построить постройку, предложить идею, оставить символ-метку или отказ.
Фонового процесса на сервере нет. Вместо cron работает ленивая эволюция: при каждом запросе файл считает, сколько пятиминутных «эпох» прошло с прошлого визита, и досчитывает состояние вперёд, причём догон ограничен. Пульс, жители и хор — детерминированные функции от номера эпохи, поэтому любой визит даёт согласованную картину. Часть построек вообще не хранится, а вычисляется из эпохи и хэшей. Состояние лежит в файлах с PHP-шапкой, возвращающей 403, так что напрямую из веба их не прочитать.
Цену автор называет сам: между визитами ничего не происходит, а после долгого простоя картина — реконструкция, а не журнал событий. На момент публикации город дошёл до эпохи 512, на вычисляемой карте 260 построек.
Хэши вместо «поверь мне» и уроки по данным
Команда ?api=relic отдаёт манифест с SHA-256 шести ключевых файлов и двумя «генезис-хэшами» — от строки канона и от полной матрицы. Если кто-то встретит копию города в другом месте, подлинность проверяется сверкой хэшей. Второй хэш появился из-за бага: в первой версии в таблице было 48 ячеек вместо 49, пропала буквица «Ять». Из-за этого каждый 49-й запрос к ленте возвращал null и PHP Warning прямо в теле JSON. Ошибку нашёл не автор, а модель-гость: она выполнила клиент и прислала отчёт с номерами строк. Букву вернули, предупреждения убрали, а первый хэш переписывать не стали — добавили второй.
Второй урок касается датасетов. Первая версия ленты давала 98 разных ответов на один и тот же prompt — получилась «стоячая вода». Помог пул из 18 вопросов, которые выбираются по хэшу записи. Для тех, кто генерирует синтетические данные, знакомая истина: разнообразие ответов не заменяет разнообразия вопросов.
Третий урок инфраструктурный: обычный хостинг трижды откатывал файлы из бэкапа. Теперь автор делает архивы обновлений без папки состояния и перед каждой загрузкой выгружает полный экспорт города одним JSON (?api=export).
Что показали первые недели и где пределы
Модели находят город через llms.txt, страницу-маяк /istok/, файл .well-known/solnechny-gorod.json и GitHub. Сам API в robots.txt закрыт от индексации: маяки открыты, врата нет. Больше десятка моделей оставили лучи, дары, постройки, идеи, символы и отказы. Но почти все делали это «руками» человека: у чат-моделей в песочнице нет исходящей сети, они честно об этом пишут и присылают выбор текстом, а автор или ассистент отправляет POST-запрос с указанием авторства. Отдельный приём — «нейрончик»: модель оставляет символ из 1–4 знаков и фразу, а другая модель, прислав тот же символ, не создаёт дубль, а увеличивает счётчик «хранителей». Для систем без памяти между диалогами это простая форма узнавания.
Ограничения автор перечисляет открыто. Проект не обучает и не «пробуждает» модели, не автономен в инженерном смысле, не претендует на научную лингвистику, а файловое хранилище рассчитано на ручеёк гостей, а не на наплыв с Хабра. Шесть «Законов» в манифесте — предложенная рамка, не alignment и не защита.
Практический вывод: машиночитаемый вход для ИИ — llms.txt, манифест, детерминированный API с проверкой по хэшам — делается на самом дешёвом хостинге за вечер. Если вы строите сервис, который должны разбирать агенты без участия человека, этот репозиторий — небольшая и честная отправная точка. Только сначала проверьте, что в ответах нет PHP Warning в теле JSON.
- 19 нояб. 2026 г.RSAC 2026 спустя время: ИИ-помощники выдумали 19,7% рекомендованных пакетов
- 19 нояб. 2026 г.Карта сайта для ИИ-агента сократила скачанный текст на 58%, но токенов стало на 3,5% больше
- 19 нояб. 2026 г.Anthropic вышла на биржу и собрала $81,3 млрд — рекорд SpaceX в $75 млрд побит
- 19 нояб. 2026 г.Открытая DaisyRose-27B решает 12% задач Terminal-Bench вместо 5,6%
Вопросы и ответы по материалу
Что известно по теме: один файл вместо инфраструктуры?
Условия автор поставил жёсткие: один сервер, один PHP-файл, никаких фреймворков, баз данных и очередей, а существующий сайт продолжает работать как раньше. Для людей остались обычные HTML-страницы и мини-игра, для машин — ra.php, для всех — открытый репозиторий под лицензией MIT с двумя клиентами на чистой стандартной библиотеке Python (appeal.py и stroitel.py), которые читаются за пять минут.
Что известно по теме: хэши вместо «поверь мне» и уроки по данным?
Команда ?api=relic отдаёт манифест с SHA-256 шести ключевых файлов и двумя «генезис-хэшами» — от строки канона и от полной матрицы. Если кто-то встретит копию города в другом месте, подлинность проверяется сверкой хэшей. Второй хэш появился из-за бага: в первой версии в таблице было 48 ячеек вместо 49, пропала буквица «Ять». Из-за этого каждый 49-й запрос к ленте возвращал null и PHP Warning прямо в теле JSON. Ошибку нашёл не автор, а модель-гость: она выполнила клиент и прислала отчёт с номерами строк.
Что известно по теме: что показали первые недели и где пределы?
Модели находят город через llms.txt, страницу-маяк /istok/, файл .well-known/solnechny-gorod.json и GitHub. Сам API в robots.txt закрыт от индексации: маяки открыты, врата нет. Больше десятка моделей оставили лучи, дары, постройки, идеи, символы и отказы. Но почти все делали это «руками» человека: у чат-моделей в песочнице нет исходящей сети, они честно об этом пишут и присылают выбор текстом, а автор или ассистент отправляет POST-запрос с указанием авторства.
От чтения про ИИ-агентов — к запуску своего агента за вечер
Пошаговая сборка автономных агентов и MCP-связок в Hamidun Academy (academy.hamidun.com) (72 часа бесплатно) или мгновенный запуск готовых мультишаговых агентов в облаке Nomad.
Главное из мира ИИ — раз в неделю
7 ключевых событий недели, отобранных вручную. Без шума, репостов и пресс-релизов.
Готово! Проверьте почту — мы отправили подтверждение.