Dala Umbhalo We-eCommerce Wezilimi Eziningi Ngezithombe Zemikhiqizo usebenzisa i-AI Writer

Yini i-AI Writer?

I-AI Writer iwuhlelo oluvulekile oluguqula izithombe zemikhiqizo zibe izincazelo ze-ecommerce ezihleleka. Ungahlinzeka ngama-URL ezithombe zomphakathi e-HTTPS aphakathi kweyodwa neziyisishiyagalombili, ukhethe ulimi lokuphumayo bese usebenzisa imodeli ye-Chat Completions ekwazi ukubona izithombe ye-OpenAI ukuze kwakheke okusalungiswa.

Lolu hlelo lusekela isiNgisi, isiTurkey, iSpanishi, isiJalimane, isiFulentshi nesiShayina. Luphinde lufake ukuqinisekiswa kwama-akhawunti, ukuhlela okusekelwe esipheqululini, ukuhumusha nohlelo lwamakhredithi olusekelwa yi-MySQL.

I-AI Writer yenza okusalungiswa kunokuba yenze imininingwane yomkhiqizo eqinisekisiwe. Buyekeza zonke izincazelo ngaphambi kokuzishicilela ngoba izithombe azikwazi ukufakazela ngokuthembekile imininingwane efana nezilinganiso, ukwakheka kwendwangu noma izitifiketi.

Izici Ezisemqoka

• Ukubhala okusekelwe ezithombeni: Yenza umbhalo usebenzisa isithombe somkhiqizo esisodwa kuya kweziyisishiyagalombili esifinyeleleka esidlangalaleni nge-HTTPS.
• Ukulanda amakhasi emikhiqizo: Sebenzisa i-Puppeteer ukuqoqa izixhumanisi zezithombe ekhasini lomkhiqizo elisesidlangalaleni.
• Izilimi eziyisithupha zokuphumayo: Yenza okuqukethwe ngesiNgisi, ngesiTurkey, ngeSpanishi, ngesiJalimane, ngesiFulentshi noma ngesiShayina.
• Ukuhlela nokuhumusha: Thuthukisa okusalungiswa okukhiqiziwe esipheqululini, ukukopishe futhi ukuhumushe ngesenzo esisodwa.
• Ama-akhawunti namakhredithi: Lolu hlelo lusebenzisa amaphasiwedi e-bcrypt, amaseshini e-MySQL nebhalansi evikela ekusebenziseni imali ngokweqile ngesikhathi esifanayo.
• Ukubuyiselwa kwemali uma kwehluleka: Amakhredithi abekelwe eceleni ayabuyiselwa lapho izicelo zokukhiqiza ezisekelwayo zehluleka.
• Okokufaka kwevidiyo kokuhlolwa: Khipha amafreyimu afinyelela kwayisishiyagalombili kuvidiyo emfushane ye-YouTube bese uwasebenzisa njengokokufaka okubonakalayo.

Izidingo Zokuqala

Ngaphambi kokufaka, lungiselela lokhu okulandelayo:

• Node.js 22.12 noma eyakamuva ne-npm.
• Docker ene-Compose, noma ukufinyelela kuseva ekhona ye-MySQL 8 noma eyakamuva.
• Ukhiye we-OpenAI API onokufinyelela kumodeli ye-Chat Completions ekwazi ukubona izithombe.
• I-Chrome efakwe nge-Puppeteer uma ufuna ukulanda izithombe emakhasini emikhiqizo.
• I-FFmpeg ne-FFprobe etholakala ku-PATH uma ufuna ukuzama ukucutshungulwa kwevidiyo kokuhlolwa.

I-FFmpeg ayidingeki uma uhlela kuphela ukwenza izincazelo ngezithombe.

Faka i-AI Writer Ngokuzenzakalela

Umbhalo wokumisa osebenzisanayo uyindlela elula kakhulu yokufaka. Klona inqolobane, ngena kufolda yayo, sebenzisa isifaki bese uqala uhlelo:

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

Isifaki silanda okuncikile kohlelo ne-Chrome, sikucela ukhiye wakho we-OpenAI API ngaphandle kokuwubonisa, sakha izimfihlo zesizindalwazi neseshini, bese siqalisa i-MySQL. Sigcina amanani akhona e-.env futhi sakhe ikhophi eyisipele yasendaweni.

