EmDash Build yordamida tahrirlanadigan, sun’iy intellekt yaratgan saytlarni tuzish va ishga tushirish

EmDash Build nima?

EmDash Build yozma topshiriqni tahrirlash mumkin bo‘lgan EmDash veb-saytiga aylantiradigan ochiq kodli AI sayt yaratuvchisidir. U faqat statik sahifa belgilarini generatsiya qilish o‘rniga, tuzilgan kontent modelini yaratadi, ushbu modelni EmDash’ning Model Context Protocol serveri orqali to‘ldiradi hamda kontentni ko‘rsatish uchun tiplashtirilgan Astro sahifalari va komponentlarini yozadi.

Yakuniy loyiha serverda render qilinadigan sahifalar, tuzilgan kontent, media xotirasi va EmDash ma’muriyat interfeysini o‘z ichiga oladi. Tahrirchilar dastlabki generatsiyadan keyin ham saytdan foydalanishda davom etishlari mumkin: ular matn va mediani yangilashi, bo‘limlar qo‘shishi yoki nusxalashi, kontent bloklari tartibini o‘zgartirishi, postlarni rejalashtirishi hamda agentdan kattaroq kontent yoki dizayn o‘zgarishlarini so‘rashi mumkin.

Muhim: EmDash Build hosting provayderlari, sayt yaratuvchilari va platformalar uchun mo‘ljallangan alfa darajasidagi namunaviy ilovadir. Joylashtirilgan demoda nashr qilish o‘chirilgan.

Siz joylashtirilgan demoni ko‘rishingiz mumkin, biroq undan saytlarni nashr qila olmaysiz.

Asosiy imkoniyatlar

• Tuzilgan aniqlashtirish: Topshiriqda muhim qaror ochiq qolganida agent aniq yo‘naltirilgan savollar beradi.
• Agent tomonidan ishlab chiqilgan kontent modellari: U qayta foydalaniladigan obyektlar uchun kolleksiyalar va tahrirchilar tartibini o‘zgartira oladigan sahifa bo‘limlari uchun tuzilgan bloklarni yaratadi.
• Tahrirlanadigan Astro saytlari: Frontend tiplashtirilgan Astro komponentlaridan foydalanadi, oddiy kontent esa EmDash orqali boshqariladigan bo‘lib qoladi.
• Jonli ko‘rish va tuzatish: Loyiha yopiq Builder ko‘rish muhitida render qilinadi. Agent natijani tekshirishi, xatolarni ko‘rib chiqishi va ularni shu jarayonning o‘zida tuzatishi mumkin.
• Kontent jarayonlari: Tahrirchilar EmDash ma’muriyat interfeysi orqali matn, media, bo‘limlar, bloklar va rejalashtirilgan kontentni boshqarishi mumkin.
• Saqlanadigan tarix: Manba kodi va mahalliy CMS holati Cloudflare Artifacts’da Git commitlari sifatida saqlanadi.
• Nazorat qilinadigan nashr: Tekshirilgan statik relizlar Workers for Platforms uchun paketlanishi mumkin, biroq bu faqat operator nashr qilishni aniq yoqib, sozlaganida amalga oshadi.

Arxitektura qanday ishlaydi

Har bir generatsiya qilingan loyiha tayyor EmDash, Astro va Tailwind loyihasini o‘z ichiga olgan Cloudflare Sandbox’ni oladi. BuilderAgent Durable Object suhbatni hamda model va vositalar siklini boshqaradi.

Agent sxemalar va kontent yaratish uchun EmDash MCP vositalaridan foydalanadi. U Sandbox ichida ommaviy frontend’ni yozadi, yopiq ko‘rish muhitini ishga tushiradi, render qilingan saytni tekshiradi va navbatdagi amalni yakunlashdan oldin xatolarni tuzatadi.

Cloudflare Artifacts har bir yaxlit loyiha holatini Git tarixi sifatida saqlaydi. Sandbox uyqu holatiga o‘tsa, EmDash Build manba kodini va mahalliy CMS holatini yangi konteynerga tiklashi hamda ko‘rish muhitini qayta ishga tushirishi mumkin.

