
Loyiha haqida
xxd-strip-ai-meta — ExifTool asosidagi rasmlar metama’lumotlarini tozalash vositasi bo‘lib, undan mustaqil buyruq qatori dasturi sifatida foydalanish yoki AI Agent Skill sifatida o‘rnatish mumkin. U mahalliy rasmlarni ommaviy qayta ishlaydi, qo‘llab-quvvatlanadigan C2PA, Content Credentials, OpenAI, gpt-image kelib chiqishi ma’lumotlari, shuningdek EXIF, XMP, IPTC va izohlar kabi metama’lumotlarni tozalaydi.
Vosita sukut bo‘yicha asl faylni bevosita o‘zgartiradi, biroq rasm piksellarini dekodlamaydi yoki qayta kodlamaydi. U ICC rang profilini va faylning o‘zgartirish vaqtini saqlaydi, shu sababli maxfiylikni himoyalash, ichki materiallarni qayta ishlash va metama’lumotlarni tartibga solish uchun mos keladi.
Foydalanish chegaralari: bu metama’lumotlarni tozalash vositasi. U rasmda ko‘zga ko‘rinadigan suv belgilarini o‘chira olmaydi, shuningdek piksel darajasidagi yashirin suv belgilari, platforma izlari yoki server tomonidagi yozuvlar to‘liq o‘chirilishini kafolatlamaydi. Undan rasm manbasini boshqalarni chalg‘itadigan tarzda ko‘rsatish uchun foydalanmang.
Asosiy imkoniyatlar
- PNG, JPEG, WebP, TIFF, HEIC, HEIF va AVIF rasmlarini rekursiv qidiradi.
- Qo‘llab-quvvatlanadigan AI kelib chiqishi ma’lumotlari hamda EXIF, XMP, IPTC, izohlar va boshqa metama’lumotlarni tozalaydi.
- Sukut bo‘yicha ICC rang profilini saqlaydi va ranglar ko‘rinishi o‘zgarishi xavfini kamaytiradi.
- Faylning o‘zgartirish vaqtini saqlaydi, rasm piksellarini dekodlamaydi yoki qayta kodlamaydi.
- Bir vaqtning o‘zida bir nechta fayl va katalogni qabul qiladi hamda ustma-ust tushadigan kiritishlar natijasidagi takroriy elementlarni avtomatik olib tashlaydi.
- Yashirin ichki kataloglar va keng tarqalgan kesh kataloglarini o‘tkazib yuboradi.
- Kengaytmasi fayl sarlavhasiga mos kelmaydigan va aniqlangan fayllarni sukut bo‘yicha o‘tkazib yuboradi.
- Ko‘rib chiqish, asl faylni zaxiralash, parallel ommaviy qayta ishlash, jurnal yuritish, fonda ishlash va tozalashdan keyin tekshirishni qo‘llab-quvvatlaydi.
Muayyan formatga metama’lumot yozish imkoniyati ExifTool va tegishli fayl formatiga bog‘liq. Vosita faqat mahalliy fayl yoki kataloglarni qabul qiladi; masofaviy havolalar va arxivlar bilan bevosita ishlamaydi.
O‘rnatish talablari
Loyihani ishga tushirish uchun Python 3.10 yoki undan yuqori versiyasi hamda tizim PATH o‘zgaruvchisiga qo‘shilgan ExifTool kerak. Loyihaning o‘zida uchinchi tomon Python bog‘liqliklari mavjud emas.
1. ExifTool’ni o‘rnatish
macOS foydalanuvchilari Homebrew orqali o‘rnatishi mumkin:
brew install exiftoolDebian yoki Ubuntu foydalanuvchilari tizim paket menejeri orqali o‘rnatishi mumkin:
sudo apt install libimage-exiftool-perlWindows foydalanuvchilari ExifTool’ni ExifTool rasmiy saytidan yuklab olib o‘rnatishi, so‘ng uning bajariluvchi fayli joylashgan katalog PATH ga qo‘shilganini ta’minlashi kerak.
2. Ishlash muhitini tekshirish
python3 --version
exiftool -verPython versiyasi 3.10 yoki undan yuqori bo‘lishi kerak. Windows muhitida Python buyrug‘i python bo‘lishi mumkin; bunday holatda keyingi misollardagi python3 ni mos ravishda almashtiring.
3. Loyihani klonlash
git clone https://github.com/nevertoday/xxd-strip-ai-meta.git
cd xxd-strip-ai-metaQuyidagi barcha buyruqlar joriy katalog omborning ildiz katalogi deb hisoblaydi.
Asosiy foydalanish jarayoni
Birinchi qadam: avval qayta ishlanadigan fayllarni ko‘rib chiqing
Sukut bo‘yicha dastur asl fayllarni bevosita o‘zgartirgani sababli, birinchi ishlatishda --dry-run parametridan foydalaning. Bu parametr faqat fayllar ro‘yxatini chiqaradi va tozalashni bajarmaydi.
python3 scripts/clean_image_provenance.py /path/to/images --dry-runNatijani tekshirib, skanerlash doirasida qayta ishlanmasligi kerak bo‘lgan rasmlar yo‘qligiga ishonch hosil qiling. Jurnalda fayl o‘tkazib yuborilgani yoki yo‘l mavjud emasligi haqida xabar chiqsa, avval bu muammolarni hal qiling.
Ikkinchi qadam: zaxira nusxasini saqlab, tozalang
Fayllar ro‘yxati to‘g‘ri ekaniga ishonch hosil qilgach, birinchi haqiqiy ishga tushirishda --backup parametrini qo‘shish tavsiya etiladi:
python3 scripts/clean_image_provenance.py /path/to/images --backupExifTool *_original nomli asl fayl zaxira nusxalarini saqlaydi. Natija kutilganidek ekanini tasdiqlagach, ushbu zaxiralarni qanday boshqarishni o‘zingiz hal qiling.
Uchinchi qadam: fayl va kataloglarni aralashtirib qayta ishlash
Skript bir marta ishga tushirilganda bir nechta mahalliy fayl va katalogni qabul qiladi:
python3 scripts/clean_image_provenance.py \
/path/to/a.png \
/path/to/folder-a \
/path/to/folder-bKataloglar rekursiv skanerlanadi. Kiritish yo‘llari bir-birining ichiga kirsa, vosita takroriy elementlarni avtomatik olib tashlaydi va bir faylning ustma-ust yo‘llar sabab qayta ishlanishining oldini oladi.
Ko‘p ishlatiladigan parametrlar
--dry-run: faqat fayllarni ko‘rib chiqadi, o‘zgartirish kiritmaydi.--backup: ExifTool yaratgan asl fayl zaxira nusxalarini saqlaydi.--jobs 5: parallel paketlar sonini belgilaydi, sukut bo‘yicha 5; tizim yuklamasini kamaytirish uchun 1 ga o‘rnatish mumkin.--chunk-size 100: har bir paketda qayta ishlanadigan fayllar sonini belgilaydi, sukut bo‘yicha 100.--log-file PATH: jurnalni ko‘rsatilgan yo‘lga yozadi.--background: vazifani fonda ishga tushiradi va vazifani to‘xtatish hamda jurnalni ko‘rish uchun kerakli buyruqlarni chiqaradi; POSIX shell uchun mos.--drop-color-profile: ICC rang profilini ham o‘chiradi, biroq bu rasm ranglari ko‘rinishiga ta’sir qilishi mumkin.--no-verify: tozalashdan keyin metama’lumotlardagi kelib chiqish belgilarini tekshirishni o‘tkazib yuboradi.
Katta hajmdagi vazifalar
Fonda bajarish
POSIX shell’ni qo‘llab-quvvatlaydigan tizimlarda uzoq davom etadigan vazifalarni fon rejimida ishga tushirish mumkin:
python3 scripts/clean_image_provenance.py /path/to/images --backgroundBuyruq ishga tushgach, vazifani to‘xtatish va jurnalni ko‘rish buyruqlarini chiqaradi. Keyinchalik vazifani kuzatish yoki to‘xtatish uchun ushbu ko‘rsatmalarni saqlab qo‘ying.
Parallel ishlash va paket hajmini boshqarish
Sukut bo‘yicha 5 ta parallel paket ishlatiladi va har bir paketda ko‘pi bilan 100 ta fayl bo‘ladi. Qurilma resurslari cheklangan bo‘lsa, parallel jarayonlar sonini 1 ga kamaytirish mumkin:
python3 scripts/clean_image_provenance.py /path/to/images \
--jobs 1 \
--chunk-size 100 \
--log-file /path/to/clean-image-meta.logJurnal faqat tozalashdagi xatolarni ko‘rish uchun emas, o‘tkazib yuborilgan fayllar va mavjud bo‘lmagan kiritish yo‘llarini tekshirish uchun ham kerak. Chiqish kodi 0 bo‘lishi rasmlar qayta ishlanganini anglatmaydi; hech qanday fayl topilmagan bo‘lishi ham mumkin.
Tekshiruv va chiqish kodlari
Sukut bo‘yicha skript tozalashdan keyin ExifTool chiqishida tegishli kelib chiqish kalit so‘zlari qolgan-qolmaganini tekshiradi. Bu tekshiruv faqat metama’lumot belgilarini aniqlash uchun mo‘ljallangan; u umumiy suv belgisi detektori emas va piksel darajasidagi yashirin belgilar mavjudligini aniqlay olmaydi.
0chiqish kodi: tozalashdagi xatolar yoki qoldiq belgilar haqida xabar berilmagan; hech qanday fayl topilmagan bo‘lishi ham mumkin.1chiqish kodi: tozalashda xato yuz berdi.2chiqish kodi: qoldiq belgilar aniqlandi.
Agar biror maxsus sababga ko‘ra tozalashdan keyingi tekshiruvni bajarish shart bo‘lmasa, quyidagidan foydalaning:
python3 scripts/clean_image_provenance.py /path/to/images --no-verifyTekshiruv o‘tkazib yuborilganda vosita yuqoridagi kelib chiqish kalit so‘zlarini tekshirmaydi. Shu sababli natijani jurnal va boshqa tekshiruv usullari yordamida tasdiqlash kerak.
Kengaytirilgan foydalanish tavsiyalari
Ishlov berish tartibini puxtaroq tashkil etish
- Maqsadli yo‘l uchun avval
--dry-runni ishga tushirib, skanerlash doirasini tekshiring. - Birinchi haqiqiy ishga tushirishda
--backupdan foydalanib, tiklash mumkin bo‘lgan asl faylni saqlang. - Katta vazifalar uchun
--log-fileni belgilang, shunda xato, o‘tkazib yuborilgan va yo‘q fayllarni tekshirish oson bo‘ladi. - Resurslar cheklanganida
--jobsni 1 gacha kamaytiring, so‘ng muhitga qarab--chunk-sizeni sozlang. - Xato yoki qoldiq mavjudligini chiqish kodlari orqali aniqlang, biroq jurnal mazmunini e’tiborsiz qoldirmang.
- Zaxira fayllarini boshqarishdan oldin qayta ishlangan rasmlarning ranglari va yaroqliligini rasm ko‘ruvchi dasturda tekshiring.
ICC rang profilini o‘chirishda ehtiyot bo‘ling
ICC profilini sukut bo‘yicha saqlash rasm ranglari ko‘rinishini barqaror saqlash uchun mo‘ljallangan. Rang profilini ham o‘chirish zarur bo‘lsa, quyidagini qo‘shing:
python3 scripts/clean_image_provenance.py /path/to/images \
--backup \
--drop-color-profile--drop-color-profile turli dastur yoki qurilmalarda ranglar ko‘rinishini o‘zgartirishi mumkin. Shu sababli avval oz miqdordagi nusxalarda sinab ko‘ring.
Format cheklovlarini tushunish
Skript qo‘llab-quvvatlanadigan kengaytmali fayllarni qidiradi, biroq muayyan formatga muvaffaqiyatli yozish imkoniyati o‘rnatilgan ExifTool versiyasi va fayl formatining o‘ziga bog‘liq. Xato yuz berganda moslikni faqat kengaytmaga qarab baholamasdan, jurnal va ExifTool chiqishini tekshiring.
AI Agent Skill sifatida o‘rnatish
Loyihani AI Agent’ning skill katalogiga ham joylashtirish mumkin. Masalan, Claude Code uchun:
git clone https://github.com/nevertoday/xxd-strip-ai-meta.git \
~/.claude/skills/xxd-strip-ai-metaMaqsadli joyda xuddi shu nomdagi katalog mavjud bo‘lsa, avval uning zaxira nusxasini yarating yoki boshqa o‘rnatish joyidan foydalaning. Skill’ning kirish fayli SKILL.md hisoblanadi. Agent skriptni o‘rnatish katalogidan ishga tushirishi yoki avval skriptning mutlaq yo‘lini aniqlab, undan foydalanishi kerak.
Xulosa
xxd-strip-ai-meta uchinchi tomon Python paketlarisiz metama’lumotlarni ommaviy tartibga solish imkonini beradi. Amaliy foydalanishda “avval ko‘rib chiqish, keyin zaxiralash, so‘ng tozalash va jurnalni tekshirish” tartibiga amal qilish, shuningdek metama’lumotlarni tozalash, ko‘rinadigan suv belgisini o‘chirish va piksel darajasidagi belgilarni aniqlashni aniq farqlash tavsiya etiladi. Loyiha MIT litsenziyasi asosida tarqatiladi; ExifTool alohida o‘rnatiladigan bog‘liqlik bo‘lib, o‘z litsenziyasiga ega.