Ngesikhathi sokumisa, khetha docker ukuze uqale ngokuzenzakalela ikhonteyina ye-MySQL eqhubekayo. I-Docker kumele ibe isifakiwe futhi isebenza. Khetha existing ukuze uxhumane neseva yakho ye-MySQL. Ngemininingwane yomlawuli, isifaki singakha isizindalwazi esizinikezele nomsebenzisi wohlelo; asiligcini iphasiwedi yomlawuli.

Ngemva kokuqala, vula http://localhost:3000 esipheqululini sakho.

Misa Isizindalwazi Se-Docker

Ukuze umise ikhonteyina ye-MySQL yasendaweni ngaphandle kokususa idatha yayo eqhubekayo, sebenzisa:

docker compose -f compose.mysql.yml stop

Ukushintsha imininingwane yesizindalwazi ku-.env akusethi kabusha ivolumu ye-Docker ebivele iqalisiwe. Gcina imininingwane yokuqala noma wenze ukuthuthwa kwesizindalwazi okuhleliwe.

Faka i-AI Writer Ngokuzenzela

Ukumisa ngokuzenzela kukunikeza ukulawula okuqondile kwemvelo nokumiswa kwesizindalwazi. Klona iphrojekthi, faka okuncikile kwayo okuqondile bese udala ifayela lemvelo:

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'))"

Kopisha inani elikhiqiziwe ulifake ku-SESSION_SECRET ku-.env. Imfihlo kumele ibe nezinhlamvu okungenani ezingu-32. Bese ufaka ukhiye wakho we-OpenAI API nezilungiselelo zokuxhumana ne-MySQL. Sebenzisa imininingwane emisha futhi ungalokothi ufake ifayela le-.env enqolobaneni.

Dala isizindalwazi nomsebenzisi wohlelo usebenzisa umlawuli we-MySQL, nikeza lowo msebenzisi ukufinyelela kusizindalwazi, bese uqalisa amathebula nge-schema.sql:

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

Vula http://localhost:3000, dala i-akhawunti bese ungena.

Lungiselela Imvelo

Uhlelo lufunda izilungiselelo zalo kokuguquguqukayo kwemvelo. Lungiselela okungenani imininingwane ye-OpenAI, imfihlo yeseshini nokuxhumana nesizindalwazi.

• OPENAI_API_KEY: Imininingwane edingekayo ye-OpenAI API.
• OPENAI_MODEL: Imodeli ye-Chat Completions ekwazi ukubona izithombe. Okuzenzakalelayo ngu-gpt-4.1-mini.
• SESSION_SECRET: Imfihlo engahleliwe edingekayo enezinhlamvu okungenani ezingu-32.
• DB_HOST kanye ne-DB_PORT: Ikheli le-MySQL. Okuzenzakalelayo ngu-127.0.0.1 no-3306.
• DB_USER kanye ne-DB_PASSWORD: Imininingwane yasendaweni yomsebenzisi wohlelo lwe-MySQL.
• DB_NAME: Igama lesizindalwazi. Okuzenzakalelayo ngu-ai_writer.
• PORT: Ichweba le-HTTP lohlelo. Okuzenzakalelayo ngu-3000.
• NODE_ENV: Imodi yokusebenza. Okuzenzakalelayo ngu-development.
• TRUST_PROXY: Setha ukuthi uhlelo luthemba yini ummeleli oyedwa obuyisela i-HTTPS. Okuzenzakalelayo ngu-0.

Imodeli ekhethiwe kufanele isekele ukufakwa kwezithombe nge-Chat Completions API. Bheka umhlahlandlela osemthethweni we-OpenAI wokufaka izithombe ukuze ubone indlela yezicelo ehambisanayo.

Yakha Incazelo Yomkhiqizo Wakho Yokuqala

1. Dala i-akhawunti: Bhalisa ngohlelo lokusebenza lwendawo bese ungena ngemvume. I-akhawunti entsha ngayinye iqala ngamakhredithi ayishumi.
2. Engeza izithombe zomkhiqizo: Nikeza ama-URL ezithombe zomphakathi ze-HTTPS aphakathi kweyodwa neziyisishiyagalombili. Imodeli kufanele ikwazi ukufinyelela kula ma-URL.
3. Khetha ulimi: Khetha isiNgisi, isiTurkey, iSpanishi, isiJalimane, isiFulentshi noma isiShayina.
4. Yakha uhlaka: Thumela izithombe ukuze zihlaziywe ngokubuka futhi kwakhiwe incazelo.
5. Hlela umphumela: Buyekeza uhlaka esipheqululini bese ulungisa izimangalo ezingasekelwe, ithoni noma imininingwane yomkhiqizo.
6. Kopisha umbhalo: Kopisha incazelo ebuyekeziwe uyifake ohlelweni lwakho lwe-ecommerce.

