Unda Maandishi ya Biashara Mtandaoni kwa Lugha Nyingi kutoka kwa Picha za Bidhaa kwa AI Writer

AI Writer ni Nini?

AI Writer ni programu huria inayobadilisha picha za bidhaa kuwa maelezo ya ecommerce yanayoweza kuhaririwa. Unaweza kutoa kati ya URL moja na nane za picha za HTTPS zilizo wazi kwa umma, kuchagua lugha ya matokeo na kutumia modeli ya OpenAI Chat Completions yenye uwezo wa kuona ili kuunda rasimu.

Programu hii inasaidia Kiingereza, Kituruki, Kihispania, Kijerumani, Kifaransa na Kichina. Pia inajumuisha uthibitishaji wa akaunti, uhariri wa kivinjari, tafsiri na mfumo wa salio unaotumia MySQL.

AI Writer huunda rasimu badala ya vipimo vya bidhaa vilivyothibitishwa. Kagua kila maelezo kabla ya kuchapisha kwa sababu picha haziwezi kuthibitisha kwa uhakika maelezo kama vipimo, muundo wa kitambaa au vyeti.

Vipengele Muhimu

• Uandishi unaotegemea picha: Tengeneza maandishi kutoka kwa picha moja hadi nane za bidhaa zinazoweza kufikiwa na umma kupitia HTTPS.
• Kupata data kutoka ukurasa wa bidhaa: Tumia Puppeteer kukusanya viungo vya picha kutoka ukurasa wa bidhaa wa umma.
• Lugha sita za matokeo: Tengeneza maudhui kwa Kiingereza, Kituruki, Kihispania, Kijerumani, Kifaransa au Kichina.
• Uhariri na tafsiri: Boresha rasimu zilizotengenezwa kwenye kivinjari, zinakili na kuzitafsiri kwa tendo moja.
• Akaunti na salio: Programu hutumia manenosiri ya bcrypt, vipindi vya MySQL na salio linalozuia matumizi ya ziada yanayotokana na shughuli zinazofanyika kwa wakati mmoja.
• Urejeshaji wa salio baada ya hitilafu: Salio lililotengwa hurudishwa maombi ya utengenezaji yanayoungwa mkono yanaposhindwa.
• Ingizo la video la majaribio: Toa hadi fremu nane kutoka video fupi ya YouTube na uzitumie kama ingizo la kuona.

Mahitaji ya Awali

Kabla ya usakinishaji, tayarisha yafuatayo:

• Node.js 22.12 au toleo jipya zaidi pamoja na npm.
• Docker yenye Compose, au ufikiaji wa seva iliyopo ya MySQL 8 au toleo jipya zaidi.
• Ufunguo wa API wa OpenAI wenye ufikiaji wa modeli ya Chat Completions yenye uwezo wa kuona.
• Chrome iliyosakinishwa kupitia Puppeteer ikiwa unataka kupata picha kutoka kurasa za bidhaa.
• FFmpeg na FFprobe zinazopatikana kwenye PATH ikiwa unataka kujaribu uchakataji wa video wa majaribio.

FFmpeg si lazima ikiwa unapanga tu kutengeneza maelezo kutoka kwa picha.

Sakinisha AI Writer Kiotomatiki

Script ya usanidi shirikishi ndiyo njia rahisi zaidi ya usakinishaji. Nakili hazina, ingia kwenye saraka yake, endesha kisakinishi na uanzishe programu:

git clone https://github.com/csadigital/ai-writer.git
cd ai-writer
npm run setup
npm start

Kisakinishi hupakua vitegemezi vya programu na Chrome, huomba ufunguo wako wa API wa OpenAI bila kuuonyesha, huunda siri za hifadhidata na kipindi, na kuanzisha MySQL. Huhifadhi thamani zilizopo za .env na huunda nakala ya ndani.

Wakati wa usanidi, chagua docker ili kuanzisha kiotomatiki kontena endelevu la MySQL. Docker lazima iwe tayari imesakinishwa na kuendeshwa. Chagua existing ili kuunganisha kwenye seva yako ya MySQL. Ukiwa na vitambulisho vya msimamizi, kisakinishi kinaweza kuunda hifadhidata na mtumiaji maalum wa programu; hakihifadhi nenosiri la msimamizi.

