دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

من المعاينة المحلية حتى Cloudflare Pages: نشر AI Pose Gallery بالنسخة الصينية

كيشرح هاد الدليل وظائف AI Pose Gallery بالنسخة الصينية، وبنية البيانات وطريقة الاستعمال، وكيعاونك تكمل المعاينة المحلية، والتحقق من البيانات، وتحديث الترجمة، والنشر على Cloudflare Pages.

حوالي 19 دقايق ديال القراية
من المعاينة المحلية حتى Cloudflare Pages: نشر AI Pose Gallery بالنسخة الصينية

نبذة على المشروع

AI Pose Gallery بالنسخة الصينية هو أرشيف ثابت لوضعيات الجسم، موجّه للرسم بالذكاء الاصطناعي، والإبداع ثلاثي الأبعاد، ومراجع التصوير. المشروع كيضم 288 مجموعة و1439 صورة مرجعية من زوايا متعددة، وكيترجم بشكل كامل البيانات الوصفية اليابانية ديال الموقع الأصلي للصينية.

المستودع كيحتافظ حتى بـ1439 صورة مصغّرة بصيغة JPG و1439 صورة أصلية بصيغة PNG، يعني مجموع 2878 ملف صورة. الواجهة الأمامية عبارة عن تطبيق صفحة واحدة بلا اعتماديات، ويمكن استعمالها بلا تثبيت إطار عمل ولا تشغيل أدوات البناء.

معاينة معرض AI Pose Gallery بالنسخة الصينية

تقدر تزور العرض التجريبي المباشر باش تشوف النتيجة الفعلية، أو تحصل على المشروع كامل من مستودع GitHub.

المعرض فيه مراجع لوضعيات موجهة للبالغين، وبعض أسماء التصنيفات فيها مصطلحات مرتبطة بالسلوك الجنسي. المحتوى مخصص غير للإبداع الفني، ومراجع الحركات، وتعلّم تقنيات الواجهة الأمامية. ممنوع على القاصرين الولوج.

الوظائف الرئيسية

البحث والتصفية المركبة

المعرض منظم حسب أربعة أنظمة، والصفحة كتعرض عدد الصور وعدد مجموعات الوضعيات فكل نظام. مربع البحث كيدعم أسماء الوضعيات، والأرقام، والمعرّفات، وكلمات التصنيفات. الضغط على / كيركّز بسرعة على مربع البحث.

  • تبويبات أربعة أنظمة للوضعيات
  • 26 تصنيف للحركات
  • خمس زوايا: أمامية، مائلة جانبية، جانبية، من الأعلى، ومن الأسفل
  • تصفية مركبة حسب النظام والتصنيف والزاوية
  • إعادة ضبط شروط التصفية بنقرة واحدة

التصفح حسب المجموعات وبصورة بصورة

الصفحة كتوفّر جوج أوضاع: التجميع حسب الوضعية والتصفح صورة بصورة. بطاقات المجموعات كتعرض صوراً مصغّرة متعددة لنفس الوضعية من زوايا مختلفة، وبالمرور فوق الصورة المصغّرة أو النقر عليها يمكن تبديل الصورة الرئيسية للبطاقة.

منين كيتحل صندوق العرض، كتظهر أولاً الصورة المصغّرة بحجم 300×400، ومن بعد كتتحمّل الصورة الأصلية PNG بحجم 900×1200. صندوق العرض كيدعم تحميل PNG، ونسخ معرّف السجل، وفتح الصورة فنافذة جديدة.

  • ← و→: تبديل زاوية الوضعية الحالية
  • ↑ و↓: تبديل الوضعية
  • Esc: إغلاق صندوق العرض
  • السحب لليمين أو اليسار فالهاتف: تبديل الصورة

التخطيط المتجاوب

فالحاسوب المكتبي كيتستعمل تخطيط شبكي متعدد الأعمدة، وفالهاتف كيتستعمل تخطيط بشبكة من جوج أعمدة. لوحة التصفية فالأجهزة المحمولة يمكن فتحها أو طيّها، باش يسهل التصفح فالشاشات الصغيرة.

حجم البيانات وبنيتها

السجلات الـ1439 موزعة على أربعة أنظمة:

  • شخص واحد بكامل الجسم・النظام العادي: 365 سجل
  • شخص واحد بكامل الجسم・النظام المثير: 399 سجل
  • شخص واحد من الجزء العلوي للجسم: 400 سجل
  • شخصان متعانقان: 275 سجل

الواجهة الأمامية كتقرا فعلياً data/pose-zh.json. كل سجل فيه معرّف فريد، والنظام، ورقم الوضعية، والتصنيف، واسم الوضعية، والزاوية، ومسار الصورة المصغّرة، ومسار الصورة الأصلية، وسلسلة البحث.

{
  "id": "full_sexy_P001_front",
  "体系": "全身单人・性感系",
  "姿势编号": "P001",
  "分类": "站姿",
  "姿势名称": "S形站姿・胯部侧顶",
  "角度": "正面",
  "缩略图": "thumbs/…jpg",
  "原图": "img/…png",
  "检索": "用于前端模糊搜索的拼接串"
}