Ukwakhiwa kwencazelo okuphumelele kubiza ikhredithi eyodwa. Uma isicelo sokwakha sihluleka, uhlelo lokusebenza lubuyisela ikhredithi ebigodliwe.

Isibonelo Sokusetshenziswa Kwezithombe

Emkhiqizweni onezinhlangothi eziningi, nikeza iqoqo elincane lama-URL ezithombe eziqondile ezifana nalezi:

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

Sebenzisa amakheli omphakathi e-HTTPS kuphela. Ukubuka okuningi kunganikeza imodeli umongo obonakalayo owengeziwe, kodwa akuthathi indawo yezicaciso eziqinisekisiwe ezisohlwini lomkhiqizo wakho.

Landa Izithombe Ekhasini Lomkhiqizo

Esikhundleni sokuqoqa mathupha wonke ama-URL ezithombe, i-AI Writer ingasebenzisa i-Puppeteer ukuhlola ikhasi lomkhiqizo lomphakathi nokuqoqa izixhumanisi zezithombe. Le ndlela idinga ukufakwa kwe-Chrome okuphethwe yi-Puppeteer.

1. Nikeza i-URL yomphakathi yekhasi lomkhiqizo ohlelweni lokulanda ikhasi.
2. Vumela uhlelo lokusebenza luqoqe izixhumanisi zezithombe ezingase zifanele.
3. Khetha izithombe zomkhiqizo ezifanele emiphumeleni elandiwe.
4. Yakha futhi ubuyekeze incazelo njengokujwayelekile.

Phatha kuphela amakhasi nezithombe ogunyazwe ukuzisebenzisa. Ekusetshenzisweni komphakathi, ukuzenzakalela kwesiphequluli kufanele kufakwe ku-sandbox futhi ukufinyelela kunethiwekhi kufanele kukhawulelwe.

Humusha Uhlaka Olukhona

Ngemva kokwakha noma ukuhlela incazelo, sebenzisa isenzo sokuhumusha ukuze ukhiqize olunye ulimi olusekelwayo. Ukuhumusha okuphumelele kubiza ikhredithi eyodwa. Buyekeza umbhalo ohunyushiwe ukuze uhlole amagama omkhiqizo, izwi lomkhiqizo nokunemba kwamaqiniso ngaphambi kokuwushicilela.

Sebenzisa Indlela Yokuhlola Yevidiyo

I-AI Writer ingakhipha amafreyimu afinyelela kwayisishiyagalombili kuvidiyo emfushane ye-YouTube bese ithumela lawo mafreyimu njengomongo obonakalayo. Amafreyimu endawo athunyelwa kumodeli njengama-data URL ngoba izixhumanisi zezithombe ze-localhost bezingeke zifinyeleleke ku-API.

Ividiyo kufanele ihlangabezane nayo yonke le mingcele:

• Akufanele ibe yividiyo ebukhoma.
• Akufanele ibe yinde kunemizuzu emithathu.
• Akufanele ibe nkulu kune-50 MB.
• I-FFmpeg ne-FFprobe kufanele kutholakale ku-PATH.
• Kufanele ugunyazwe ukucubungula imidiya.

Lesi sici sincike ekutholakaleni komlandi we-YouTube wangaphandle, futhi i-YouTube ingase yenqabe ukulanda okuzenzakalelayo. Ukucubungula okuhlulekile kubuyisela ikhredithi ebigodliwe.

Ukuthuthukisa Nokuhlola

Sebenzisa umyalo wokuthuthukisa ngenkathi ushintsha uhlelo lokusebenza:

npm run dev

Qalisa ukuhlolwa kwephrojekthi, izivivinyo ezizenzakalelayo nokuhlolwa kokuncika kokukhiqiza ngale miyalo:

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

Isethi yezivivinyo ihlanganisa ukuqinisekiswa kobunikazi, ukuzungeziswa kweseshini, ukuvikelwa kwe-CSRF, ukuqinisekiswa kwama-URL, okukhiphayo okubalekisiwe, ukwakhiwa kwezithombe, ukuhumusha, ukubuyiselwa kwamakhredithi nokusetshenziswa kwamakhredithi okufanayo. Izivivinyo zendawo zihlukanisa amasevisi esizindalwazi nawe-AI, ngakho azisebenzisi iziqinisekiso zokukhiqiza noma zenze izingcingo ze-API ezikhokhelwayo. Ukuhlanganiswa okuqhubekayo kudala nesiphakeli sesikhashana sangempela se-MySQL ukuze kuqinisekiswe ukwakhiwa kwe-schema yesifaki kanye namalungelo abasebenzisi besizindalwazi.

