Ultrafast ट्रबलशूटिंग: कनेक्ट न होना, क्लिक न चलना, भटकना — क्या करें
Jev Ultrafast चलाते समय समस्या आई है, तो अधिकतर संभावना है कि ये चार में से किसी लेयर पर अटकी होगी: लोकल सर्विस शुरू नहीं हुई, Chrome कनेक्ट नहीं हुआ, मॉडल कॉल अस्वीकृत, या निर्णय निष्पादन में रुकावट। यह पाठ सामान्य jev-ultrafast त्रुटियों को उनके मूल पाठ के अनुसार एक-एक करके कारण और समाधान देता है — पहले 60 सेकंड की त्वरित जाँच, फिर मिलती-जुलती त्रुटि ढूँढें।
सभी त्रुटि पाठ रिपॉज़िटरी के सोर्स कोड से लिए गए हैं (jev_ultrafast/model.py, agent.py, browser.py, demo.py और inspector इंटरफ़ेस), शब्दशः खोजे जा सकते हैं और प्रश्न पूछने के लिए कॉपी किए जा सकते हैं। पिछला कोर्स अटका हो तो कोई बात नहीं, इंस्टॉल और रन का कोई भी चरण विफल हो तो यहीं लौटकर जाँच सकते हैं।
सीखने के बाद आप क्या कर सकेंगे
- 4 कमांड से 60 सेकंड में पता लगाएँ कि डायरेक्टरी, Key, Chrome, ब्राउज़र निष्पादन लेयर में से कौन-सी कड़ी में समस्या है
- jev-ultrafast त्रुटियों को पहचानें: त्रुटि का मूल पाठ → कारण → सुधार के चरण
- तीन प्रकार की त्रुटियों का व्यवहार समझें: stale प्रकार (ऑटो मोड में स्वयं ठीक), रीट्राई प्रकार (कोड स्वतः बैकऑफ़), मैनुअल प्रकार (आपको कॉन्फ़िगरेशन या लक्ष्य बदलना होगा)
- inspector स्टेटस बार के 6 प्रकार के प्रदर्शन समझें, और जानें कि done और blocked के बाद आगे क्या करना है
- असमर्थित सूची याद रखें: shadow DOM, frames, canvas, अपलोड, नया टैब पॉपअप, नेस्टेड स्क्रॉल, कोई भी कीबोर्ड कंपोनेंट
- Export trace से निर्णय के साक्ष्य निर्यात करें, और न्यूनतम जानकारी के साथ प्रश्न पूछें
आपकी मौजूदा दिक्कत
- Start demo पर क्लिक करने से कोई प्रतिक्रिया नहीं, पता नहीं सर्विस शुरू नहीं हुई, Chrome कनेक्ट नहीं हुआ, या Key कॉन्फ़िगर नहीं है
- लाल बॉक्स में अंग्रेज़ी त्रुटि एक पल को दिखती है, पता नहीं कौन-सा वाक्य खोजना है, और खोज लेने पर भी समझ नहीं आता कि किस लेयर की गलती है
- agent की स्थिति done / blocked हो जाती है, पर पेज वह परिणाम नहीं दिखाता जो चाहिए — लक्ष्य गलत लिखा गया है, या यह पेज बिलकुल भी नहीं चल सकता?
यह तरीका कब अपनाएँ
जब आपको ये करना हो:
- Ultrafast इंस्टॉल और रन, Google Flights चलाना, अपने ब्राउज़र टास्क लिखना में अटकी त्रुटियाँ ठीक करनी हों
- काम शुरू करने से पहले यह जाँचना हो कि कोई वेबसाइट Ultrafast के लिए उपयुक्त है या नहीं — पहले असमर्थित सूची से छानें, ज़बरदस्ती मत करें
और आप ये नहीं करना चाहते:
- त्रुटि मिलते ही रिपॉज़िटरी मिटाकर दोबारा इंस्टॉल करना, पूरा इंस्टॉल प्रक्रिया फिर से चलाना
- «पेज बदल गया है तो रीट्राई करें» और «कॉन्फ़िगरेशन टूटा है तो ठीक करें» में फ़र्क न कर पाना, और बिना कारण आधे दिन बदलते रहना
🎒 शुरू करने से पहले की तैयारी
- Ultrafast इंस्टॉल और रन पूरा किया है (अटकने पर कोई बात नहीं, यही पाठ अटकना हटाने के लिए है)
- रिपॉज़िटरी लोकल पर clone है, टर्मिनल
jev-ultrafast/रूट डायरेक्टरी में कमांड चला सकता है - (वैकल्पिक) अपने ब्राउज़र टास्क लिखना चला चुके हैं — Agent लाइब्रेरी का उपयोग करते समय आई त्रुटियाँ भी यहीं पहचानी जा सकती हैं
मूल विचार
पहले लेयर तय करें, फिर त्रुटि देखें। एक Ultrafast टास्क चार लेयर से गुज़रता है, हर लेयर की त्रुटियाँ अलग दिखती हैं:
| लेयर | क्या जाँचें | सामान्य त्रुटि / लक्षण |
|---|---|---|
| 1. लोकल सर्विस | uv run jev चला या नहीं, डायरेक्टरी सही है या नहीं, पता 127.0.0.1 है या नहीं | Cannot reach local demo server / Forbidden |
| 2. Chrome कनेक्शन | Browser Harness, रिमोट डिबगिंग अनुमति | पैनल लगातार नहीं हिलता |
| 3. मॉडल कॉल | दोनों Key, नेटवर्क, कोटा | TYPE_TEXT needs TEXT_MODEL_API_KEY / Model provider returned HTTP 401 |
| 4. निर्णय और निष्पादन | पेज में बदलाव, एक्शन बजट, पेज कंट्रोल की सीमाएँ | Target changed or is covered / स्थिति blocked हो जाती है |
तीन प्रकार की त्रुटियाँ, तीन तरह का व्यवहार। त्रुटि दिखते ही पहले उसकी श्रेणी पहचानें, जल्दबाज़ी में कुछ करने से पहले:
| प्रकार | उदाहरण | आपको क्या करना है |
|---|---|---|
| स्व-चिकित्सा प्रकार (stale, पेज बदल गया) | Page changed since the decision / Target changed or is covered | कुछ नहीं करना है: ऑटोमैटिक रन फिर से ऑब्ज़र्व करके निर्णय लेगा; मैनुअल मोड में एक बार Choose next दबाएँ |
| रीट्राई प्रकार (सर्वर की ओर से अस्थायी इनकार) | 429 / 529 / 503 → कोड कुल 3 बार कोशिश करता है (रीट्राई 2 बार), फिर भी विफल होने पर Model provider returned HTTP 429/529/503 रिपोर्ट करता है | थोड़ा इंतज़ार करके दोबारा चलाएँ, कोटा जाँचें |
| स्वयं कार्रवाई प्रकार (कॉन्फ़िगरेशन / बजट / सीमाएँ) | Key गायब, HTTP 401, 60 एक्शन बजट, shadow DOM समर्थित नहीं | नीचे दिए गए बिंदुओं के अनुसार कॉन्फ़िगरेशन बदलें, लक्ष्य बदलें या पेज बदलें |
💡 inspector स्टेटस बार की तुलना तालिका (app.js का मूल पाठ)
| स्टेटस बार में दिखता है | अर्थ | आपको क्या करना है |
|---|---|---|
| Ready to explore | अभी Start demo नहीं किया गया | लक्ष्य भरें, Start demo दबाएँ |
| Page observed · ready for a decision | पेज ऑब्ज़र्व हो चुका है, निर्णय की प्रतीक्षा में | Choose next या Run automatically दबाएँ |
| Choice ready · inspect or execute | निर्णय आ चुका है, निष्पादन बाकी है | प्रायिकता जाँचकर Execute choice दबाएँ |
| Jev reports complete · inspect the page | मॉडल ने DONE चुना | स्वयं पेज की जाँच करें——DONE सफलता का प्रमाण नहीं है |
| Stopped · no supported next action | blocked: लगातार अमान्य एक्शन या मॉडल ने BLOCKED चुना | Decision trail के आख़िरी कुछ चरण देखें, असमर्थित सूची से मिलाएँ |
| Paused · needs attention | त्रुटि के कारण रुका है | लाल बॉक्स में दिख रही त्रुटि का मूल पाठ देखें, उसे उसकी जगह पर रखें |
पहली जाँच: 60-सेकंड तुरंत जाँच
चार कमांड क्रम से चलाएँ, ताकि बारी-बारी से डायरेक्टरी, Key, Chrome कनेक्शन और ब्राउज़र निष्पादन परत की पुष्टि हो। पूर्वशर्त: uv run jev चलाने वाला टर्मिनल अभी भी Jev Ultrafast: http://127.0.0.1:8766 प्रिंट कर रहा हो, और ब्राउज़र 127.0.0.1:8766 से खोला गया हो (localhost से नहीं, कारण नीचे Forbidden वाले ट्रबलशूटिंग बिंदु में देखें)।
# 1. 当前目录对吗?——.env 从「当前目录」读取,必须在仓库根目录跑
pwd
# 应以 jev-ultrafast 结尾;不在就先 cd jev-ultrafast
# 2. 两个 Key 都配了吗?——应看到两行(值非空才算数)
grep -E "^(TYPESAFE_API_KEY|TEXT_MODEL_API_KEY)=." .env
# 顺手 echo $TYPESAFE_API_KEY 确认 shell 里没有旧值抢先——.env 不会覆盖已 export 的变量
# 3. Chrome 连得上吗?——官方诊断命令
uv run browser-harness --doctor
# 按提示在 Chrome 里允许远程调试
# 4. 浏览器执行层正常吗?——官方开发命令,不调用模型、不花 API 费
uv run python scripts/check_guards.py
# 在本地浏览器里跑执行守卫回归;脚本自己的说明:No model calls or external websitesआपको यह दिखना चाहिए: पहला 1 jev-ultrafast पर समाप्त हो; दूसरा 2 दो पंक्तियाँ आउटपुट करे; तीसरा 3 कनेक्शन डायग्नोस्टिक्स पूरा करे; चौथा 4 अंत में PASS: N browser guard checks; no model calls प्रिंट करे। जो भी कड़ी टूटी हो, वहीं से ठीक करें; चारों पास होने के बाद भी त्रुटि आती है, तो समस्या लगभग मॉडल कॉल या निर्णय परत में है——नीचे उसे उसकी जगह पर रखें।
आम समस्याओं की जाँच
स्टार्टअप और Chrome कनेक्शन (कनेक्ट नहीं हो पा रहा)
"Cannot reach local demo server"
कारण: inspector पेज लोकल सेवा से कनेक्ट नहीं हो पा रहा——uv run jev चल नहीं रहा है, पोर्ट बदला गया है, या पेज एक पुराना टैब है। यह वाक्य स्टेटस बार में आता है (app.js का fetch विफलता ब्रांच)।
समाधान:
- रिपॉज़िटरी की रूट डायरेक्टरी से दोबारा स्टार्ट करें, टर्मिनल में यह प्रिंट होना चाहिए:
uv run jev
# Jev Ultrafast: http://127.0.0.1:8766- ब्राउज़र में
http://127.0.0.1:8766खोलें। पोर्ट बदला हो तो:TYPESAFE_DEMO_PORTको स्टार्ट करने से पहले सेट करना ज़रूरी है (demo.py मॉड्यूल इंपोर्ट के समय ही पोर्ट पढ़ लेता है), विवरण के लिए इंस्टॉल और रन पाठ्यक्रम की एडवांस ट्रिक्स देखें।
पेज खोलने पर केवल "Forbidden" दिखता है
कारण: localhost:8766 का उपयोग किया गया, 127.0.0.1:8766 का नहीं। demo सेवा Host हेडर की जाँच करती है और केवल 127.0.0.1:8766 को मान्यता देती है——यह सेवा केवल लोकल लूपबैक पते पर सुनती है (demo.py ख़ुद को Loopback-only inspector कहता है), POST रिक्वेस्ट को {"error": "Local demo requests only"} भी मिलता है।
समाधान: एड्रेस बार में http://127.0.0.1:8766 डालें, रिफ्रेश करें, बस।
Chrome कनेक्ट नहीं होता, पैनल बिल्कुल नहीं हिलता
कारण: Browser Harness के लिए ज़रूरी है कि Chrome रिमोट डिबगिंग की अनुमति दे, पहली बार कनेक्ट करते समय Chrome प्रॉम्प्ट दिखाता है; उसे मिस कर देने या इनकार करने के बाद कनेक्ट नहीं हो पाता। README का मूल वाक्य: Allow remote debugging in Chrome when prompted।
समाधान:
- आधिकारिक डायग्नोस्टिक कमांड चलाएँ, रिपॉज़िटरी की रूट डायरेक्टरी में:
uv run browser-harness --doctor- Chrome दोबारा「रिमोट डिबगिंग की अनुमति दें」प्रॉम्प्ट दिखाए तोअनुमति दें दबाएँ।
- डायग्नोस्टिक्स पास हो जाए पर फिर भी न हिले: पहले ऊपर वाला
uv run python scripts/check_guards.pyचलाएँ——यह मॉडल को कॉल नहीं करता, ब्राउज़र निष्पादन परत को अलग से जाँच सकता है।
"A browser step is already running"
कारण: पिछला चरण अभी भी निष्पादित हो रहा है। demo सेवा एक ग्लोबल लॉक से सुनिश्चित करती है कि एक ही समय में केवल एक ब्राउज़र चरण चले, लॉक से टकराने वाली रिक्वेस्ट को 409 और यह वाक्य वापस मिलता है।
समाधान: वर्तमान चरण पूरा होने तक इंतज़ार करें; Run automatically चलते समय रोकना हो तो Pause दबाएँ।
"Local demo failed; no automatic retry. Reset to recover."
कारण: demo सेवा उन अपवादों को, जिन्हें विशेष रूप से कैच नहीं किया गया, इस 500 फ़ॉलबैक संदेश में लपेट देती है। सबसे आम कारण: TYPESAFE_API_KEY बिल्कुल सेट नहीं किया गया——model.py सीधे os.environ["TYPESAFE_API_KEY"] पढ़ता है, गायब होने पर KeyError थ्रो करता है, मूल पाठ नहीं दिखता, केवल यह फ़ॉलबैक दिखता है।
समाधान:
.envके दोनों Key जाँचें (60-सेकंड तुरंत जाँच का 2 बिंदु)।- संकेत के अनुसार Reset करें: Start demo दबाकर एक बार दोबारा शुरू करें।
- Agent लाइब्रेरी का उपयोग करने वाले छात्र सीधे मूल traceback देखेंगे (जैसे
KeyError: 'TYPESAFE_API_KEY'), जो गायब है उसे जोड़कर संभालें।
"Start a demo first"
कारण: inspector में Start demo किए बिना ही Choose next / Execute choice / Run automatically दबा दिया गया——demo सेवा agent बनने से पहले इन कमांड को अस्वीकार कर देती है।
समाधान: पहले लक्ष्य भरें, Start demo पर क्लिक करें, फिर कंट्रोल बटन चलाएँ।
"Enter 1–2,000 characters"
कारण: लक्ष्य खाली है या 2000 अक्षरों से अधिक है (demo.py का reset सत्यापन)।
समाधान: लक्ष्य को 1–2000 अक्षरों के भीतर लिखें। Agent लाइब्रेरी से खाली लक्ष्य भेजने पर Supply a task दिखता है (agent.py), मतलब वही है।
Key और मॉडल कॉल (TEXT_MODEL त्रुटियों का हॉटस्पॉट)
"TYPE_TEXT needs TEXT_MODEL_API_KEY; no text is hardcoded or guessed by the executor."
कारण: .env में TEXT_MODEL_API_KEY नहीं है। यह जाँच केवल तब ट्रिगर होती है जब ऑपरेशन TYPE_TEXT हो (model.py का field_text()), इसलिए demo शुरू हो जाता है, पेज भी देखा जा सकता है, पर "इनपुट बॉक्स में टाइप करने" पर ही रुकता है—Flights demo को शहर के नाम बनाने होते हैं, इससे बचा नहीं जा सकता।
समाधान:
.envमें टेक्स्ट मॉडल की Key भरें (कहाँ से मिलेगी, वह इंस्टॉल-रन पाठ के चरण 3 के तरीके A/B/C में देखें)।- पढ़ने का नियम ध्यान में रखें:
.envवर्तमान डायरेक्टरी से पढ़ा जाता है, और shell में पहले से export किए गए उसी नाम के वेरिएबल को ओवरराइट नहीं करता—भरने के बाद भी त्रुटि आए तोcd jev-ultrafastकरके दोबारा चलाएँ औरecho $TEXT_MODEL_API_KEYजाँचें।
"Model provider returned HTTP 401; no action executed."
कारण: मॉडल एंडपॉइंट ने त्रुटि स्टेटस कोड लौटाया, जो इस वाक्य के टेम्पलेट में फिट हो गया (सोर्स कोड है f"Model provider returned HTTP {response.status_code}; no action executed.")। 401 = Key अमान्य। यह वाक्य TypeSafe और टेक्स्ट मॉडल दोनों में साझा है, पहले पहचानें कि कौन सा पक्ष है:
| कब त्रुटि आती है | कौन सा पक्ष | क्या जाँचें |
|---|---|---|
| पहले निर्णय चरण पर ही त्रुटि | TypeSafe (निर्णय हर चक्र में कॉल होता है) | TYPESAFE_API_KEY |
| टाइपिंग के चरण पर ही त्रुटि | टेक्स्ट मॉडल (केवल TYPE_TEXT उपयोग करता है) | TEXT_MODEL_API_KEY और TEXT_MODEL_BASE_URL मेल खाते हैं या नहीं |
समाधान:
- TypeSafe पक्ष: कंसोल के Keys पेज पर जाकर Key दोबारा कॉपी करें, curl से सत्यापित कर सकते हैं (शुरुआती ट्रबलशूटिंग में पूरा कमांड है)।
- टेक्स्ट मॉडल पक्ष: पुष्टि करें कि Key उसी एंडपॉइंट की है जिसे आपने कॉन्फ़िगर किया है (OpenRouter की Key को DeepSeek एंडपॉइंट पर लगाना ही 401 है)।
- अन्य स्टेटस कोडों का अर्थ (400/413/415/422 आदि) API क्विक रेफ़रेंस के स्टेटस कोड तालिका में देखें—429/529/503 तुरंत नहीं दिखते, नीचे "Model provider returned HTTP 429/529/503" देखें।
"Model connection failed; no action executed."
कारण: HTTP क्लाइंट ने नेटवर्क स्तर पर ही एक्सेप्शन फेंका—एंडपॉइंट से कनेक्ट नहीं हो पाना, DNS रिज़ॉल्व विफलता जैसी समस्याएँ, अनुरोध भेजा ही नहीं गया (model.py httpx.HTTPError पकड़कर यह वाक्य फेंकता है)।
समाधान:
- जाँचें कि नेटवर्क
api.typesafe.aiऔर आपकेTEXT_MODEL_BASE_URLतक पहुँच सकता है। - एंडपॉइंट की स्पेलिंग जाँचें:
TEXT_MODEL_BASE_URLकी सामान्य गलती है/v1कम या ज़्यादा होना (उदाहरण मानhttps://openrouter.ai/api/v1, DeepSeek का डिफ़ॉल्टhttps://api.deepseek.com/v1)।
"Model provider returned HTTP 429/529/503; no action executed." (रेट लिमिट और ओवरलोड)
कारण: मॉडल एंडपॉइंट ने 429 (रेट लिमिट)/ 529 (ओवरलोड)/ 503 लौटाया। ऐसे स्टेटस कोड तुरंत नहीं दिखते: कोड कुल 3 बार कोशिश करता है (रीट्राय 2 बार, अंतराल 0.5s, 1s), 3वें प्रयास में भी विफलता पर ही ऊपर वाले स्टेटस कोड टेम्पलेट में फिट होकर Model provider returned HTTP 429; no action executed. दिखता है (529, 503 इसी वाक्य-शैली में)।
सोर्स कोड में एक और फॉलबैक वाक्य "Model unavailable" है (model.py L27), पर वर्तमान कंट्रोल फ़्लो में यह अप्राप्य है—429/529/503 की रीट्राय खत्म होने पर स्टेटस कोड टेम्पलेट चलता है, इंटरफ़ेस पर यह वाक्य नहीं दिखता; सोर्स में इसे खोजने पर इसी मद से मिलान कर लें।
समाधान: थोड़ा रुककर दोबारा चलाएँ; बार-बार आए तो कोटा जाँचें—TypeSafe पक्ष के लिए कंसोल के rate-limits पेज पर देखें, टेक्स्ट मॉडल पक्ष के लिए अपने सेवा प्रदाता का बिलिंग पेज देखें।
"Invalid TypeSafe response; no action executed."
कारण: निर्णय रिस्पॉन्स लोकल सत्यापन से नहीं गुज़रा (model.py का validate_choice(): चुना गया विकल्प उम्मीदवारों में होना चाहिए, हर विकल्प की प्रायिकता हो, संख्याएँ 0–1 में हों, प्रायिकताओं का योग लगभग 1 हो)। यह "रिस्पॉन्स अनुबंध के अनुरूप नहीं" का गार्ड है, आपकी कॉन्फ़िगरेशन की समस्या नहीं।
समाधान: पहले बिना बदलाव दोबारा चलाएँ (कभी-कभी होता है); लगातार आए तो trace एक्सपोर्ट करें ("अब भी नहीं हो रहा?" देखें) और फ़ीडबैक में ले जाएँ।
"Text helper returned no valid field value; nothing typed."
कारण: टेक्स्ट मॉडल का आउटपुट अनुबंध के अनुरूप नहीं है—ऐसा JSON होना चाहिए जिसमें केवल text एक की हो, मान गैर-रिक्त स्ट्रिंग हो और 2000 अक्षरों से अधिक न हो (model.py का पार्सिंग नियम)। दो सामान्य ट्रिगर:
| ट्रिगर | तंत्र |
|---|---|
| लक्ष्य में आवश्यक मान गायब | मॉडल निर्देश स्पष्ट रूप से कहते हैं: मान गायब होने पर {"text": null} लौटाएँ, व्यक्तिगत जानकारी कभी न गढ़े (questions.py का TEXT_VALUE)—null पार्स विफल, कुछ भी टाइप नहीं होता |
| मॉडल नियम नहीं मानता | JSON के बजाय टिप्पणी जैसा टेक्स्ट आउटपुट किया—आधिकारिक परफ़ॉर्मेंस रिपोर्ट में प्रोबिंग के दौरान ऐसे मॉडल को अस्वीकार करने का ज़िक्र है |
समाधान:
- कार्य के लिए आवश्यक मान लक्ष्य में लिखें (तारीख़, शहर का नाम जैसी चीज़ें, मॉडल को अनुमान लगाने न दें)।
- अब भी नहीं हो तो टेक्स्ट मॉडल बदलें, और
TEXT_MODEL_REASONING=noneबनाए रखें (रीज़निंग बंद वाले मॉडल कम इम्प्रोवाइज़ करते हैं)। - गलत मान टाइप करने पर (टाइप न करने पर नहीं) भी यही तरीका अपनाएँ — आधिकारिक प्रोब ने निकासी स्थान और गंतव्य उलट लिखने वाले मॉडल को भी अस्वीकार किया था, इसलिए मॉडल बदलने से पहले छोटे कार्यों से परख लें।
निष्पादन बाधित होना और बजट (आगे नहीं बढ़ता)
"Target changed or is covered. Observe again."
कारण: निष्पादन से पहले की सुरक्षा जाँच में पाया गया कि लक्ष्य बदल गया है: वह ढक गया, छिप गया, अक्षम हो गया, व्यूपोर्ट से बाहर चला गया, या अब वही नोड नहीं रहा जो अवलोकन के समय था। यह गार्ड का काम करना है, बग नहीं — मॉडल का आउटपुट हमेशा केवल अवलोकन किए गए वास्तविक तत्वों को ही संदर्भित करता है, और निष्पादन से पहले ज्यामितीय स्थिति की फिर से जाँच होती है।
समाधान: फिर से अवलोकन करें और नया निर्णय लें। स्वचालित चलाने पर (Slow motion बिना खोले) हर कदम tick से चलता है, ऐसी stale त्रुटियाँ स्वतः ही दब जाती हैं और फिर से अवलोकन होता है, आपको दिखेंगी ही नहीं; मैन्युअल कदम-दर-कदम या धीमी गति पर यह मूल संदेश दिखाकर रुकता है, एक बार Choose next दबाकर नया निर्णय ले लें।
"Page changed since the decision. Choose again."
कारण: stale परिवार — निर्णय लेने के बाद पेज बदल गया, पुराना निर्णय निरर्थक हो गया। इसी परिवार के रूप: Page changed before text generation. Choose again. (टाइपिंग से पहले पेज बदल गया), Page changed since this decision. Observe again. (निष्पादन से पहले पुनः जाँच), Document changed during evaluation / Document is navigating (अवलोकन के समय पेज बदल रहा था)।
समाधान: ऊपर की तरह, फिर से अवलोकन करें। दो बातें:
- टाइप किया गया मान व्यर्थ नहीं जाता: केवल तब पुनः प्रयास पिछली बार जनरेट किए गए मान का पुनः उपयोग करता है जब टेक्स्ट helper का इनपुट पूरी तरह अपरिवर्तित हो (README का Reuse an interrupted text request)।
- बार-बार आने का अर्थ है कि पेज पर एनिमेशन/लोडिंग बहुत है, थोड़ा रुककर चलाएँ या कोई अधिक स्थिर पेज चुनें।
"Page did not settle"
कारण: लगातार 10 बार अवलोकन (हर बार 20ms के अंतराल पर) के बाद भी पेज स्थिर नहीं हुआ — एनिमेशन बंद नहीं होती या लगातार लोड होता रहता है।
समाधान: पेज शांत होने पर चलाएँ; कुछ भारी पेज (स्क्रॉल एनिमेशन, स्थायी स्केलेटन स्क्रीन) शायद बस उपयुक्त ही नहीं हैं।
"Dropdown execution was not confirmed; inspect before retrying."
कारण: नेटिव <select> का निष्पादन परिणाम पुष्ट नहीं हुआ, या निष्पादन बाधित हुआ (रूप-विकल्प का मूल पाठ: Dropdown execution was interrupted; inspect before retrying.)। कोड यहाँ अंधाधुंध पुनः प्रयास करने के बजाय सतर्कता से रुकना चुनता है — पुनः प्रयास से डुप्लिकेट चयन हो सकता है।
समाधान: फिर से अवलोकन करें (Choose next / पुनः चलाएँ), ताकि agent नए पेज के आधार पर नया निर्णय ले सके।
"Observe and choose before acting"
कारण: मैन्युअल मोड में बिना निर्णय लिए Execute choice दबाया गया, या निर्णय आने के बाद पेज की फिंगरप्रिंट बदल गई और निर्णय पहले ही उपयोग हो चुका है।
समाधान: एक बार Choose next दबाकर नया निर्णय लें, फिर Execute choice।
"Stopped at the 60-action demo budget"
कारण: एक रन का हार्ड बजट खत्म हो गया: अधिकतम 60 निष्पादित क्रियाएँ (MAX_STEPS = 60)। निर्णय कॉल की संख्या की अलग सीमा 120 (MAX_STEPS × 2) है, जो भरने पर Reached the demo's model-call budget दिखाता है।
समाधान: कार्य बहुत बड़ा है तो छोटे टुकड़ों में बाँटें — examples/run.py का आधिकारिक उदाहरण पैरामीटर ही 'A narrow goal' नाम का है, लक्ष्य संकीर्ण लिखना आधिकारिक सलाह है। बजट में रन पूरा न होना आम तौर पर बताता है कि लक्ष्य बहुत व्यापक है या पेज उपयुक्त नहीं है (नीचे का समूह देखें)।
"This run has stopped. Start a fresh demo."
कारण: स्थिति पहले से ही done या blocked है, फिर भी नया निर्णय माँगा जा रहा है — एक रन समाप्त हो चुका है।
समाधान: Start demo दबाकर एक नया रन शुरू करें।
स्टेटस बार में "Stopped · no supported next action" (blocked) दिखता है
कारण: दो स्रोत: मॉडल ने स्वयं BLOCKED चुना (निर्देश परिभाषा: कोई समर्थित क्रिया कार्य को आगे नहीं बढ़ा सकती), या लगातार 3 निष्पादित क्रियाओं (और कोई भी WAIT नहीं) के बाद भी पेज में कोई बदलाव नहीं हुआ — कोड इसे अटकना मानकर स्वतः blocked कर देता है।
समाधान:
- Decision trail के अंतिम 3 कदम देखें: क्या क्लिक हुआ, पेज क्यों नहीं बदला।
- नीचे दिए "असमर्थित सूची" समूह से मिलाएँ — blocked का सबसे आम मूल कारण पेज में ऐसे कंट्रोल होना है जो चल नहीं सकते।
- लक्ष्य को संकीर्ण और अधिक ठोस बनाकर demo पुनः शुरू करें।
परिणाम गलत होना और पेज की सीमाएँ (भटक गया)
स्टेटस बार में "Jev reports complete · inspect the page" दिखता है, लेकिन पेज वही नहीं है जो चाहिए
कारण: मॉडल ने DONE चुना, लेकिन DONE कभी भी सफलता का प्रमाण नहीं है — आधिकारिक Evidence and limits में बिल्कुल स्पष्ट लिखा है: DONE चुनने के बाद भी परिणाम का स्वतंत्र सत्यापन करना ज़रूरी है। इंटरफ़ेस के स्टेटस बार का उत्तरार्ध (inspect the page) आपको स्वयं देखने की याद दिलाता है।
समाधान:
- महत्वपूर्ण कार्यों में स्वतंत्र सत्यापन जोड़ें। आधिकारिक नमूना है
examples/flights.pyकाverify(): परिणाम पेज पर एक-एक करके सिंगल ट्रिप, निकासी स्थान, गंतव्य, तारीख़, परिणाम दिखने — सब जाँचें — मॉडल के DONE पर भरोसा न करें; सत्यापन असफल हो तो बाहर निकलें औरFinal page did not satisfy the route/date checksरिपोर्ट करें। - लक्ष्य में रुकने की शर्त साफ़ लिखें। आधिकारिक Flights उदाहरण का लक्ष्य
Stop when …से समाप्त होता है, इसी ढाँचे में लिखें। - "कोई परिणाम खोलने" वाले लक्ष्यों पर विशेष ध्यान दें: मॉडल के निर्देशों में स्पष्ट लिखा है कि "केवल मिलान लिंक ढूँढ लेना पूर्ण नहीं माना जाता"।
कंट्रोल पर क्लिक का कोई असर नहीं / तत्व सूची में उसका नाम ही नहीं (shadow DOM, canvas, अपलोड…)
कारण: MVP सीमा से टकरा गए। DOM reader केवल सामान्य HTML और ARIA कंट्रोल पहचानता है, पूरा accessible-name एल्गोरिदम लागू नहीं करता। आधिकारिक Limits सूची के अनुसार, निम्नलिखित सब असमर्थित हैं:
| असमर्थित | उदाहरण |
|---|---|
| shadow roots / frames | कंपोनेंट फ्रेमवर्क द्वारा रेंडर किए आंतरिक कंट्रोल |
| canvas | मानचित्र, कैनवास जैसी इंटरैक्शन |
| फ़ाइल अपलोड | <input type="file"> |
| नए टैब में पॉपअप | क्लिक करने पर नया tab खोलने वाले लिंक |
| नेस्टेड स्क्रॉल | आंतरिक स्क्रॉल कंटेनर |
| कोई भी कीबोर्ड कंपोनेंट | शॉर्टकट, रिच टेक्स्ट एडिटर |
समाधान: कार्य शुरू करने से पहले इस सूची से मिलाकर छान लें, इन कंट्रोल वाले पेजों पर फिलहाल ज़बरदस्ती न घुसें (सिद्धांत पाठ के चरण 4 में यही सीमा सूची है); ऐसा पेज या कार्य चुनें जिसमें केवल सामान्य कंट्रोल हों। साथ ही ध्यान दें: agent का tab आपके मौजूदा Chrome profile का उपयोग करता है — लॉगिन स्थिति पेज की सामग्री को प्रभावित करती है, "पेज अपेक्षा से अलग है" की जाँच में इस परत को भी सोचें।
टाइप हुआ टेक्स्ट गलत है, या जो टाइप होना चाहिए था वह नहीं हुआ
कारण: स्ट्रिंग को टेक्स्ट helper लक्ष्य से अनुमान लगाता है, यह Jev द्वारा लिखी नहीं जाती। गलत अक्षर टाइप होना = helper मॉडल की समझ भटक गई; कुछ टाइप न होना = उसने नियम के अनुसार {"text": null} लौटाया (लक्ष्य में अनिवार्य मान न होने पर आविष्कार करने से इनकार, ऊपर दिए गए nothing typed वाले बिंदु को देखें)।
समाधान: अनिवार्य मान को लक्ष्य में जस का तस लिखें (「September 20, 2026」 न कि 「अगले महीने」); फिर भी न हो तो टेक्स्ट मॉडल बदलें, पहले छोटे कार्य से जांचें—आधिकारिक टीम ने ही छह जांच कॉल की मदद से वे मॉडल हटाए जो शहर उलटे लिखते थे या कमेंट आउटपुट करते थे (देखें प्रदर्शन व्याख्या)।
भरने के बाद सबमिट नहीं करता, टाइप करने के बाद सुझाव नहीं चुनता
कारण: मॉडल के निर्देशों में ये नियम वास्तव में तय हैं: अनिवार्य फ़ील्ड भरने के बाद सबमिट करें (「भरे गए फ़ील्ड लागू की गई खोज के बराबर नहीं हैं」), और टाइप की गई क्वेरी के लिए मिलता-जुलता ऑटो-कंप्लीट सुझाव चुनें। न होने का कारण ज़्यादातर समय का है—टाइप करने के बाद कोड अधिकतम 200ms प्रतीक्षा करता है और सुझाव आ जाते हैं; धीमे सुझाव वाली साइटें अगली अवलोकन को नहीं पकड़ पातीं।
समाधान: वैसे ही एक बार फिर चलाने पर आमतौर पर पास हो जाता है; लगातार एक ही जगह अटके रहने पर लक्ष्य को और स्पष्ट लिखें (क्या सबमिट करना है, कहाँ रुकना है), या ऐसा पेज चुनें जिसके सुझाव जल्दी लोड होते हों।
फिर भी नहीं होता?
पहले अलग करें, फिर सबूत इकट्ठा करें, अंत में सबूत के साथ जाकर पूछें।
अलग करने का बेहतरीन औज़ार रिपॉज़िटरी के दो स्क्रिप्ट हैं (दोनों scripts/ में, README के Development अनुभाग से):
# 只测浏览器执行层:本地页面、不调用模型、不花钱
uv run python scripts/check_guards.py
# 测完整链路:浏览器只开本地 fixture 页面,但会发起真实模型调用(产生付费 API 费用)
uv run python scripts/smoke.pycheck_guards.py पास, smoke.py भी पास, फिर भी असली वेबसाइट पर विफलता—समस्या ज़्यादातर उस साइट में है (कंट्रोल सीमाएँ, लोड समय), असमर्थित सूची से मिलाएँ।
सबूत इकट्ठा करें, तीन चीज़ें काफ़ी हैं:
| सबूत | कैसे लें | इसमें क्या है |
|---|---|---|
| निर्णय trace | inspector के नीचे Export trace ↓ बटन | डाउनलोड typesafe-browser-trace.json: पूरा निर्णय इतिहास, संभावनाएँ, लक्ष्य, पेज URL और दिखाई देने वाला टेक्स्ट (स्क्रीनशॉट शामिल नहीं) |
| मॉडल ने क्या देखा | पेज का फोल्ड किया हुआ हिस्सा What the model sees | मॉडल को भेजा गया पूरा रिक्वेस्ट बॉडी, हर फ़ील्ड जांचने योग्य |
| त्रुटि का मूल पाठ | लाल बॉक्स में लिखा वाक्य | इस पेज के सभी H4 से मेल खाता है |
⚠️ भेजने से पहले एक बार देख लें
trace में पेज URL और दिखाई देने वाला टेक्स्ट होता है, जिसमें आपकी खाता जानकारी हो सकती है; साथ ही ध्यान रखें: live उदाहरण और रिकॉर्डिंग स्क्रिप्ट दोनों सशुल्क API कॉल करते हैं (README के शब्द), बार-बार पुनः प्रस्तुत करने से पहले इसका ध्यान रखें।
कहाँ जाकर पूछें:
| चैनल | कब जाएँ |
|---|---|
| यह पाठ + इंस्टॉल और चलाना | पहले दो बार खुद जांचें, ज़्यादातर समस्याएँ यहाँ तक नहीं पहुँचतीं |
| शुरुआती समस्या निवारण / API क्विक रेफ़रेंस | TypeSafe API पक्ष की स्टेटस कोड समस्याएँ |
| GitHub Issues | Ultrafast की अपनी खामियाँ: trace + त्रुटि का मूल पाठ + लक्ष्य और URL के साथ |
| TypeSafe Discord | निर्णय API (Jev) पक्ष की समस्याएँ, आधिकारिक रूप से कहा गया है कि टूटा हो तो सीधे रिपोर्ट करें |
| Browser Use Cloud | होस्टेड BU Ultrafast (model: "bu-ultrafast") इस्तेमाल करते समय की समस्याएँ |
चेकपॉइंट ✅
- 60 सेकंड में जांचें: चारों कमांड चला चुका हूँ, पता है किस परत पर अटका हूँ
- मैं तीन तरह की त्रुटियाँ पहचान सकता हूँ: stale स्व-चिकित्सा, 429/529/503 स्वतः पुनः प्रयास, कॉन्फ़िगरेशन/बजट/सीमा के लिए हाथ से काम
- स्थिति done होने पर मैं सीधे काम पूरा नहीं मानता—महत्वपूर्ण कार्यों में स्वतंत्र सत्यापन जोड़ता हूँ (flights.py का verify() आदर्श है)
- असमर्थित सूची से गुज़र चुका हूँ: shadow DOM, frames, canvas, अपलोड, नया tab, नेस्टेड स्क्रॉल, कीबोर्ड कंपोनेंट
- पूछते समय मैं typesafe-browser-trace.json, त्रुटि का मूल पाठ, लक्ष्य और URL साथ रखूँगा
इस पाठ का सारांश
✅ समस्या निवारण में पहले परत तय करें: लोकल सेवा → Chrome कनेक्शन → मॉडल कॉल → निर्णय निष्पादन, हर परत की त्रुटि अलग दिखती है।
✅ jev-ultrafast की त्रुटियों का मूल पाठ पूरी तरह रिपॉज़िटरी सोर्स से आता है, शब्दशः खोजने योग्य; H4 शीर्षक ही त्रुटि का मूल पाठ है, कॉपी करके खोजें या पूछें।
✅ तीन तरह का व्यवहार: stale प्रकार स्वतः पुनः अवलोकन को सौंपें, 429/529/503 कोड के पुनः प्रयास को सौंपें, कॉन्फ़िगरेशन/बजट/सीमा प्रकार को ही आपको हाथ लगाना पड़ता है।
✅ DONE सफलता का सबूत नहीं, blocked पर पहले असमर्थित सूची देखें, 60 एक्शन कठोर बजट है—ये तीन बातें याद रखें तो आधी 「भटकाव」 पहले से टल सकते हैं।
मुख्य संकेतों की क्विक रेफ़रेंस:
| संकेत | किस परत में | पहला कदम |
|---|---|---|
| Cannot reach local demo server / Forbidden | लोकल सेवा | uv run jev फिर से चलाएँ; 127.0.0.1:8766 से खोलें |
| पैनल बिल्कुल नहीं हिलता | Chrome कनेक्शन | uv run browser-harness --doctor, रिमोट डिबगिंग की अनुमति दें |
| TYPE_TEXT needs TEXT_MODEL_API_KEY | मॉडल कॉल (टेक्स्ट पक्ष) | .env में Key भरें, cwd और setdefault पर ध्यान दें |
| Model provider returned HTTP 401 | मॉडल कॉल (Key अमान्य) | पहले पहचानें TypeSafe है या टेक्स्ट मॉडल, फिर Key दोबारा कॉपी करें |
| Model provider returned HTTP 429/529/503 | मॉडल कॉल (रेट लिमिट/ओवरलोड) | थोड़ा रुककर फिर चलाएँ, कोटा जांचें |
| Target changed or is covered | निर्णय निष्पादन (stale) | पुनः अवलोकन; ऑटो मोड में स्व-चिकित्सा |
| Stopped at the 60-action demo budget | निर्णय निष्पादन (बजट) | लक्ष्य संकरा लिखें, कार्य छोटे तोड़ें |
| स्थिति done लेकिन परिणाम गलत | परिणाम सत्यापन | स्वयं जाँच करें; flights.py जैसा स्वतंत्र सत्यापन जोड़ें |
| स्थिति blocked | पृष्ठ की सीमाएँ | असमर्थित सूची से मिलान करें, पृष्ठ बदलें या लक्ष्य बदलें |
अगले पाठ का पूर्वावलोकन
ब्राउज़र अध्याय यहीं समाप्त होता है। अगला पाठ Jev 1.13 गलतियों की कुंजी: 9 विफलता के तरीके और वैकल्पिक तरीके वापस Jev मॉडल पर आता है—Ultrafast के अलावा, सभी Jev ऐप्स पर लागू होता है। आप सीखेंगे:
- आधिकारिक jaggedness दस्तावेज़ के 9 विफलता के तरीके: शाब्दिक समझ, अंकगणितीय गिनती, तिथि तुलना, अप्रत्यक्ष संदर्भ…
- हर विफलता के तरीके का विकल्प: अंकगणित कोड में रखें, तिथि से घटक निकालें, बड़े state को पहले फ़िल्टर करें
- ये प्रश्न पूछने की आदतें आपके Ultrafast लक्ष्य और अन्य Jev ऐप्स लिखने में कैसे मदद करती हैं
संबंधित ट्यूटोरियल
- Ultrafast इंस्टॉल और चलाना: uv sync और दो API Key
- Google Flights चलाना: 7 सेकंड में एक वास्तविक खोज पूरी करें
- इंस्टॉल न हो या चले नहीं तो क्या करें: शुरुआती समस्या-निवारण
परिशिष्ट: सोर्स कोड संदर्भ
क्लिक करके सोर्स कोड की स्थिति देखें
अपडेट समय: 2026-11-04 (रिपॉज़िटरी github.com/browser-use/jev-ultrafast, स्थानीय जानकारी स्रोत sources/jev/repo-ultrafast/)
| सुविधा | फ़ाइल पथ | मुख्य स्थितियाँ |
|---|---|---|
| त्रुटि संदेश: कनेक्शन/HTTP/पुनःप्रयास | jev_ultrafast/model.py | L15–27 post_json (L20 कनेक्शन विफल, L21–23 पर 429/529/503 स्वचालित पुनःप्रयास · कुल 3 प्रयास, L25 HTTP स्टेटस कोड टेम्पलेट, L27 Model unavailable फ़ॉलबैक संदेश · वर्तमान नियंत्रण-प्रवाह में पहुँच योग्य नहीं); L12 क्लाइंट timeout=25 |
| त्रुटि संदेश: निर्णय प्रतिक्रिया सत्यापन | jev_ultrafast/model.py | L30–45 validate_choice (L44 Invalid TypeSafe response) |
| त्रुटि संदेश: टेक्स्ट helper | jev_ultrafast/model.py | L160–198 field_text (L163 अनुपस्थित Key का मूल पाठ, L187–193 JSON अनुबंध सत्यापन, L193 nothing typed) |
| TypeSafe अनुरोध और Key पढ़ना | jev_ultrafast/model.py | L119 (api.typesafe.ai/v1/systemone + os.environ["TYPESAFE_API_KEY"], अनुपस्थित होने पर KeyError फेंकता है) |
| त्रुटि संदेश: बजट और स्टेट मशीन | jev_ultrafast/agent.py | L74 रुक गया, L75–76 मॉडल कॉल बजट (MAX_STEPS×2=120), L88–89 पहले देखें फिर निष्पादित करें, L96/L107–108 stale मूल पाठ, L102–104 60 एक्शन बजट, L153–158 लगातार 3 बार कोई बदलाव नहीं → blocked |
| त्रुटि संदेश: stale और निष्पादन गार्ड | jev_ultrafast/browser.py | L86 Page did not settle, L102 निष्पादन से पहले पृष्ठ बदला, L130–131/L162–163 ड्रॉपडाउन अपुष्ट/बाधित, L164 लक्ष्य अध्यारोपित; L16 StalePage(ValueError) |
| त्रुटि संदेश: demo सेवा | jev_ultrafast/demo.py | L16 पोर्ट (शुरू करने से पहले सेट करें TYPESAFE_DEMO_PORT), L23–29 .env पढ़ना (cwd + setdefault), L48–52 परिदृश्य और 1–2000 वर्ण, L64–65 Start a demo first, L111–112 409 सिंगल-स्टेप लॉक, L122–123 500 फ़ॉलबैक |
| inspector स्टेटस बार और त्रुटि प्रदर्शन | jev_ultrafast/static/app.js | L63 Paused · needs attention, L82–88 पाँच स्थितियों के संदेश, L173–183 स्वचालित लूप (tick स्व-उपचार vs धीमा कदम-दर-कदम), L217–235 trace निर्यात (स्क्रीनशॉट हटाकर), L243 Cannot reach local demo server |
| इंटरफ़ेस बटन और फोल्ड क्षेत्र | jev_ultrafast/static/index.html | L56–59 Choose next / Execute choice / Run automatically / Pause, L126 Export trace ↓, L133 What the model sees |
| मॉडल निर्देश (DONE/BLOCKED/सबमिट/सुझाव नियम) | jev_ultrafast/questions.py | L3–14 NEXT_ACTION, L21–24 TEXT_VALUE (अनुपस्थित मान पर null लौटाता है, व्यक्तिगत जानकारी नहीं गढ़ता), L26 MAX_STEPS = 60 |
| इंस्टॉलेशन, --doctor, रिमोट डिबगिंग, असमर्थित वस्तुओं की सूची | README.md | L53–68 Try it (uv run browser-harness --doctor सहित), L118–126 Evidence and limits (DONE की स्वतंत्र सत्यापन आवश्यक है; shadow roots/frames/canvas/अपलोड/नए tab/नेस्टेड स्क्रॉल/कीबोर्ड कंपोनेंट असमर्थित हैं; tab मौजूदा Chrome profile का उपयोग करता है), L128–138 Development (check_guards, भुगतान संबंधी संकेत) |
| असमर्थित वस्तुओं की सूची (Limits मूल पाठ) | docs/performance.md | L53–55; L49 ऐसे मॉडलों का पता लगाना जिन्होंने इनकार किया (उल्टा शहर लिखना/आउटपुट में टिप्पणी) |
| स्वतंत्र सत्यापन का नमूना | examples/flights.py | L18–38 verify() मद-दर-मद जांच, L63–64 Final page did not satisfy the route/date checks |
| स्थानीय गार्ड रिग्रेशन स्क्रिप्ट | scripts/check_guards.py | L1 डॉकस्ट्रिंग (No model calls or external websites), L133 अंत में प्रिंट PASS: N browser guard checks; no model calls |
| स्थानीय fixture स्मोक स्क्रिप्ट | scripts/smoke.py | L1 डॉकस्ट्रिंग (भुगतान वाला API), L19 --max-actions (डिफ़ॉल्ट 15), L25 trace डायरेक्टरी प्रिंट करना |