كيف يعرف الوكيل أن تعليق مراجعة جديدًا ظهر في طلب سحب، من دون أن يستعلم من GitHub كل دقيقة أو يطلب من المستخدم تشغيل خادم عام؟ في 17 نوفمبر 2026، أطلقت GitHub ميزة Event Streams في مرحلة المعاينة: يشترك العميل في طلب سحب، ويبقي اتصاله بـ GitHub مفتوحًا، ويتلقى الأحداث فور وقوعها.

يتعلق التغيير العملي بالوكلاء المحليين وأنظمة الأتمتة التي تحتاج إلى الاستجابة لتحديثات المستودع. ومن دون مستقبل webhook خاص، تتمثل الطريقة المعتادة لمتابعة التغييرات في الاستعلام الدوري عن واجهة API: فالطلبات المتكررة تستهلك الحصة، بينما تؤخر الطلبات المتباعدة الاستجابة. ويتيح تدفق الأحداث تشغيل المعالجة استجابةً لإشارة تغيير بدلًا من التحقق وفق مؤقت.
الأحداث التي يتلقاها المشترك
تسرد وثائق Event Streams أحداث طلبات السحب، ومنها إرسال تعليق مراجعة، وإضافة إيداع جديد، وظهور تعارض دمج، ودمج الطلب أو إغلاقه، فضلًا عن تغيير مجموعة الفحوص أو اكتمال فحص منفرد. تُنقل الأحداث عبر Server-Sent Events (SSE)، ولا يحتاج العميل إلى نقطة نهاية webhook عامة. ويناسب ذلك، على سبيل المثال، وكيلًا يعمل على حاسوب المطور المحمول ويحتاج إلى الاستجابة لتعليق مراجعة أو إيداع جديد.
يعمل الحدث إشارةً إلى وقوع تغيير، ثم يحصل العميل على البيانات الحالية عبر GitHub REST API. فمثلًا، يشير إشعار تعليق المراجعة الجديد إلى مورد API المرتبط به؛ ويمكن عبره تحميل الحالة الحالية للتعليق أو طلب السحب قبل بدء الإجراء التالي.
الفرق بين تدفق الأحداث والاستطلاع وwebhook
الاستطلاع بسيط: يرسل العميل طلبات على فترات محددة ويقارن الردود. وتحدد الفترة موازنةً بين التأخير وتواتر الطلبات: فإذا كان التحقق مرة كل دقيقة، فقد تنتظر الاستجابة حتى الدورة التالية؛ أما التحقق بوتيرة أعلى فقد يجعل عددًا كبيرًا من الطلبات لا يرصد أي تغيير. وتذكر GitHub هذه المفاضلة تحديدًا سببًا لاستخدام النهج القائم على الأحداث.

مع Event Streams، ينشئ العميل اشتراكًا واحدًا في طلب السحب، ويتصل بـ GitHub، ثم ينتظر الأحداث عبر اتصال مفتوح. وينقل webhook الأحداث أيضًا، لكن عمليات التكامل تحتاج عادةً إلى نقطة نهاية استقبال متاحة للعامة. لذلك يناسب التدفق عميلًا تفاعليًا أو وكيلًا محليًا، بينما يناسب webhook خدمةً تستقبل الطلبات الواردة أصلًا. ويظل الاستطلاع خيارًا مفهومًا لعمليات التحقق المتباعدة التي لا تتطلب استجابة سريعة.
ومن النتائج العملية الأخرى إعداد الاشتراك لمورد بعينه. وتصف وثائق GitHub مسارًا للاشتراك في طلب سحب واحد، لا موجزًا عامًا بكل تحديثات المستودع. لذا صمّم المعالج حول طلب سحب محدد وأنواع الأحداث التي يحتاج إليها.
كيف يمكن أن يعمل وكيل محلي
لنتصور وكيلًا يساعد في مراجعة طلب سحب. فعند وقوع حدث تعليق مراجعة، يحصل الوكيل على البيانات الحالية ويمكنه إعداد تحليل للملاحظات؛ وبعد إيداع جديد، يعيد تشغيل الفحوص؛ وبعد الإغلاق أو الدمج، ينهي المهمة المرتبطة. هذا مثال على استخدام يستند إلى أنواع الأحداث التي تسردها GitHub، وليس نتيجة اختبار لهذا السيناريو نشرتها الشركة.
والتسلسل الدقيق مهم: فالحدث يفيد بوقوع تغيير، ثم يطلب العميل الحالة الراهنة من مورد API المحدد. ولأن الأحداث قد تتكرر أو تصل بترتيب غير متسلسل، يُستحسن أن يتحمل المعالج إعادة التسليم بأمان وأن يراجع الحالة عبر API، بدلًا من اعتبار ترتيب الإشعارات سجلًا كاملًا للتغييرات.
قيود ينبغي أخذها في الحسبان
اعتبارًا من 18 نوفمبر 2026، تتوفر Event Streams في مرحلة المعاينة على جميع خطط GitHub بعد الموافقة على طلب الانضمام إلى قائمة الانتظار. ويُفعّل الوصول لحساب بعينه، لذا لا تظهر الميزة تلقائيًا لكل مستخدم. كما توضح الوثائق أن الميزة متاحة على GitHub.com، لكنها غير متاحة بعد على GHE.com.
يشمل الاشتراك طلب سحب واحدًا، وتنتهي صلاحيته بعد 24 ساعة من إنشائه. ولا يعيد التدفق تشغيل الأحداث التي وقعت قبل الاتصال، أو خلال فترة قصيرة بعد إنشاء الاشتراك، أو أثناء انقطاع الاتصال. وتوصي GitHub بجلب الحالة الحالية لطلب السحب مرة واحدة بعد الاشتراك، وبالاعتماد على بيانات API عند تكرار الأحداث أو وصولها بترتيب غير متسلسل. ويعني ذلك عمليًا أن الوكيل يحتاج إلى معالجة إعادة الاتصال ومزامنة الحالة، لا إلى اتصال مفتوح فحسب.
تتوفر في مرحلة المعاينة أحداث طلبات السحب؛ وتصف الوثائق المجموعة الحالية، كما تنبه إلى احتمال تغيّر API وأنواع الأحداث والحدود. إذا كانت الأتمتة تحتاج إلى أحداث أخرى للمستودع أو إلى تسليم مضمون من الخادم، فتحقق مما إذا كان التدفق يغطي احتياجاتها؛ وإلا فاستخدم webhook أو التحقق عبر API.
بالنسبة إلى وكيل محلي يحتاج إلى الاستجابة لأحداث طلبات السحب من دون خادم عام، توفر Event Streams قناة مباشرة قائمة على الأحداث بدلًا من الطلبات المتكررة. وثمن هذا الاختيار هو اشتراك مؤقت في طلب واحد، والحاجة إلى استعادة الحالة الحالية بعد تفويت أحداث. ويمكن الإبقاء على الاستطلاع لعمليات التحقق المتباعدة، بينما تُبنى عمليات التكامل الخادمية حول webhook إذا كانت تحتاج إلى تسليم البيانات إلى عنوانها الخاص.