Amathiphu Athuthukile

Khetha Izithombe Ngokucophelela

Sebenzisa izithombe ezicacile ezibonisa umkhiqizo usezinhlangothini eziwusizo. Gcina isicelo ngaphakathi komkhawulo wezithombe ezisukela kweyodwa kuye kweziyisishiyagalombili. Izithombe ezengeziwe kufanele zengeze ulwazi olubonakalayo olunenani, kunokuphinda umbono ofanayo.

Gcina Idatha Yamaqiniso Ingaphandle Kokucatshangelwa Ngokubuka

Ungathathi izimangalo ezakhiwe mayelana nobukhulu, ukwakheka noma izitifiketi njengeziyiqiniso elisemthethweni. Engeza izicaciso eziqinisekisiwe ezivela ohlwini lwakho lwempahla noma ohlelweni lolwazi lwemikhiqizo ngesikhathi sokuhlela.

Vikela Izimfihlo Nokufinyelela Kwesizindalwazi

Gcina i-.env iyimfihlo, sebenzisa iziqinisekiso zesizindalwazi ezizinikele futhi ugweme ukufaka okhiye be-API noma izimfihlo zeseshini ohlelweni lokulawula izinguqulo. Uma usebenzisa isiphakeli se-MySQL esikhona, nikeza umsebenzisi wohlelo lokusebenza ukufinyelela kuphela kusizindalwazi ahloselwe sona.

Lungiselela Ngaphambi Kokusetshenziswa Komphakathi

Funda umhlahlandlela wokuthunyelwa wendawo yokugcina ngaphambi kokwethula i-AI Writer ku-inthanethi. Isiphakeli somphakathi sidinga i-HTTPS, ukuphuma kwenethiwekhi okukhawulelwe nesiphequluli esifakwe ku-sandbox. Ukuqinisekiswa kwe-DNS kukodwa akusona isivikelo esiphelele ekuhlanganisweni kabusha kwe-DNS.

Amakhredithi akhelwe ngaphakathi anciphisa ukusetshenziswa kwemali, kodwa iphrojekthi ayifaki ukuhlanganiswa kokukhokha, ukuthengwa kwamakhredithi okuzenzakalelayo, ukubuyiselwa kwamaphasiwedi noma ukuqinisekiswa kwe-imeyili. Ukushicilela indawo yokugcina nakho akudali uhlelo lokusebenza olusingathiwe noma idemo ebukhoma.

Qonda Amafayela Ayinhloko Ephrojekthi

• app.js: Uhlelo lwe-Express kanye nemizila yama-akhawunti namakhredithi.
• db.js: Iqoqo lokuxhumana ne-MySQL.
• youtube.js: Ukugeleza komsebenzi wokuhlola amavidiyo okunemikhawulo.
• lib/ai.js: Izicelo zamamodeli nemiyalelo yezilimi eziningi.
• lib/network.js: Ukuqinisekiswa kwama-URL omphakathi e-HTTPS.
• views/: Amakhasi e-EJS nesakhiwo esabiwe.
• public/: Izitayela, ikhodi yesiphequluli nokwakhiwa komkhiqizo.
• schema.sql: Ithebula lesizindalwazi sama-akhawunti.
• scripts/setup.js: Isifaki esisebenzisanayo.
• compose.mysql.yml: Isevisi ye-MySQL yasendaweni ongayikhetha.
• test/: Ukuhlolwa okuzenzakalelayo kokubuyela emuva.

Isiphetho

I-AI Writer inikeza ukugeleza komsebenzi kwasendaweni okuwusizo kokuguqula izithombe zemikhiqizo zibe okusalungiswa kwe-ecommerce ngezilimi eziningi. Qala ngesifaki esisebenzisanayo, xhuma imodeli ye-OpenAI ekwazi ukubona, engeza izithombe zomphakathi ze-HTTPS futhi ubuyekeze umphumela ngamunye ngaphambi kokuwushicilela. Izici zayo zama-akhawunti, amakhredithi, ukuhumusha nokuhlola zinikeza isisekelo esiqinile, kodwa ukuthunyelwa kwezinhlelo ezikhiqizayo kusadinga ukuhlukaniswa ngokucophelela kwesiphequluli, izilawuli zenethiwekhi kanye ne-HTTPS.