shipwords yordamida kalit so‘zlarga yo‘naltirilgan AI saytlar tarmog‘ini yarating va ishga tushiring

shipwords nima qiladi

shipwords — Cloudflare’da AI tasvir va video saytlar tarmog‘ini ishga tushirish uchun mo‘ljallangan, MIT litsenziyasiga ega ochiq kodli freymvork. Har bir kalit so‘z uchun alohida sayt yaratiladi. Hisoblar, to‘lovlar, kreditlar va AI generatsiyasi kabi umumiy imkoniyatlar freymvorkda bir marta amalga oshiriladi, har bir sayt esa o‘z sahifalari, vizual identifikatsiyasi, domeni, ma’lumotlar bazasi, xotirasi va to‘lov hisobiga ega bo‘lishi mumkin.

Har bir sayt o‘zining Cloudflare Worker’i, D1, R2 va Workflows xizmatlarida ishlaydigan TanStack Start va React 19 ilovasidir. Bunday ajratish saytlarni mustaqil ravishda ishga tushirish, yangilash yoki to‘xtatish imkonini beradi, shu bilan birga kelajakdagi joylashtirishlarda umumiy yadroning yaxshilanishlarini olish davom etadi.

Asosiy imkoniyatlar

• Google va email orqali kirish hamda hisob sahifalari.
• Stripe va PayPal qo‘llab-quvvatlovi, jumladan kredit paketlari, obunalar, buyurtmalar, qaytarimlar va nizolar.
• Email bildirishnomalari hamda reCAPTCHA v3 orqali suiiste’mol cheklovlariga ega mehmonlar uchun bepul sinovlar.
• Maxfiylik, foydalanish shartlari, qaytarim va DMCA sahifalari.
• SEO va GEO yordamchilari, jumladan sitemap.xml, robots.txt va llms.txt.
• Bir yo‘nalishli ish holatlari va muvaffaqiyatsiz ishlar uchun avtomatik qaytarimlarga ega, workflow asosidagi generatsiya muhiti.
• GPT Image, Nano Banana, Seedream, FLUX, Seedance, Veo, Kling va Wan kabi modellar uchun Yir API integratsiyasi.
• Mahalliy ishlab chiqishda model API kalitisiz ishlash uchun mock upstream.
• ffmpeg konteyneri yordamida ixtiyoriy video kompozitsiyasi.

Talablar

Boshlashdan oldin repository’ning .nvmrc faylida ko‘rsatilgan Node 24 ni o‘rnating va kerakli pnpm versiyasi mavjud bo‘lishi uchun Corepack’ni yoqing:

corepack enable

Windows’da Git Bash yoki WSL’dan foydalaning. Joylashtirish va to‘lovlarni qabul qilishga tayyor bo‘lganingizda Cloudflare hisobi hamda Stripe yoki PayPal hisobi kerak bo‘ladi. Oddiy mahalliy sozlash uchun ular talab qilinmaydi.

Repository’ni o‘rnating

Repository’ni fork qiling yoki klonlang, so‘ng uning bog‘liqliklarini o‘rnating:

pnpm install

Yangi sayt shablonini yarating

To‘liq AI sayt shablonidan sayt yaratish uchun sayt generatoridan foydalaning. Birinchi argument sites/ ichidagi katalog nomiga aylanadi, domen esa sayt konfiguratsiyasida saqlanadi:

pnpm new-site my-tool --domain my-tool.com
pnpm install

Yaratilgan sayt bosh sahifa, narxlar, hisob va kirish jarayonlari, siyosat sahifalari hamda standart sitemap.xml, robots.txt va llms.txt fayllarini o‘z ichiga oladi. Yangi sayt bog‘liqliklari o‘rnatilishi uchun pnpm install buyrug‘ini yana ishga tushiring.

Mahalliy maxfiy ma’lumotlarni sozlang

Mahalliy maxfiy ma’lumotlarni repository’dan tashqarida saqlang. Konfiguratsiya katalogini yarating, yaratilgan saytning namunaviy o‘zgaruvchilar faylidan nusxa oling va worktree konfiguratsiyasini ulang:

