Skip to content

دليل متقدّم: Jev Ultrafast وكيل المتصفح ودليل تجنّب الأخطاء ​

💡 الهدف: إنجاز أمرين في نحو 92 دقيقة — تشغيل وكيل متصفح Jev Ultrafast على حاسوبك (تسجيل رسمي: بحث حقيقي واحد على Google Flights في 7.073 ثانية)، ثم أخذ 9 أنماط فشل مع البدائل الرسمية من وثائق تجنّب الأخطاء لـ Jev 1.13.

🎯 أهداف المرحلة ​

  • أن تشرح كيف يعمل Jev Ultrafast: فضاء إجراءات مُفهرَس ديناميكيًا، وجولة واحدة تحدّد الإجراء والهدف معًا، والحلقة الافتراضية لا تأخذ لقطات شاشة
  • أن تشغّله من الصفر: uv sync + مفتاحا API، وترى العناصر المرقّمة والاحتمالات في inspector الخاص بـ 127.0.0.1:8766، ثم تكتب مهام متصفحك الخاصة باستخدام مكتبة Agent
  • أن تعرف قراءة بيانات الأداء الرسمية وحدودها: كيف قيست 7.073 ثانية، وماذا يعني استدعاء البروتوكول 1,092→101، وأي عناصر التحكم غير مدعومة، ولماذا يجب التحقق من DONE بشكل مستقل
  • أن تتعرّف على 9 أنماط فشل في Jev 1.13، وتذكر البديل الرسمي لكل منها — الحساب في الكود، والتواريخ عبر مكوّن، وتصفية الحالة الكبيرة أولًا

⏳ الوقت المتوقّع ​

  • مجموع 7 دروس نحو 92 دقيقة، وباحتساب هامش مرونة نحو 64–120 دقيقة
  • 5.1–5.4 خط واحد متسلسل (المبادئ ← التثبيت ← التشغيل الفعلي ← قراءة البيانات)، ويُنصح باتّباع الترتيب؛ 5.5 / 5.6 يعتمدان فقط على بيئة الدرس 2 ويمكن قراءتهما منفردَين حسب الحاجة
  • دليل 5.7 لتجنّب الأخطاء مستقل تمامًا ويمكن قراءته دون لمس المتصفح — مستخدمو API الخالص لا يخسرون شيئًا بالانتقال إليه مباشرة

🚀 قبل أن تبدأ ​

  • أكملت الاستخدام اليومي: إتقان الطرق الخمس للسؤال في Jev: كل قرار في Ultrafast هو طلب TypeSafe واحد، فلا بد أولًا من فهم state والأسئلة المُنمَّطة وتوزيعات الاحتمالات
  • لديك مفتاح API لـ TypeSafe (التسجيل ومفتاح API)؛ ويحتاج Ultrafast أيضًا إلى TEXT_MODEL_API_KEY لنموذج نصي (الدرس 2 يعلّمك كيفية إعداده)
  • لديك Chrome و uv على حاسوبك — يُثبَّت Ultrafast عبر uv sync ويتصل Chrome عبر Browser Harness
  • كوب من الماء ☕ — في هذه المرحلة سيبدأ Jev أخيرًا في النقر على المتصفح نيابةً عنك

📚 دروس هذه المرحلة ​

بطل الدروس 6 الأولى هو Jev Ultrafast — وكيل متصفح من Browser Use × TypeSafe، وتعريفه الرسمي بجملة واحدة: «وكيل متصفح ديناميكي بفضاء إجراءات مُفهرَس». وطريقة الاستخدام هي نمط الحكم المألوف لديك في Jev: أعطه هدفًا، فيختار Jev الإجراء والعنصر، ولا يكتب LLM الصغير سلسلة نصية إلا عند الحاجة إلى الكتابة (TYPE_TEXT).

