عن المشروع

Figranium أداة ذاتية الاستضافة لبناء سير عمل أتمتة المتصفح بصريًا وتشغيلها عبر API. بدلًا من كتابة النصوص البرمجية، تقوم بتكديس كتل تمثل إجراءات مثل التنقل والنقر والكتابة والانتظار والضغط والتمرير والتحويم وتنفيذ JavaScript ولقطات الشاشة والشروط والحلقات والمتغيرات والتحميلات ومعالجة الأخطاء. يمكن تشغيل المهام يدويًا أو وفق جدول زمني أو عبر HTTP. يوصف وضعان للمهام: وضع الوكيل (Agent Mode)، الذي ينفذ أتمتة متصفح حتمية من تسلسل إجراءات مرتب، ووضع الاستخراج (Scrape Mode)، الذي يقوم باستخراج وكشط خفيف عبر HTTP دون تشغيل متصفح. تُعرض جلسات المتصفح المرئية كقدرة تصحيح/تشغيل وليس كوضع منفصل. تتضمن الواجهة لوحة معلومات بمقاييس المهام والتنفيذ، ومحرر مهام مكاني قائم على الكتل، وعرض سجل التنفيذات، ومساحة Captures للقطات الشاشة والتسجيلات، وCabinets لقوائم الملفات الدائمة (بما في ذلك ملفات ZIP والمجلدات وحالة التحميل)، وإعدادات لمفاتيح API ونماذج الذكاء الاصطناعي ووكيل المستخدم والوكلاء والمظهر. تشمل ميزات الأتمتة قوالب المتغيرات بصيغة {$var}، وشروطًا منظمة، واستخراج بيانات منظمة، وإدارة الوكلاء (المضيف، التدوير، استيراد وكلاء HTTP/SOCKS، مفتاح تدوير لكل مهمة)، ومجدولًا مدمجًا يدعم إعدادات مرئية للفواصل/اليومية/الأسبوعية/الشهرية أو تعبيرات cron القياسية المكونة من 5 حقول، مع استمرار الجداول عبر عمليات إعادة التشغيل. يُتاح REST API على النسخة (المنفذ الافتراضي 11345). تغطي نقاط النهاية الموثقة إدارة المهام (السرد، الإنشاء، التحديث، تنفيذ مهمة محفوظة بمتغيرات وقت التشغيل)، والجدولة (السرد، الإنشاء/التحديث، الحذف، نظرة عامة على الحالة)، والتنفيذات (سجل مقسم إلى صفحات وتفاصيل لكل تشغيل)، وCabinets (قوائم الملفات، العناصر، التنزيلات، التحميلات، إنشاء ZIP). يمكن أن تستخدم المصادقة ترويسة x-api-key أو رمز Bearer. يتم النشر بشكل أساسي عبر Docker Compose، مع تشغيل التطبيق على المنفذ 11345 وعارض VNC على المنفذ 54311. تشير إرشادات الوكيل العكسي إلى أن منفذ التطبيق الرئيسي فقط يحتاج إلى تمرير عبر الوكيل، لأن عارض المتصفح المدمج يتصل عبر نقطة نهاية /websockify موثقة باستخدام تذاكر قصيرة العمر للاستخدام مرة واحدة. تشمل خيارات التكوين SESSION_SECRET (مطلوب)، وALLOWED_IPS، وTRUST_PROXY، وALLOW_PRIVATE_NETWORKS، وتخزين PostgreSQL الاختياري عبر DB_TYPE ومتغيرات DB_POSTGRESDB_*، ومحرك CloakBrowser الاختياري عبر USE_CLOAK_ENGINE وCLOAKBROWSER_LICENSE_KEY. يُفوَّض حل CAPTCHA إلى مشروع Fiptcha المنفصل. تشمل الملاحظات المتعلقة بالأمان في README مصادقة الجلسة، وقوائم IP المسموح بها، وإدارة الأسرار، ومسارات التدقيق، وتحذيرات من إيداع الأسرار، والتدوير الدوري لمفاتيح API. المشروع مرخص بموجب GPLv3 ويتضمن خارطة طريق لعناصر مكتملة ومخطط لها مثل مفاتيح API محددة النطاق، وحقن بيانات الاعتماد، ومرشحات حجب الإعلانات، وتنظيم المجلدات، والتفاعل مع iframe، والمحددات ذاتية الإصلاح.