النشر في السجل

يستخدم سوق AISCouncil نموذج توزيع متدرج يوازن بين الانفتاح والثقة. يمكنك توزيع التطبيقات بحرية عبر URL، أو إدراجها في السجل لاكتشاف أوسع مع شارات الثقة.

مستويات التوزيع

المستوى	كيفية الإدراج	المراجعة	الشارة	التطبيقات المدفوعة	مميّزة
التثبيت المباشر	المستخدم يلصق أي URL بيان	لا شيء	لا شيء	لا	لا
المجتمع	PR إلى registry/packages.json	آلي	"Community"	نعم	لا
AI Verified	المجتمع + فحص AI مدفوع	تدقيق أمان LLM	"AI Verified"	نعم	لا
Verified	المجتمع + مراجعة فريق يدوية	مراجعة بشرية	"Verified"	نعم	نعم

التثبيت المباشر

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

• لا حاجة لإدراج في السجل
• لا عملية مراجعة
• لا شارة ثقة
• تطبيقات مجانية فقط
• يعمل فوراً

هذا هو نموذج التوزيع الأصلي للويب. راجع التحميل الجانبي للتطبيقات للتفاصيل.

المجتمع

إدراج السجل القياسي. أرسل طلب سحب لإضافة تطبيقك إلى registry/packages.json. إذا نجح التحقق الآلي، يمكن دمج الـ PR وسيظهر تطبيقك في متجر التطبيقات بشارة "Community".

• تحقق آلي عبر validate.py
• قابل للاكتشاف في متجر التطبيقات
• يدعم التطبيقات المجانية والمدفوعة
• لا مراجعة يدوية مطلوبة

AI Verified

ترقية ثقة اختيارية لتطبيقات المجتمع. ادفع لفحص أمان مدعوم بـ LLM يتحقق من كودك بحثاً عن البرمجيات الخبيثة، تسريب البيانات، سوء استخدام الأذونات، الكود المشوّش، ومحاولات الهروب من صندوق الحماية.

• تكلف 19-99 دولاراً حسب عمق الفحص
• الشارة مثبتة على تجزئة محتوى SHA-256
• تغييرات الكود تبطل الشارة
• الشارة تنتهي بعد 12 شهراً

معلومات

