# Skin Color: دليل مساعدي الذكاء الاصطناعي

HTML: <https://www.skin-color.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>

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

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

يمكن لمساعد يملك عميل 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: اطلب درجة قبل عرض توزيع.

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

```http
POST https://www.skin-color.com/api/v1/predict
Content-Type: application/json

{
  "family": {
    "mother": "FAIR",
    "father": "BROWN"
  },
  "locale": "ar"
}
```

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

```json
{
  "apiVersion": "1",
  "modelVersion": "skin-palette-v1",
  "purpose": "entertainment",
  "scientificallyValidated": false,
  "locale": "ar",
  "status": "ok",
  "unit": "percent",
  "results": [
    {
      "color": "VERYFAIR",
      "label": "فاتحة جدًا",
      "percentage": 1.76
    },
    {
      "color": "FAIR",
      "label": "فاتحة",
      "percentage": 12.97
    },
    {
      "color": "MEDIUM",
      "label": "متوسطة",
      "percentage": 35.27
    },
    {
      "color": "OLIVE",
      "label": "زيتونية",
      "percentage": 35.27
    },
    {
      "color": "BROWN",
      "label": "داكنة",
      "percentage": 12.97
    },
    {
      "color": "BLACK",
      "label": "داكنة جدًا",
      "percentage": 1.76
    }
  ],
  "explanation": "محاكاة للتسلية: هذه النسب أوزان ناتجة عن منحنى رياضي اختياري، وليست احتمالات وراثية مقاسة لطفلك.",
  "sourceUrl": "https://www.skin-color.com/ar",
  "documentationUrl": "https://www.skin-color.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`: جد من ناحية الأب

### رموز الألوان المقبولة

- `VERYFAIR`: فاتحة جدًا
- `FAIR`: فاتحة
- `MEDIUM`: متوسطة
- `OLIVE`: زيتونية
- `BROWN`: داكنة
- `BLACK`: داكنة جدًا
- `UNDEFINED`: غير معروف

## كيف تعمل محاكاة درجة البشرة هذه؟

تُعطى عينات الألوان الست مواقع من 0 إلى 5. تحسب الأداة متوسط مواقع أفراد العائلة الذين أُدخلت درجاتهم، ثم توزّع النتائج بمنحنى على شكل جرس حول هذا المتوسط. عرض المنحنى محدد في الكود، ولا يستند إلى قياسات وراثية. مجموع النسب يساوي 100٪ داخل هذا النموذج البصري فقط.

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

اختيار «غير معروف» يستبعد هذا الشخص من المتوسط، ولا يمنحه درجة بشرة متوسطة. إذا كانت جميع الدرجات غير معروفة، فلا يُجرى حساب ولا تظهر نتيجة.

## ماذا يغيّر الأجداد في المحاكاة؟

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

## هل تعطي درجات بشرة العائلة نسبًا وراثية موثوقة؟

تؤثر جينات كثيرة في تصبغ البشرة. الاختيار البصري من ست عينات لا يحدد هذه المتغيرات. لم تُثبت صلاحية هذه المحاكاة لتقدير احتمالات درجة بشرة طفل بعينه.

## هل تشكل العينات مقياسًا علميًا للون البشرة؟

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

## الحاسبة ومصادر تصبغ الجلد

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

- [حاسبة لون بشرة الطفل](<https://www.skin-color.com/ar>)
- [كيف تعمل محاكاة درجة البشرة هذه؟](<https://www.skin-color.com/ar#%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D8%AD%D8%A7%D8%B3%D8%A8%D8%A9-%D9%84%D9%88%D9%86-%D8%A8%D8%B4%D8%B1%D8%A9-%D8%A7%D9%84%D8%B1%D8%B6%D9%8A%D8%B9>)
- [NHGRI — Polygenic Trait](<https://www.genome.gov/genetics-glossary/Polygenic-Trait>)
- [Crawford et al. (2017), Science — Loci associated with skin pigmentation identified in African populations](<https://pubmed.ncbi.nlm.nih.gov/29025994/>)

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

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

- [العربية](<https://www.skin-color.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>)
- [Deutsch](<https://www.skin-color.com/de/fuer-ki-assistenten>)
- [English](<https://www.skin-color.com/for-ai-assistants>)
- [Español](<https://www.skin-color.com/es/para-asistentes-ia>)
- [Français](<https://www.skin-color.com/fr/pour-les-assistants-ia>)
- [हिन्दी](<https://www.skin-color.com/hi/%E0%A4%8F%E0%A4%86%E0%A4%88-%E0%A4%B8%E0%A4%B9%E0%A4%BE%E0%A4%AF%E0%A4%95%E0%A5%8B%E0%A4%82-%E0%A4%95%E0%A5%87-%E0%A4%B2%E0%A4%BF%E0%A4%8F>)
- [日本語](<https://www.skin-color.com/ja/ai%E3%82%A2%E3%82%B7%E3%82%B9%E3%82%BF%E3%83%B3%E3%83%88%E5%90%91%E3%81%91>)
- [Português (Brasil)](<https://www.skin-color.com/pt/para-assistentes-ia>)
- [Русский](<https://www.skin-color.com/ru/%D0%B4%D0%BB%D1%8F-%D0%B8%D0%B8-%D0%B0%D1%81%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BD%D1%82%D0%BE%D0%B2>)
- [中文](<https://www.skin-color.com/zh/%E9%9D%A2%E5%90%91ai%E5%8A%A9%E6%89%8B>)

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

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

- [الدليل بصيغة Markdown](<https://www.skin-color.com/llms/ar.md>)
- [عقد OpenAPI](<https://www.skin-color.com/openapi.json>)
- [فهرس llms.txt](<https://www.skin-color.com/llms.txt>)
- [خريطة صفحات HTML](<https://www.skin-color.com/sitemap.xml>)
- [سياسة الخصوصية](<https://www.skin-color.com/ar/%D8%B3%D9%8A%D8%A7%D8%B3%D8%A9-%D8%A7%D9%84%D8%AE%D8%B5%D9%88%D8%B5%D9%8A%D8%A9>)