Рецепта 9 · цял проект от А до Я
Заглавна секция за сайта: жива сцена и AI фон
Правиш първия екран на сайта си: жив блок от СЦЕНА с твоето заглавие и цвят върху фотореален фон, направен само за теб. За всеки, който има сайт и иска първият екран да се движи, без да пише код.
Какво получаваш накрая
Нова заглавна секция най-отгоре в страницата ти: живата сцена от ./site/hero (index.html, файловете ѝ и LICENSES.txt) върху фон 16:9 в истински 4K от ./site/fon, с олекотени копия за голям екран и за телефон. Плюс две снимки на екрана (лаптоп и телефон), тежестта на страницата преди и след и README.md с паспорта на секцията.
Ще ти трябва
- Агент с терминал (Claude Code, Codex или Cursor), свързан с cyberninjas.ai.
- Всеки план: в СЦЕНА са 9 сцени в безплатния план, 126 в Pro и всички 191 в Ultra и Бизнес. За AI фона ти трябват кредити.
- Сайтът ти или поне папка ./site със страница index.html, в която да влезе секцията.
- Заглавието и подзаглавието като готов текст и цветът на бранда като код от шест знака, например #40c288.
- Браузър на компютъра: Chrome или Edge.
- Достъп до настройките на хостинга ти: за шрифтовете на сцената сървърът трябва да връща едно разрешение. Агентът ти казва кое и къде.
- 1
Намери сцената с една дума
СЦЕНА е каталог с живи блокове за сайт: фонове, частици, бутони, цели секции. Първо виждаш какво има в твоя план, после избираш. Търсенето не сваля нищо и не харчи кредити.
Търси с една дума
Кажи на агента
Търси в СЦЕНА само сред сцените от моя план, с ЕДНА дума на заявка: първо „[hero]“, после „[частици]“, после „[фон]“. За всяка дума ми кажи колко сцени излизат. От всички ми покажи до 6, които стават за заглавна секция върху снимка: тъмен фон и светло заглавие или движение. За всяка ми кажи името, за какво е, картинката за преглед, дали има поле за заглавие и как се сменя цветът. Кажи ми и какъв е планът ми и колко сцени включва. Нищо не сваляй.
Агентът прави
find_scene
Получаваш: Кратък списък със сцени от твоя план, с картинка и полетата на всяка, броят за всяка дума и колко сцени включва планът ти. 0 кредита.
0 кредитавсеки агентЗащо работи
- Търсенето иска ВСЯКА дума от заявката в една и съща сцена: в името, описанието или етикетите ѝ. Пет думи са пет условия, една дума е едно.
- Разбира и английски: „hero“ намира готовите заглавни секции, включително в безплатния план.
Провери, преди да продължиш
- За всяка дума излезе поне една сцена.
- Агентът каза плана ти и колко сцени включва: 9 в безплатния план, 126 в Pro, 191 в Ultra и Бизнес.
- До всяка сцена има картинка за преглед и списък с полетата ѝ.
Подробно в урок 8: Умения и СЦЕНАКапанът
„Жив фон за начална страница“ връща нула. Каталогът не е празен: заявката е пет условия наведнъж, а една сцена трябва да ги изпълни всичките.
- 2
Избери сцената и прочети настройките ѝ
Сцената приема само полетата, които сама обявява, и само в техните граници. Видиш ли ги предварително, първата заявка минава.
Прочети настройките
Кажи на агента
Покажи ми всичко за сцената [име на сцената], без да я зареждаш: всичките ѝ полета с името, вида (текст, цвят, число или избор), стойността по подразбиране и границите, например колко знака побира заглавието. При поле с избор ми дай точните стойности, например за тъмен и светъл режим. Ако има варианти, изброй ги с id-тата им. Дай ми връзката към видеото за преглед.
Агентът прави
find_scene
Получаваш: Картата на сцената: кои полета приема, в какви граници и с какви варианти. Знаеш какво можеш да смениш, преди да го поискаш.
0 кредитавсеки агентЗащо работи
- Непознато поле, текст над границата или стойност извън списъка спират цялата заявка.
- При поле с избор се подава стойността, не надписът: dark, а не „Тъмно“. Вариантът се подава с id-то си, не с името.
Провери, преди да продължиш
- Знаеш точното име на полето за заглавие и колко знака побира.
- Знаеш дали цветът се сменя с код или с „Тон“ (число) и дали сцената има тъмен режим.
- Избрал си вариант по id-то му или си решил да е без вариант.
Подробно в урок 8: Умения и СЦЕНАКапанът
Вариантът може да има свои полета, а търсенето показва само името му. Поле, което сцената приема без вариант, с избрания вариант може да върне „Непозната настройка“.
- 3
Зареди сцената с твоя текст и свали всичко веднага
Тук сцената се зарежда с твоето заглавие и цвят и се записва на диска ти. Сваляш веднага, защото част от връзките живеят 15 минути.
Зареди и свали
Кажи на агента
Зареди [име на сцената] с вариант [id на варианта или „без вариант“]. Заглавие „[твоето заглавие]“, подзаглавие „[твоето подзаглавие]“, цветът на бранда [#40c288] и тъмен режим, ако сцената има такъв. Ако сцената има поле за цвят, подай кода точно така. Ако има само „Тон“ (число в границите, които сцената обяви), превърни цвета ми в тон и подай числото. Подавай само полетата, които сцената обяви. Веднага запиши index.html и всички файлове по относителните им пътища в ./site/hero, а до тях LICENSES.txt. Сваляй, преди да правиш каквото и да е друго: част от връзките изтичат след 15 минути. Кажи ми колко файла свали и ми покажи реда с моето заглавие.
Агентът прави
get_scene
Получаваш: Папка ./site/hero с index.html, файловете на сцената и LICENSES.txt, с твоето заглавие и цвят. 0 кредита.
0 кредитаЗащо работи
- Изтече ли връзка, агентът зарежда сцената наново. Губиш време, не кредити.
- Лицензите на чуждия код, от който е направена сцената, стоят в LICENSES.txt и в коментар най-горе в index.html.
Провери, преди да продължиш
- В ./site/hero има index.html, файловете на сцената и LICENSES.txt.
- Агентът ти показа реда в index.html с твоето заглавие и твоя цвят.
- Всичко е свалено, преди агентът да мине към следващото.
Подробно в урок 8: Умения и СЦЕНАКапанът
Цветът е подаден във вид, който сцената не приема. Много сцени, сред тях „ГЕРОЙ: СИЯНИЕ“, нямат поле за цвят, а „Тон“: число. Там код като #40c288 връща „Невалидна стойност“. В поле за цвят пък минава само # и шест знака, затова „green“ или #4c8 също се отказват. Един отказ спира цялата заявка, не само цвета.
- 4
Отвори сцената отделно, преди да я вграждаш
Сцената се проверява отделно от сайта. Ако нещо не работи, знаеш, че проблемът е в нейните файлове, а не в страницата ти. Тук виждаш и дали е тъмна отдолу и светла отгоре: само такава сцена ще пусне фона ти.
Отвори я отделно
Кажи на агента
Преди да вграждаш, пусни малък локален сървър в ./site/hero и отвори index.html в браузъра, не с двоен клик върху файла. Направи снимка на екрана и я сравни с видеото за преглед. Кажи ми дали се движи, дали заглавието и цветът са моите и дали има грешки в конзолата. Кажи ми и дали фонът на сцената е тъмен, а заглавието и движението светли. Ако не са, кажи ми кое поле да сменим.
Агентът прави
на твоя компютър: агентът работи там, без конектора на cyberninjas.ai
Получаваш: Знаеш, че сцената работи сама, и дали е тъмна отдолу и светла отгоре: такава сцена ще пусне фона ти в стъпка 7.
0 кредитаЗащо работи
- Самата сцена идва с тази инструкция: разгледай резултата в браузър, преди да го вграждаш.
- Файл, отворен направо от диска, браузърът ограничава повече и част от сцените може да не тръгнат. Сайтът ти се отваря през адрес, затова и пробата е през адрес.
Провери, преди да продължиш
- Сцената се движи и прилича на видеото за преглед.
- В конзолата на браузъра няма червени грешки.
- Фонът на сцената е тъмен, а заглавието и движението са светли.
Подробно в урок 8: Умения и СЦЕНАКапанът
Агентът прави фона на страницата прозрачен с CSS и чака да види снимката. Не я вижда: много сцени рисуват тъмния си фон направо в платното, на всеки кадър, или го слагат отново от скрипта. Снимката минава през сцената със смесване, в стъпка 7.
- 5
Поръчай тъмен фотореален фон без текст, 16:9 в истински 4K
Фонът е картината, а сцената е движението отгоре. Правиш го чак след като знаеш сцената: така оставяш спокойно и тъмно място точно там, където тя слага заглавието.
Тъмен фон в истински 4K
Кажи на агента
Сега фонът под сцената. Провери баланса ми и цената на Seedream 5 Lite в 4K. После направи с него фотореален кадър 16:9 в 4K: [какво има на фона, напр. мъглива борова гора призори], тъмен и приглушен, светлина отдясно, а [лявата] половина спокойна и най-тъмна: там ще стои заглавието. Без текст, без букви, без лого и без хора. Цветовете кажи с думи ([тъмнозелено и мед]), не с кодове. Промпта към модела пиши на английски, като фотограф: апарат, обектив, светлина с посока. Кажи ми цената, преди да поръчаш.
Агентът прави
get_creditslist_modelsgenerate_image
Получаваш: Един тъмен фотореален кадър 16:9 без нито една буква, със спокойно място за заглавието. Цената я чуваш преди поръчката.
всеки агентЗащо работи
- Мерено: от проверените през MCP-то модели само Seedream 5 Lite върна истински 4 096 px. Gemini 2.5 Flash, поръчан в „4K“, върна 1 344 px, а Seedream 5 Pro върна 2 560 px. Затова агентът мери файла, а не етикета.
- Seedream чупи кирилицата. Затова фонът е без текст, а заглавието идва от сцената като истински текст.
- Тъмен, защото смесването в стъпка 7 само изсветлява: светлото на сцената ляга върху снимката. Върху светла снимка бялото заглавие се губи.
Провери, преди да продължиш
- Кадърът е 16:9 и в него няма нито една буква.
- Кадърът е тъмен и приглушен, а мястото за заглавието е най-спокойно, без шарка зад текста.
- Знаеше цената, преди агентът да поръча.
Подробно в урок 12: Кой моделКапанът
Код на цвят в промпта (#40c288) моделът изписва като надпис в кадъра. В сцената цветът е код или тон, в промпта за снимка е дума.
- 6
Свали оригинала и провери истинския размер
Етикетът „4K“ не гарантира размера: при някои модели значи ниво на качество или по-малък файл. Сваляш оригинала веднага и мериш пикселите, преди да строиш върху него.
Свали оригинала
Кажи на агента
Свали веднага фона в пълен размер в ./site/fon, по връзката от поръчката. Ако връзката е изтекла, вземи нова от последните ми генерации. Кажи ми реалния размер в пиксели и формата на файла. Ако е JPEG с разширение .png, преименувай го на .jpg. Това е оригиналът: не го променяй, копията ще правим от него.
Агентът прави
list_recent_generations
Получаваш: Оригиналът на фона на диска ти, с вярно разширение и с истинския му размер, не с етикета.
0 кредитаЗащо работи
- Връзката към пълния размер живее 1 час. id-то остава и агентът взима нова връзка от историята, без нова поръчка.
- Seedream 5 Lite връща JPEG с разширение .png. С вярното разширение всяка програма след това го отваря като JPEG.
- Виж честната граница
Провери, преди да продължиш
- Файлът е на диска ти и агентът каза реалния му размер в пиксели.
- Разширението отговаря на формата: JPEG е .jpg.
- Оригиналът стои отделно, а копията ще се правят от него.
Подробно в урок 3: СнимкиКапанът
Запазваш картинката, която агентът показа в разговора. Тя е смалена до 1 024 px и като фон на голям екран излиза размазана.
- 7
Вгради сцената върху фона в страницата си
Фонът е отдолу, сцената отгоре. Изолираната рамка пази сайта ти от стиловете и скриптовете на сцената, а сцената от сайта. Смесването пуска снимката през тъмното на сцената.
Вгради я
Кажи на агента
Вгради заглавната секция най-отгоре в [./site/index.html]. Фонът от ./site/fon е най-отдолу и покрива цялата секция. Сцената от ./site/hero стои отгоре, в изолирана рамка (sandbox iframe) със същия размер като секцията. В рамката позволи само скриптовете, а ако сцената има бутони, и отварянето на страница при клик (allow-top-navigation-by-user-activation). На бутоните сложи адресите [https://твоят-сайт.bg/…] с target=_top: в заготовката те са без адрес. На рамката сложи смесване screen (mix-blend-mode: screen), за да се вижда снимката през тъмното на сцената. Рамката няма свой произход и браузърът тегли шрифтовете на сцената като чужди, затова сървърът трябва да връща за ./site/hero разрешението Access-Control-Allow-Origin: *. Пусни локалния сървър с него и ми кажи какво да добавя на хостинга. На тесен екран фонът да показва частта, върху която ляга заглавието. Не пипай нищо друго в страницата и ми покажи какво си променил.
Агентът прави
на твоя компютър: агентът работи там, без конектора на cyberninjas.ai
Получаваш: Страницата ти с нова заглавна секция: фонът отдолу, живата сцена отгоре, изолирана от останалия сайт, а снимката се вижда през тъмното на сцената.
0 кредитаЗащо работи
- Рамката е стена в двете посоки: стиловете и скриптовете на сцената не стигат до сайта ти, нито сайтът до тях. Самата СЦЕНА съветва точно това.
- Смесването screen пуска тъмното и пази светлото: черното на сцената оставя снимката, бялото остава бяло. Затова то само изсветлява и фонът е поръчан тъмен.
- Без allow-same-origin бутонът отваря страница от сайта ти, но сцената не може да чете бисквитките и страниците му. Затова шрифтовете искат разрешението: самият cyberninjas.ai го връща за файловете на СЦЕНА.
Провери, преди да продължиш
- Секцията е най-отгоре, а останалата страница е непроменена.
- Фонът се вижда през тъмните части на сцената, а заглавието е отгоре.
- Рамката позволява само скриптове и, ако има бутони, отваряне на страница при клик.
- Шрифтовете на сцената са заредени и в конзолата няма грешка CORS.
Подробно в урок 8: Умения и СЦЕНАКапанът
Сцената, вградена направо в страницата, без рамка. Почти всяка сцена задава на цялата страница свой фон, а повечето и забраняват превъртането ѝ: така сменят фона на целия ти сайт и спират превъртането му.
- 8
Провери на лаптоп и на телефон
Страницата живее на два много различни екрана. Гледаш снимки на двата в реален размер, не впечатлението от своя монитор.
Лаптоп и телефон
Кажи на агента
Пусни ./site през локален сървър с разрешението от стъпка 7 и направи снимки на екрана в два размера: 1 440 × 900 като на лаптоп и 390 × 844 като на телефон. Покажи ми ги в реален размер. Кажи ми: чете ли се заглавието, вижда ли се фонът през сцената, четат ли се буквите на бутоните, има ли хоризонтален скрол, излиза ли нещо встрани, движи ли се сцената, има ли грешки в конзолата. На телефона ми кажи и коя част от фона се вижда.
Агентът прави
на твоя компютър: агентът работи там, без конектора на cyberninjas.ai
Получаваш: Две снимки на екрана и кратък списък с проблемите, ако има. Нищо не е качено никъде, 0 кредита.
0 кредитаЗащо работи
- Смалено, счупеното изглежда наред. Затова гледаш в реален размер и на двата екрана.
- 16:9 фон на вертикален екран показва само тясна ивица. Коя ивица, решаваш ти при вграждането.
Провери, преди да продължиш
- Заглавието се чете и на двата размера, а фонът се вижда през сцената.
- На телефона няма хоризонтален скрол и нищо не излиза встрани.
- Конзолата е без грешки, а сцената се движи.
- Буквите на бутоните се четат: смесването пуска снимката и през тъмни букви.
Подробно в урок 13: ПравилатаКапанът
Гледаш само на големия си екран. При секция на цял екран телефонът показва около една четвърт от ширината на 16:9 фона, а заглавието може да легне върху най-шарената му част.
- 9
Олекоти страницата и измери преди и след
Секцията е първото, което посетителят вижда, и първото, което страницата тегли. Мериш, олекотяваш и мериш пак: двете числа показват дали олекотяването е помогнало.
Олекоти и измери
МайсторскиКажи на агента
Измери колко тежи страницата при първо отваряне: брой заявки и общо мегабайти от мрежовия панел на браузъра. После олекоти: от оригиналния фон направи WebP с ширина 2 560 px за голям екран и 1 280 px за телефон, а страницата да тегли подходящия според екрана. Файловете в ./site/hero, които страницата не зарежда, премести в ./site/hero-izlishni, не ги трий. LICENSES.txt, а ако ги има, папката ЛИЦЕНЗИ и ПРОЧЕТИ-МЕ.txt остават, дори страницата да не ги зарежда. Измери пак, провери, че сцената работи, и ми покажи двете числа: преди и след.
Агентът прави
на твоя компютър: агентът работи там, без конектора на cyberninjas.ai
Получаваш: Две числа, преди и след, и страница, която тегли само това, което показва. Оригиналът, лицензите и излишните файлове остават при теб.
0 кредитаЗащо работи
- Сцената идва с всички общи файлове на СЦЕНА, не само с тези, които ползва. Сред тях има например три различни версии на three.js.
- Преместени, а не изтрити: ако нещо спре, връщаш файла и си там, откъдето тръгна.
Провери, преди да продължиш
- Имаш две числа: тежестта преди и след.
- Сцената работи и след олекотяването, без грешки в конзолата.
- LICENSES.txt и лицензните файлове от пакета са на мястото си, а махнатите файлове са преместени, не изтрити.
Подробно в урок 13: ПравилатаКапанът
Слагаш 4K оригинала направо в страницата. На екрана изглежда същото, но всеки посетител тегли целия 4K файл, и на телефон.
- 10
Запиши паспорта на секцията
След месец ще искаш друго заглавие или друг сезон във фона. С паспорта го правиш за минути, без да търсиш и поръчваш наново.
Паспортът на секцията
Кажи на агента
Запиши паспорта на секцията в ./site/hero/README.md: id на сцената и варианта, всички настройки, които подадохме, плана, в който е сцената, как е вградена (рамката, смесването screen и разрешението Access-Control-Allow-Origin на сървъра), id-то, модела и промпта на фона и откъде са лицензите. Покажи ми и реда в index.html, в който стоят настройките на сцената, за да сменям заглавието сам.
Агентът прави
на твоя компютър: агентът работи там, без конектора на cyberninjas.ai
Получаваш: Един файл, по който след месец сменяш текста, цвета или фона за минути.
0 кредитаЗащо работи
- Настройките на сцената стоят в самия index.html. Ново заглавие е редакция на един ред, не нова заявка.
- С id-то на фона агентът взима нова връзка към оригинала или прави вариация на същия кадър.
Провери, преди да продължиш
- README.md стои до index.html.
- Знаеш кой ред в index.html сменя заглавието.
- id-то и промптът на фона са записани.
- Записано е как е вградена секцията: рамката, смесването и разрешението на сървъра.
Подробно в урок 14: Дълъг клипКапанът
Редактираш index.html и махаш коментара с лицензите най-горе. Лицензите на кода, от който е направена сцената, пътуват с нея.
Готово е, когато
Секцията се отваря най-отгоре на страницата ти, на лаптоп и на телефон, без грешки в конзолата на браузъра. Фонът се вижда през сцената, заглавието се чете, нищо не излиза встрани, а до сцената стоят LICENSES.txt и README.md.
Варианти
- Цяла страница вместо секция: в Pro и нагоре заготовките „Скоро“ и „404“ са готови страници. Там index.html на сцената е самата страница: без рамка и без снимка отдолу.
- Без AI фон: махаш смесването и сцената остава със своя тъмен фон. Тогава рецептата е 0 кредита.
- Готов първи екран: думата „hero“ намира заготовки със заглавие и подзаглавие, някои и с бутони. Сменяш текста, а на бутоните агентът слага адресите на страниците ти.