Jenga na Endesha Tovuti Zinazoweza Kuhaririwa Zilizozalishwa na AI kwa EmDash Build

EmDash Build ni Nini?

EmDash Build ni kiunda tovuti cha AI cha chanzo huria kinachobadilisha maelezo yaliyoandikwa kuwa tovuti ya EmDash inayoweza kuhaririwa. Badala ya kuzalisha tu alama tuli za ukurasa, huunda muundo wa maudhui uliopangwa, hujaza muundo huo kupitia seva ya EmDash ya Model Context Protocol, na huandika kurasa na vipengele vya Astro vilivyo na aina maalum ili kuonyesha maudhui.

Mradi unaozalishwa unajumuisha kurasa zinazotolewa na seva, maudhui yaliyopangwa, hifadhi ya midia, na kiolesura cha usimamizi cha EmDash. Wahariri wanaweza kuendelea kutumia tovuti baada ya uzalishaji wa awali: wanaweza kusasisha maandishi na midia, kuongeza au kunakili sehemu, kupanga upya vizuizi vya maudhui, kuratibu machapisho, na kumuomba wakala afanye mabadiliko makubwa ya maudhui au muundo.

Muhimu: EmDash Build ni programu ya marejeo ya alpha inayolengwa kwa watoa huduma za upangishaji, waundaji wa tovuti, na majukwaa. Uchapishaji umezimwa katika onyesho linalopangishwa.

Unaweza kuchunguza onyesho linalopangishwa, ingawa huwezi kuchapisha tovuti kutoka humo.

Uwezo Muhimu

• Ufafanuzi uliopangwa: Wakala huuliza maswali yaliyoelekezwa wakati maelezo yanaacha uamuzi muhimu bila kutatuliwa.
• Miundo ya maudhui iliyoundwa na wakala: Huunda mikusanyo ya huluki zinazoweza kutumika tena na vizuizi vilivyopangwa kwa sehemu za ukurasa ambavyo wahariri wanaweza kupanga upya.
• Tovuti za Astro zinazoweza kuhaririwa: Kiolesura hutumia vipengele vya Astro vilivyo na aina maalum, huku maudhui ya kawaida yakiendelea kudhibitiwa kupitia EmDash.
• Hakiki ya moja kwa moja na urekebishaji: Mradi hutolewa katika hakiki ya faragha ya Builder. Wakala anaweza kuthibitisha matokeo, kukagua hitilafu, na kuzirekebisha katika mzunguko huo huo.
• Mtiririko wa kazi wa maudhui: Wahariri wanaweza kudhibiti maandishi, midia, sehemu, vizuizi, na maudhui yaliyoratibiwa kupitia kiolesura cha usimamizi cha EmDash.
• Historia inayodumu: Msimbo chanzi na hali ya ndani ya CMS huhifadhiwa kama commits za Git katika Cloudflare Artifacts.
• Uchapishaji unaodhibitiwa: Toleo tuli lililothibitishwa linaweza kupakiwa kwa Workers for Platforms, lakini tu wakati mwendeshaji anapowasha na kusanidi uchapishaji waziwazi.

Jinsi Usanifu Unavyofanya Kazi

Kila mradi unaozalishwa hupokea Cloudflare Sandbox yenye mradi uliotayarishwa wa EmDash, Astro, na Tailwind. Durable Object ya BuilderAgent hudhibiti mazungumzo na mzunguko wa modeli na zana.

Wakala hutumia zana za EmDash MCP kuunda miundo na maudhui. Huandika kiolesura cha umma ndani ya Sandbox, huanzisha hakiki ya faragha, huthibitisha tovuti iliyotolewa, na hurekebisha hitilafu kabla ya kukamilisha zamu.

Cloudflare Artifacts huhifadhi kila hali thabiti ya mradi kama historia ya Git. Sandbox inapolala, EmDash Build inaweza kurejesha msimbo chanzi pamoja na hali ya ndani ya CMS katika kontena jipya na kuanzisha upya hakiki.

Mtiririko wa Kazi wa Wakala

1. Elewa: Soma maelezo na utambue maamuzi muhimu ya nyenzo yanayokosekana.
2. Unda muundo: Amua ni data gani inapaswa kuwa mikusanyo inayoweza kutumika tena na ni kurasa gani zinahitaji vizuizi vilivyopangwa.
3. Jenga: Unda muundo wa EmDash, sasisha aina zilizozalishwa, na uandike vitoa maudhui vya Astro vilivyo na aina maalum.
4. Jaza: Ongeza maudhui na midia ya mfano kupitia zana za EmDash MCP.
5. Thibitisha: Kagua aina za mradi, toa njia za umma, kagua hakiki, na rekebisha hitilafu.
6. Hifadhi: Weka hali kamili ya mradi katika Cloudflare Artifacts.

Mahitaji ya Awali

Uendelezaji wa ndani unategemea zana za ndani pamoja na ufikiaji wa huduma kadhaa za Cloudflare. Kabla ya kuendelea, tayarisha yafuatayo:

• Node.js 24 au baadaye
• pnpm 11.9
• Daemon inayoendesha inayooana na Docker
• Wrangler iliyothibitishwa kwa akaunti ya Cloudflare
• Ufikiaji wa Cloudflare Workers
• Ufikiaji wa Durable Objects
• Ufikiaji wa Cloudflare Sandbox
• Ufikiaji wa Workers AI na AI Gateway
• Ufikiaji wa Cloudflare Artifacts
• Ufikiaji wa Workers for Platforms

Kwa kuwa rasilimali za mtoa huduma na mipaka ya uaminifu zinahitaji usanidi makini, soma mwongozo wa kujipangia upangishaji wa hazina kabla ya kupeleka programu.

Sakinisha na Usanidi EmDash Build

1. Sakinisha Vitegemezi

Kutoka kwenye mzizi wa hazina, sakinisha matoleo yaliyofungwa ya vitegemezi:

pnpm install --frozen-lockfile

2. Unda Usanidi wa Mtoa Huduma

nakili provider.config.example.json kuwa faili iliyopuuzwa ya provider.config.json:

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

Fungua provider.config.json na ubadilishe kila thamani ya mfano kwa rasilimali za akaunti yako ya Cloudflare. Unda rasilimali zinazohitajika kwa kufuata mwongozo wa kujipangia upangishaji badala ya kutegemea thamani za mfano.

3. Thibitisha na Toa Usanidi

Endesha ukaguzi wa awali, kisha zalisha usanidi wa Wrangler mahususi kwa mtoa huduma:

pnpm preflight
pnpm configure

Usanidi unaozalishwa unaotumiwa na amri ya kuanzisha ya ndani iliyoandikwa ni wrangler.provider.jsonc. Kagua faili hii mahususi kwa mtoa huduma kabla ya kupeleka au kuendesha mazingira nyeti.

4. Sanidi Siri za Ndani

nakili kiolezo cha siri za uendelezaji:

cp .dev.vars.example .dev.vars

Ongeza vitambulisho vya AI Gateway vinavyohitajika na kiunda tovuti kwenye .dev.vars. UNSPLASH_ACCESS_KEY ni ya hiari; kuiongeza huwezesha utafutaji wa picha za hisa wakati wa uzalishaji.

Usiweke vitambulisho vya mtoa huduma ndani ya miradi inayozalishwa. Uchapishaji hudhibitiwa na seva, na tovuti zinazozalishwa hazipewi vitambulisho vya mtoa huduma.

5. Anzisha Programu Kamili ya Ndani

Anzisha EmDash Build kwa usanidi wa mtoa huduma uliotengenezwa:

EMDASH_WRANGLER_CONFIG=wrangler.provider.jsonc pnpm dev

Seva ya usanidi ikiwa tayari, fungua http://localhost:5173.

6. Anzisha Hali ya UI Pekee Inapofaa

Ikiwa unahitaji tu kufanya kazi kwenye kiolesura, tumia:

pnpm dev:ui

Hali hii haianzishi uundaji wa tovuti unaotegemea Sandbox. Tumia amri kamili ya usanidi unapohitaji kujaribu wakala wa builder, uundaji wa mradi, au mwoneko wa moja kwa moja uliotengenezwa.

Matumizi ya Msingi: Tengeneza Tovuti kutoka kwa Maelezo

1. Andika Maelezo Yenye Manufaa

Eleza tovuti inayokusudiwa, hadhira yake, kurasa kuu, maudhui yanayoweza kutumika tena, na mwelekeo unaotakiwa wa mwonekano. Kwa mfano:

Tengeneza tovuti ya jalada kwa mpiga picha wa mandhari za Iceland.
Jumuisha ukurasa wa mwanzo, mikusanyo ya picha inayoweza kutumika tena, ukurasa wa kuhusu,
na sehemu za ukurasa zenye muundo ambazo wahariri wanaweza kupanga upya.

Wakala anaweza kuuliza maswali mahususi ya ufafanuzi ikiwa maelezo yataacha maamuzi muhimu bila kutatuliwa. Jibu maswali haya kabla ya kutarajia schema na frontend yenye mshikamano.

2. Mruhusu Wakala Aweke Muundo na Kujenga Tovuti

Baada ya ufafanuzi, wakala huamua ni taarifa zipi zinapaswa kuwa katika mikusanyo inayoweza kutumika tena na ni kurasa zipi za maelezo zinapaswa kutumia vizuizi vyenye muundo. Kisha huunda schema ya EmDash, husasisha aina zilizotengenezwa, huandika virekebishaji vya Astro, na huongeza maudhui ya mfano kupitia zana za MCP.

3. Kagua Mwoneko wa Faragha

Tumia mwoneko wa moja kwa moja wa Builder kukagua njia zilizotengenezwa na muundo wa jumla. EmDash Build huidhinisha mradi uliotengenezwa na inaweza kurekebisha hitilafu zilizogunduliwa ndani ya mchakato wa wakala.

4. Endelea Kuhariri katika EmDash

