Predict Hair: دليل مساعدي الذكاء الاصطناعي

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

الدليل بصيغة Markdown

الحساب عبر الواجهة البرمجية

يمكن لمساعد يملك عميل HTTP استدعاء POST /api/v1/predict. أرسل JSON بترميز UTF-8 لا يتجاوز 1024 بايت، مع Content-Type: application/json. الواجهة عامة ولا تحتاج إلى مفتاح أو ملف تعريف ارتباط. تُرسل الألوان في جسم الطلب؛ وتُرفض معاملات عنوان URL.

يمكن لعملاء HTTP الاحتفاظ بقيمة User-Agent الأصلية. لا يلزم استخدام اسم وكيل محدد أو انتحال هوية متصفح لقراءة المستندات أو استدعاء خدمة الحساب.

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

عند معرفة لون واحد على الأقل، تحتوي الاستجابة على خمسة عناصر بحقول color وlabel وpercentage، ومجموعها 100 داخل اللعبة. يترجم locale التسميات والشرح من دون تغيير الحساب. إذا كانت كل الألوان مجهولة، تكون status بقيمة needs_input وresults بقيمة null: اطلب لونًا بدلًا من اختراع توزيع.

مثال طلب باختيارات افتراضية

POST https://www.predict-hair.com/api/v1/predict
Content-Type: application/json

{
  "family": {
    "mother": "BROWN",
    "father": "BLOND"
  },
  "locale": "ar"
}

الاستجابة المحسوبة لهذا المثال

{
  "apiVersion": "1",
  "modelVersion": "hair-game-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "ar",
  "status": "ok",
  "unit": "percent",
  "results": [
    {
      "color": "BLACK",
      "label": "أسود",
      "percentage": 0
    },
    {
      "color": "BROWN",
      "label": "بني",
      "percentage": 57.14
    },
    {
      "color": "RED",
      "label": "أحمر",
      "percentage": 14.29
    },
    {
      "color": "BLOND",
      "label": "أشقر",
      "percentage": 23.81
    },
    {
      "color": "STBLOND",
      "label": "أشقر فاتح",
      "percentage": 4.76
    }
  ],
  "explanation": "محاكاة للتسلية: تصف النسب قواعد النموذج لا الاحتمالات الحقيقية لطفلك. لا يحدد الحساب الجينات ولا لون الشعر عند الولادة.",
  "sourceUrl": "https://www.predict-hair.com/ar",
  "documentationUrl": "https://www.predict-hair.com/ar/%D8%AF%D9%84%D9%8A%D9%84-%D9%85%D8%B3%D8%A7%D8%B9%D8%AF%D9%8A-%D8%A7%D9%84%D8%B0%D9%83%D8%A7%D8%A1-%D8%A7%D9%84%D8%A7%D8%B5%D8%B7%D9%86%D8%A7%D8%B9%D9%8A"
}

حقول الإدخال ورموز الألوان

الكائن family مطلوب، لكن حقوله الستة اختيارية وتأخذ UNDEFINED عند حذفها. الحقل locale اختياري وقيمته الافتراضية en. استخدم أسماء الحقول والرموز بالأحرف الكبيرة كما تظهر أدناه، مهما كانت اللغة. تُرفض الحقول الإضافية والقيم غير المعروفة.

حقول family
`mother`	الأم
`father`	الأب
`maternalGrandmother`	الجدة من جهة الأم
`maternalGrandfather`	الجد من جهة الأم
`paternalGrandmother`	الجدة من جهة الأب
`paternalGrandfather`	الجد من جهة الأب

رموز الألوان المقبولة
`BLACK`	أسود
`BROWN`	بني
`RED`	أحمر
`BLOND`	أشقر
`STBLOND`	أشقر فاتح
`UNDEFINED`	غير معروف

القواعد التي تستخدمها الحاسبة

تستخدم اللعبة خمس فئات بأولوية ثابتة: أسود وبني وأحمر وأشقر وأشقر فاتح. تجمع ملفات افتراضية من رمزين، ينتقل أحدهما من كل والد. لا تمثل هذه الرموز متغيرات محددة في الحمض النووي. يبلغ مجموع النسب 100٪ داخل هذا النموذج فقط.

ماذا تعني «غير معروف»؟

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

ماذا يحدث إذا لم تتوافق ألوان العائلة مع القواعد؟

يعود النموذج إلى الملفات المرتبطة بلون الوالد المعني. قواعده أبسط من أن تمثل جميع العائلات. ولا يتيح الاختلاف عن النموذج استنتاج أي شيء عن النسب.

هل تكفي ألوان شعر الوالدين للتنبؤ بلون شعر الطفل؟

تعتمد صبغة الشعر على جينات كثيرة وأصباغ الميلانين. لا تكفي ألوان العائلة الظاهرة لإعطاء احتمالات فردية مثبتة لطفل.

هل يتغير لون الشعر مع العمر؟

نعم، يصبح شعر بعض الأطفال الفاتح أغمق مع نموهم. لا تتنبأ هذه المحاكاة باللون الدقيق عند الولادة ولا بتطوره.

الحاسبة ومصادر تصبغ الشعر

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

النسخ اللغوية

يتوفر الدليل والحاسبة باللغات التالية. تؤدي الروابط إلى صفحات HTML الأساسية المعتمدة للأدلة.

مستندات للبرامج

يربط فهرس llms.txt بالأدلة العشرة بصيغة Markdown. ويصف عقد OpenAPI الطلبات والاستجابات والأخطاء. تساعد قراءة المستندات على إعداد التكامل؛ ويحتاج العميل إلى أداة HTTP لتنفيذ الحساب.