Baada ya kuanzisha, fungua http://localhost:3000 kwenye kivinjari chako.

Simamisha Hifadhidata ya Docker

Ili kusimamisha kontena la ndani la MySQL bila kufuta data yake endelevu, endesha:

docker compose -f compose.mysql.yml stop

Kubadilisha vitambulisho vya hifadhidata kwenye .env hakutaweka upya volume ya Docker iliyokuwa imeanzishwa awali. Hifadhi vitambulisho vya awali au fanya uhamishaji wa hifadhidata uliopangwa kwa makusudi.

Sakinisha AI Writer Wewe Mwenyewe

Usanidi wa wewe mwenyewe hukupa udhibiti wa moja kwa moja wa mazingira na usanidi wa hifadhidata. Nakili mradi, sakinisha vitegemezi vyake kamili na uunde faili la mazingira:

git clone https://github.com/csadigital/ai-writer.git
cd ai-writer
npm ci
cp .env.example .env
node -e "console.log(require('node:crypto').randomBytes(32).toString('hex'))"

Hamisha thamani iliyotengenezwa kwenye SESSION_SECRET ndani ya .env. Siri lazima iwe na angalau vibambo 32. Kisha ongeza ufunguo wako wa API wa OpenAI na mipangilio ya muunganisho wa MySQL. Tumia vitambulisho vipya na usiwahi kuweka faili la .env kwenye hazina.

Unda hifadhidata na mtumiaji wa programu kwa kutumia msimamizi wa MySQL, mpe mtumiaji huyo ufikiaji wa hifadhidata, kisha anzisha majedwali kwa kutumia schema.sql:

mysql -h 127.0.0.1 -u ai_writer -p ai_writer < schema.sql
npm start

Fungua http://localhost:3000, unda akaunti na uingie.

Sanidi Mazingira

Programu husoma mipangilio yake kutoka kwa vigezo vya mazingira. Sanidi angalau kitambulisho cha OpenAI, siri ya kipindi na muunganisho wa hifadhidata.

• OPENAI_API_KEY: Kitambulisho cha API cha OpenAI kinachohitajika.
• OPENAI_MODEL: Modeli ya Chat Completions yenye uwezo wa kuona. Chaguo-msingi ni gpt-4.1-mini.
• SESSION_SECRET: Siri ya nasibu inayohitajika yenye angalau vibambo 32.
• DB_HOST na DB_PORT: Anwani ya MySQL. Chaguo-msingi ni 127.0.0.1 na 3306.
• DB_USER na DB_PASSWORD: Vitambulisho vya ndani vya programu ya MySQL.
• DB_NAME: Jina la hifadhidata. Chaguo-msingi ni ai_writer.
• PORT: Mlango wa HTTP wa programu. Chaguo-msingi ni 3000.
• NODE_ENV: Hali ya uendeshaji. Chaguo-msingi ni development.
• TRUST_PROXY: Weka ikiwa programu inaamini proksi moja ya HTTPS ya kinyume. Chaguo-msingi ni 0.

Muundo uliochaguliwa lazima uunge mkono uingizaji wa picha kupitia API ya Chat Completions. Tazama mwongozo rasmi wa OpenAI wa uingizaji wa picha kwa maelezo kuhusu tabia ya maombi inayooana.

Tengeneza Maelezo Yako ya Kwanza ya Bidhaa

1. Fungua akaunti: Jisajili kupitia programu ya ndani kisha uingie. Kila akaunti mpya huanza na salio la mikopo kumi.
2. Ongeza picha za bidhaa: Weka kati ya URL moja na nane za picha za HTTPS zinazopatikana hadharani. Muundo lazima uweze kufikia URL hizi.
3. Chagua lugha: Chagua Kiingereza, Kituruki, Kihispania, Kijerumani, Kifaransa au Kichina.
4. Tengeneza rasimu: Tuma picha ili zichanganuliwe kimuonekano na maelezo yatengenezwe.
5. Hariri matokeo: Kagua rasimu kwenye kivinjari na urekebishe madai yasiyothibitishwa, mtindo au maelezo ya bidhaa.
6. Nakili maandishi: Nakili maelezo yaliyorekebishwa kwenye mtiririko wako wa kazi wa biashara ya mtandaoni.