في السحابة يوجد أيضًا BU Ultrafast المستضاف رسميًا (Browser Use Cloud، متاح لجميع الخطط، model: "bu-ultrafast"، والمدخل cloud.browser-use.com)؛ وما تشغّله في هذه المرحلة هو النسخة مفتوحة المصدر على GitHub، وتُنفَّذ جميع العمليات على حاسوبك الخاص.

انظر أولًا أين يختلف عن أسلوبك الحالي:

أسلوبك الحاليأسلوب Jev Ultrafast
❌ سكربتات الأتمتة تُصلّب المحدِّدات، فتتعطّل بالجملة عند أي تغيير في تصميم الصفحة✅ توليد جدول عناصر مرقّمة ديناميكيًا عند كل ملاحظة ([1] button Change ticket type · Round trip …)، ويختار Jev فقط مما هو موجود فعلًا في الصفحة الحالية
❌ الوكلاء البصريّون يخمّنون الإحداثيات من لقطات الشاشة، لقطة لكل خطوة، بطيئة ومكلفة✅ الحلقة الافتراضية لا تأخذ لقطات: Jev يستهلك state مُهيكلًا، وجولة واحدة تحدّد الإجراء والهدف معًا
❌ جعل LLM الكبير يُخرج JSON «خطة عمليات» ثم التضرّع كي يُحلَّل ويُنفَّذ✅ الإجراء والهدف كلاهما إجابات مُنمَّطة؛ ومخرجات النموذج لا تتحول أبدًا إلى selector أو إحداثيات أو JS قابل للتنفيذ

الإجراءات 8 في المجموع: CLICK، TYPE_TEXT، SELECT، SCROLL_UP، SCROLL_DOWN، WAIT، DONE، BLOCKED — لا يوجد إجراء خطير مثل «تنفيذ سكربت عشوائي». وسيفصّل الدرس 1 هذا الفضاءَ الإجرائي.

تنظيم الدروس:

الدرسالمحتوىالمدة
5.1 Jev مبادئ Ultrafastفضاء الإجراءات المُفهرَس ديناميكيًا و8 أنواع من الإجراءات؛ طلب TypeSafe واحد يسأل عن الإجراء والهدف معًا (قراران، جولة واحدة)؛ ولماذا الحلقة الافتراضية لا تأخذ لقطات12 دقيقة
5.2 تثبيت Ultrafast وتشغيلهgit clone + uv sync + مفتاحا API؛ فتح inspector الخاص بـ 127.0.0.1:8766 ورؤية العناصر المرقّمة واحتمالات الإجراءات واحتمالات الأهداف15 دقيقة
5.3 تشغيل Google Flightsبحث حقيقي واحد Zürich → London بتسجيل رسمي 7.073 ثانية؛ examples/flights.py يتضمّن تحققًا مستقلًا، بحث فقط دون حجز15 دقيقة
5.4 قراءة الأداءكيف تم قياس 7.073 ثانية: 17 طلبًا مع وسيط زمن الاستجابة Jev 178 ms؛ مقارنة بالقياس الفعلي 9.450→7.092 s وعدد استدعاءات البروتوكول 1,092→101 — تقول الجهة الرسمية صراحةً إنه عيّنة صغيرة وليس معيارًا مرجعيًا عامًا10 دقيقة
5.5 اكتب مهام متصفحك الخاصةتطبيق عملي على مكتبة Agent: Agent(url, goals) + run() للحصول على state خطوة بخطوة؛ تغيير URL والهدف فقط يعني مهمة جديدة15 دقيقة
5.6 استكشاف أخطاء Ultrafast وإصلاحهاماذا تفعل عند تعذّر الاتصال بـ Chrome (browser-harness --doctor)، أو ظهور خطأ TEXT_MODEL، أو تعذّر النقر وانحراف المسار؛ قائمة الميزات غير المدعومة: shadow DOM وcanvas والرفع وفتح tab جديد10 دقيقة
5.7 Jev 1.13 دليل تجنّب المزالقأنماط الفشل الـ 9 في وثائق jaggedness الرسمية والبدائل المقترحة: الفهم الحرفي، العدّ الحسابي، مقارنة التواريخ، الإحالة غير المباشرة، state الضخم، المحتوى التضليلي، التعليمات المتناقضة، ترتيب الخيارات، الحاجة إلى التوليد15 دقيقة

