شرح الأداء: كيف تم قياس ثواني 7.073
في الدرس السابق شاهدت بعينيك الوكيل يبحث عن الرحلات في 7 ثوانٍ. في هذا الدرس نفكك ساعة الإيقاف — 7.073 ثانية ليست شعارًا دعائيًا، بل سجل بقياسات وحدود كاملة: الجهة الرسمية لم تقدّم التقرير فحسب، بل وضعت أيضًا ملفات JSON للقياسات الخام في المستودع، بما في ذلك تجزئة الكود المصدري وإصدار المتصفح. إذا قرأت بيانات أداء Jev Ultrafast بفهم، فلن تتمكن فقط من إعادة إنتاجها، بل أيضًا من نسخ هذه المنهجية لقياس وكيلك الخاص.
أرقام هذا الدرس مصدرها الرئيسي ثلاثة ملفات في مستودع jev-ultrafast الذي استنسخته: docs/performance.md (نص التقرير)، وdocs/flights-measurement.json (بيانات السجل)، وdocs/full-speed-measurement.json (بيانات تجربة المقارنة).
ماذا ستستطيع أن تفعل بعد الدرس
- شرح منهجية توقيت 7.073 ثانية: يبدأ الاحتساب من أول تنبؤ ويتوقف عند قبول DONE، وما هي البنود الخمسة داخل الجدول والبنود الثلاثة خارجه
- تفكيك فاتورة السجل: 17 طلب قرار (وسيط 178 ms بإجمالي 3,720 ms)، و2 عملية توليد نصوص، و11 إجراءً، ومتى نُفِّذ كل إجراء بالثواني
- قراءة تصميم تجربة المقارنة من 9.450 إلى 7.092 ثانية، وتفسير السبب الذي جعل الجهة الرسمية تقول بنفسها «أزواج 3 قليلة جدًا، ليست معيارًا عامًا»
- توضيح ما أزاله التحسين: استدعاءات بروتوكول المتصفح من 1,092 إلى 101، منها 828 استدعاء DOM.resolveNode صُفِّرت تمامًا
- استخدام trace الخاص بـ
examples/flights.pyلمواءمة نفس المنهجية وقياس ثوانيك الخاصة
المأزق الذي أنت فيه الآن
- «الجهة الرسمية تقول 7 ثوانٍ، وأنا حصلت على 12 ثانية — ألا يبدو أن هذا الرقم اختار أفضل تشغيل؟» بدون معرفة المنهجية، المقارنة بلا فائدة
- تريد الاستشهاد بأرقام سرعة ultrafast هذه في عرضك، فتخنع عند سؤال واحد: «كيف تم القياس؟»
- تريد إجراء مقارنة أداء لوكيل المتصفح الذي صنعته، لكنك لا تعرف أي المتغيرات يجب ضبطها: النموذج؟ الشبكة؟ المتصفح؟ تريد نسخ نموذج جاهز ولا تجد أيًّا
متى تستخدم هذه الحيلة
عندما تحتاج إلى:
- نقل أو الاستشهاد بأرقام أداء Jev Ultrafast، مع القدرة على تحمّل سؤال «كيف تم قياسها؟»
- إجراء مقارنة أداء بنفسك لـ browser agent، وتحتاج منهجية قياس جاهزة (منهجية التوقيت، التحقق المستقل، إعلان حجم العينة) لنسخها
- الحكم على مدى ملاءمة هذه الأرقام لسيناريوك: فهي مهمة واحدة، شبكة حية (live)، عينة صغيرة
ولا تريد:
- التعامل مع ثواني تشغيل واحد كمؤشر ثابت والاستشهاد بها في كل مكان
- مقارنة أرقام بمنهجيات مختلفة (inspector مع لقطات الشاشة مقابل سكربت بدون لقطات؛ jev-1.13 مقابل jev-1.14)
🎒 التحضير قبل البدء
- أنجزت تشغيل Google Flights بنجاح: شغّلت
examples/flights.pyمرة واحدة على الأقل، ورأيت JSON التحقق الخاص بـ"passed": trueوartifacts/flights/latest/ - تذكر «التنبؤ المزدوج في جولة واحدة» من Jev Ultrafast المبادئ — كل طلب من طلبات 17 في هذا الدرس يتبع هذا الهيكل
- (اختياري) اترك مستودع jev-ultrafast مفتوحًا، واقرأ مقابل
docs/performance.mdوملفي JSON للقياس، كل رقم في هذا الدرس يمكنك العثور عليه هناك - كوب من الماء — هذا الدرس قراءة بالأساس، والتطبيق العملي في «النصائح المتقدمة»
الفكرة الأساسية
يمكن ضغط موقف الجهة الرسمية من أرقام الأداء في ثلاث جمل:
- كل رقم يحمل منهجيته — من أي ملّي ثانية يبدأ احتساب 7.073 ثانية، وعند أي ملّي ثانية يتوقف، وما يُحتسب داخل الجدول وما خارجه، كل ذلك موثق بوضوح تام
- المقارنة تتطلب ضبط المتغيرات — تشغيل النسختين الجديدة والقديمة بالتناوب 3 مرات لكل منهما، بنفس المهمة والنموذج والميزانية والتحقق المستقل
- إعلان القيود طوعًا — حجم العينة، الشبكة الحية، المهمة الواحدة، الجهة الرسمية قالتها بنفسها أولًا قبل أن يفتضح أمرها
المجموعات الأربع من الأرقام الرسمية التي سيفككها هذا الدرس:
| الرقم | المنهجية الرسمية | المصدر |
|---|---|---|
| 7.073 ث | أول تنبؤ → قبول DONE؛ يشمل استدعاءات النموذج وتوليد النص وعمليات المتصفح وقرارات stale وانتظار التحميل | docs/performance.md وflights-measurement.json |
| 9.450 → 7.092 ث | الوسيط من 6 تشغيلات متناوبة، تحقق مستقل للطرفين 3/3 | docs/full-speed-measurement.json |
| 1,092 → 101 | وسيط استدعاءات بروتوكول المتصفح في نفس التجربة المقارنة | docs/full-speed-measurement.json |
| $0.00006272 | فوترة OpenRouter لمساعدَي نص فقط، لا تشمل TypeSafe | docs/performance.md |
أمر آخر يجب تذكره مسبقًا: هذه الأرقام كلها صدرت عن نفس التوليفة — ** نموذج القرار jev-1.13.0 + نموذج النص inception/mercury-2.5** (عبر OpenRouter، مع إيقاف الاستدلال). في ملف JSON للقياس كان TYPESAFE_MODEL يساوي null، أي أنه استُخدم الافتراضي في الكود jev-latest (السطر 108 في jev_ultrafast/model.py)، وحينها كان يُحلَّل إلى 1.13.0؛ أما اليوم فقد أصبح jev-latest يشير إلى jev-1.14.0. إذا أعدت التجربة اليوم، سيكون النموذج مختلفًا وبالتالي ستختلف الثواني حتمًا.
💡 لماذا يستحق هذا الدرس قراءة متأنية
الأكثر فائدة من حفظ الرقم 7.073 هو منهجية «تعريف القياس + الفاتورة + بيان حجم العينة». يمكنك تطبيقها كما هي عند قياس أداء أي agent — سواء كان Ultrafast أو غيره.
نفّذ معي
الخطوة 1: مواءمة تعريف التوقيت — من أي ميلي ثانية يبدأ احتساب الثواني الرسمية
** لماذا**: قبل مقارنة أي رقمين بالثواني، مواءِم التعريف أولًا وإلا كانت كل المقارنات غير صالحة. سواء حصلت أنت على 9 ثوانٍ أو 12 ثوانٍ، فالخطوة الأولى هي فهم كيف يعمل المؤقت الرسمي.
التعريف الرسمي، في جدول واحد واضح:
| البند | المحتوى |
|---|---|
| بدء المؤقت | التنبؤ الأول بعد ملاحظة الصفحة الرئيسية الابتدائية |
| إيقاف المؤقت | لحظة قبول DONE |
| داخل المؤقت | استدعاءات النموذج وتوليد النص وعمليات المتصفح وقرارات stale (تنبؤات أُعيدت بعد إلغائها) وانتظار التحميل |
| خارج المؤقت | تشغيل المتصفح والتنقل الابتدائي وتحقق verify() المستقل بعد انتهاء التشغيل |
هذا التعريف مطابق في الكود (jev_ultrafast/agent.py):
started_atلا يُضبط إلا عند أولpredict— لذا فملاحظة الصفحة الابتدائية خارج المؤقت- يُحدَّث
elapsed_msعند قبول DONE داخلact— هذه هي نقطة إيقاف المؤقت - انتهاء صلاحية التنبؤ (
StalePage) يؤدي إلى تجاهل القرار وإعادة الملاحظة وإعادة التنبؤ — الوقت الملغى يبقى داخل المؤقت
الفيديو أيضًا بنفس التعريف: تشغيل بسرعة 1× الأصلية، دون توقف افتتاحي، مع إضافة 0.5 ثانية توقف فقط في النهاية؛ تسجيل متصل بـ 186 إطارًا مع 1 لقطة شاشة ابتدائية (في JSON: source_frames: 187)، وقُصَّ فقط شريط الحساب/التنقل العلوي بارتفاع 64 px — دون أي قص في البداية أو النهاية.
** ينبغي أن ترى**: فقرة التوقيت في docs/performance.md تقابل الجدول أعلاه بندًا ببند — "begins at the first prediction after initial homepage observation and ends at the accepted DONE choice"، بلا اختلاف كلمة واحدة بين ما هو داخل المؤقت وخارجه.
- أن تتمكن من ذكر البنود الخمسة داخل المؤقت والبنود الثلاثة خارجه
الخطوة 2: تفكيك فاتورة 7.073 ثانية — أين ذهب كل من 17 طلبًا
** لماذا**: كتب المسؤول كل رقم من هذه الجلسة المسجلة في docs/flights-measurement.json، ويمكن نسخ الفاتورة مباشرة. الإجمالي:
| المقياس | القيمة |
|---|---|
| الوقت الإجمالي | 7,073 ms |
| طلبات القرار | 17 مرة |
| زمن استجابة القرار | الوسيط 178 ms، بإجمالي 3,720 ms |
| تنفيذ الإجراءات | 11 إجراءً (10 تفاعلًا + 1 انتظار WAIT صريحًا واحدًا) |
| توليد النص | 2 مرة (Zurich 581 ms، وLondon 346 ms) |
| الـ token | 90,558 إدخالًا + 6,325 إخراجًا |
| نموذج القرار | jev-1.13.0 |
وجهة الوقت (السطران الأولان حقول أصلية من JSON الرسمي، والسطر الثالث محسوب في هذه الصفحة: 7073 − 3720 − 927):
| الوجهة | الوقت | النسبة |
|---|---|---|
| 17 طلب قرار | 3,720 ms | ≈ 53% |
| 2 توليد نص | 927 ms | ≈ 13% |
| تنفيذ المتصفح والملاحظة وتحميل الصفحات | ≈ 2,426 ms | ≈ 34% |
17 طلبًا لا تعني 17 إجراءً: 11 إجراءً مع 1 DONE مقبول واحدًا، أي ما مجموعه 12 تنبؤًا «صُرف في موضعه الصحيح»؛ أما الـ 5 مرات الأخرى فأوقفتها فحوصات الحداثة قبل التنفيذ — تغيّر بصمة الصفحة فيُلغى القرار المبني على لقطة قديمة ويعاد من جديد، وهذه هي stale decisions في التعريف، ووقتها محسوب كذلك ضمن إجمالي الثواني. (5 = 17 − 11 − 1، محسوب في هذه الصفحة استنادًا إلى منطق الحلقة في agent.py «كل تنبؤ يُستهلك مرة واحدة بالضبط، وما يُلغى يُعاد قياسه»، والمسؤولون لم ينشروا عدد مرات stale على حدة.)
موقع 11 إجراءً على الخط الزمني (executed_ms، مأخوذ من مصفوفة actions في ملف JSON الخاص بالتسجيل):
| اللحظة | الإجراء |
|---|---|
| 0.336 s | CLICK Change ticket type. Round trip |
| 0.640 s | CLICK One way |
| 1.595 s | TYPE_TEXT من أين؟ → زيورخ (توليد النص 581 ms) |
| 1.930 s | CLICK زيورخ، سويسرا (اختيار اقتراح الإكمال التلقائي) |
| 2.748 s | TYPE_TEXT إلى أين؟ → لندن (توليد النص 346 ms) |
| 3.053 s | CLICK لندن، المملكة المتحدة |
| 3.452 s | CLICK فتح المغادرة |
| 3.769 s | CLICK الأحد، سبتمبر 20، 2026 |
| 4.097 s | CLICK تم. البحث عن رحلات ذهاب فقط… |
| 5.217 s | CLICK بحث (النص الرسمي: تم تنفيذ البحث في الثانية 5.217) |
| 5.587 s | WAIT انتظار تحديث الصفحة |
| 7.073 s | DONE تم القبول، إيقاف المؤقت |
أول 5.2 ثانية كانت لتعبئة النموذج وإرساله، وآخر 1.9 ثانية كانت لانتظار النتيجة وتأكيد الاكتمال. نُفِّذ WAIT في الثانية 5.587، وقُبل DONE في الثانية 7.073 — هذه الثواني الأخيرة البالغة نحو 1.49 ثانية، التفسير الرسمي لها هو تحميل صفحة النتائج وتغير الحالة واتخاذ قرار الاكتمال. تسببت عمليتا توليد النص كل منهما في «توقف عن الكتابة» مدته نحو 0.3–0.6 ثانية، وهذا هو سبب ظهور حقل الإدخال في الفيديو وكأنه «يفكر قليلًا قبل أن تظهر الأحرف».
يجب أن ترى: في flights-measurement.json الحقول الأربعة في المستوى الأعلى elapsed_ms وdecision_requests وdecision_median_ms وdecision_total_ms، وexecuted_ms لعدد 11 من الإدخالات في مصفوفة actions — الخط الزمني أعلاه منسوخ من هذه المصفوفة.
- أن تستطيع ذكر كم من طلبات 17 تحولت إلى إجراءات، وكم منها كان stale، وكم منها كان DONE
الخطوة 3: فهم تجربة مقارنة أداء Jev Ultrafast: 9.450 → 7.092 ثانية
لماذا: الثواني 7.073 الواحدة ليست سوى تسجيل؛ أما استنتاج «أسرع بنسبة 25%» فيأتي من مجموعة أخرى من التجارب المقارنة. تصميم هذه التجارب هو ما يحدد مدى ما يمكن قوله من الاستنتاج.
تصميم التجربة (قسم «Matched runtime comparison» في performance.md):
- 6 تشغيلات، بالتناوب: تشغيلة أساس ثم تشغيلة للنسخة المحسّنة، بإجمالي 3 أزواج؛ المهمة نفسها، ونفس ملف تعريف Chrome الجاهز
- كلا الذراعين يستخدمانتمامًا نفس: الهدف باللغة الطبيعية، والمدقق المستقل للنتائج، ومنفذ العرض 1120×780، وjev-1.13.0، وmercury-2.5 (مع إيقاف الاستدلال)، وميزانية الإجراءات والطلبات
- التنقل الأولي لا يُحتسب في التوقيت لدى الطرفين؛ كل تشغيلة تفتح علامة التبويب الخاصة بها وتغلقها؛ جميع 6 تشغيلة محسوبة، لا شيء مُستبعد، ولا فشل من المزوّد أو التحقق
- ذراع الأساس مجمّدة عند الـ commit
68c077bf…؛ الطرفان يستخدمان Mercury، لتجنب خلط متغيرَي «تغيير نموذج النص» و«تعديل الكود» معًا
النتائج:
| الزوج | الأساس | النسخة المحسّنة | التحقق |
|---|---|---|---|
| 1 | 11.214 s | 6.964 s | نجح الطرفان |
| 2 | 8.984 s | 7.913 s | نجح الطرفان |
| 3 | 9.450 s | 7.092 s | نجح الطرفان |
| الوسيط | 9.450 s | 7.092 s | بمقدار 3/3 |
ثلاثة تغييرات في الوسيط: وقت المهمة −25.0%، وطلبات TypeSafe 22 → 17، واستدعاءات بروتوكول المتصفح 1,092 → 101. النسخة المحسّنة كانت أسرع في الأزواج الثلاثة جميعها.
لكن الجهة الرسمية أعطت مباشرةً بعدها ثلاثة إخلاءات مسؤولية بنفسها:
- الأزواج 3 قليلة جدًا، واختبار الإشارة ثنائي الجانب p = 0.25، وهو لا يدعم استنتاجًا إحصائيًا قويًا
- هذه مقارنة محكمة على عينة صغيرة، وليست معيارًا (benchmark) واسعًا للـ agents
- Google واستجابات الشبكة والتوجيه وذاكرة التخزين المؤقت للمتصفح كلها عناصر حية، ولم تكن خاضعة للتحكم
⚠️ الطريقة الصحيحة للاستشهاد بهذه الأرقام
«في 3 أزواج من التشغيلات المتناوبة على المهمة نفسها والنموذج نفسه والمتصفح نفسه، كانت النسخة المحسّنة أسرع في كل مرة، بوسيط أسرع بنسبة 25%» — هذا قول له أساس. أما «Jev Ultrafast أسرع من فلان من الـ agents بنسبة 25%» — فلا أساس له، فالجهة الرسمية لم تُجرِ مقارنة عبر الـ agents.
يجب أن ترى: جدول المقارنة في performance.md هو 3 أزواج من الأرقام أعلاه مضافًا إليها صف وسيط بالخط العريض؛ "p = 0.25" و"not a broad agent benchmark" كلاهما موجود في النص الأصلي.
- أن تتمكن من ذكر أي المتغيرات ضبطتها التجربة وأيها لم تضبطه
الخطوة 4: معرفة إلى أين يذهب الوقت — 1,092 → 101 استدعاء بروتوكول، ما الذي أُزيل
لماذا: سبب كونه "أسرع بنسبة 25%" يقع بالكامل على استدعاءات بروتوكول المتصفح. خزّن المسؤولون في ملف measurement JSON تفاصيل كاملة لكل استدعاء CDP (بروتوكول Chrome DevTools) في كل تشغيل، وهذه أقوى مجموعة أدلة في الدورة بأكملها.
الأعباء الثلاثة للحلقة القديمة (performance.md «Where the time went»):
- كل تغيير في DOM — بما في ذلك الرسوم المتحركة — يُبطل القرار ويُعيد التنبؤ مرارًا وتكرارًا
- قراءة شجرة إمكانية الوصول بأكملها بشكل متكرر (
Accessibility.getFullAXTree) - تحليل مئات عقد DOM (
DOM.resolveNode)
ما تفعله الحلقة الجديدة (performance.md «Where the time went» + README):
- استدعاء متصفح واحد لقراءة عناصر HTML/ARIA الشائعة — لم يعد هناك قراءة متكررة للشجرة أو تحليل للعقد واحدًا تلو الآخر
- حارس النقر يقارن فقط الهدف والسياق المجاور وحالة المستند/النموذج؛ تُجرى الهندسة واختبار الإصابة قبل الإدخال
- انتظار أحداث combobox: تصل اقتراحات الإكمال التلقائي أولًا (README: الحد الأقصى 200 ms؛ التفاعلات الأخرى حتى إطارين متحركين أو 50 ms) ثم يُسأل Jev
- استبدال النص الأصلي يُصدر صراحةً أمر select-all الخاص بالمتصفح
تفاصيل استدعاءات CDP (مدرجة واحدة تلو الأخرى للتشغيلات الثلاثة، من كائن cdp لكل run في full-speed-measurement.json):
| طريقة البروتوكول | خط الأساس (3 مرة) | النسخة المحسّنة (3 مرة) |
|---|---|---|
| DOM.resolveNode | 828 / 828 / 828 | 0 (لم يعد المفتاح يظهر) |
| Accessibility.getFullAXTree | 30 / 30 / 30 | 0 |
| Runtime.callFunctionOn | 40 / 40 / 40 | 0 |
| DOM.getBoxModel + DOM.getNodeForLocation | 10 + 10 / 10 + 10 / 10 + 10 | 0 |
| Runtime.evaluate | 158 / 146 / 148 | 75 / 77 / 71 |
| Input.dispatchMouseEvent / KeyEvent / insertText | 20 / 4 / 2 (نفس الشيء في كل مرة) | 20 / 4 / 2 (دون تغيير) |
| الإجمالي | 1102 / 1090 / 1092 (الوسيط 1,092) | 101 / 103 / 97 (الوسيط 101) |
رؤيتان عند قراءة الجدول:
- «طريقة رؤية الصفحة» تغيرت، أما «النقر على الصفحة» فلا — استدعاءات الإدخال الثلاثة (الفأرة ولوحة المفاتيح وإدراج النص) متطابقة تمامًا بين الجانبين، وكل ما أُزيل هو استدعاءات المراقبة
- الطلبات أيضًا أصبحت أقل (الوسيط 22 → 17): لم يعد القرار يُبطل بشكل متكرر بسبب الرسوم المتحركة، فقلّت إعادة التنبؤ بشكل طبيعي
💡 هذا هو الدليل الكمي على «لقطة واحدة تعني استدعاء متصفح واحدًا»
درس المبادئ تناول مبدأ التصميم في README «One browser call per snapshot». وعلى مستوى الأرقام: انخفض Runtime.evaluate من حوالي 150 مرة إلى حوالي 75 مرة، وأصبح DOM.resolveNode صفرًا من 828 مرة. يتطابق ما يقوله المعماري مع بيانات القياس.
يجب أن ترى: في تفاصيل cdp للتشغيلات الثلاثة لخط الأساس في full-speed-measurement.json، DOM.resolveNode هي جميعًا 828 مرة؛ وفي تفاصيل cdp للتشغيلات الثلاثة للنسخة المحسّنة لا توجد هذه الطريقة على الإطلاق.
- أن تتمكن من ذكر ما هي فئات استدعاءات المراقبة الثلاث التي أُزيلت، ولماذا لم تتغير استدعاءات الإدخال
الخطوة 5: حساب التكلفة بدقة — token، والمساعد النصي، والسعر الذي لم يبلغ عنه المسؤولون
لماذا: لا يمكن أن يقتصر تفسير الأداء على الثواني، بل يجب أيضًا معرفة كم كلّفت هذه الجولة من المال. أبلغ المسؤولون عن النصف، ويمكن استنتاج النصف الآخر بأنفسنا.
ما أبلغ عنه المسؤولون:
- إجمالي جميع طلبات التسجيل 90,558 input token + 6,325 output token
- حسب OpenRouter فاتورة على استدعاءي النص $0.00006272 (Zurich $0.0000293 + London $0.0000334)
- أعلن المسؤولون صراحةً: هذه هي فقط** تكلفة المساعد النصي، وليست التكلفة الإجمالية للمهمة** — استجابة TypeSafe تحتوي على أعداد token فقط دون فاتورة بالدولار، ولا تشمل تكلفة المتصفح أيضًا
ما لم يبلغ عنه المسؤولون ويمكن استنتاجه بأنفسنا (تقدير من هذه الصفحة، وليس رقمًا رسميًا):
وفقًا لقائمة الأسعار الرسمية لـ TypeSafe ($42 / مليار token إدخال، والإخراج مجاني)، فإن 90,558 token إدخال ≈ $0.0038. عملية الحساب: 90558 × 42 ÷ 10⁹ ≈ 0.0038 دولار. وبإضافة $0.00006272 الخاصة بمساعد النصوص، فإن التكلفة الإجمالية للنموذج في مهمة استغرقت 7 ثوانٍ تبلغ حوالي 0.4 سنت.
مثال على التقلب (كلاهما في full-speed-measurement.json): في توليد London نفسها، استغرقت الجلسة المسجلة 346 ms و94 token إكمال ($0.0000334)؛ بينما استغرقت النسخة المحسّنة في الزوج رقم 2 من تجربة المقارنة 1,137 ms و511 token ($0.0000961) — يمكن أن يختلف زمن استجابة استدعاء نصي واحد بأكثر من 3 أضعاف، وكل هذا النوع من التقلب يدخل في إجمالي الثواني.
يجب أن ترى: الفقرة "$0.00006272" في performance.md تنص على «text-helper charge, not total task cost»؛ وسعر الوحدة للاستدعاءين موجود في text_calls بملف flights-measurement.json (2.93e-05 + 3.342e-05).
- أن يشرح بوضوح ما يشمله $0.00006272 وما لا يشمله
نقطة تحقق ✅
- أن يستطيع سرد منهجية التوقيت كاملة: نقطة بدء التوقيت، نقطة إيقافه، البنود الخمسة داخل المؤقت، والبنود الثلاثة خارجه
- أن يستطيع ذكر الأرقام الأربعة الرئيسية لفاتورة الجلسة المسجلة: 17 طلبًا، ووسيط 178 ms، و11 إجراءً، ونُفّذ البحث في الثانية 5.217
- أن يستطيع شرح تصميم تجربة 9.450 → 7.092 ثانية، وذكر إخلاءات المسؤولية الثلاثة التي أعلنها الطرف الرسمي نفسه
- أن يستطيع ذكر أنواع الاستدعاءات الثلاثة التي صُفّرت في استدعاءات البروتوكول 1,092 → 101
- أن يوضح أن $0.00006272 هو مجرد تكلفة مساعد النصوص، وأن فاتورة TypeSafe تُحسب وفق قائمة الأسعار بشكل منفصل
تنبيهات من الأخطاء الشائعة
❌ استخدام ثوانيك الخاصة مباشرة للتشكيك في الأرقام الرسمية
الظاهرة: حصلت على 9 ثوانٍ و12 ثوانٍ، وتظن أن 7.073 ثانية فيها مبالغة.
السبب: هناك أربعة اختلافات في المنهجية على الأقل — ① النموذج مختلف: القياس استخدم jev-1.13.0، بينما يشير jev-latest اليوم إلى jev-1.14.0؛ ② الشبكة متغيرة: النسخة الرسمية المحسّنة نفسها توزعت محاولاتها الثلاث على 6.964–7.913 ثوانٍ؛ ③ كان inspector مفتوحًا مع التقاط لقطات شاشة، وهذا أصلًا ليس طريقة تشغيل للتوقيت (كما شرحنا في الدرس السابق)؛ ④ قد يصادف تشغيلك المزيد من القرارات stale.
الطريقة الصحيحة: شغّل باستخدام examples/flights.py (بدون لقطات شاشة)، واقرأ elapsed_ms من المستوى الأعلى في artifacts/flights/latest/state.json — هذا هو الرقم الموافق لمنهجية الطرف الرسمي؛ وقبل المقارنة طابق النموذج وURL والهدف أولًا.
❌ اعتبار «أسرع بنسبة 25%» استنتاجًا عبر جميع الوكلاء
الظاهرة: «Jev Ultrafast أسرع من وكيل المتصفح الفلاني بنسبة 25%.»
السبب: الطرف الرسمي قارن نسختيه القديمة والجديدة نفسهما — خط الأساس هو التنفيذ القديم المجمّد عند commit 68c077bf…، وليس أي وكيل آخر؛ كما أن 3 أزواج للعينة تعطي p = 0.25، والطرف الرسمي نفسه يقول إنها عينة صغيرة مضبوطة.
الطريقة الصحيحة: أضف القيود عند الاقتباس: «3 أزواج متبادلة على نفس المهمة ونفس النموذج، النسخة الجديدة أسرع من القديمة بوسيط 25%».
❌ الظن أن الطرف الرسمي وصل إلى 7 ثانية من المحاولة الأولى
الظاهرة: رؤية 7.073 ثانية والظن أن الأداء جاء تلقائيًا.
السبب: يحتفظ performance.md بسجل تطوير كامل: النسخة القديمة نجحت مرة واحدة بـ 9.302 s؛ ومخططا شجرة الوصول 9.395 s و10.157 s؛ وأول مخطط DOM مباشر 8.697 s لكنهفشل في التحقق المستقل (استخراج الأسماء/القيم كان غير مكتمل)؛ وبعد الإصلاح تسلق المسار 8.051 ثم 8.631 ثم 8.395 ثم 8.385 ثم 7.741 s، وتشخيص Mercury 7.559 s. وقبل ذلك كان هناك تسجيل بـ 11.387 s وانحدار في الاستراتيجية بـ 12.898 s.
الطريقة الصحيحة: اعتبر «8.697 s لكن verify فشل» تذكيرًا — مهما بدت الثواني جميلة، لا يُعد النجاح نجاحًا إن لم يجتز التحقق المستقل. وجرأة الطرف الرسمي على كتابة كل المحاولات الفاشلة في الوثائق تثبت أن قابلية إعادة الإنتاج أهم من المظهر الجميل.
❌ تطبيق 7 ثانية على جميع المواقع
الظاهرة: «Flights في 7 ثوانٍ، إذن لوحة التحكم المعقدة عندي يجب أن تكون 7 ثوانٍ أيضًا.»
السبب: الطرف الرسمي لم ينشر سوى ثوانٍ لثلاث مهام: Flights 7.073 s، وفتح نظرية عدم الاكتمال لغودل على Wikipedia 2.798 s، ومهمة الفندق المحلية 1.896 s — والطرف الرسمي صرّح بأن الأخيرتين «فحص دخان، وليس مقارنة مطابقة». قارئ DOM يدعم عناصر HTML/ARIA الشائعة فقط، ولا يدعم shadow DOM أو canvas أو الرفع وغيرها.
الطريقة الصحيحة: قِس بنفسك على موقعك وأهدافك؛ وراجع أولًا قائمة غير المدعوم في استكشاف أخطاء Ultrafast وإصلاحها واستبعد الصفحات غير المناسبة.
تقنيات متقدمة (اختيارية)
اختبر منهجيتك الخاصة. بعد انتهاء uv run --env-file .env python examples/flights.py --keep-open من الدرس السابق، افتح artifacts/flights/latest/state.json: القيمة elapsed_ms في المستوى الأعلى هي ثواني هذه الجولة بمنهجية الطرف الرسمي؛ وفي history يحمل كل إجراء executed_ms وlatency_ms وtext_latency_ms، حيث decisions هي كل تنبؤ وtext_calls هي مساعد النصوص. ملف JSON للقياس الرسمي هو ببساطة تقرير مصنوع من هذه الحقول. شغّل ثلاث جولات وخذ الوسيط، فهذا أكثر إقناعًا من جولة واحدة.
راجع أرقام هذا الدرس حقلًا بحقل. يحتوي docs/flights-measurement.json (الجلسة المسجلة) وdocs/full-speed-measurement.json (تجربة المقارنة) على جميع البيانات الخام: هاش الكود المصدري، وعدد الـ tokens، وتكلفة كل استدعاء نصي؛ كما تحمل 6 تشغيلات تجربة المقارنة لكل منها إصدار المتصفح (Chrome/152.0.7977.83) وتفاصيل CDP كاملة. إذا أردت التحقق من أي رقم في هذا النص، فارجع إلى هذين الملفين.
انتبه لتغيرات الكود بعد القياس. يسجل performance.md أنه بعد اكتمال التوقيت والتسجيل، تم تشديد معالجة مقاطعة عناصر SELECT الأصلية (التوقف عند عدم اليقين، بدلًا من اعتبارها قراءة stale قابلة لإعادة المحاولة)؛ ومهمة Flights لا تُفعّل SELECT الأصلية، لذا بقي هاش التوقيت والتسجيل دون تغيير. الكود الذي تستنسخه أحدث قليلًا من وقت القياس، وهذا أمر طبيعي.
**عند اختيار مساعد نصي، انظر كيف اختارته الجهة الرسمية. ** استخدمت الجهة الرسمية حقلي رحلتين حقيقيتين كمسبار، وجرّبت Gemini 2.5 Flash Lite وGemini 3.1 Flash Lite وMercury 2.5، وجميعها أعادت القيم الصحيحة؛ مسبار سابق استبعد نموذجًا كان يعكس موضعي المغادرة/الوصول، واستبعد أيضًا نموذجًا لم يكن يُخرج JSON صالحًا بل كان يُخرج تعليقات. الدرس: عند تغيير TEXT_MODEL لا تنظر إلى زمن الاستجابة فقط، بل أجرِ مسبار صحة باستخدام حقول حقيقية قبل الاعتماد عليه.
خلاصة هذا الدرس
✅ تأتي أرقام أداء Jev Ultrafast في ثلاث مجموعات: التسجيل الفعلي 7.073 ثانية (المعيار: أول تنبؤ → قبول DONE)، وتجربة المقارنة 9.450 → 7.092 ثانية (6 تبادلات، بأخذ الوسيط، بـ 3/3 لكل من الطرفين)، واستدعاءات البروتوكول 1,092 → 101 (نفس التجربة).
✅ فاتورة التسجيل الفعلي: 17 طلب قرار (الوسيط 178 ms، والإجمالي 3,720 ms، أي نحو 53% من الوقت الإجمالي)، و2 توليدًا نصيًا (927 ms)، و11 إجراءً، و90,558 + 6,325 token؛ ونُفِّذ البحث في الثانية 5.217.
✅ 17 طلبًا = 11 إجراءً + 1 DONE مقبولًا + 5 stale (تنبؤ أصبح لاغيًا قبل التنفيذ بسبب تغيّر الصفحة، ويُحتسب وقته مع ذلك).
✅ سبب التسريع هو تغيّر طريقة «رؤية الصفحة»: DOM.resolveNode 828 → 0، وشجرة الوصولية الكاملة 30 → 0، وRuntime.evaluate نحو 150 → نحو 75؛ استدعاءات الإدخال لم تتغير بين الطرفين.
✅ أرفِق المؤهلات عند الاقتباس: مهمة واحدة، 3 أزواج متبادلة، شبكة حية (live)، p = 0.25 — الجهة الرسمية نفسها كتبت القيود بجانب الأرقام، فانقلها بهذه الطريقة أيضًا.
مراجعة الأرقام الرئيسية:
| المقياس | الرقم الرسمي | المعيار |
|---|---|---|
| زمن التسجيل الفعلي | 7.073 s | أول تنبؤ → قبول DONE |
| طلبات القرار / وسيط زمن الاستجابة | 17 مرة / 178 ms | تسجيل فعلي |
| لحظة تنفيذ البحث | 5.217 s | تسجيل فعلي، أحد 11 إجراءً |
| وسيط زمن المقارنة | 9.450 → 7.092 s (−25.0%) | 3 أزواج تشغيل متبادلة |
| وسيط استدعاءات البروتوكول | 1,092 → 101 | نفس تجربة المقارنة |
| تكلفة المساعد النصي | $0.00006272 | 2 استدعاءً نصيًا فقط (OpenRouter) |
| TypeSafe token | 90,558 إدخال / 6,325 إخراج | جميع طلبات التسجيل الفعلي |
استعراض الدرس التالي
بعد أن استعرضنا الأرقام، في الدرس التالي اكتب مهمة متصفحك الخاصة: تطبيق عملي لمكتبة Agent ستحوّل Ultrafast إلى أداتك الخاصة. ستتعلم:
- الاستخدام الكامل لـ
Agent(url, goals): يمكن أن يكون goals سلسلة نصية أو قائمة، وrun()للحصول على state خطوة بخطوة - كيفية استخدام كل حقل في state: history وdecisions وtext_calls وstatus وelapsed_ms — وهي نفسها مصدر بيانات فاتورة هذا الدرس
- تغيير URL وجملة هدف واحدة يعني مهمة جديدة، ومتى ينبغي إعداد تحقق مستقل خاص بك
- كيفية تغيير النموذج النصي: طرق إعداد DeepSeek وGLM وغيرها من نقاط النهاية المتوافقة مع OpenAI
ملحق: مرجع الكود المصدري
انقر للتوسيع ومعرفة مواضع الكود المصدري
آخر تحديث: 2026-11-04 (المستودع github.com/browser-use/jev-ultrafast، ومصدر المعلومات المحلي sources/jev/repo-ultrafast/)
| الوظيفة | مسار الملف | المواضع الرئيسية |
|---|---|---|
| نص تقرير الأداء | docs/performance.md | معيار التوقيت (Timing begins…)؛ فاتورة التسجيل الفعلي (17 طلبًا / 178 ms / 5.217 s / 7.073 s / 90,558+6,325 token / $0.00006272)؛ جدول تجربة المقارنة وp=0.25؛ Where the time went؛ Other checks (2.798 s / 1.896 s)؛ Development attempts؛ Limits |
| بيانات القياس الفعلي | docs/flights-measurement.json | elapsed_ms 7073؛ decision_requests 17؛ decision_median_ms 178؛ decision_total_ms 3720؛ actions مصفوفة، الجدول الزمني لـ 11 إجراءً في executed_ms؛ text_calls (581/346 ms و$2.93e-05/$3.342e-05)؛ tokens 90558/6325؛ video (187 إطارًا / 1× / 0 توقف افتتاحي / 500 ms توقف ختامي / قص 64 px)؛ حقل timing هو نص المعيار نفسه |
| بيانات تجربة المقارنة | docs/full-speed-measurement.json | summary (9450/7092 و1092/101)؛ runs 6 إدخالات (لكل زوج: elapsed_ms وdecision_requests وتفاصيل cdp وبصمة الكود المصدري وtokens وtext_calls)؛ scope (3 أزواج، 1120×780، live غير مضبوطة)؛ baseline_commit 68c077bf… |
| ملخص README | README.md | «Evidence and limits»: 7,073 ms، نجاح 3/3، 25%، استدعاءات البروتوكول 1,092 → 101، 2.798 s / 1.896 s، يتطلب DONE تحققًا مستقلًا |
| نقطة بداية التوقيت ومعالجة الحالة القديمة (stale) | jev_ultrafast/agent.py | L68–69 يُضبط started_at عند أول predict؛ L93–99 يُحدَّث elapsed_ms عند قبول DONE؛ L55–64 StalePage → تجاهل القرار وإعادة الملاحظة؛ L75–76 ميزانية استدعاءات النموذج MAX_STEPS×2؛ L102–104 ميزانية الإجراءات |
| النموذج الافتراضي | jev_ultrafast/model.py | L108 os.environ.get("TYPESAFE_MODEL", "jev-latest") |
| حقول حفظ trace | examples/flights.py | L50–52 طباعة elapsed_ms/status؛ L54–56 state.json = agent.snapshot() + verification (يشمل elapsed_ms وhistory وdecisions وtext_calls) |
| النص الأصلي لمبادئ التصميم | README.md | L98 «One browser call per snapshot»؛ L100 الحد الأقصى المقترح لانتظار combobox هو 200 ms، وللتفاعلات الأخرى إطاران للرسوم المتحركة أو 50 ms |
| قائمة أسعار Jev (أساس تقدير التكلفة) | الوثائق الرسمية لـ TypeSafe docs/models.md (محليًا sources/jev/docs/models.md) | $42 / B لرموز الإدخال، والمخرجات مجانية؛ يشير الاسم المستعار jev-latest حاليًا إلى jev-1.14.0 |