Amp تفتح Portals على الأجهزة المحلية: خادم التطوير يظهر مباشرة داخل الثريد

موقف مألوف: كتب الوكيل الواجهة الأمامية وشغّل خادم التطوير، والآن عليك أنت فتح الطرفية والبحث عن المنفذ والتحقق مما حدث. وإذا كان الوكيل يعمل على جهاز آخر، مثل جهاز Mac في المنزل بينما تجلس أنت بحاسوبك المحمول في مقهى، تتحول المهمة إلى لغز صغير. فريق Amp في Sourcegraph يسدّ هذه الفجوة: Portals، التي كانت تعمل سابقًا داخل الـ orbs السحابية فقط، صارت تعمل الآن على الـ runner الخاص بك أيضًا.

ما الذي تغيّر

Portal هو تبويب بجانب الثريد تُفتح فيه صفحة ويب أنشأها الوكيل. كان متاحًا سابقًا عندما يعمل الوكيل داخل orb. أما الآن فتعمل الآلية نفسها على الأجهزة المحلية: تطلب من Amp تشغيل خادم تطوير أو بناء موقع، ثم تفتح النتيجة في تبويب Portal داخل الثريد. وثمة تفصيل مهم في الإعلان: «بغض النظر عن مكان وجودك». أي أن الـ runner قد يكون على جهاز، بينما تشاهد أنت النتيجة من جهاز آخر.

مثال من الإعلان

عرض مطورو Amp حالة بسيطة لكنها معبّرة. في ثريد على macOS runner يطلب المستخدم إنشاء صفحة استعراضية عن استخدام نظام الملفات في Mac وعرضها في البوابة. يردّ الوكيل برابط إلى بوابة Disk Usage، وبجانبها يُفتح تطبيق ويب صغير: المستخدم 241 غيغابايت من 383 غيغابايت، وشريط السعة مقسّم إلى فئات، ومخطط حلقي يبيّن أن المحاكيات وبيانات Xcode تشغل 155 غيغابايت.

القيمة ليست في المخطط نفسه، بل في الحلقة: سؤال، ثم شيفرة، ثم صفحة حيّة، فتنظر إلى النتيجة فورًا وتوضّح المهمة. أما لوحات المعلومات الداخلية الاستخدامية التي لم يكن أحد ليبنيها يدويًا، فتصبح شبه مجانية. إذا أردت أن تعرف ما الذي التهم القرص، أو تطّلع على مقاييس البناء، أو تتحقق من التخطيط، فاطلب ذلك من الوكيل لتحصل على صفحة بدل جدار من النص في الدردشة.

كيفية التفعيل ومن سيرى النتيجة

هناك طريقتان. في تطبيق macOS افتح Settings › Runner وفعّل Allow Portals. وإذا كنت تعمل من الطرفية، فشغّل الـ runner بالأمر amp --no-tui --remote-control-portals.

افتراضيًا تكون بوابات الـ runner الخاص بك متاحة لك وحدك. ولإظهارها لزملائك، شغّل runner مشتركًا (shared runner) مع الخيار --share، أو فعّل Share With Workspace في تطبيق macOS. عندها يستطيع أي عضو في الـ workspace فتح بوابات هذا الـ runner. التفاصيل موجودة في وثائق Amp ضمن قسم Portals on Your Runner.

القيود والخلاصة العملية

هناك أمور يجب وضعها في الحسبان. الخيار معطّل افتراضيًا، وهذا صحيح: فأنت من يقرر هل تمنح الوكيل إمكانية عرض صفحات ويب من جهازك. وعند تفعيل المشاركة مع الـ workspace كله، تذكّر أن زملاءك سيرون كل ما يعرضه الوكيل في البوابة. وعلى الجهاز المحلي قد يظهر في الصفحة أي شيء: مسارات وأسماء مشاريع وبيانات من نظام الملفات. تقرير القرص في المثال غير مؤذٍ على جهاز Mac شخصي، لكن لا ينبغي عرضه على الـ workspace بأكمله دون مراجعة. ولا يتضمن الإعلان تفاصيل عن آلية الوصول أو القيود التقنية للبوابات، لذا ارجع إلى الوثائق لمعرفة التفاصيل.

الخلاصة العملية بسيطة. إذا كنت تستخدم Amp مع runner محلي، ففعّل Allow Portals وجرّبه على مهمة كنت تضطر فيها إلى تشغيل الخادم يدويًا: معاينة الواجهة الأمامية، أو تقرير التبعيات، أو لوحة معلومات للسجلات. وإذا كنت تعمل ضمن فريق، فابدأ بالوضع الشخصي ولا تفعّل --share إلا للـ runners التي لا تحتوي على أي شيء حساس.

وإذا كنت تبني وكلاء بنفسك، فدوّن هذه الفكرة. إن إمكانية عرض النتيجة على شكل صفحة حيّة بدل نص في الدردشة ميزة قائمة بذاتها ويُستهان بها كثيرًا. فهي تختصر الطريق بين الطلب والتحقق من النتيجة بالعين، وفي هذه الخطوة تحديدًا يضيع الوقت عادةً.