mkdir -p ~/.config/shipwords
cp sites/my-tool/.dev.vars.example ~/.config/shipwords/my-tool.dev.vars
pnpm setup:worktree

Namunaviy konfiguratsiya mahalliy ishlab chiqishda darhol ishlashga mo‘ljallangan. Email orqali kirish kodlari ishlab chiqish serveri terminalida chop etiladi, yangi hisoblar ro‘yxatdan o‘tish kreditlarini oladi va UPSTREAM_MOCK=1 bo‘lganda generatsiya mock upstream’dan foydalanadi. Shu sababli ilovani model API kalitisiz sinab ko‘rishingiz mumkin.

Haqiqiy generatsiyani qo‘shing

Haqiqiy model so‘rovlari uchun Yir API kalitini qo‘shing va UPSTREAM_MOCK qiymatini o‘zgartirib, mock upstream’ni o‘chiring.

To‘lovlarni sinang

Kredit xaridlarini sinash uchun sk_test_ bilan boshlanadigan Stripe test kalitini qo‘shing. Sayt katalogidan repository’ning webhook yo‘naltirish yordam dasturini ishga tushiring, shunda mahalliy ishlab chiqish muhiti Stripe hodisalarini qabul qila oladi:

node ../../tools/stripe-listen.mjs

Umumiy to‘lov kodi takroriy yoki tartibsiz kelgan to‘lov hodisalari, ikki marta yechib olish va muvaffaqiyatsiz ishlar uchun qaytarimlarni boshqarishga mo‘ljallangan.

Ixtiyoriy kirish va mehmonlar imkoniyatini sozlang

Mehmonlar uchun bepul sinovlar reCAPTCHA kalitlarini talab qiladi. Ular bo‘lmasa, tashrif buyuruvchilar birinchi generatsiyasidan oldin tizimga kirishlari kerak. Google orqali kirish ixtiyoriy; uni yoqsangiz, Google OAuth mijozini yarating va ruxsat etilgan manba sifatida http://localhost:<port>dan foydalaning. Email orqali kirish Google OAuth’siz ham ishlaydi.

Saytni mahalliy ishga tushiring

Yaratilgan saytga o‘ting, mahalliy ma’lumotlar bazasi artefaktlarini yarating, mahalliy migratsiyalarni qo‘llang va ishlab chiqish serverini ishga tushiring:

cd sites/my-tool
pnpm db:generate && pnpm db:migrate:local
pnpm dev

Ishlab chiqish serveri chiqargan mahalliy URL manzilni oching. Namunaviy konfiguratsiya yordamida email orqali autentifikatsiya, hisob yaratish, kreditlar va mock generatsiyani sinab ko‘rishingiz mumkin.

Repository buyruqlaridan foydalaning

Aksariyat buyruqlarni muayyan sayt uchun cheklash yoki butun repository bo‘yicha tekshiruvlar uchun ishlatish mumkin:

pnpm new-site <dir> --domain <domain>
pnpm list-sites
pnpm setup:worktree
pnpm --filter "./sites/<site>" dev
pnpm --filter "./sites/<site>" check
pnpm check:packages
pnpm check:template
pnpm lint && pnpm test:tools

list-sites buyrug‘i har bir sayt kodi va README faylidan saytlar ro‘yxatini tuzadi. Saytning check buyrug‘i turlarni tekshirish, build va ishga tushirish tekshiruvlarini bajaradi. Paket tekshiruvlari umumiy yadro va jobs paketlarini qamrab oladi, template va tools tekshiruvlari esa ishga tushirishdan oldin muammolarni aniqlashga yordam beradi.

AI kodlash agenti yordamida sayt yarating

Agar mo‘ljallamoqchi bo‘lgan kalit so‘zingizni allaqachon bilsangiz, repository agent boshqaradigan ish jarayonini qo‘llab-quvvatlaydi. Claude Code, Codex yoki Cursor’da repository agent ko‘rsatmalarini bering va undan sayt yaratishni so‘rang:

Read shipwords.dev/llms.txt and build a site for "<your keyword>"

