Sebenzisa i-xxd-strip-ai-meta ukususa ngobuningi izimpawu nemethadatha yomthombo we-AI ezithombeni

Isingeniso Sephrojekthi

xxd-strip-ai-meta iyithuluzi lokuhlanza imethadatha yezithombe elisekelwe ku-ExifTool. Lingasetshenziswa njengohlelo oluzimele lomugqa womyalo, noma lifakwe njenge-AI Agent Skill. Lingacubungula izithombe zasendaweni ngobuningi, lisuse ulwazi lomthombo olusekelwayo lwe-C2PA, Content Credentials, OpenAI kanye ne-gpt-image, kanye nemethadatha efana ne-EXIF, XMP, IPTC namazwana.

Ngokuzenzakalelayo, ithuluzi liguqula amafayela oqobo ngqo, kodwa alikwazi ukuqopha kabusha noma ukuphinda lifake ikhodi kumaphikseli ezithombe. Ligcina iphrofayela yombala ye-ICC nesikhathi sokuguqulwa kwefayela, ngakho lilungele ukuvikela ubumfihlo, ukucubungula izinto zangaphakathi nokuhlela imethadatha.

Imikhawulo yokusetshenziswa: Leli ithuluzi lokuhlanza imethadatha. Alikwazi ukususa ama-watermark abonakala ngamehlo esithombeni, futhi alikwazi ukuqinisekisa ukususwa kwama-watermark afihlekile asezingeni lamaphikseli, iminwe yesikhulumi noma amarekhodi aseva. Ungalisebenzisi ukudukisa abanye mayelana nomthombo wesithombe.

Izici Eziyinhloko

• Useshela ngokuphindaphindiwe izithombe ze-PNG, JPEG, WebP, TIFF, HEIC, HEIF ne-AVIF.
• Isusa ulwazi lomthombo we-AI olusekelwayo kanye nemethadatha ye-EXIF, XMP, IPTC, amazwana nokunye.
• Ngokuzenzakalelayo igcina iphrofayela yombala ye-ICC, inciphise ingozi yokushintsha kokubonakala kwemibala.
• Igcina isikhathi sokuguqulwa kwefayela, futhi ayiqophi kabusha noma iphinde ifake ikhodi kumaphikseli esithombe.
• Yamukela amafayela nezinkomba eziningi ngesikhathi esisodwa, futhi isuse ngokuzenzakalelayo okuphindaphindwayo okubangelwa izindlela ezigqagqanayo.
• Iqa izinkomba ezingaphansi ezifihliwe nezinkomba ezivamile zenqolobane.
• Ngokuzenzakalelayo iyeqa amafayela anesandiso esingahambisani nesihloko sefayela futhi asevele abonakele.
• Isekela ukubuka kuqala, ukwenza ikhophi yasenqolobaneni yefayela loqobo, ukucubungula ngobuningi ngesikhathi esifanayo, izingodo, ukusebenza ngemuva nokuqinisekisa ngemva kokuhlanza.

Amandla okubhala imethadatha ancike ku-ExifTool nefomethi yefayela ehambisanayo. Ithuluzi lamukela kuphela amafayela noma izinkomba zasendaweni; alicubunguli ngokuqondile izixhumanisi ezikude noma amafayela acindezelwe.

Izidingo Zokufaka

Ukuze usebenzise iphrojekthi, udinga i-Python 3.10 noma inguqulo ephezulu kanye ne-ExifTool efakwe ku-PATH yesistimu. Iphrojekthi ayinakho ukuncika kwe-Python kwezinkampani zangaphandle.

1. Faka i-ExifTool

Abasebenzisi be-macOS bangayifaka nge-Homebrew:

brew install exiftool

Abasebenzisi be-Debian noma Ubuntu bangayifaka ngomphathi wamaphakheji wesistimu:

sudo apt install libimage-exiftool-perl

Abasebenzisi be-Windows bangalanda futhi bafake ku-iwebhusayithi esemthethweni ye-ExifTool, bese beqinisekisa ukuthi inkomba equkethe ifayela layo elisebenzisekayo ingeziwe ku-PATH.

2. Hlola Indawo Yokusebenza

python3 --version
exiftool -ver

Inguqulo ye-Python kufanele ibe ngu-3.10 noma ngaphezulu. Ku-Windows, umyalo we-Python ungaba python; uma kunjalo, shintsha u-python3 ezibonelweni ezilandelayo ngokufanele.

3. Klona Iphrojekthi

git clone https://github.com/nevertoday/xxd-strip-ai-meta.git
cd xxd-strip-ai-meta

Yonke imiyalo elandelayo ithatha ngokuthi inkomba yamanje iyimpande yeriphozithori.

Inqubo Eyisisekelo Yokusebenzisa

Isinyathelo Sokuqala: Buka Kuqala Amafayela Azocutshungulwa

