- 26
- نوع خطوة في التدفق
- 7
- وكلاء متصفح قابلون لإعادة الاستخدام
- 1
- نقطة نهاية n8n بثلاثة أوضاع تنفيذ
التقنيات المستخدمة
- Node.js
- Express
- Playwright
- Alpine.js
- n8n
- Server-Sent Events
- ngrok
المشكلة
عمليات أتمتة المتصفح متعددة الخطوات — تسجيل الدخول، البحث، التنفيذ، التأكيد وهكذا — يصعب تأليفها وإعادة استخدامها وتشغيلها من أدوات أخرى. وكتابة كل حملة كنص برمجي منفرد تعني انعدام إعادة الاستخدام، وغياب الرؤية لما جرى، وعدم وجود طريقة نظيفة ليشغّلها غير المطوّر أو منسّق مثل n8n.
المنهجية
بنيتُ منصة على Node.js / Express وPlaywright مع مُنشئ تدفقات مرئي يوفّر 26 نوع خطوة (متغيرات، شروط، حلقات، معالجة أخطاء، تدفقات فرعية) تربط سبعة وكلاء متصفح قابلين لإعادة الاستخدام. ويمكن تضمين أي وكيل كخطوة، فتغذّي نتائجه الخطوات التالية. وتتيح المنصة نقطة نهاية واحدة /n8n/execute بثلاثة أوضاع — تدفق محفوظ، أو خطوات مُضمَّنة، أو مسار وكلاء قديم — إضافةً إلى إدارة جلسات في الذاكرة بمدة صلاحية، وإدارة أنفاق مدمجة للمُشغِّلات السحابية، وسجلات لحظية عبر Server-Sent Events.
النتائج
عمليات أتمتة قابلة لإعادة الاستخدام والتأليف يستطيع غير المطوّرين تجميعها بصرياً وتشغيلها باستدعاء HTTP واحد. وتستمر الجلسات عبر الخطوات فتتصرّف التدفقات متعددة المراحل كجولة واحدة متماسكة، ويجعل السجل الحي كل عملية تنفيذ قابلة للمراقبة لحظياً.
أبرز الحلول الهندسية
- مُنشئ تدفقات مرئي بـ 26 نوع خطوة — متغيرات وشروط وحلقات ومعالجة أخطاء وتدفقات فرعية وخطوات وكلاء مضمّنة.
- سبعة وكلاء متصفح قابلين لإعادة الاستخدام يُؤلَّفون في سير عمل؛ نتائج كل وكيل تغذّي الخطوات التالية.
- نقطة نهاية واحدة /n8n/execute بثلاثة أوضاع (تدفق محفوظ، خطوات مضمّنة، مسار قديم) للتشغيل الخارجي.
- إدارة جلسات متصفح في الذاكرة بمدة صلاحية ساعتين، مشتركة بين خطوات التدفق.
- إدارة أنفاق مدمجة (ngrok) للمُشغِّلات السحابية وبث سجلات لحظي عبر Server-Sent Events.
لقطات الشاشة والمخططات
لقطات ورسوم حقيقية من الواجهة — الشيفرة خاصة ولا تُعرض علامات العملاء التجارية.
تفاصيل تقنية معمّقة
الفكرة الجوهرية هي محرّك تدفقات يتعامل مع وكلاء المتصفح بوصفهم لبنات قابلة للتأليف. والتدفق رسم بياني مرتّب من خطوات مصنّفة — تحكّم في المسار (شروط، حلقات، معالجة أخطاء)، وبيانات (متغيرات)، وتأليف (تدفقات فرعية)، وخطوات run_agent التي تستدعي وكيل متصفح حقيقياً. ولأن جلسة المتصفح العاملة مشتركة بين الخطوات ضمن مدة صلاحية، يستطيع التدفق تسجيل الدخول مرة واحدة وإعادة استخدام الجلسة طوال بقية الجولة، وهذا بالضبط ما يجعل الأتمتة الواقعية متعددة المراحل ممكنة.
كان التكامل هدفاً من الدرجة الأولى: نقطة نهاية واحدة /n8n/execute بثلاثة أوضاع تتيح للمنسّق تشغيل تدفق محفوظ، أو إرسال خطوات مضمّنة، أو الرجوع إلى مسار وكلاء قديم — كما تكشفها إدارة الأنفاق المدمجة لـ n8n Cloud دون بنية تحتية إضافية. وتبثّ سجلات SSE اللحظية كل خطوة إلى لوحة التحكم ليتابع المشغّلون الجولة أثناء حدوثها.