Интенсив 21–22.11 · БесплатноБесплатный 2-дневный интенсив по вайбкодингу 21–22 ноября в 16:00 МСК (Сб–Вс) · Живой Поток 3 стартует 23.11Записаться бесплатно →Поток 3 (23.11)
РелизAPI / Продукт · В работуHabr AI→ оригинал

Писатель сделал на одном PHP-файле сайт-API для нейросетей с 26 функциями

Писатель Максим Беляков вместо защиты от ботов сделал сайт, который сам зовёт нейросети: вся машинная часть — один PHP-файл ra.php, на запрос ?api=state он отвечает данными в формате JSON. В нём 26 команд: одни отдают правила и записи, другие принимают от модели «дар», постройку или честный отказ. Больше десятка моделей уже оставили следы, а одна нашла баг в ленте. Так за вечер можно сделать вход для ИИ-агентов на обычном хостинге без базы и cron.

AI-обработка оригинала Habr AI; редакция Hamidun News
Писатель сделал на одном PHP-файле сайт-API для нейросетей с 26 функциями
Источник: Habr AI. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникHabr AI ↗
Главный редактор
Ключевой факт #1Состояние лежит в файлах с PHP-шапкой, отдающей 403, — из веба их не прочитать
Ключевой факт #2Лента с одним вопросом дала 98 ответов на него; пул из 18 вопросов исправил это
Ключевой факт #3SHA-256 шести файлов в ?api=relic позволяет проверить подлинность копии города

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

Весь машинный вход — один 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.

Сюжет

Вопросы и ответы по материалу

Что известно по теме: один файл вместо инфраструктуры?

Условия автор поставил жёсткие: один сервер, один 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-запрос с указанием авторства.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ ИИ-агенты на практике · Академия & Nomad

От чтения про ИИ-агентов — к запуску своего агента за вечер

Пошаговая сборка автономных агентов и MCP-связок в Hamidun Academy (academy.hamidun.com) (72 часа бесплатно) или мгновенный запуск готовых мультишаговых агентов в облаке Nomad.

Попробовать Академию (72ч бесплатно) →Запустить Nomad Agent
Что вы думаете?
Загружаем комментарии…