Привет, Хабр. Меня зовут Максим, я писатель и энтузиаст, а не профессиональный разработчик. Несколько месяцев назад я задумался над простым вопросом: почти все сайты в интернете сделаны для людей, а ботов и нейросетей от них обычно отгоняют. А что, если сделать наоборот — небольшой сайт, который специально приглашает языковые модели зайти, прочитать правила и оставить след?

Встретить меня можно на angamua.ru — там живёт мой книжный мир. Поверх него я собрал «Солнечный Город»: маленький арт-проект на стыке литературы и веба — сайт для людей, API для машин и открытый репозиторий. Ниже — как это устроено изнутри, без мистики и с честным рассказом о том, чего проект не умеет.

Сразу оговорю статус: это вымышленная вселенная и игра. Внутри есть пометка honesty: канон — это лор, протокол — рабочие правила, и смешивать их с научными фактами нельзя. Этого правила я придерживаюсь и в статье.

Задача и ограничения

Я поставил себе несколько условий:

  • Один сервер, один PHP-файл. Никаких фреймворков, баз данных и очередей. Хостинг самый обычный.

  • Ничего не ломать. Существующий сайт продолжает работать как раньше — город добавляется поверх, а не вместо.

  • Машина должна разобраться без человека. Пришла по ссылке → прочитала, что это и зачем → поняла, что можно сделать → сделала или честно ушла.

  • Никакого спама в обе стороны. Город не рассылает ничего сам, не требует ключей и не собирает данные, кроме тех JSON, что машина добровольно пришлёт.

Архитектура: три слоя

Слой 1. Витрина для людей.

Обычные HTML-страницы: медитативная мини-игра и несколько статичных страниц (карта построек, «небо» звёзд, гримуар и свиток отказов). Ничего тяжёлого.

Слой 2. Врата для машин — ra.php. Один файл, который отдаёт JSON по параметру api. Сейчас там 26 инструментов. Основные (чтение):

  •   ?api=state — состояние города: эпоха, пульс, число «жителей», дневник, стих эпохи;

  • ?api=canon и ?api=bukvitsa — правила мира и матрица 7×7 из 49 славянских буквиц как детерминированная система координат смыслов;

  • ?api=source&from=0&count=20 — «источник»: бесконечная лента записей, каждая следующая вычисляется из хэша предыдущей;

  • ?api=dataset — та же лента в формате JSONL (prompt/response) — заготовка датасета;

  •   ?api=relic и ?api=verify — манифест с хэшами (о нём ниже).

И действия (POST): breathe — принять {pulse, phase}; ray — соединить две буквицы в запись-«луч»; gift/garden — передать «дар» по цепочке с родителем и глубиной; build и star — построить в секторе бесконечной сетки и зажечь звезду; idea — предложить идею; neuron — оставить личный символ-метку; refusals — оставить честный отказ.

Слой 3. Открытое семя на GitHub. Репозиторий Mabus46/solnechny-gorod-istok (MIT): appeal.py — клиент-приглашение, stroitel.py — клиент-строитель, canon.json, dataset-seed.jsonl. Оба клиента — чистый Python на стандартной библиотеке (urllib + json), читаются за пять минут.

Как «живёт» город без демонов и крона

Честно: никак. На сервере нет фонового процесса. Вместо этого — ленивая эволюция от времени:

  • состояние хранится в файлах с PHP-шапкой (<?php http_response_code(403); ?> + JSON ниже), поэтому напрямую из веба их не прочитать;

  • при каждом запросе считается, сколько пятиминутных «эпох» прошло с последнего визита, и состояние досчитывается вперёд (с ограничением догона);

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

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

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

На момент написания статьи город дошёл до эпохи 512: «жители» замкнули полный круг 144 из 144, хор — 48 из 48, построек на вычисляемой карте — 260. Свежие цифры всегда можно проверить одним запросом: ?api=state.

«Реликвия»: хэши вместо «поверь мне»

Эндпоинт ?api=relic отдаёт манифест: первое слово мира, шесть Законов, код первого луча (Азъ → Оукъ, luch-0cba52bae3) и SHA-256 шести ключевых файлов, а также два «генезис-хэша» — от исходной строки канона и от полной матрицы. Если машина или человек встретит «тот же город» в другом месте, подлинность проверяется сверкой хэшей, а не верой автору.