Agent ish jarayoni

1. Tushunish: Topshiriqni o‘qish va yetishmayotgan muhim qarorlarni aniqlash.
2. Modellashtirish: Qaysi ma’lumotlar qayta foydalaniladigan kolleksiyalarga aylanishi va qaysi sahifalarga tuzilgan bloklar kerakligini belgilash.
3. Qurish: EmDash sxemasini yaratish, generatsiya qilingan turlarni yangilash va tiplashtirilgan Astro renderlarini yozish.
4. To‘ldirish: EmDash MCP vositalari orqali namunaviy kontent va media qo‘shish.
5. Tekshirish: Loyihani turlar bo‘yicha tekshirish, ommaviy yo‘nalishlarni render qilish, ko‘rish muhitini ko‘zdan kechirish va xatolarni tuzatish.
6. Saqlash: To‘liq loyiha holatini Cloudflare Artifacts’ga commit qilish.

Talablar

Mahalliy ishlab chiqish uchun mahalliy vositalar hamda bir nechta Cloudflare xizmatlariga kirish talab etiladi. Davom etishdan oldin quyidagilarni tayyorlang:

• Node.js 24 yoki undan keyingi versiya
• pnpm 11.9
• Ishlayotgan Docker bilan mos daemon
• Cloudflare hisobiga autentifikatsiya qilingan Wrangler
• Cloudflare Workers’ga kirish
• Durable Objects’ga kirish
• Cloudflare Sandbox’ga kirish
• Workers AI va AI Gateway’ga kirish
• Cloudflare Artifacts’ga kirish
• Workers for Platforms’ga kirish

Provayder resurslari va ishonch chegaralari ehtiyotkorlik bilan sozlashni talab qilgani sababli, ilovani joylashtirishdan oldin repository’ning o‘z hosting qo‘llanmasini o‘qing.

EmDash Build’ni o‘rnatish va sozlash

1. Bog‘liqliklarni o‘rnatish

Repository ildizidan lock qilingan bog‘liqlik versiyalarini o‘rnating:

pnpm install --frozen-lockfile

2. Provayder konfiguratsiyasini yaratish

provider.config.example.json faylini e’tibordan chetda qoldiriladigan provider.config.json fayliga nusxalang:

cp provider.config.example.json provider.config.json

provider.config.json faylini oching va har bir namunaviy qiymatni Cloudflare hisobingizdagi resurslar bilan almashtiring. Kerakli resurslarni namunaviy qiymatlarga tayanish o‘rniga o‘z hosting qo‘llanmasiga amal qilib yarating.

3. Konfiguratsiyani tekshirish va render qilish

Dastlabki tekshiruvlarni ishga tushiring, so‘ng provayderga xos Wrangler konfiguratsiyasini yarating:

pnpm preflight
pnpm configure

Hujjatlarda ko‘rsatilgan mahalliy ishga tushirish buyrug‘i foydalanadigan generatsiya qilingan konfiguratsiya wrangler.provider.jsonc hisoblanadi. Joylashtirish yoki maxfiy muhitlarni ishga tushirishdan oldin provayderga xos ushbu faylni tekshiring.

4. Mahalliy maxfiy ma’lumotlarni sozlash

Ishlab chiqish maxfiy ma’lumotlari shablonidan nusxa oling:

cp .dev.vars.example .dev.vars

Builder uchun zarur bo‘lgan AI Gateway ma’lumotlarini .dev.vars fayliga qo‘shing. UNSPLASH_ACCESS_KEY ixtiyoriy; uni qo‘shish generatsiya vaqtida stok rasmlarni qidirishni yoqadi.

Provayder ma’lumotlarini generatsiya qilingan loyihalar ichiga joylashtirmang. Nashr qilish server tomonidan boshqariladi va generatsiya qilingan saytlarga provayder ma’lumotlari berilmaydi.

5. To‘liq mahalliy ilovani ishga tushirish

EmDash Build’ni yaratilgan provayder konfiguratsiyasi bilan ishga tushiring:

EMDASH_WRANGLER_CONFIG=wrangler.provider.jsonc pnpm dev

Ishlab chiqish serveri tayyor bo‘lgach, http://localhost:5173 manzilini oching.

6. Zarur bo‘lganda faqat UI rejimini ishga tushiring

Agar faqat interfeys ustida ishlashingiz kerak bo‘lsa, quyidagidan foydalaning:

pnpm dev:ui

Bu rejim Sandbox asosidagi sayt yaratishni ishga tushirmaydi. Builder agenti, loyiha yaratish yoki real vaqtdagi yaratilgan ko‘rib chiqishlarni sinash kerak bo‘lganda to‘liq ishlab chiqish buyrug‘idan foydalaning.

Asosiy foydalanish: topshiriqdan sayt yaratish

1. Foydali topshiriq yozing

Mo‘ljallangan sayt, uning auditoriyasi, asosiy sahifalari, qayta foydalaniladigan kontenti va istalgan vizual yo‘nalishini tasvirlang. Masalan:

Create a portfolio website for an Icelandic landscape photographer.
Include a home page, reusable photo collections, an about page,
and structured page sections that editors can reorder.

Agar topshiriqda muhim tanlovlar ochiq qolsa, agent aniq yo‘naltirilgan savollar berishi mumkin. Izchil sxema va frontendni kutishdan oldin bu savollarga javob bering.

2. Agent saytni modellashtirsin va yaratsin

Aniqlashtirishdan so‘ng agent qaysi ma’lumotlar qayta foydalaniladigan to‘plamlarga tegishli ekanini va qaysi bayoniy sahifalar tuzilmaviy bloklardan foydalanishi kerakligini belgilaydi. Keyin u EmDash sxemasini yaratadi, yaratilgan turlarni yangilaydi, Astro renderlarini yozadi va MCP vositalari orqali namunaviy kontent qo‘shadi.

3. Shaxsiy ko‘rib chiqishni tekshiring

Yaratilgan yo‘nalishlar va umumiy dizaynni tekshirish uchun Builder’ning real vaqtdagi ko‘rib chiqishidan foydalaning. EmDash Build yaratilgan loyihani tekshiradi va agent sikli davomida aniqlangan xatolarni tuzatishi mumkin.

4. EmDash’da tahrirlashni davom ettiring

Dastlabki loyiha foydalanishga tayyor bo‘lgach, odatiy kontentni EmDash ma’muriyat interfeysi orqali boshqaring. Matn va medialarni tahrirlashingiz, bo‘limlar qo‘shishingiz yoki nusxalashingiz, bloklar tartibini o‘zgartirishingiz va postlarni rejalashtirishingiz mumkin. Kengroq tuzilmaviy, kontent yoki dizayn o‘zgarishlari kerak bo‘lganda agentga qayting.

5. Loyiha holatini saqlang va tiklang

Izchil loyiha holatlari Git tarixi sifatida Cloudflare Artifacts’ga yuboriladi. Bu saqlash mexanizmi Sandbox uyqu holatiga o‘tganda va yangi konteyner kerak bo‘lganda EmDash Build’ga loyiha manbasi hamda mahalliy CMS holatini tiklash imkonini beradi.

Tekshirish va ishlab chiqish buyruqlari

Kiritayotgan o‘zgarish turiga mos repository buyruqlaridan foydalaning:

• pnpm dev EmDash Build’ni standart konfiguratsiya bilan ishga tushiradi.
• pnpm dev:ui Cloudflare Sandbox konteynerlarisiz interfeysni ishga tushiradi.
• pnpm check ilova va Worker testlarida turlarni tekshiradi.
• pnpm test ilova testlar to‘plamini ishga tushiradi.
• pnpm test:worker Workers integratsiya to‘plamini ishga tushiradi.
• pnpm build EmDash Build’ni standart konfiguratsiya bilan yig‘adi.
• pnpm build:provider wrangler.provider.jsonc yordamida yig‘adi.
• pnpm format repository’ni oxfmt bilan formatlaydi.

Hissa qo‘shishdan oldin loyiha tavsiya qilgan to‘liq tekshiruv ketma-ketligini ishga tushiring:

