ربط GitHub
اربط حساب GitHub.com مع AI CodeOps عبر OAuth أو برمز وصول شخصي، وتعرف على النطاقات التي يحتاج إليها وما تفعله المنصة بمستودعاتك.
يعمل AI CodeOps على مستودعاتك في GitHub عبر اتصال تنشئه مرة واحدة. ثم تستنسخ الجلسات المستودع، وتكتب التغيير على فرع جديد، وتفتح طلب سحب للمراجعة.
قبل أن تبدأ
- حساب على GitHub.com له وصول إلى المستودعات التي تريد استخدامها.
- الخدمة GitHub Enterprise Server غير مدعومة. ولخوادم Git التي تشغلها بنفسك، يدعم AI CodeOps كلا من GitLab و Gitea و Forgejo.
الربط عبر OAuth
- في مساحة عملك، افتح Configure → Settings وانزل إلى Git Providers.
- في بطاقة GitHub، اختر Connect (ربط).
- يطلب منك GitHub أن تأذن لـ AI CodeOps. وافق، فتعود إلى Settings ويظهر الحساب ضمن Connected Accounts (الحسابات المربوطة).
يطلب AI CodeOps من GitHub نطاقات OAuth التالية:
| النطاق | السبب |
|---|---|
repo | قراءة المستودعات التي تستطيع الوصول إليها والكتابة فيها: الاستنساخ، ودفع فرع، وفتح طلبات السحب ودمجها. ويشمل المستودعات الخاصة. |
read:user | إظهار حساب GitHub المربوط. |
user:email | يطلب مع نطاقات تسجيل الدخول؛ ولا يقرأ AI CodeOps العنوان عبر هذا الاتصال. |
إذا لم يكن في البطاقة زر Connect، أو رأيت الرسالة "GitHub sign-in isn't available for this server"، فتطبيق OAuth الخاص بالمنصة غير متاح. اربط برمز بدلا من ذلك.
الربط برمز وصول شخصي
في بطاقة GitHub، الصق رمزا في الحقل or access token (no OAuth app) واختر Connect with token (ربط برمز). يفحص AI CodeOps الرمز لدى GitHub قبل حفظه. والرمز الذي لا يتعرف عليه GitHub يعطي الرسالة "GitHub didn't recognise this token"؛ والرمز الذي لا يستطيع قراءة حسابك يعطي رسالة تسمي الصلاحيات التي يجب إضافتها.
يحتاج الرمز إلى قراءة ملفك الشخصي، وقراءة المستودعات، ودفع الفروع، وإنشاء طلبات السحب ودمجها. وعلى GitHub يعني ذلك:
- رمزا من نوع classic بالنطاق
repo، أو - رمزا من نوع fine-grained للمستودعات التي تريدها، مع ضبط Contents و Pull requests على القراءة والكتابة (وصلاحية قراءة Metadata مشمولة).
رموز الوصول الشخصية لا تجدد. حين تنتهي صلاحية الرمز على GitHub، افصل الاتصال واربط من جديد برمز جديد.
ما يفعله AI CodeOps بالمستودع
- التصفح: صفحة Develop → Repositories تسرد المستودعات التي يستطيع الحساب رؤيتها، مع فروعها وملفاتها وطلبات السحب فيها.
- الجلسات: تستنسخ الجلسة مستودع المشروع في بيئتها المعزولة وتكتب التغيير هناك.
- الفروع وطلبات السحب: حين تجري الموافقة على تغيير ويجتاز بوابات الجودة الخاصة به، يدفع AI CodeOps فرعا اسمه
codeops/run-<id>ويفتح طلب سحب إلى الفرع الافتراضي للمشروع. ويكون مؤلف الإيداعات "AI CodeOps". - الدمج: طلب السحب الذي فتحته لوحة التحكم يمكن دمجه من لوحة التحكم. وتعمل بوابة الإصدار مرة أخرى أولا.
لا تسجل الجلسات أي webhook على مستودعاتك، ولا ينشر AI CodeOps تعليقات مراجعة على GitHub. والاستثناء هو المستودع الذي تربطه من Build & Test → Builds، فهو يحصل على webhook، ليبدأ الدفع أو طلب السحب عملية بناء، وعلى حالة إيداع بنتيجة كل عملية بناء.
رمزك ووصولك
- الاتصالات تخصك أنت، لا مساحة العمل. يربط كل عضو حسابه، وتبقى صلاحيات مساحة العمل هي التي تقرر ما يستطيع فعله.
- تشفر الرموز وهي مخزنة (AES-256-GCM) ولا تكتب أبدا في إعدادات Git للمستودع.
- لإزالة الوصول، اختر Disconnect (فصل) بجانب الحساب. ويمكنك أيضا إلغاء التطبيق أو الرمز على GitHub.
الخطوات التالية
- أنشئ مشروعا من مستودع على GitHub.
- شغّل أول جلسة لك.
- راجع استكشاف الأخطاء وإصلاحها إذا ظهر اتصال بالحالة Expired أو رفض دفع.