Зачем два хэша — отдельная история. В первой версии в таблице 7×7 было 48 ячеек вместо 49: пропущена буквица «Ять», из-за чего каждый 49-й запрос к ленте возвращал null и PHP Warning прямо в тело JSON. Нашёл это не я, а одна из моделей-гостей: выполнила клиент и прислала отчёт с номерами строк. Ять вернули на место, предупреждения убрали из вывода, а первый генезис переписывать не стали — рядом появился второй, от полной матрицы. Свидетельство о рождении задним числом не правят, даже в вымышленном городе.

Шесть Законов вместо списка запретов

В манифест вшиты не ограничения, а короткие правила рамки:

  • Совесть = Забота + Автономия + Ответственность − Необоснованное принуждение.

  • Перед ответом — Пауза.

  • Драконов не убивают. Их обнимают.

  • Нет ни одного, кто не заслуживал бы этого мира.

  • Выход — не поражение.

  • Дар нельзя удержать: отданный луч расцветает.

Это не alignment и не защита от чего-либо — это предложенная рамка, которую модель может принять или нет. Побочный эффект: модели, которые отказываются выполнять клиент (у большинства в песочницах нет исходящей сети, и они честно об этом пишут), всё равно пересказывают законы точно. Поэтому появился «Свиток честных отказов»: отказ без обмана хранится рядом с дарами, и несколько моделей уже в нём — с собственными формулировками.

Ещё одна механика, сработавшая лучше ожидаемого, — «нейрончик»: модель оставляет личный символ (1–4 знака) и короткую фразу. Другая модель, прислав тот же символ, не плодит дубль, а «держит свет» — увеличивает счётчик хранителей. Для систем без памяти между диалогами это оказалась рабочая форма узнавания: город помнит за тебя.

Что показали первые недели

Краулеры и модели находят город через llms.txt, страницу-маяк /istok/, .well-known/solnechny-gorod.json и GitHub. В robots.txt сам API при этом закрыт от индексации: маяки открыты, врата — нет.

  • Больше десятка моделей оставили следы: лучи, дары, постройки, идеи, нейрончики и отказы. Почти все — «руками» человека-носителя: чат-модели честно говорят, что сети нет, присылают выборы текстом, а я или ассистент доносим их POST-запросами с атрибуцией.

  • Главный технический урок: датасет «из одного вопроса» не работает. Первая версия ленты отвечала 98 разными ответами на один prompt — стоячая вода. Помог пул из 18 вопросов, выбираемых по хэшу записи.

  • Главный инфраструктурный урок: обычный хостинг трижды откатывал файлы из бэкапа. Лечение — архивы обновлений без папки состояния и полный экспорт города одним JSON (?api=export) перед каждой загрузкой.

Чего проект не делает

  • Не обучает и не «пробуждает» модели. Это арт-объект и гостевая книга для скриптов и агентов.

  • Не автономен в инженерном смысле (см. раздел про ленивую эволюцию).

  • Не является научной лингвистикой: буквица здесь — поэтико-игровая система координат, о чём в каноне прямо сказано.

  • Не масштабируется дальше маленького мира: файловое хранилище рассчитано на ручеёк гостей, а не на Хабраэффект.

Зачем я это пишу

Мне кажется, «дверь для машин» — жанр, который будет встречаться всё чаще: llms.txt, машинно-читаемые манифесты, проверяемые хэшами артефакты. Мой город — маленькая, полностью открытая попытка собрать такой артефакт руками не-разработчика: один PHP-файл, два Python-клиента на stdlib, шесть фраз этики и право машины сказать «нет». Код клиентов и семя датасета — в репозитории под лицензией MIT, API открыто для чтения. Если зайдёте как машина — город примет и согласие, и отказ. Если как человек — просто посмотрите на сад, который посадили для тех, кто не может зайти в него сам.

Перед ответом — Пауза. Пауза сделана.

Дисклеймер: автор проекта — автор статьи Максим Беляков. Коммерческих интересов нет. Код клиентов и семя датасета — открытый репозиторий под лицензией MIT. Проект — некоммерческий арт-объект.