Ngenxa yokuthi indlela ezenzakalelayo iguqula amafayela oqobo ngqo, kufanele uqale usebenzise i---dry-run. Le pharamitha ibala amafayela kuphela futhi ayenzi ukuhlanza.

python3 scripts/clean_image_provenance.py /path/to/images --dry-run

Hlola okukhiphayo ukuze uqinisekise ukuthi ububanzi bokuskena abunazo izithombe okungafanele zicutshungulwe. Uma ilogi ikhombisa ukuthi ifayela leqiwe noma indlela ayikho, lungisa lezo zinkinga kuqala.

Isinyathelo Sesibili: Hlanza Ngemva Kokugcina Ikhophi Yasenqolobaneni

Ngemva kokuqinisekisa ukuthi uhlu lwamafayela lulungile, kunconywa ukuthi usebenzise i---backup okokuqala lapho uqala umsebenzi wangempela:

python3 scripts/clean_image_provenance.py /path/to/images --backup

I-ExifTool izogcina ikhophi yasenqolobaneni yefayela loqobo enegama elithi *_original. Ngemva kokuqinisekisa ukuthi umphumela uyahambisana nokulindelekile, nquma ngokwakho ukuthi uzowaphatha kanjani la makhophi.

Isinyathelo Sesithathu: Cubungula Amafayela Nezinkomba Ndawonye

Isikripthi sivumela ukuthi udlulise amafayela nezinkomba eziningi zasendaweni ngesikhathi esisodwa:

python3 scripts/clean_image_provenance.py \
  /path/to/a.png \
  /path/to/folder-a \
  /path/to/folder-b

Izinkomba zizoskenwa ngokuphindaphindiwe. Uma izindlela zokufaka zigqagqana, ithuluzi lizosusa okuphindaphindwayo ngokuzenzakalelayo ukuze ifayela elifanayo lingacutshungulwa kaningi ngenxa yezindlela ezigqagqanayo.

Amapharamitha Avamile

• --dry-run: Buka amafayela kuqala kuphela, ngaphandle kokwenza izinguquko.
• --backup: Gcina ikhophi yasenqolobaneni yefayela loqobo eyenziwe yi-ExifTool.
• --jobs 5: Setha inani lamaqoqo asebenza ngesikhathi esisodwa; okuzenzakalelayo ngu-5. Ungayisetha ku-1 ukuze unciphise umthwalo wesistimu.
• --chunk-size 100: Setha inani lamafayela acutshungulwa kuqoqo ngalinye; okuzenzakalelayo ngu-100.
• --log-file PATH: Bhala ilogi endleleni ethile.
• --background: Qalisa umsebenzi ngemuva futhi ukhiphe imiyalo edingekayo ukuwumisa nokubuka ilogi; ilungele i-POSIX shell.
• --drop-color-profile: Susa nephrofayela yombala ye-ICC, kodwa lokhu kungathinta ukubonakala kwemibala yesithombe.
• --no-verify: Yeqa ukuhlolwa kwezimpawu zomthombo wemethadatha ngemva kokuhlanza.

Imisebenzi Emikhulu

Ukusebenza Ngemuva

Kumasistimu asekela i-POSIX shell, ungasebenzisa imodi yangemuva emisebenzini ethatha isikhathi eside:

python3 scripts/clean_image_provenance.py /path/to/images --background

Ngemva kokuqala komyalo, kuzokhishwa imiyalo yokumisa umsebenzi nokubuka ilogi. Gcina le miyalezo ukuze ukwazi ukuqapha noma ukumisa umsebenzi kamuva.

Lawula Ukusebenza Ngasikhathi Sinye Nobukhulu Beqoqo

Ngokuzenzakalelayo kusetshenziswa amaqoqo angu-5 asebenza ngesikhathi esisodwa, iqoqo ngalinye linamafayela afinyelela ku-100. Uma izinsiza zedivayisi zilinganiselwe, yehlisa inani lokusebenza ngesikhathi esisodwa libe ngu-1:

python3 scripts/clean_image_provenance.py /path/to/images \
  --jobs 1 \
  --chunk-size 100 \
  --log-file /path/to/clean-image-meta.log

Ilogi ayisetshenziselwa ukubuka kuphela ukwehluleka kokuhlanza; kufanele futhi uhlole amafayela eqiwe nezindlela zokufaka ezingekho. Ikhodi yokuphuma engu-0 ayisho ngaso sonke isikhathi ukuthi izithombe zicutshunguliwe; ingasho nokuthi awatholwanga amafayela.

Ukuqinisekisa Namakhodi Okuphuma