💡 يمكن استخدام نموذج نصي محلي الصنع

يعمل المساعد النصي (text helper) في Ultrafast عبر واجهة متوافقة مع OpenAI، ويقول README الرسمي صراحةً إن Gemini وGLM وDeepSeek كلها قابلة للتهيئة؛ والنقطة الافتراضية في الكود عند عدم تعيين متغيرات البيئة هي DeepSeek (https://api.deepseek.com/v1 + deepseek-chat). لا يظهر إلا عند TYPE_TEXT — عدم تهيئة TEXT_MODEL_API_KEY يؤدي إلى خطأ مباشرة، والنص الرسمي الحرفي: no text is hardcoded or guessed.

⚠️ DONE لا يعني النجاح

تقول الجهة الرسمية في Evidence and limits بوضوح تام: حتى بعد اختيار DONE يجب التحقق من النتيجة بشكل مستقل (وظيفة verify() في مثال Flights موجودة لهذا الغرض بالتحديد)؛ قارئ DOM يتعرّف فقط على عناصر HTML/ARIA الشائعة، وshadow roots وframes وcanvas والرفع وفتح tab جديد والتمرير المتداخل ومكوّنات لوحة المفاتيح العشوائية ليست ضمن هذا الـ MVP. وقد تكون العمليات الصالحة خاطئة أيضًا — الدرسان 4 و6 سيؤكدان هذه النقطة مرارًا.

الدرس الأخير مستقل نسبيًا: جمعت الجهة الرسمية المشكلات المعروفة لـ Jev 1.13 في وثيقة jaggedness — 9 أنماط فشل، مع بديل مقترح لكل منها. تشير الوثيقة إلى أنها تنطبق على jev-1.13 (آخر مراجعة 2026-10-02)، وتقول الجهة الرسمية أيضًا إن كثيرًا منها سيُصلح في الإصدارات اللاحقة؛ لكن عادات صياغة الأسئلة مثل «الحساب في الكود، التواريخ في مكوّن منفصل، وتصفية state الضخم أولًا» تستحق التشكّل بغض النظر عن الإصدار المستخدم.

🎒 ما ستكتسبه ​

  • وكيل متصفح (Agent) قابل للتشغيل: من clone إلى inspector ثم كتابة مهام مخصصة بمكتبة Agent، كل ذلك على جهازك المحلي
  • الطريقة الصحيحة لقراءة بيانات الأداء الرسمية: حدود احتساب 7.073 ثانية، وكيفية الاستشهاد بمقارنات العيّنات الصغيرة، دون تهويل أو تشويه
  • وعي بحدود الأمان: مخرجات النموذج لا تتحول أبدًا إلى كود قابل للتنفيذ، وDONE يجب التحقق منه بشكل مستقل، وقائمة عناصر التحكم غير المدعومة محفوظة في ذهنك
  • قائمة بأنماط الفشل الـ 9 بصيغة «العَرَض → البديل المقترح»، لتتجنب بوعي مزالق Jev 1.13 عند كتابة الأسئلة

خارج نطاق المتصفح، إذا أردت رؤية 15 حالة كاملة لـ Jev في سيناريوهات API الخالصة (تصفية التعليقات العائمة، ومراجعة RAG، والاستخراج المتسلسل)، راجع سيناريوهات عملية: اختر مسارك؛ وللاستعلام عن تنسيق الطلبات ورموز الحالة، انتقل إلى مرجع API سريع، أما إصدارات النماذج والأسعار فتجدها في النماذج والأسعار.


هل أنت مستعد؟ ابدأ بالدرس الأول: مبادئ Jev Ultrafast →

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.