data/pose.json كيبقي الحقول والبيانات اليابانية الأصلية، باش يسهل تدقيق الترجمة أو إعادة إدخال البيانات. أما data/translations.csv كيوفّر 323 سجل للمقابلة بين اليابانية والصينية.

الحصول على المشروع

وجد Git وPython 3، ومن بعد كلون المستودع ودخل لمجلد المشروع:

git clone https://github.com/anhao/ai-pose-gallery-zh.git
cd ai-pose-gallery-zh

المشروع ما فيه حتى خطوة لتثبيت اعتماديات npm أو Python. الصفحة الأساسية موجودة فـindex.html، والبيانات والصور محفوظة فالمجلدات الخاصة بها داخل المستودع.

المجلدات المهمة

  • index.html: معرض صفحة واحدة بلا اعتماديات
  • data/: البيانات اليابانية، والبيانات الصينية، والتصنيفات، وجدول الترجمة المقابلة
  • thumbs/: 1439 صورة مصغّرة JPG بحجم 300×400
  • img/: 1439 صورة أصلية PNG بحجم 900×1200
  • scripts/: سكريبتات التحميل، وإدماج الترجمة، والتحقق، والنشر
  • _headers: سياسة التخزين المؤقت لـCloudflare Pages
  • robots.txt وsitemap.xml: إعدادات محركات البحث

تشغيل المعرض محلياً

الصفحة كتستعمل fetch لتحميل بيانات JSON، وبهذا ما يمكنش تفتح index.html مباشرة بالنقر المزدوج. عند الاستعمال عبر بروتوكول الملفات المحلي، المتصفح كيمنع الطلب بسبب سياسة الأمان.

شغّل خادم HTTP ديال Python من جذر المستودع:

python3 -m http.server 8000

ومن بعد حل:

http://127.0.0.1:8000

من بعد ما تتحمّل الصفحة، تقدر تتعرف على العمليات الأساسية بهاد الترتيب:

  1. اختار نظام وضعيات من التبويبات الموجودة فالأعلى.
  2. اختار تصنيف الحركة وزاوية أو أكثر.
  3. دخل اسم الوضعية أو رقمها أو معرّفها أو كلمة من كلمات التصنيف فمربع البحث.
  4. بدّل بين وضع التجميع ووضع التصفح صورة بصورة.
  5. نقر على البطاقة لفتح صندوق العرض، ومن بعد استعمل لوحة المفاتيح أو حركات اللمس للتنقل.
  6. حمّل صورة PNG الأصلية أو نسخ معرّف السجل من صندوق العرض.

صيانة الصور وبيانات الترجمة

إعادة تحميل الصور

المستودع فيه سكريبت للتحميل المتوازي. الملفات الموجودة من قبل كيتجاوزها تلقائياً، وبهذا يمكن تشغيل الأمر أكثر من مرة، مع دعم استئناف التحميل وإعادة المحاولة تلقائياً.

python3 scripts/download.py

العدد الافتراضي للتحميلات المتوازية هو 48. إلا بغيتي تبدّل العدد، تقدر تضبط WORKERS:

WORKERS=64 python3 scripts/download.py

تحديث الترجمة الصينية

قاموس الترجمة موجود فـscripts/i18n.py. من بعد تعديل الترجمات داخلو، شغّل سكريبت الإدماج باش تعاود تولّد البيانات الصينية:

python3 scripts/apply_translation.py

النتيجة المولّدة غادي تستعملها الواجهة الأمامية. من بعد التحديث، من الأفضل تراجع واش النظام، والتصنيف، واسم الوضعية، والزاوية، وحقل البحث فـdata/pose-zh.json موافقين للتوقعات.

التحقق من سلامة الصور

سكريبت التحقق كيفحص وجود 2878 ملف، وحجمها، ورأس كل صورة:

python3 scripts/verify.py

تشغيل التحقق مرة قبل إعادة تحميل الموارد، أو نقل المجلدات، أو النشر الرسمي، كيقلل من خطر ظهور صور ناقصة أو تالفة فالنسخة المنشورة.

النشر على Cloudflare Pages

هاد المشروع موقع ثابت بالكامل، ومن الأفضل ربطه بـGitHub وخلي Cloudflare Pages ينشره تلقائياً.

  1. دخل إلى Cloudflare Dashboard.
  2. سير إلى Workers & Pages، واختار بالتتابع Create، ثم Pages، ثم Connect to Git.
  3. اختار مستودع المشروع، وخلي فرع الإنتاج هو main.
  4. عيّن Framework preset على None.
  5. عيّن Build command على bash scripts/build.sh.
  6. عيّن Build output directory على dist.
  7. حفظ ونشر المشروع. غالباً من بعد حوالي 2 إلى 5 دقايق غادي تحصل على العنوان https://<project>.pages.dev.

