Ruka hadi maudhui makuu
Mafunzo ya AI

Jenga na Uzindue Mkusanyiko wa Tovuti za AI Zinazolenga Maneno Muhimu kwa shipwords

Jifunze jinsi ya kutumia shipwords kuunda kwa haraka tovuti za AI za picha au video zinazolenga maneno muhimu mapya, kuziendesha ndani ya kompyuta yako kwa huduma za majaribio, kusanidi uthibitishaji na malipo, na kuandaa kila tovuti kwa ajili ya uwekaji wake binafsi kwenye Cloudflare.

Jenga na Uzindue Mkusanyiko wa Tovuti za AI Zinazolenga Maneno Muhimu kwa shipwords

shipwords hufanya nini

shipwords ni mfumo huria wenye leseni ya MIT wa kuendesha mkusanyiko wa tovuti za picha na video za AI kwenye Cloudflare, huku kila tovuti ikiwa imejitolea kwa neno muhimu moja. Uwezo wa pamoja kama vile akaunti, malipo, salio, na utengenezaji wa AI hutekelezwa mara moja kwenye mfumo, huku kila tovuti ikiwa na kurasa, utambulisho wa kuona, kikoa, hifadhidata, hifadhi, na akaunti yake ya malipo.

Kila tovuti ni programu ya TanStack Start na React 19 inayoendesha kwenye Cloudflare Worker yake, pamoja na D1, R2, na Workflows. Utenganishaji huu hukuwezesha kuzindua, kusasisha, au kustaafisha tovuti kwa kujitegemea, huku bado ukipokea maboresho ya kiini cha pamoja katika uwekaji wa baadaye.

Vipengele muhimu

  • Kuingia kwa Google na barua pepe pamoja na kurasa za akaunti.
  • Usaidizi wa Stripe na PayPal, ikijumuisha vifurushi vya salio, usajili, oda, marejesho ya fedha, na mizozo.
  • Arifa za barua pepe na majaribio ya bure kwa wageni yenye vikomo vya matumizi mabaya kupitia reCAPTCHA v3.
  • Kurasa za faragha, masharti, marejesho ya fedha, na DMCA.
  • Vifaa vya SEO na GEO, ikijumuisha sitemap.xml, robots.txt, na llms.txt.
  • Mazingira ya utengenezaji yanayotegemea workflow, yenye hali za kazi za mwelekeo mmoja na marejesho ya fedha ya kiotomatiki kwa kazi zilizoshindwa.
  • Muunganisho wa Yir API kwa miundo kama GPT Image, Nano Banana, Seedream, FLUX, Seedance, Veo, Kling, na Wan.
  • Upstream ya kuigiza kwa ajili ya utengenezaji wa ndani bila ufunguo wa API wa modeli.
  • Utungaji wa video wa hiari kwa kutumia kontena ya ffmpeg.

Mahitaji ya awali

Kabla ya kuanza, sakinisha Node 24, kama ilivyoainishwa na .nvmrc ya hazina, na uwashe Corepack ili toleo linalotarajiwa la pnpm lipatikane:

corepack enable

Kwenye Windows, tumia Git Bash au WSL. Akaunti ya Cloudflare na akaunti ya Stripe au PayPal zinahitajika unapokuwa tayari kusambaza na kupokea malipo. Hazihitajiki kwa usanidi wa msingi wa ndani.

Sakinisha hazina

Fanya fork au clone ya hazina, kisha sakinisha vitegemezi vyake:

pnpm install

Unda tovuti mpya

Tumia jenereta ya tovuti kuunda tovuti kutoka kwenye kiolezo kamili cha tovuti ya AI. Hoja ya kwanza inakuwa saraka iliyo chini ya sites/, na kikoa huhifadhiwa kwa usanidi wa tovuti:

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

Tovuti iliyoundwa inajumuisha ukurasa wa mwanzo, bei, mtiririko wa akaunti na kuingia, kurasa za sera, pamoja na faili za kawaida za sitemap.xml, robots.txt, na llms.txt. Endesha pnpm install tena ili vitegemezi vya tovuti mpya visakinishwe.

Sanidi siri za ndani

Weka siri za ndani nje ya hazina. Unda saraka ya usanidi, nakili faili ya mifano ya vigezo ya tovuti iliyoundwa, na uunganishe usanidi wa worktree:

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

Usanidi wa mfano umeundwa kufanya kazi mara moja kwa utengenezaji wa ndani. Misimbo ya kuingia kwa barua pepe huchapishwa kwenye terminal ya seva ya utengenezaji, akaunti mpya hupokea salio za kujisajili, na utengenezaji hutumia upstream ya kuigiza wakati UPSTREAM_MOCK=1. Hii inamaanisha unaweza kuijaribu programu bila ufunguo wa API wa modeli.

Ongeza utengenezaji halisi

Kwa maombi halisi ya modeli, ongeza ufunguo wa Yir API na uzime upstream ya kuigiza kwa kubadilisha UPSTREAM_MOCK.

Jaribu malipo

Ili kujaribu ununuzi wa salio, ongeza ufunguo wa majaribio wa Stripe unaoanza na sk_test_. Kutoka kwenye saraka ya tovuti, endesha zana ya hazina ya kusambaza webhook ili utengenezaji wa ndani uweze kupokea matukio ya Stripe:

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

Msimbo wa pamoja wa malipo umeundwa kushughulikia matukio ya malipo yanayojirudia au kufika nje ya mpangilio, kutozwa mara mbili, na marejesho ya fedha kwa kazi zilizoshindwa.

Sanidi kuingia na ufikiaji wa wageni wa hiari