Baada ya mradi wa awali kutumika, dhibiti maudhui ya kawaida kupitia kiolesura cha usimamizi cha EmDash. Unaweza kuhariri maandishi na midia, kuongeza au kunakili sehemu, kupanga upya vizuizi, na kuratibu machapisho. Rudi kwa wakala unapohitaji mabadiliko mapana ya muundo, maudhui, au muonekano.

5. Hifadhi na Rejesha Hali ya Mradi

Hali thabiti za miradi huwekwa kwenye Cloudflare Artifacts kama historia ya Git. Uendelevu huu huruhusu EmDash Build kurejesha chanzo cha mradi na hali ya CMS ya ndani Sandbox inapokuwa imelala na kontena jipya linahitajika.

Amri za Uthibitishaji na Usanidi

Tumia amri za hazina zinazofaa aina ya mabadiliko unayofanya:

• pnpm dev huanzisha EmDash Build kwa usanidi chaguomsingi.
• pnpm dev:ui huanzisha kiolesura bila kontena za Cloudflare Sandbox.
• pnpm check hukagua aina za programu na majaribio ya Worker.
• pnpm test huendesha mkusanyiko wa majaribio ya programu.
• pnpm test:worker huendesha mkusanyiko wa majaribio ya ujumuishaji wa Workers.
• pnpm build hujenga EmDash Build kwa usanidi chaguomsingi.
• pnpm build:provider hujenga kwa kutumia wrangler.provider.jsonc.
• pnpm format hupangilia hazina kwa oxfmt.

Kabla ya kuwasilisha mchango, endesha mfuatano kamili wa uthibitishaji unaopendekezwa na mradi:

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

Vidokezo vya Kina

Chagua Hali Sahihi ya Maendeleo

Tumia pnpm dev:ui kwa kazi ya kiolesura iliyotengwa kwa sababu huepuka kuanzisha kontena za Sandbox. Usitumie hali hii kuthibitisha mtiririko wa uundaji: uundaji unaotegemea Sandbox haupatikani katika hali ya UI pekee.

Tenganisha Uhariri wa Maudhui na Mabadiliko ya Muundo

Tumia kiolesura cha usimamizi cha EmDash kwa kazi za kawaida za uhariri kama kubadilisha maandishi, midia, sehemu, na mpangilio. Tumia wakala kwa mabadiliko makubwa ya muundo au modeli ya maudhui. Hii hudumisha mgawanyo wa mradi kati ya data ya CMS yenye muundo na msimbo wa uwasilishaji wa Astro wenye aina.

Kagua Usanidi wa Mtoa Huduma

Chukulia usanidi wa mfano wa mtoa huduma kama kiolezo pekee. Badilisha kila thamani ya mfano, endesha pnpm preflight, tengeneza usanidi wa Wrangler kwa pnpm configure, na kagua matokeo kwa akaunti lengwa ya Cloudflare.

Dhibiti Uchapishaji kwa Uwazi

Uchapishaji wa umma unadhibitiwa na seva na umezimwa kwa chaguomsingi. Uwashe na kuusanidi tu mtoa huduma wa uendeshaji akiwa tayari kufungasha matoleo tuli yaliyothibitishwa kwa Workers for Platforms. Onyesho la mtandaoni pia huacha uchapishaji ukiwa umezimwa.

Kagua Mipaka ya Usalama Kabla ya Kutumia

Angalia muundo wa vitisho wa hazina kwa maelezo kuhusu zana za modeli, utekelezaji wa Sandbox, siri, mionekano ya faragha, uendelevu, na uchapishaji. Tumia mwongozo wa uendeshaji kwa ukaguzi wa kiutendaji.

Navigega Hazina kwa Ufanisi

• src/worker ina njia za Worker, BuilderAgent, vidokezo, zana, uendelevu, na vidhibiti vya uchapishaji.
• src/client ina kiolesura cha React Builder, gumzo, mionekano ya shughuli, na mwoneko wa moja kwa moja.
• prototype/builder-cloudflare ina EmDash tupu iliyoandaliwa na scaffold ya Astro inayotumika kwa miradi mipya.
• migrations ina uhamishaji wa hifadhidata wa uthibitishaji na udhibiti wa mtoa huduma.
• scripts ina usanidi wa mtoa huduma, majaribio ya smoke, na wasaidizi wa uendeshaji.
• test ina ufunikaji wa programu na Worker.
• docs ina nyaraka za kujipangia mwenyewe, usalama, uendeshaji, na utekelezaji.

Hitimisho

EmDash Build inaunganisha uundaji unaosaidiwa na AI na mtiririko thabiti wa kazi wa CMS unaoweza kuhaririwa. Huunda maudhui yaliyopangwa ya EmDash na vipengele vya Astro vilivyo na aina, huhakiki matokeo katika onyesho la faragha la Cloudflare Sandbox, na huhifadhi historia ya mradi katika Cloudflare Artifacts. Kwa kuwa ni programu ya marejeo ya awamu ya alpha yenye mahitaji makubwa ya miundombinu, sanidi rasilimali za mtoa huduma kwa uangalifu, soma nyaraka za usalama, na udhibiti uchapishaji wa umma kwa uwazi.