Utengenezaji wa maelezo uliofaulu hugharimu salio moja la mkopo. Ikiwa ombi la utengenezaji litashindikana, programu hurejesha salio la mkopo lililohifadhiwa.

Mfano wa Mtiririko wa Kazi wa Picha

Kwa bidhaa iliyo na pembe nyingi za kuonekana, toa seti ndogo ya URL za picha za moja kwa moja kama:

https://example.com/products/item-front.jpg
https://example.com/products/item-side.jpg
https://example.com/products/item-detail.jpg

Tumia anwani za HTTPS za umma pekee. Mitazamo mingi inaweza kuupa muundo muktadha zaidi unaoonekana, lakini haiwezi kuchukua nafasi ya vipimo vilivyothibitishwa kutoka kwenye katalogi ya bidhaa yako.

Pata Picha kutoka Kwenye Ukurasa wa Bidhaa

Badala ya kukusanya kila URL ya picha mwenyewe, AI Writer inaweza kutumia Puppeteer kukagua ukurasa wa bidhaa wa umma na kukusanya viungo vya picha. Mtiririko huu wa kazi unahitaji usakinishaji wa Chrome unaodhibitiwa na Puppeteer.

1. Weka URL ya umma ya ukurasa wa bidhaa kwenye mtiririko wa kazi wa kuchukua ukurasa.
2. Ruhusu programu ikusanye viungo vinavyowezekana vya picha.
3. Chagua picha zinazofaa za bidhaa kutoka kwenye matokeo yaliyopatikana.
4. Tengeneza na ukague maelezo kama kawaida.

Shughulikia tu kurasa na picha ambazo umeidhinishwa kutumia. Kwa utumiaji wa umma, uendeshaji wa kivinjari unapaswa kutengwa kwenye sandbox na ufikiaji wa mtandao uzuiwe.

Tafsiri Rasimu Iliyopo

Baada ya kutengeneza au kuhariri maelezo, tumia kitendo cha kutafsiri ili kutoa toleo katika lugha nyingine inayotumika. Tafsiri iliyofaulu hugharimu salio moja la mkopo. Kagua maandishi yaliyotafsiriwa kwa istilahi za bidhaa, sauti ya chapa na usahihi wa taarifa kabla ya kuyachapisha.

Tumia Mtiririko wa Kazi wa Video wa Majaribio

AI Writer inaweza kutoa hadi fremu nane kutoka kwenye video fupi ya YouTube na kutuma fremu hizo kama muktadha wa kimuonekano. Fremu za ndani hutumwa kwa muundo kama URL za data kwa sababu viungo vya picha vya localhost havitaweza kufikiwa na API.

Video lazima itimize mipaka yote hii:

• Haipaswi kuwa video ya moja kwa moja.
• Haipaswi kuzidi dakika tatu.
• Haipaswi kuwa kubwa kuliko MB 50.
• FFmpeg na FFprobe lazima zipatikane kwenye PATH.
• Lazima uwe umeidhinishwa kuchakata maudhui hayo.

Kipengele hiki kinategemea upatikanaji wa kipakua video cha YouTube cha upande wa juu, na YouTube inaweza kukataa upakuaji wa kiotomatiki. Uchakataji ukishindikana, salio la mkopo lililohifadhiwa hurejeshwa.

Utengenezaji na Majaribio

Tumia amri ya utengenezaji unapobadilisha programu:

npm run dev

Endesha ukaguzi wa mradi, majaribio ya kiotomatiki na ukaguzi wa utegemezi wa uzalishaji kwa:

npm run check
npm test
npm audit --omit=dev