Majaribio ya bure kwa wageni yanahitaji funguo za reCAPTCHA. Bila hizo, wageni lazima waingie kabla ya utengenezaji wao wa kwanza. Kuingia kwa Google ni kwa hiari; ukiwezesha, unda mteja wa Google OAuth na utumie http://localhost:<port> kama asili inayoruhusiwa. Kuingia kwa barua pepe hufanya kazi bila Google OAuth.

Endesha tovuti ndani

Ingia kwenye tovuti iliyoundwa, unda vitekelezi vya hifadhidata ya ndani, tumia uhamishaji wa ndani, na uanzishe seva ya utengenezaji:

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

Fungua URL ya ndani iliyoonyeshwa na seva ya utengenezaji. Unaweza kujaribu uthibitishaji wa barua pepe, uundaji wa akaunti, salio, na utengenezaji wa kuigiza kwa kutumia usanidi wa mfano.

Tumia amri za hazina

Amri nyingi zinaweza kulenga tovuti moja au kutumika kwa ukaguzi wa hazina nzima:

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

Amri ya list-sites huunda orodha ya tovuti kutoka kwenye msimbo na README ya kila tovuti. Amri ya check ya tovuti huendesha ukaguzi wa aina, ujenzi, na ukaguzi wa uzinduzi. Ukaguzi wa vifurushi hushughulikia kiini cha pamoja na vifurushi vya kazi, huku ukaguzi wa kiolezo na zana ukisaidia kugundua matatizo kabla ya uzinduzi.

Jenga tovuti kwa kutumia wakala wa uandishi wa msimbo wa AI

Ikiwa tayari unajua neno muhimu unalotaka kulenga, hazina inaunga mkono mtiririko wa kazi unaoendeshwa na wakala. Katika Claude Code, Codex, au Cursor, mpe maagizo ya wakala ya hazina na umwombe ajenge tovuti:

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

Wakala anaweza kuiga hazina, kuunda tovuti, na kuiendesha ndani ya kompyuta yako. Kanuni za mawakala wa usimbaji wa AI zimeandikwa katika AGENTS.md. Ikiwa unahitaji mawazo kuhusu maneno muhimu yanayoibuka, mradi tofauti wa new-term-radar hufuatilia maneno mapya ya AI kwenye X, Hugging Face, GitHub, na ramani za tovuti.

Badilisha tabia za juu za tovuti

Tumia mazingira ya pamoja ya uzalishaji

Kifurushi cha packages/jobs hutoa mazingira ya utekelezaji yanayotegemea mtiririko wa kazi, kiolesura cha adapta ya huduma ya juu, adapta ya Yir, huduma ya juu ya kuiga ya ndani, na uundaji wa hiari kwa ffmpeg. Weka tabia mahususi za uzalishaji wa tovuti katika usanidi wa tovuti, na utumie mazingira ya pamoja kwa uchakataji wa kazi na kushughulikia marejesho ya fedha.

Weka mipaka ya gharama za uzalishaji

Miito ya modeli kupitia Yir hutozwa kwa kila ombi. Gharama ya juu ya kila kazi huwekwa katika site.models.ts. Kagua mipaka hii kabla ya kuwezesha uzalishaji halisi ili bei ya tovuti na tabia ya mikopo ilingane na gharama ya juu kutoka huduma ya juu.

Chunguza mfano wa video

Kwa tovuti inayolenga video, kagua sites/tinydeskai-example. Hiki ndicho chanzo kamili cha Tiny Desk AI na kinaonyesha nafasi za picha, uhariri wa video kwa hatua moja, ukaguzi wa matokeo, uundaji kwa ffmpeg, na kurasa za maudhui. Mtiririko wake wa kazi hubadilisha klipu iliyosambaa sana kuwa kiolezo ambacho wageni wanaweza kutumia pamoja na picha walizopakia.

Weka tovuti zikiwa huru

Kila tovuti hupelekwa kwa kujitegemea ikiwa na hifadhidata, hifadhi, na akaunti yake ya malipo. Muundo huu hukuruhusu kuboresha kiini cha pamoja mara moja na kupeleka sasisho kwenye tovuti zilizochaguliwa bila kuunganisha uzinduzi au kustaafu kwa tovuti hizo.

Jiandae kwa uzalishaji

Tovuti ya ndani inapofanya kazi, fuata mwongozo wa uzinduzi wa tovuti kwa mchakato wa uzalishaji. Panga gharama za kikoa, matumizi ya Cloudflare, ada za uchakataji wa malipo, na maombi ya modeli za Yir. Tovuti za video zinazounganisha klipu hutumia Cloudflare Containers na zinahitaji mpango wa Workers Paid.

Kabla ya uzinduzi, thibitisha uthibitishaji wa tovuti, webhook za malipo, tabia ya mikopo, kushindwa kwa uzalishaji, marejesho ya fedha, kurasa za sera, faili za SEO, na usanidi wa takwimu za matumizi. Hazina pia hutoa nyaraka za usanifu na maendeleo ya ndani kwa maelezo ya kina zaidi ya usanidi.

Hitimisho

shipwords hutoa msingi wa vitendo wa kuzindua tovuti nyingi za AI zinazolenga maneno muhimu bila kujenga upya uthibitishaji, utozaji, mikopo, mitiririko ya uzalishaji, na usaidizi wa SEO kwa kila mradi. Anza na kiolezo, tumia huduma ya juu ya kuiga kwa majaribio ya ndani, ongeza watoa huduma halisi ukiwa tayari, na peleka kila tovuti iliyokamilika kwa kujitegemea kwenye Cloudflare.