Что нейросети ломают в сайтах: разбор 14 проверок
Сайт, написанный нейросетью, ломается предсказуемо: в файлах остаётся ключ API, пути ведут в никуда, форма ничего не отправляет, а картинки вклеены прямо в HTML. Поэтому Tuqo при каждой публикации читает файлы сайта и показывает отчёт «Что улучшить» — 14 проверок в двух уровнях. Ничего не блокируется: сайт публикуется в любом случае, а замечания ждут рядом с адресом.
Стоит исправить
Из-за этого сайт не работает как задумано или раскрывает лишнее. Плашка становится жёлтой.
Ссылка на файл, которого нет. «Страница ссылается на файл, но в наборе его нет: стили
не применятся, картинка не покажется, скрипт не сработает». Модель пишет в тексте
«создайте style.css», а в разметке ссылается на styles.css или assets/style.css.
Добавьте файл или исправьте путь — регистр букв и папки важны.
В файлах найден ключ Tuqo. Ключ tqk_… даёт доступ к проекту через API и MCP: «любой
посетитель сможет менять ваши сайты». Агенты вставляют ключ в скрипт «чтобы работало».
Удалите его из файлов, опубликуйте заново и перевыпустите ключ в разделе «API-ключи».
В файлах похожее на секрет. Токен бота Telegram, ключ облака, приватный ключ — «всё равно что выложить пароль». На статике серверных секретов не бывает по определению: уберите, опубликуйте заново и отзовите у сервиса, который выдал.
Ссылки на localhost или файлы на диске. «Работало на компьютере разработчика, у
посетителей не откроется». Классика для кода, который модель писала «под локальный
запуск»: http://localhost:3000/api, file:///Users/.... Замените на адреса
опубликованного сайта или уберите.
Ресурсы по http:// на защищённом сайте. Сайт открывается по HTTPS, «а браузер
блокирует скрипты и стили по http и помечает картинки как небезопасные». Модели тянут
библиотеки со старых CDN по памяти. Замените на https:// или положите файлы в набор.
Сайт закрыт от поиска. <meta name="robots" content="noindex"> — «Яндекс и Google не
покажут сайт в результатах. Часто остаётся от шаблона или тестовой сборки». Уберите тег,
если сайт должен находиться в поиске.
robots.txt запрещает обход всего сайта. Строка Disallow: / — «поисковые роботы не
зайдут ни на одну страницу». Убирается или сужается до конкретных разделов.
Нет meta viewport. «Без него телефон показывает страницу как на мониторе, текст
нечитаем без увеличения». Добавьте в head:
<meta name="viewport" content="width=device-width, initial-scale=1">.
Картинки вклеены в HTML. Самая частая беда артефактов Claude: «страница грузится
целиком до первой отрисовки, а base64 не сжимается. На телефоне посетители ждут несколько
секунд». Передайте картинки отдельными файлами (в deploy_files с encoding: base64),
в HTML оставьте ссылки — и уменьшите их до реального размера на экране.
Форма без адреса отправки. «Кнопка “Отправить” ничего не отправляет». Модель рисует
action="#" или alert('Спасибо!'), потому что серверной части у неё нет. Возьмите код
формы с вкладки «Формы» сайта — заявки придут в Tuqo, в уведомления и автоответ.
Можно улучшить
Советы про вид в поиске и мессенджерах и про заявки. Плашка бирюзовая.
Заголовок страницы «Document». Дефолт шаблона, который модель забыла заменить. «Заголовок
виден во вкладке браузера, в закладках и в результатах поиска» — напишите в <title>
название и суть.
Нет фавикона. «Во вкладке браузера и в закладках сайт показывается пустым значком».
Положите favicon.svg или favicon.png в корень и добавьте <link rel="icon"> в head.
Нет превью для мессенджеров. «Ссылка на сайт в Telegram, WhatsApp и ВКонтакте
показывается без картинки и описания». Добавьте og:title, og:description и og:image
с картинкой 1200×630.
Форма отправляет заявки на сторонний сервис. Модели по привычке подставляют
formspree.io и подобные. «Если так и задумано, оставляйте как есть» — но Tuqo тоже
принимает заявки: они попадут на вкладку «Формы», в уведомления и автоответ.
Где смотреть отчёт
Плашка рядом с адресом сайта: жёлтая — есть «стоит исправить», бирюзовая — только советы. На странице-чеклисте у каждого замечания причина, способ исправления и место — файл и строка, до 10 мест. «Сделано» и «Скрыть» запоминаются в вашем браузере.
Агенту через MCP и REST замечания приходят полем recommendations в ответе на публикацию,
в статусе деплоя и в карточке сайта: первые пять и число остальных.
Промпт «исправь замечания»
В панели есть кнопка, которая собирает замечания в готовый текст. Если нужен свой:
Вот отчёт проверок Tuqo по моему сайту — исправь все пункты уровня «стоит исправить».
[вставьте список замечаний]
Правила: пути только относительные, никаких ссылок на localhost и http://,
никаких ключей и токенов в файлах, картинки — отдельными файлами, не base64.
В head должны быть meta charset UTF-8, meta viewport, осмысленный title,
og:title/og:description/og:image и ссылка на фавикон.
Форму оставь без адреса отправки — я подставлю код с вкладки «Формы».
Выведи изменённые файлы целиком и опубликуй заново.Частые вопросы
Проверки могут заблокировать публикацию?
Нет, это рекомендации. Единственное, что Tuqo не публикует никогда, — служебные файлы
вроде .git, .env и ключей SSH: они отбрасываются при загрузке.
Как выключить?
В настройках сайта есть переключатель показа рекомендаций после публикации. Выключили —
плашка и поле recommendations исчезают. Можно и точечно: «Скрыть» у конкретного пункта.
На каких тарифах работает?
На всех, включая бесплатный: проверки — часть публикации, а не платная функция.
Почему проверок только 14?
Это первая волна — то, что чаще всего ломает сайты, сделанные нейросетью. Список пополняется по спросу, чтобы чеклист оставался коротким и честным.