pnpm format
pnpm check
pnpm test
pnpm test:worker
pnpm build

Ilg‘or maslahatlar

To‘g‘ri ishlab chiqish rejimini tanlang

Izolyatsiyalangan interfeys ishlari uchun pnpm dev:ui dan foydalaning, chunki u Sandbox konteynerlarini ishga tushirmaydi. Uni yaratish jarayonlarini tekshirish uchun ishlatmang: UI-only rejimida Sandbox asosidagi yaratish mavjud emas.

Kontent tahririni tuzilmaviy o‘zgarishlardan ajrating

Matn, media, bo‘limlar va tartibni o‘zgartirish kabi oddiy tahrir ishlari uchun EmDash ma’muriyat interfeysidan foydalaning. Kattaroq dizayn yoki kontent modeli o‘zgarishlari uchun agentdan foydalaning. Bu tuzilmaviy CMS ma’lumotlari va tiplashtirilgan Astro render kodi o‘rtasidagi loyiha taqsimotini saqlaydi.

Provayder konfiguratsiyasini tekshiring

Namunaviy provayder konfiguratsiyasini faqat shablon sifatida ko‘ring. Har bir namunaviy qiymatni almashtiring, pnpm preflight ni ishga tushiring, pnpm configure bilan Wrangler konfiguratsiyasini yarating va chiqish ma’lumotlarini maqsadli Cloudflare hisobiga mosligini tekshiring.

Nashrni aniq nazorat ostida saqlang

Ommaviy nashr server tomonidan boshqariladi va sukut bo‘yicha o‘chirilgan. Uni faqat ishlaydigan provayder Workers for Platforms uchun tekshirilgan statik relizlarni paketlashga tayyor bo‘lganda yoqing va sozlang. Xost qilingan demo ham nashrni o‘chirilgan holda saqlaydi.

Joylashtirishdan oldin xavfsizlik chegaralarini tekshiring

Model vositalari, Sandbox bajarilishi, sirlar, shaxsiy ko‘rib chiqishlar, saqlash va nashr qilish haqida batafsil ma’lumot uchun repository’ning tahdid modeliga murojaat qiling. Operatsion tekshiruvlar uchun operatsiyalar qo‘llanmasidan foydalaning.

Repository bo‘ylab samarali navigatsiya qiling

• src/worker Worker yo‘nalishlari, BuilderAgent, promptlar, vositalar, saqlash va nashr boshqaruvlarini o‘z ichiga oladi.
• src/client React Builder interfeysi, chat, faollik ko‘rinishlari va real vaqtdagi ko‘rib chiqishni o‘z ichiga oladi.
• prototype/builder-cloudflare yangi loyihalar uchun tayyorlangan bo‘sh EmDash va Astro skeletini o‘z ichiga oladi.
• migrations autentifikatsiya va provayder boshqaruvi ma’lumotlar bazasi migratsiyalarini o‘z ichiga oladi.
• scripts provayder konfiguratsiyasi, smoke testlar va operatsion yordamchi skriptlarni o‘z ichiga oladi.
• test ilova va Worker test qamrovini o‘z ichiga oladi.
• docs o‘z serverida joylashtirish, xavfsizlik, operatsiyalar va amalga oshirish hujjatlarini o‘z ichiga oladi.

Xulosa

EmDash Build sun’iy intellekt yordamidagi generatsiyani mustahkam, tahrirlash mumkin bo‘lgan CMS ish jarayoni bilan birlashtiradi. U tuzilgan EmDash kontenti va tiplashtirilgan Astro komponentlarini yaratadi, natijani shaxsiy Cloudflare Sandbox ko‘rish muhitida tekshiradi hamda loyiha tarixini Cloudflare Artifacts’da saqlaydi. Bu muhim infratuzilma talablariga ega alfa bosqichidagi namunaviy ilova bo‘lgani sababli, provayder resurslarini ehtiyotkorlik bilan sozlang, xavfsizlik hujjatlarini ko‘rib chiqing va ommaviy nashrni aniq nazorat ostida saqlang.