من بعد، كل مرة كتدير git push لفرع الإنتاج، Cloudflare Pages غادي يعاود يبني المشروع وينشره تلقائياً.

ما تعيّنش Build output directory مباشرة على جذر المستودع. المجلد الجذري فيه .git اللي ممكن يحتوي على مئات MB من البيانات، ومسح ملفات pack ديالو من طرف Cloudflare يقدر يفعّل حد 25 MiB للملف الواحد. السكريبت scripts/build.sh كينسخ غير الملفات اللي محتاجها الموقع إلى dist.

أكبر ملف فالمستودع حجمو تقريباً 917 KB، ومجلد النشر فيه حوالي 2883 ملف، وهاد الشي داخل حدود Cloudflare Pages: أقل من 25 MiB لكل ملف وأقل من 20000 ملف فكل عملية نشر.

النشر باستعمال سطر الأوامر

إلا ما بغيتيش تربط GitHub، تقدر أولاً تولّد مجلد النشر، ومن بعد ترفعو باستعمال Wrangler:

bash scripts/build.sh
npx wrangler pages deploy dist --project-name ai-pose-gallery-zh

الملف _headers مهيّأ باش يفعّل التخزين المؤقت القوي لمدة عام لكل من img/ وthumbs/، وبهذا المتصفح ما يعاودش يطلب الصور اللي ما تبدلاتش.

اقتراحات الإعداد المتقدم

تغيير النطاق الرسمي

العناوين المطلقة فالمستودع كتشير افتراضياً إلى https://ai-pose-gallery.anhao.app/. إلا درتي Fork ونشرت المشروع فالنطاق ديالك، خاصك تبدّل حتى المواضع التالية:

  • عنوان canonical فـindex.html
  • عناوين Open Graph من نوع og:*
  • إعدادات Twitter Card من نوع twitter:*
  • عنوان الموقع فبيانات JSON-LD المهيكلة
  • عنوان sitemap فـrobots.txt
  • عنوان الصفحة الرئيسية فـsitemap.xml

تحديث هاد العناوين كاملين بشكل موحّد كيمنع محركات البحث من اعتبار النطاق المخصص ونطاق pages.dev صفحات مكررة.

الحفاظ على دلالات SEO

الصفحة مجهزة بوصف، وكلمات مفتاحية، ومؤلف، وOpen Graph، وTwitter Card مستقلة، بالإضافة إلى بيانات JSON-LD من نوع WebSite وImageGallery. منين كتعدّل الواجهة الأمامية، خاصك تحافظ على عنوان رئيسي واحد، وعناوين أقسام واضحة، ونصوص بديلة للصور فيها اسم الوضعية والزاوية.

الصور المصغّرة كتستعمل التحميل الكسول، وصندوق العرض كيعرض الصورة الصغيرة أولاً ومن بعد كيطلب الصورة الأصلية. عند توسيع وظائف الصفحة، من الأفضل الاحتفاظ بهاد ترتيب التحميل باش ما يتطلبوش صور PNG بحجم 900×1200 كلها فآن واحد ويتأثر وقت تحميل الواجهة الأولى.

الحفاظ على تطابق الحقول عند تعديل البيانات

البحث والتصفية والتجميع وتبديل الزوايا كلهم كيعتمدو على الحقول الموجودة فـpose-zh.json. عند تعديل السجلات يدوياً، خاص الانتباه خصوصاً إلى فرادة id، والمسارات النسبية للصور، واسم النظام، والتصنيف، ورقم الوضعية، واسم الزاوية، ومن بعد تشغيل سكريبت التحقق.

حقوق النشر وحدود الاستعمال

حقوق تأليف الصور والبيانات الأصلية كترجع للمؤلف الأصلي ギア. المسؤولون على المستودع ما كيطالبوش بحقوق على هاد الموارد، والمشروع ما كيعتبرش ترخيصاً للاستعمال التجاري للأعمال الأصلية.

الكود الموجود فـscripts/ وindex.html خاضع لرخصة MIT، ولكن هاد الرخصة ما كتغطيش الصور والبيانات الأصلية الموجودة فـimg/ وthumbs/ وdata/. قبل إعادة نشر الموارد أو استعمالها، خاص التأكد من أن الغرض مطابق لمتطلبات حقوق النشر المعمول بها.

الخلاصة

نسخة AI Pose Gallery بالصينية كاتجمع تعريب كامل للبيانات، والموارد المحلية ديال الصور، وواجهة أمامية متجاوبة فمشروع ثابت بلا حتى اعتماديات. تقدر تعاين عليه محلياً باستعمال خادم HTTP ديال Python، وبالسكربتات المدمجة تقدر تعاود تهبط الموارد، وتحدّث الترجمة، وتتحقق من المواد، ومن بعد تنشره بسرعة باستعمال Cloudflare Pages. ملي غادي تنشر النسخة ديالك، ما تنساش تبدّل إعدادات SEO المرتابطة بالنطاق، وتحترم ملاحظات المحتوى وحدود حقوق النشر ديال المشروع.