دليل الإرسال
كيفية نشر الفرق في السوق عبر واجهة الويب.
طريقتان للإرسال
يمكنك إرسال الفرق إلى السوق باستخدام رابط مستودع GitHub أو بتحميل ملف ZIP مباشرة.
| الطريقة | الأنسب لـ | صيغة الـ Slug |
|---|---|---|
| رابط GitHub | المستودعات العامة، تحديثات سهلة عبر إعادة الإرسال | owner/repo/squad-name |
| تحميل ZIP | الفرق الخاصة، لا حاجة لمستودع GitHub | username/uploads/squad-name |
الإرسال عبر رابط GitHub
- 1سجّل الدخول إلى squads.sh بحسابك على GitHub.
- 2انتقل إلى لوحة التحكم > إرسال.
- 3اختر "رابط GitHub" وأدخل مستودعك بصيغة owner/repo.
- 4انقر على "تحقق". سيقوم النظام بجلب فريقك وتشغيل التحقق.
- 5راجع تقرير التحقق. أصلح الأخطاء إذا كانت الحالة CRITICAL.
- 6اختيارياً حدد سعراً (بدّل بين مجاني/مدفوع، أدخل المبلغ بالدولار).
- 7انقر على "إرسال إلى السوق" للنشر.
الإرسال عبر تحميل ZIP
- 1سجّل الدخول إلى squads.sh بحسابك على GitHub.
- 2انتقل إلى لوحة التحكم > إرسال واختر "رفع .zip".
- 3اسحب وأفلت ملف ZIP أو انقر للتصفح. الحد الأقصى 50 ميجابايت، يجب أن يحتوي على squad.yaml.
- 4انقر على "تحقق" لتشغيل التحقق على الفريق المُحمّل.
- 5راجع التقرير، حدد السعر إذا رغبت، وانقر على "إرسال إلى السوق".
تحديد السعر
الفرق مجانية بشكل افتراضي. لبيع فريقك، بدّل إلى "مدفوع" بعد التحقق وأدخل سعراً بالدولار ($0.99 – $999.99). يجب ربط حساب Stripe في لوحة التحكم > الإعدادات قبل بيع فرق مدفوعة. يمكنك أيضاً تغيير السعر لاحقاً من صفحة فرقي.
فهم تقرير التحقق
بعد التحقق، سترى تقريراً مفصلاً بدرجة من 0 إلى 100 وشارة حالة:
SAFEالدرجة >= 80، بلا أخطاء — جاهز للنشر.
WARNINGيحتوي على تحذيرات لكن بلا أخطاء حاجبة — يمكن النشر، لكن فكّر في إصلاح التحذيرات.
CRITICALيحتوي على أخطاء أو درجة منخفضة — يجب إصلاح الأخطاء قبل الإرسال. زر الإرسال معطّل.
يعرض التقرير 6 فئات قابلة للتوسيع (البيان، الهيكل، الوكلاء، المهام، سير العمل، المراجع المتقاطعة) مع نتائج فردية يمكنك فحصها.
بعد الإرسال
- ▸يخضع فريقك لتدقيق أمني آلي. النتائج مرئية في صفحة التدقيق.
- ▸تكسب 50 XP لنشر فريق جديد.
- ▸لتحديث فريق منشور، أرسل نفس رابط GitHub أو حمّل ZIP جديد. سيتم تحديث القائمة الحالية.
- ▸يمكنك تغيير السعر في أي وقت من لوحة التحكم > فرقي.
CLI مقابل الويب
كلتا الطريقتين تنشران في نفس السوق. اختر بناءً على سير عملك:
- ▸الويب — الأفضل للتغذية البصرية للتحقق، والناشرين لأول مرة، والإرسالات الفردية.
- ▸CLI (squads publish) — الأفضل للأتمتة، وخطوط أنابيب CI/CD، والنشر المتكرر. يدعم علامات --dry-run و --strict.
راجع مرجع CLI لأمر publish. CLI Reference