الوثائقاربط أدواتك
ربط مستودع بمشروع
الفروع والالتزامات وطلبات الدمج على كل تذكرة، والمشكلات من المستودع وإليه، وHelpi Agent في كودك.
آخر تحديث 22 نوفمبر 2026
اربط مستودع GitHub أو GitLab بمشروع لتعرض كل تذكرة الفروع والالتزامات وطلبات الدمج التي تذكرها. ويمكن استيراد المشكلات من المستودع أو نشرها فيه، ويستطيع Helpi Agent العمل على التذاكر في كودك.
الربط برمز وصول
- افتح صفحة
Repositoryفي المشروع وانقرConnect Repository. - اختر المزوّد: GitHub أو GitLab.
- الصق عنوان المستودع، مثل
https://github.com/acme/app. - الصق رمز وصول شخصيًا من إعدادات GitHub أو GitLab.
- انقر
Connect Repository. يتحقق Octopora من الرمز على المستودع ويؤكد الربط.
يدعم Octopora موقعي github.com وgitlab.com. لكل مشروع مستودع واحد، وربط مستودع آخر يستبدله.
الصلاحيات التي يحتاجها الرمز
| الرمز | لقراءة النشاط | ليتمكن Helpi Agent من الدفع وفتح طلبات الدمج |
|---|---|---|
| GitHub دقيق الصلاحيات | Contents و Pull requests: read | Contents: write و Pull requests: write |
| GitHub الكلاسيكي | repo | repo |
| GitLab | read_api | دور Developer و api و write_repository |
تطبيق Helpi على GitHub (اختياري)
عند ربط مستودع على GitHub، تعرض صفحة Settings > Helpi Agent > Repository خيار Install the Helpi GitHub app. ثبّته على المستودع نفسه: بعدها تظهر طلبات الدمج والالتزامات والتعليقات باسم التطبيق بدل اسم شخص.
سمِّ عملك باسم التذكرة
ضع مفتاح التذكرة في أي مكان من اسم الفرع أو رسالة الالتزام أو عنوان طلب الدمج ليظهر على التذكرة. وتعرض بطاقة Git Workflow في كل تذكرة أمثلة جاهزة للنسخ.
| العنصر | مثال |
|---|---|
| الفرع | feature/ML-13-login-screen |
| الالتزام | ML-13: add the login form |
| طلب الدمج | [ML-13] Login screen |
- لا يهم حجم الأحرف، ولا يطابق ML-1 المفتاح ML-10.
- في GitLab تسمى طلبات الدمج merge requests، وتعمل الأسماء نفسها.
- إن كان مستودعك يستخدم بادئة أخرى، مثل CP-12 بدل ML-12، فأدخلها في
Settings > General > Git key prefix.
المشكلات
في صفحة المشكلات، يعرض Import GitHub Issues (أو GitLab) مشكلات المستودع لاستيرادها: تصل المفتوحة بحالة Opened والمغلقة بحالة Resolved. ومن قائمة أي مشكلة، ينشئها Push to GitHub issue في المستودع.
فصل المستودع
في صفحة Repository انقر Disconnect. يُحذف الربط ورمزه، ويمكنك الربط مجددًا لاحقًا. بعدها يطلب Helpi Agent مستودعًا قبل أن يعمل.
أسئلة شائعة
يقول Helpi Agent إن الرمز لا يستطيع الدفع.
الرمز لا يملك صلاحية الكتابة. أنشئ رمزًا بصلاحية الكتابة المذكورة أعلاه وانقر Reconnect repository.
لا يظهر فرع على تذكرته.
تأكد أن المفتاح موجود في اسم الفرع أو الالتزام أو عنوان طلب الدمج، وأن المفتاح القديم مُدخل كبادئة Git إن تغيّر.
هل يمكنني ربط GitLab مستضاف ذاتيًا؟
ليس بعد: github.com وgitlab.com فقط.