Seti ya majaribio inashughulikia uthibitishaji, mzunguko wa kipindi, ulinzi wa CSRF, uthibitishaji wa URL, matokeo yaliyotoroshwa, utengenezaji wa picha, tafsiri, marejesho ya mikopo na matumizi ya mikopo kwa wakati mmoja. Majaribio ya ndani hutenga huduma za hifadhidata na AI, hivyo hayatumii vitambulisho vya uzalishaji wala kufanya miito ya API inayolipiwa. Muunganisho endelevu pia huunda seva ya muda halisi ya MySQL ili kuthibitisha uundaji wa schema ya kisakinishi na ruhusa za mtumiaji wa hifadhidata.

Vidokezo vya Kina

Chagua Picha kwa Uangalifu

Tumia picha zilizo wazi zinazoonyesha bidhaa kutoka pembe zenye manufaa. Weka ombi ndani ya kikomo cha picha moja hadi nane. Picha zaidi zinapaswa kuongeza taarifa muhimu ya kimuonekano badala ya kurudia mtazamo uleule.

Weka Data ya Ukweli Nje ya Makisio ya Kimuonekano

Usichukulie madai yaliyotengenezwa kuhusu vipimo, muundo wa bidhaa au vyeti kuwa ya mamlaka. Ongeza vipimo vilivyothibitishwa kutoka kwenye orodha yako ya bidhaa au mfumo wa taarifa za bidhaa wakati wa kuhariri.

Linda Siri na Ufikiaji wa Hifadhidata

Weka .env kuwa ya faragha, tumia vitambulisho maalum vya hifadhidata na epuka kuweka funguo za API au siri za vipindi kwenye mfumo wa udhibiti wa matoleo. Ikiwa unatumia seva iliyopo ya MySQL, mpe mtumiaji wa programu ufikiaji wa hifadhidata iliyokusudiwa pekee.

Jitayarishe Kabla ya Kutumia Hadharani

Soma mwongozo wa uwekaji wa hazina kabla ya kuiweka AI Writer wazi kwenye intaneti. Seva ya umma inahitaji HTTPS, egress ya mtandao iliyozuiwa na kivinjari kilichowekwa kwenye sandbox. Uthibitishaji wa DNS peke yake si kinga kamili dhidi ya uunganishaji upya wa DNS.

Mikopo iliyojengwa ndani huweka kikomo cha matumizi, lakini mradi huu hauna ujumuishaji wa malipo, ununuzi wa mikopo kiotomatiki, urejeshaji wa nenosiri au uthibitishaji wa barua pepe. Kuchapisha hazina pia hakutengenezi programu iliyopangishwa au onyesho la moja kwa moja.

Elewa Faili Kuu za Mradi

• app.js: Programu ya Express pamoja na njia za akaunti na salio.
• db.js: Bwawa la miunganisho ya MySQL.
• youtube.js: Mtiririko wa majaribio wa video wenye mipaka.
• lib/ai.js: Maombi kwa modeli na vidokezo vya lugha nyingi.
• lib/network.js: Uthibitishaji wa URL za HTTPS za umma.
• views/: Kurasa za EJS na mpangilio unaoshirikiwa.
• public/: Mitindo, msimbo wa kivinjari na utambulisho wa chapa.
• schema.sql: Jedwali la hifadhidata la akaunti.
• scripts/setup.js: Kisakinishi shirikishi.
• compose.mysql.yml: Huduma ya hiari ya MySQL ya ndani.
• test/: Ukaguzi wa kiotomatiki wa urejeshaji.

Hitimisho

AI Writer hutoa mtiririko wa vitendo wa ndani wa kubadilisha picha za bidhaa kuwa rasimu za biashara ya mtandaoni za lugha nyingi. Anza na kisakinishi shirikishi, unganisha modeli ya OpenAI yenye uwezo wa kuona, ongeza picha za HTTPS za umma na ukague kila matokeo kabla ya kuchapisha. Vipengele vyake vya akaunti, salio, tafsiri na majaribio hutoa msingi thabiti, huku usambazaji wa uzalishaji bado ukihitaji kutengwa kwa uangalifu kwa kivinjari, udhibiti wa mtandao na HTTPS.