Agent repozitoriydan nusxa olishi, sayt yaratishi va uni lokal ishga tushirishi mumkin. AI kodlash agentlari qoidalari AGENTS.md faylida hujjatlashtirilgan. Agar yangi paydo bo‘layotgan kalit so‘zlar bo‘yicha g‘oyalar kerak bo‘lsa, alohida new-term-radar loyihasi X, Hugging Face, GitHub va sayt xaritalaridagi yangi AI atamalarini kuzatadi.

Saytning kengaytirilgan xatti-harakatlarini sozlash

Umumiy generatsiya runtime’idan foydalaning

packages/jobs paketi workflow asosidagi runtime, upstream adapter interfeysi, Yir adapteri, lokal mock upstream va ixtiyoriy ffmpeg kompozitsiyasini taqdim etadi. Saytga xos generatsiya xatti-harakatlarini sayt konfiguratsiyasida saqlang va vazifalarni qayta ishlash hamda mablag‘ni qaytarish uchun umumiy runtime’dan foydalaning.

Generatsiya xarajati limitlarini belgilang

Yir orqali model chaqiruvlari har bir so‘rov bo‘yicha hisoblanadi. Har bir vazifaning maksimal xarajati site.models.ts faylida belgilanadi. Haqiqiy generatsiyani yoqishdan oldin ushbu limitlarni ko‘rib chiqing, shunda sayt narxlari va kreditlar bilan bog‘liq xatti-harakatlar maksimal upstream xarajatiga mos keladi.

Video misolini o‘rganing

Videoga yo‘naltirilgan sayt uchun sites/tinydeskai-example katalogini ko‘rib chiqing. U Tiny Desk AI’ning to‘liq manba kodi bo‘lib, foto slotlari, bir martalik video tahrirlash, natijani tekshirish, ffmpeg kompozitsiyasi va kontent sahifalarini namoyish etadi. Uning workflow’i viral videoni tashrif buyuruvchilar yuklagan fotosuratlar bilan ishlatishi mumkin bo‘lgan shablonga aylantiradi.

Saytlarni mustaqil saqlang

Har bir sayt o‘z ma’lumotlar bazasi, xotirasi va to‘lov hisobiga ega holda mustaqil joylashtiriladi. Ushbu arxitektura umumiy yadroni bir marta takomillashtirib, saytlarning ishga tushirilishi yoki yopilishini o‘zaro bog‘lamagan holda yangilanishni tanlangan saytlarga joylashtirish imkonini beradi.

Ishlab chiqarish muhitiga tayyorlaning

Lokal sayt ishlayotganida, ishlab chiqarish jarayoni uchun saytni ishga tushirish qo‘llanmasiga amal qiling. Domen xarajatlari, Cloudflare’dan foydalanish, to‘lovlarni qayta ishlash komissiyalari va Yir model so‘rovlarini rejalashtiring. Kliplarni birlashtiradigan video saytlar Cloudflare Containers’dan foydalanadi va Workers Paid tarif rejasini talab qiladi.

Ishga tushirishdan oldin sayt autentifikatsiyasi, to‘lov webhook’lari, kreditlar bilan bog‘liq xatti-harakatlar, generatsiya xatolari, mablag‘ni qaytarish, siyosat sahifalari, SEO fayllari va analitika konfiguratsiyasini tekshiring. Repozitoriy, shuningdek, batafsil konfiguratsiya ma’lumotlari uchun arxitektura va lokal ishlab chiqish hujjatlarini taqdim etadi.

Xulosa

shipwords har bir loyiha uchun autentifikatsiya, billing, kreditlar, generatsiya workflow’lari va SEO qo‘llab-quvvatlashini qayta yaratmasdan, kalit so‘zlarga yo‘naltirilgan bir nechta AI saytlarini ishga tushirish uchun amaliy asos taqdim etadi. Shablondan boshlang, lokal testlar uchun mock upstream’dan foydalaning, tayyor bo‘lganingizda haqiqiy provayderlarni qo‘shing va har bir tayyor saytni Cloudflare’da mustaqil joylashtiring.