विफलताएँ (दस्तावेज़ अनुवाद)

विफलताएँ टैब केवल दस्तावेज़ अनुवाद के लिए है। यह उन विफलता रिकॉर्डों को पढ़ता है जो SQLite में लिखे गए थे जब किसी सेगमेंट का किसी स्थान के लिए सफलतापूर्वक अनुवाद नहीं किया जा सका — उदाहरण के लिए खाली या अमान्य मॉडल आउटपुट, अनुवाद के बाद के सत्यापन त्रुटियाँ (AST mismatch, प्लेसहोल्डर लीक, और इसी तरह की गुणवत्ता जाँचें), या एक घातक स्थिति जिसने प्रगति को अवरुद्ध कर दिया।

यह आपको यह उत्तर देने में मदद करता है: कौन सा स्रोत सेगमेंट टूटा, किस स्थान और मॉडल के लिए, और कौन सा त्रुटि पाठ रिकॉर्ड किया गया था?

इसका उपयोग कब करें

• translate-docs या sync के त्रुटियों, आंशिक स्थानों, या भ्रमित करने वाले लॉग के साथ समाप्त होने के बाद — केवल टर्मिनल आउटपुट को स्क्रॉल करने के बजाय विफलताओं को सॉर्ट और फ़िल्टर करें।
• जब आप पुनः कार्य को प्राथमिकता देना चाहते हैं: # विफलताएँ द्वारा सॉर्ट करें ताकि बार-बार विफल होने वाले सेगमेंट पहले दिखाई दें; वे स्रोत मार्कडाउन में सरल बनाने या पुनः स्वरूपित करने के लिए मजबूत उम्मीदवार हैं।
• जब आपको अपने रेपो में सही पैराग्राफ को संपादित करने के लिए सटीक सेगमेंट — फ़ाइलपाथ, लाइन संकेत, स्रोत हैश, और पूर्ण स्रोत पाठ — की आवश्यकता हो।

स्रोत संपादन क्यों मायने रखते हैं

घने इनलाइन मार्कअप (बोल्ड `code` के साथ मिश्रित, नेस्टेड जोर, कई स्पैन वाले लंबे वाक्य) मॉडल के लिए ऐसे अनुवाद वापस करना कठिन बनाते हैं जो अभी भी संरचनात्मक जाँचों को पास करते हैं। कई रिकॉर्ड की गई विफलताओं वाले सेगमेंट आमतौर पर अपरिवर्तित पाठ पर अनुवाद को फिर से चलाने की तुलना में स्रोत को फिर से लिखने या विभाजित करने (या उदाहरणों को फेंस किए गए कोड ब्लॉक में ले जाने) से अधिक सुधार करते हैं। यह जटिल मार्कडाउन और विफल गुणवत्ता जाँचें के साथ संरेखित है।

टैब का उपयोग कैसे करें

1. डैशबोर्ड में विफलताएँ खोलें।
2. सारांश पट्टी पढ़ें — किसी भी विफलता वाले सेगमेंट, साथ ही 1, 2, या 3+ विफलता रिकॉर्ड वाले सेगमेंट के लिए गणना।
3. आंशिक फ़ाइलनाम, स्थान, मॉडल, गुणवत्ता त्रुटि (मान आपके कैश से आते हैं), केवल घातक, और वैकल्पिक स्रोत हैश, स्रोत पाठ, या त्रुटि संदेश सबस्ट्रिंग द्वारा फ़िल्टर करें — फिर लागू करें पर क्लिक करें।
4. सॉर्ट करें: # विफलताएँ (डिफ़ॉल्ट) या सॉर्ट करें: फ़ाइलपाथ + लाइन # चुनें।
5. तालिका के शीर्ष या निचले भाग में पृष्ठन का उपयोग करें। पूर्ण स्रोत पाठ का विस्तार करने के लिए एक पंक्ति पर क्लिक करें। मॉडल कॉलम विफलता मॉडल और, जब उपलब्ध हो, बाद की सफल कैश प्रविष्टि से मॉडल दिखाता है।
6. 🔗 लिंक नियंत्रण ai-i18n-tools dashboard चल रहे टर्मिनल में फ़ाइल/लाइन संकेत लॉग करता है।
7. अपनी परियोजना में स्रोत फ़ाइल को ठीक करें, फिर translate-docs या sync को फिर से चलाएँ। यदि सफल रन के बाद सूची पुरानी दिखती है, तो ai-i18n-tools sync --force-update चलाएँ और डैशबोर्ड को फिर से लोड करें।

UI के साथ फ़ाइल-आधारित डिबगिंग के लिए, रिट्राई के दौरान cacheDir के तहत FAILED-TRANSLATION विवरण लिखने के लिए translate-docs --debug-failed का उपयोग करें — कैश व्यवहार और translate-docs फ़्लैग देखें।

विफलताएँ बनाम मार्कडाउन समस्याएँ

	विफलताएँ	मार्कडाउन समस्याएँ
कब रिकॉर्ड किया गया	अनुवाद के दौरान (प्रति स्थान)	अनुवाद से पहले (स्रोत स्कैन)
विशिष्ट कारण	खराब मॉडल आउटपुट, सत्यापन त्रुटियाँ	अयुग्मित जोर, अनक्लोज्ड कोड स्पैन, लिंक के बाहर बोल्ड
ठीक करें	स्रोत संपादित करें और पुनः अनुवाद करें	स्रोत मार्कडाउन को ठीक करें, फिर पुनः अनुवाद करें

पूर्व-अनुवाद स्थिर जाँचों के लिए मार्कडाउन समस्याएँ देखें।