نظام AI Verified (نقاط النهاية /v1/verify/*) مخطط لإصدار مستقبلي. سير العمل الموصوف هنا سيكون متاحاً عندما يتم شحن نقاط النهاية تلك.

Verified

أعلى مستوى ثقة. يراجع مشرف المنصة يدوياً بيانك وأذوناتك و HTML المدخل و (للـ plugins) الثنائي WASM.

• يتطلب موافقة بشرية
• يحصل على شارة "Verified"
• وضع مميز في متجر التطبيقات
• موصى به للتطبيقات التي تتعامل مع بيانات حساسة

---

نشر تطبيق مجاني (مستوى المجتمع)

1. استضف ملفات تطبيقك

ارفع manifest.json و index.html (بالإضافة لأي أصول) إلى CDN متاح للعموم. خيارات مجانية شائعة:

المضيف	نمط URL	الإعداد
GitHub Pages	yourname.github.io/app-name/	فعّل في Settings > Pages
Cloudflare Pages	app-name.pages.dev/	اربط المستودع في لوحة CF
Vercel	app-name.vercel.app/	استورد المستودع في vercel.com
Netlify	app-name.netlify.app/	استورد المستودع في netlify.com

تأكد من أن manifest.json لديه base_url الصحيح يشير لمكان استضافة الملفات:

{
  "name": "word-counter",
  "version": "1.0.0",
  "abi": 1,
  "type": "mini-program",
  "entry": "index.html",
  "base_url": "https://yourname.github.io/word-counter/"
}

2. اختبر تطبيقك

قبل الإرسال، تحقق من أن التطبيق يعمل بالتحميل الجانبي:

1. افتح aiscouncil.net
2. اذهب إلى Apps > Sideload
3. الصق URL بيانك
4. ثبّت واختبر جميع الميزات

3. انسخ المستودع

اذهب إلى github.com/nicholasgasior/bcz وانقر Fork.

4. أضف إدخال حزمتك

حرّر registry/packages.json وأضف إدخالاً لمصفوفة packages:

{
  "name": "word-counter",
  "type": "mini-program",
  "version": "1.0.0",
  "manifest": "https://yourname.github.io/word-counter/manifest.json",
  "tier": "community",
  "category": "utilities",
  "description": "عد الكلمات في سجل محادثاتك حسب الدور",
  "icon": "https://yourname.github.io/word-counter/icon.png",
  "added": "2026-02-19",
  "price": 0,
  "currency": "USD",
  "seller": null
}

5. التحقق

شغّل سكربت التحقق للتحقق من إدخالك:

python3 registry/validate.py packages

أصلح أي أخطاء قبل المتابعة. مشاكل شائعة:

الخطأ	الإصلاح
عدم تطابق الاسم	name في packages.json يجب أن يطابق name في manifest.json
إصدار غير صالح	استخدم تنسيق semver: 1.0.0، وليس 1.0 أو v1.0.0
حقل مطلوب مفقود	تأكد من وجود name و type و version و manifest
مستوى غير صالح	يجب أن يكون community أو ai-verified أو verified

6. أرسل طلب سحب

ادفع تغييراتك إلى نسختك وأنشئ PR مقابل الفرع الرئيسي. أدرج:

• وصفاً مختصراً لما يفعله تطبيقك
• رابطاً للتطبيق المستخدم حتى يتمكن المراجعون من اختباره
• لقطات شاشة إن أمكن

إذا نجح التحقق الآلي، يمكن دمج الـ PR وسيظهر تطبيقك في متجر التطبيقات.

---

تنسيق إدخال سجل الحزم

الحقول المطلوبة

الحقل	النوع	الوصف
name	string	اسم الحزمة (يجب أن يطابق name في البيان)
type	string	"plugin" أو "addon" أو "mini-program"
version	string	Semver (يجب أن يطابق version في البيان)
manifest	string	URL كامل لـ manifest.json المستضاف

الحقول الاختيارية

الحقل	النوع	الافتراضي	الوصف
tier	string	"community"	"community" أو "ai-verified" أو "verified"
category	string	--	واحد من: productivity، developer، communication، media، utilities، games، education، finance
description	string	--	وصف قائمة المتجر
icon	string	--	URL للأيقونة (PNG 128x128 موصى به)
added	string	--	تاريخ ISO 8601 عند الإدراج الأول (مثلاً، "2026-02-19")
price	number	0	السعر بالسنت (0 = مجاني، 499 = 4.99 دولار)
currency	string	"USD"	رمز عملة ISO 4217
priceType	string	--	"one-time" للشراء لمرة واحدة
geoPrice	object	--	تجاوزات تسعير المناطق الجغرافية
seller	object|null	null	معلومات بائع Stripe Connect (مطلوب للتطبيقات المدفوعة)
verification	object	--	بيانات شارة AI Verified

---

التطبيقات المدفوعة

تعيين سعر

اضبط حقل price بالسنت. مثلاً، 4.99 دولار = 499:

{
  "name": "pro-editor",
  "type": "mini-program",
  "version": "2.0.0",
  "manifest": "https://cdn.example.com/pro-editor/manifest.json",
  "tier": "community",
  "price": 499,
  "currency": "USD",
  "priceType": "one-time",
  "seller": {
    "name": "DevCo",
    "id": "acct_abc123"
  }
}

عمولة المنصة

تأخذ المنصة عمولة 15% على المبيعات المدفوعة. يستقبل البائع 85% عبر مدفوعات Stripe Connect.

السعر	العمولة (15%)	يستلم البائع
0.99 دولار	0.15 دولار	0.84 دولار
4.99 دولار	0.75 دولار	4.24 دولار
9.99 دولار	1.50 دولار	8.49 دولار
19.99 دولار	3.00 دولار	16.99 دولار

التسعير الجغرافي

يمكنك تعيين أسعار مختلفة لمستويات جغرافية مختلفة باستخدام حقل geoPrice:

"geoPrice": {
  "1": 1500,
  "2": 1000,
  "3": 700,
  "4": 400
}

المستويات تقابل مناطق القوة الشرائية:

• المستوى 1: الولايات المتحدة، كندا، أوروبا الغربية، أستراليا، اليابان (15.00 دولار)
• المستوى 2: أوروبا الشرقية، أمريكا الجنوبية، الشرق الأوسط (10.00 دولار)
• المستوى 3: جنوب شرق آسيا، أمريكا الوسطى (7.00 دولار)
• المستوى 4: أفريقيا جنوب الصحراء، جنوب آسيا (4.00 دولار)

تكشف المنصة عن منطقة المستخدم من الـ API وتطبق سعر المستوى المناسب.

إعداد البائع

لتلقي المدفوعات، تحتاج حساب Stripe Connect مرتبطاً بالمنصة:

1. اذهب إلى Settings > Account > Developer في تطبيق AISCouncil
2. انقر Connect Stripe Account
3. أكمل تدريب Stripe Connect
4. يُعيّن لك معرف Stripe Connected Account (التنسيق: acct_xxx)
5. أضف كائن seller لإدخال سجلك:

"seller": {
  "name": "اسمك أو شركتك",
  "id": "acct_abc123"
}

تحذير

التطبيقات المدفوعة تتطلب كائن seller مع معرف حساب Stripe Connect صالح. سيرفض سكربت التحقق الإدخالات المدفوعة بدون معلومات البائع.

---

شارة AI Verified

معلومات

نظام AI Verified مخطط لإصدار مستقبلي. هذا القسم يصف سير العمل المقصود.

شارة AI Verified تشهد أن كود تطبيقك قد تم فحصه بواسطة LLM ووُجد خالياً من مشاكل الأمان الشائعة.

مستويات الفحص

المستوى	السعر	الحد الأقصى للحجم	نص الشارة
سريع	19 دولار	100 كيلوبايت	"AI Scanned"
كامل	49 دولار	500 كيلوبايت	"AI Verified"
عميق	99 دولار	2 ميجابايت	"AI Verified + Reviewed"

سير العمل (مخطط)

1. انشر تطبيقك كمستوى مجتمع أولاً
2. أرسل URL بيانك إلى POST /v1/verify/submit مع مستوى الفحص
3. ادفع رسوم الفحص عبر Stripe checkout
4. يحلل LLM كودك بحثاً عن:
   • البرمجيات الخبيثة والأبواب الخلفية
   • محاولات تسريب البيانات
   • سوء استخدام الأذونات (طلب أكثر من اللازم)
   • كود مشوّه أو مضغوط يخفي السلوك
   • محاولات الهروب من صندوق الحماية
5. تحقق من الحالة في GET /v1/verify/status/{jobId}
6. إذا نجح، استرجع كائن verification من GET /v1/verify/report/{jobId}
7. أضف كائن التحقق لإدخال سجلك:

"verification": {
  "hash": "sha256:a1b2c3d4...",
  "tier": "full",
  "date": "2026-02-19",
  "expires": "2027-02-19",
  "job_id": "ver_xyz789"
}

8. أرسل PR مع إدخال السجل المحدث
9. يؤكد سكربت التحقق أن الشارة صالحة عبر /v1/verify/badge/{hash}

قواعد الشارة

• الشارة مثبتة على تجزئة SHA-256 لـ HTML المدخل لتطبيقك
• أي تغيير في الكود يبطل الشارة (تجزئة جديدة = الشارة ذهبت)
• الشارات تنتهي بعد 12 شهراً ويجب تجديدها
• الفحوصات الفاشلة توفر تقريراً بنتائج للإصلاح

---

شارة Verified (المراجعة اليدوية)

لأعلى مستوى ثقة، اطلب التحقق اليدوي:

1. اضبط "tier": "verified" في إدخال سجلك
2. أرسل PR
3. سيراجع مشرف المنصة يدوياً:
   • أذونات البيان (هل هي مبررة؟)
   • HTML المدخل و JavaScript (لا كود ضار؟)
   • الامتثال لصندوق الحماية (لا محاولات هروب؟)
   • للـ plugins: تحليل الثنائي WASM
4. إذا وُافق: تُمنح الشارة، يُفعّل الوضع المميز
5. إذا رُفض: تُقدم ملاحظات على الـ PR

تحصل التطبيقات Verified على:

• شارة "Verified" (علامة اختيار خضراء)
• وضع مميز في أعلى متجر التطبيقات
• ثقة أعلى من المستخدمين

---

تحديث تطبيقك

لتحديث تطبيق منشور:

1. انشر الإصدار الجديد من ملفات تطبيقك إلى CDN
2. حدّث version في manifest.json
3. حدّث version في registry/packages.json
4. أرسل PR مع زيادة الإصدار

تلميح

اتبع اصطلاحات semver:

• تصحيح (1.0.0 -> 1.0.1): إصلاحات أخطاء، لا ميزات جديدة
• ثانوي (1.0.0 -> 1.1.0): ميزات جديدة، متوافق مع الإصدارات السابقة
• رئيسي (1.0.0 -> 2.0.0): تغييرات جذرية

المستخدمون الذين ثبّتوا تطبيقك بالفعل سيرون التحديث عندما يُحدّث السجل (ذاكرة تخزين مؤقت يومية).

---

أفضل الممارسات

الوصف والأيقونة

• اكتب وصفاً واضحاً وموجزاً (أقل من 256 حرفاً) يشرح ما يفعله التطبيق
• استخدم أيقونة PNG 128x128 بخلفية شفافة أو داكنة
• أيقونات SVG مقبولة أيضاً وتُعرض بوضوح بأي حجم

الأذونات

• اطلب فقط الأذونات التي يستخدمها تطبيقك فعلاً
• اشرح في وصف PR لماذا كل إذن مطلوب
• التطبيقات بأذونات أقل تحصل على تثبيتات أكثر

قائمة التحقق للاختبار

قبل إرسال PR:

• التطبيق يُثبّت ويُطلق بدون أخطاء
• جميع الميزات تعمل كما هو موصوف
• التطبيق يتعامل مع رفض الأذونات بلطف (try/catch حول استدعاءات SDK)
• التطبيق يعمل في الوضع الداكن (افتراضي المنصة)
• الأزرار والعناصر التفاعلية بارتفاع 48 بكسل على الأقل
• النص 14 بكسل على الأقل
• ais.close() يعود للمحادثة بنظافة
• python3 registry/validate.py packages يمر
• python3 registry/validate.py manifest path/to/manifest.json يمر

اختيار الفئة

اختر الفئة الأنسب لتطبيقك:

الفئة	أمثلة
productivity	مديرو المهام، تدوين الملاحظات، أدوات المشاريع
developer	محررو الكود، اختبارات API، أدوات التصحيح
communication	امتدادات الدردشة، تكاملات البريد الإلكتروني
media	محررو الصور، أدوات الصوت، مشغلات الفيديو
utilities	الحاسبات، المحولات، أدوات النظام
games	الألعاب التفاعلية، الألغاز
education	البطاقات التعليمية، أدوات الاختبار، مساعدات التعلم
finance	متتبعات الميزانية، أدوات التشفير، الفواتير