समस्या निवारण
अधिकांश Notemd समस्याएँ चार श्रेणियों में आती हैं: API मुख्य समस्याएँ, नेटवर्क कनेक्टिविटी, प्रमाणीकरण त्रुटियाँ (401/403), एवं दर सीमाएँ (429)। अंतर्निहित कनेक्शन परीक्षण एवं निदान पैनल जल्दी ही मूल कारण की पहचान करते हैं। यह पृष्ठ प्रत्येक सामान्य त्रुटि संदेश, उसका कारण एवं समाधान को कवर करता है। जो समस्याएँ यहाँ सूचीबद्ध नहीं हैं, उन्हें निदान आउटपुट के साथ GitHub Issues पर रिपोर्ट करें.
यह Obsidian AI Knowledge Management Guide का हिस्सा है.
अवलोकन
Notemd बाहरी सेवाओं पर निर्भर है -- LLM प्रदाताओं एवं खोज API सेवाओं पर -- इसलिए अधिकांश समस्याएँ प्लगइन के बाहर ही उत्पन्न होती हैं। सेटिंग्स में मौजूद निदान पैनल पिछले API कॉल का संरचित दृश्य प्रदान करता है, जिसमें अनुरोध URL, प्रतिक्रिया स्थिति एवं त्रुटि बॉडी शामिल है। आगे जाँच करने से पहले हमेशा इसे पहले ही देखें.
यह कैसे कार्य करता है: निदान
कनेक्शन परीक्षण
प्रत्येक प्रदाता कॉन्फ़िगरेशन विभाग में एक “Test Connection” बटन होता है। इसे क्लिक करने से एक न्यूनतम API अनुरोध भेजा जाता है (आमतौर पर मॉडल सूची या एक छोटा पूर्णीकरण) एवं सफलता या विशिष्ट HTTP त्रुटि की रिपोर्ट दी जाती है। यह आपके API कुंजी एवं बेस URL के सही होने की पुष्टि करने का सबसे तेज़ तरीका है.
निदान पैनल
Settings --> Notemd --> Diagnostics में निम्नलिखित दिखाया जाता है:
| फ़ील्ड | सामग्री |
|---|---|
| पिछला प्रदाता | कौन सा प्रदाता पिछले बार कॉल किया गया था |
| पिछला मॉडल | कौन सा मॉडल पिछले बार कॉल किया गया था |
| अंतिम स्थिति | HTTP स्टेटस कोड या ट्रांसपोर्ट त्रुटि |
| अंतिम त्रुटि | API से प्राप्त कच्चा त्रुटि संदेश |
| अंतिम अनुरोध URL | पिछले अनुरोध का पूरा URL (API कुंजी हटाई गई है) |
| अंतिम प्रतिक्रिया बॉडी | ट्रंक्टेड रिस्पॉन्स बॉडी (पहले 500 कैरेक्टर) |
GitHub पर समस्याओं की रिपोर्ट करते समय पूरा डायग्नोस्टिक्स आउटपुट कॉपी करें।
आम त्रुटियाँ
API कुंजी अमान्य है या गायब है
लक्षण: HTTP 401 या “गलत API कुंजी प्रदान की गई है”
कारण: API कुंजी गायब है, इसमें खाली स्थान है, या यह किसी अन्य प्रदाता से संबंधित है।
समाधान:
- सुनिश्चित करें कि कुंजी में कोई शुरुआती/अंतिम स्पेस न हो।
- पुष्टि करें कि कुंजी चयनित प्रदाता से मेल खाती है (एक OpenAI कुंजी Anthropic के साथ काम नहीं करेगी)
- यह जाँचें कि आपके खाते में क्रेडिट हैं या कोई सक्रिय सब्सक्रिप्शन है
- सत्यापन करने हेतु "Test Connection" पर क्लिक करें
नेटवर्क / कनेक्शन संबंधी त्रुटियाँ
लक्षण: ERR_CONNECTION_REFUSED, ERR_TIMED_OUT, Socket hang up, Network request failed
कारण: आपके मशीन से API एंडपॉइंट तक पहुँच संभव नहीं है.
समाधान:
- अपने इंटरनेट कनेक्शन की जाँच करें
- यदि आप प्रॉक्सी या फ़ायरवॉल के पीछे हैं, तो API डोमेन ब्लॉक न होने की पुष्टि करें
- Ollama के लिए:
ollama serveचल रहा है या नहीं यह सुनिश्चित करें (ollama listसे मॉडल प्राप्त होने चाहिए) - LMStudio के लिए:
localhost:1234पर सर्वर चल रहा है या नहीं यह सुनिश्चित करें - कोई अन्य ट्रांसपोर्ट आज़माएँ – मोबाइल उपयोगकर्ताओं को
requestUrlट्रांसपोर्ट सक्रिय होना चाहिए - अस्थायी त्रुटियों पर स्वचालित पुनः प्रयास हेतु
enableStableApiCallको सक्षम करें
403 Forbidden
लक्षण: HTTP 403
कारण: आपकी API कुंजी वैध है लेकिन अनुरोधित संसाधन के लिए अनुमति नहीं है.
समाधान:
- कुछ मॉडलों के लिए विशेष पहुँच की आवश्यकता होती है (उदाहरण के लिए, Azure के माध्यम से GPT-4 के लिए एक डिप्लॉयमेंट नाम आवश्यक है)
- कुछ प्रदाता योजना स्तर के अनुसार मॉडलों पर प्रतिबंध लगाते हैं -- अपने खाते की जाँच करें
- क्षेत्रीय प्रतिबंध लागू हो सकते हैं (कुछ चीनी प्रदाता अंतरराष्ट्रीय IP पर प्रतिबंध लगाते हैं और इसके विपरीत भी)
- सुनिश्चित करें कि मॉडल नाम सही ढंग से लिखा गया है (उदाहरण के लिए, mini मॉडल के लिए
gpt-4oन किgpt-4o-mini, जबकि आपकी पूरी योजना इसे ही अनुमति देती है)
रेट लिमिट (429)
लक्षण: HTTP 429 या “रेट लिमिट एक्सपीर्ड”
कारण: छोटे समय अंतराल में बहुत सारे अनुरोध होना.
समाधान:
batchConcurrencyको1या2तक कम करें- पुनः प्रयास करने से पहले कुछ मिनट इंतजार करें
- अपनी योजना स्तर के लिए अपने प्रदाता के रेट लिमिट दस्तावेज़ों की जाँच करें
- बैकऑफ के साथ स्वचालित पुनः प्रयास हेतु
enableStableApiCallको सक्षम करें - उच्च सीमाओं वाले प्रदाता (DeepSeek, Ollama) में स्विच करने पर विचार करें
मॉडल नहीं मिला
लक्षण: “मॉडल नहीं मिला” या HTTP 404
कारण: चुने गए प्रदाता पर मॉडल नाम मौजूद नहीं है.
समाधान:
- अपने प्रदाता के लिए उपलब्ध सभी मॉडल देखने हेतु "Get Model List" पर क्लिक करें
- कुछ मॉडलों के नाम समय के साथ बदल जाते हैं -- प्रदाता के दस्तावेज़ों में वर्तमान नाम की पुष्टि करें
- Ollama के लिए: पुल किए गए मॉडल देखने हेतु
ollama listचलाएं; केवल डाउनलोड किए गए मॉडल ही उपलब्ध हैं
कोई लिंक / कोई अवधारणाएँ उत्पन्न नहीं हुईं
लक्षण: कमांड चलती है लेकिन कोई आउटपुट नहीं आता
कारण: LLM ने खाली या पार्स न किया जा सकने वाला जवाब दिया है.
समाधान:
- वास्तविक LLM जवाब देखने हेतु डायग्नोस्टिक्स पैनल की जाँच करें
- एक अधिक सक्षम मॉडल आज़माएँ (कुछ छोटे मॉडल संरचित आउटपुट के साथ समस्या करते हैं)
- सुनिश्चित करें कि नोट में पर्याप्त सामग्री है (>50 शब्द)
- टकराव वाले निर्देशों हेतु अपने कस्टम प्रॉम्प्ट की समीक्षा करें
- यदि यह बहुत कठोरता से फिल्टर कर रहा है तो अस्थायी रूप से समानार्थक शब्दों को दबाना बंद करें
Doubao एंडपॉइंट ID गायब है
लक्षण: ByteDance Doubao प्रदाता का उपयोग करते समय त्रुटि आती है
कारण: Doubao को मॉडल नाम के बजाय एक Ark एंडपॉइंट ID (प्रारूप: ep-xxxxxxxx-xxxx-xxxx) की आवश्यकता होती है.
ठीक करें: Volcengine कंसोल से अपना वास्तविक एंडपॉइंट ID का उपयोग करके डिफ़ॉल्ट प्लेसहोल्डर मॉडल को बदलें.
कॉन्फ़िगरेशन
| निदान सेटिंग | स्थान | उद्देश्य |
|---|---|---|
| कनेक्शन जाँचें | सेटिंग्स --> प्रोवाइडर विभाग | API कुंजी एवं कनेक्टिविटी की पुष्टि करें |
| मॉडल सूची प्राप्त करें | सेटिंग्स --> प्रोवाइडर विभाग | कौन-से मॉडल एक्सेस किए जा सकते हैं, इसकी पुष्टि करें |
enableStableApiCall | सेटिंग्स --> एडवांस्ड | बैकऑफ़ के साथ रीट्राय चालू करें |
batchConcurrency | सेटिंग्स --> बैच | रेट लिमिट से बचने हेतु समानांतरता को नियंत्रित करें |
समस्याओं की रिपोर्ट कैसे करें
यदि आपकी समस्या ऊपर दी गई श्रेणियों में नहीं आती है:
- सेटिंग्स --> Notemd --> डायग्नोस्टिक्स को खोलें
- पूरा डायग्नोस्टिक्स आउटपुट कॉपी करें
- github.com/Jacobinwwey/obsidian-NotEMD/issues पर एक GitHub Issue खोलें
- शामिल करें: Obsidian संस्करण, Notemd संस्करण, प्रोवाइडर, मॉडल, डायग्नोस्टिक्स आउटपुट, एवं पुनरुत्पादन हेतु चरण
- किसी भी साझा लॉग से अपना API कुंजी हटा दें
अगले चरण
- LLM प्रोवाइडर्स -- पूरा प्रोवाइडर कॉन्फ़िगरेशन संदर्भ
- बैच प्रोसेसिंग -- बड़े ऑपरेशनों हेतु समानांतरता एवं पुनः प्रयास सेटिंग्स
- कस्टम प्रॉम्प्ट्स -- प्रॉम्प्ट्स समायोजित करके अप्रत्याशित LLM व्यवहार को ठीक करें