פתרון בעיות

💡TL;DR

רוב Notemd הבעיות מתחלקות לארבע קטגוריות: בעיות מרכזיות של API, חיבור לרשת, שגיאות אימות (401/403), ומגבלות קצב (429). מבחן החיבור המובנה ולוח האבחון מזהים את הסיבה הראשונית במהירות. דף זה מכסה כל הודעת שגיאה נפוצה, את הסיבה לה ואת התיקון. לבעיות שאינן מופיעות כאן, דווחו עליהן ב‑GitHub Issues יחד עם תוצאות האבחון.

זהו חלק מהObsidian מדריך ניהול ידע AI.

סקירה

Notemd תלוי בשירותים חיצוניים – ספקי LLM ומנועי חיפוש API – כך שרוב הבעיות נובעות מחוץ לפלגין עצמו. לוח האבחון בהגדרות מספק תצוגה ממוקדת של השיחה האחרונה API, כולל הבקשה URL, מצב התגובה וגוף השגיאה. תמיד בדקו אותו קודם לפני שאתם חוקרים יותר.

אופן הפעולה: אבחון

מבחן חיבור

לכל סעיף הגדרות של ספק יש כפתור "בדוק חיבור". לחיצה עליו שולחת בקשה מינימלית של API (בדרך כלל רשימת מודלים או השלמה קצרה) ומדווחת על הצלחה או על שגיאת HTTP ספציפית. זו הדרך המהירה ביותר לוודא ש‑API המפתח ו‑URL הבסיסי שלכם נכונים.

לוח האבחון

הגדרות --> Notemd --> אבחון מציג את הבא:

שדה	תוכן
ספק אחרון	איזה ספק נקרא לאחרונה
מודל אחרון	איזה מודל נקרא לאחרונה
מצב אחרון	קוד מצב HTTP או שגיאת העברה
שגיאה אחרונה	הודעת השגיאה המקורית מה API
בקשה אחרונה URL	URL מלא של הבקשה האחרונה (מפתח API מוסתר)
תוכן התגובה האחרון	תוכן תגובה מקוצר (500 התווים הראשונים)

העתיקו את פלט האבחון המלא כאשר מדווחים על בעיות ב‑GitHub.

שגיאות נפוצות

מפתח API לא תקין או חסר

תסמין: HTTP 401 או "מפתח API לא נכון ניתן"

סיבה: המפתח API חסר, מכיל רווחים, או שייך לספק אחר.

פתרון:

1. בדקו שאין רווחים בתחילת/סוף המפתח
2. וודאו שהמפתח תואם את הספק הנבחר (מפתח OpenAI לא יעבוד עם Anthropic)
3. בדקו שלחשבון שלכם יש אשראי או מנוי פעיל
4. לחצו על "Test Connection" כדי לבדוק

שגיאות רשת / חיבור

תסמין: ERR_CONNECTION_REFUSED, ERR_TIMED_OUT, Socket hang up, Network request failed

סיבה: הקצה API אינו נגיש מהמחשב שלכם.

פתרון:

1. בדקו את חיבור האינטרנט שלכם
2. אם אתם מאחורי פרוקסי או חומת אש, בדקו שהדומיין API אינו חסום
3. עבור Ollama: בדקו ש‑ollama serve פועל (‎ollama list צריך להחזיר מודלים)
4. עבור LMStudio: בדקו שהשרת פועל על localhost:1234
5. נסו תשלוח אחר – משתמשי מובייל צריכים לוודא שתשלוח requestUrl פעיל
6. הפעילו enableStableApiCall לניסיונות חוזרים אוטומטיים במקרה של שגיאות זמניות

403 Forbidden

תסמין: HTTP 403

סיבה: המפתח API שלכם תקין אך אינו מחזיק ברשות למשאב המבוקש.

פתרון:

1. חלק מהמודלים דורשים גישה מיוחדת (למשל, GPT-4 דרך Azure דורש שם הפריסה)
2. כמה ספקים מגבילים מודלים לפי רמת התוכנית – בדקו את החשבון שלכם
3. עשויות להיות הגבלות אזוריות (כמה ספקים בסין חוסמים IP בינלאומיים ולהיפך)
4. וודאו ששם המודל נכתב כראוי (למשל, gpt-4o ולא gpt-4o-mini כאשר המודל הקטן הוא כל מה שהתוכנית שלכם מאפשרת)

Rate Limit (429)

תסמין: HTTP 429 או "Rate limit exceeded"

סיבה: יותר מדי בקשות בפרק זמן קצר.

פתרון:

1. הפחיתו את batchConcurrency ל-1 או 2
2. חכו מספר דקות לפני ניסיון חוזר
3. בדקו את המסמכים של הספק שלכם לגבי מגבלות הקצבה לרמת התוכנית שלכם
4. הפעילו enableStableApiCall לניסיונות חוזרים אוטומטיים עם backoff
5. שקלו לעבור לספק עם מגבלות גבוהות יותר (DeepSeek, Ollama)

Model Not Found

תסמין: "Model not found" או HTTP 404

סיבה: שם המודל אינו קיים אצל הספק הנבחר.

תיקון:

1. לחצו על "Get Model List" כדי לראות את כל המודלים הזמינים עבור הספק שלכם
2. שמות של מודלים משתנים עם הזמן -- בדקו את השם העדכני במסמכי הספק
3. עבור Ollama: הריצו ollama list כדי לראות את המודלים שהורדו; רק מודלים שהורדו זמינים

אין קישורים / אין רעיונות שנוצרו

תסמין: הפקודה מתבצעת אך אינה מפיקה שום תוצאה

סיבה: הLLM החזיר תגובה ריקה או בלתי ניתנת לפענוח.

תיקון:

1. בדקו את לוח האבחון עבור התגובה האמיתית של LLM
2. נסו מודל יותר חזק (מודלים קטנים מסוימים מתקשים עם פלט ממוקדר)
3. הבטיחו שלהערה יש תוכן מספיק (יותר מ‑50 מילים)
4. בדקו את ההוראות המותאמות אישית שלכם לחיפוש על התנגשויות
5. נטרלו זמנית את דיכוי המילים הנרדפות כדי לראות אם הוא מסנן באופן קיצוני מדי

חסר מזהה קצה Doubao

תסמין: שגיאה בשימוש בספק ByteDance Doubao

סיבה: Doubao דורש מזהה קצה Ark (פורמט: ep-xxxxxxxx-xxxx-xxxx) במקום שם מודל.

תיקון: החליפו את המודל הפיילוט הסטנדרטי ב-ID של נקודת הקצה האמיתית שלכם מממשק Volcengine.

הגדרה

הגדרות אבחון	מיקום	מטרה
בדיקת חיבור	סעיף Provider בהגדרות	בדקו את מפתח API ואת החיבוריות
קבלת רשימת מודלים	סעיף Provider בהגדרות	אשרו אילו מודלים זמינים
enableStableApiCall	הגדרות --> מתקדם	הפעילו ניסיונות חוזרים עם דחייה
batchConcurrency	הגדרות --> בקבוצות	שלטו במקביליות כדי להימנע ממגבלות קצב

כיצד לדווח על בעיות

אם הבעיה שלכם אינה מכוסה לעיל:

1. לפתוח הגדרות --> Notemd --> אבחון
2. להעתיק את פלט האבחון המלא
3. לפתוח בעיה ב-GitHub בכתובת github.com/Jacobinwwey/obsidian-NotEMD/issues
4. לכלול: גרסת Obsidian, גרסת Notemd, ספק, מודל, פלט האבחון, ושלבים לשחזור
5. למחוק את המפתח API שלכם מכל יומני לוגים משותפים

---

צעדים באופק

• LLM Providers -- מסמך התייחסות מלא להגדרות הספקים
• Batch Processing -- הגדרות ריבוי משימות וניסיונות חוזרים לפעולות גדולות
• Custom Prompts -- תיקון התנהגות בלתי צפויה של LLM על ידי התאמת ההוראות