Ngokuzenzakalelayo, isikripthi sihlola ngemva kokuhlanza ukuthi okukhiphayo kwe-ExifTool kusaqukethe yini amagama angukhiye omthombo ahlobene. Lokhu kuqinisekisa kuhlola izimpawu zemethadatha kuphela; akukona ukuhlolwa okujwayelekile kwama-watermark futhi akukwazi ukunquma ukuthi zikhona yini izimpawu ezifihlekile ezisezingeni lamaphikseli.

• Ikhodi yokuphuma 0: Akukho ukwehluleka kokuhlanza noma okusele okubikiwe; kungenzeka futhi ukuthi awekho amafayela atholakele.
• Ikhodi yokuphuma 1: Kuvele ukwehluleka kokuhlanza.
• Ikhodi yokuphuma 2: Kutholakale izimpawu ezisele.

Uma ngesizathu esithile ungadingi ukuqinisekisa ngemva kokuhlanza, sebenzisa:

python3 scripts/clean_image_provenance.py /path/to/images --no-verify

Ngemva kokweqa ukuqinisekisa, ithuluzi ngeke lenze ukuhlolwa kwamagama angukhiye omthombo okuchazwe ngenhla. Ngakho-ke, sebenzisa ilogi nezinye izindlela zokuhlola ukuze uqinisekise umphumela.

Izincomo Zokusebenzisa Ezithuthukile

Sungula Ukuhleleka Kokucubungula Okuphephile

1. Qala ngokusebenzisa i---dry-run endleleni okuqondiswe kuyo, bese uhlola ububanzi bokuskena.
2. Lapho uqala umsebenzi wangempela, sebenzisa i---backup ukuze ugcine ifayela loqobo elingabuyiselwa.
3. Emisebenzini emikhulu, cacisa i---log-file ukuze kube lula ukuhlola amafayela ahlulekile, eqiwe nangekho.
4. Uma izinsiza zilinganiselwe, yehlisa i---jobs ibe ngu-1, bese ulungisa i---chunk-size ngokuya ngendawo yakho.
5. Sebenzisa ikhodi yokuphuma ukuze unqume ukuthi kukhona yini ukwehluleka noma okusele, kodwa ungakushayi indiva okuqukethwe ilogi.
6. Hlola umbala nokusebenziseka kwezithombe ezicutshunguliwe ngesibukeli sezithombe, bese uphatha amafayela ekhophi yasenqolobaneni.

Susa Iphrofayela Yombala Ye-ICC Ngokuqaphela

Ukugcina iphrofayela ye-ICC ngokuzenzakalelayo kuhloselwe ukugcina ukubonakala kwemibala yesithombe. Uma udinga ngempela ukususa nephrofayela yombala, engeza:

python3 scripts/clean_image_provenance.py /path/to/images \
  --backup \
  --drop-color-profile

--drop-color-profile ingashintsha ukubonakala kwemibala ezinhlelweni noma kumadivayisi ahlukene, ngakho kufanele uqale uyihlole kumakhophi ambalwa.

Qonda Imikhawulo Yamafomethi

Isikripthi sisesha amafayela anezandiso ezisekelwayo, kodwa ukuthi ifomethi ethile ingabhalwa ngempumelelo kusancike enguqulweni ye-ExifTool efakiwe nakwifomethi yefayela uqobo. Uma kuvela ukwehluleka, hlola ilogi nokukhiphayo kwe-ExifTool, ungahluleli ukuhambisana ngesandiso kuphela.

Faka Njenge-AI Agent Skill

Iphrojekthi ingafakwa futhi enkombeni yamakhono ye-AI Agent. Nasi isibonelo nge-Claude Code:

git clone https://github.com/nevertoday/xxd-strip-ai-meta.git \
  ~/.claude/skills/xxd-strip-ai-meta

Uma inkomba enegama elifanayo isivele ikhona endaweni okuqondiswe kuyo, qala wenze ikhophi yayo yasenqolobaneni noma usebenzise enye indawo yokufaka. Ifayela lokungena le-Skill ngu-SKILL.md. I-Agent kufanele isebenzise isikripthi isuka enkombeni yokufaka, noma iqale ithole futhi isebenzise indlela ephelele yesikripthi.

Isiphetho

xxd-strip-ai-meta inikeza inqubo yokuhlela imethadatha yezithombe ngobuningi ngaphandle kwamaphakheji e-Python ezinkampani zangaphandle. Ekusetshenzisweni kwangempela, kunconywa ukulandela ukuhleleka kokuthi “buka kuqala, yenza ikhophi yasenqolobaneni, hlanza, hlola ilogi”, futhi uhlukanise ngokucacile phakathi kokuhlanza imethadatha, ukususwa kwama-watermark abonakalayo nokutholwa kwezimpawu ezisezingeni lamaphikseli. Iphrojekthi inelayisense ye-MIT; i-ExifTool iyisidingo esifakwa ngokwehlukana futhi ilandela ilayisense yayo.