Haladjon át a fő tartalmhoz

Hibaelhárítás

💡TL;DR
Próbajegyzeten, azonos szolgáltatóval, modellel és feladatbeállítással reprodukáljon. Olvassa a folyamatjelzést és kimeneti útvonalat. Válassza szét a hitelesítést, generálást, parsingot és írást; a kapcsolatteszt nem teljes munkafolyamat-próba.

Áttekintés​

Rögzítse a Notemd/Obsidian verziót, OS-t, műveletet, protokollt, modellt és minimális lépéseket. Ne indítson újra, amíg a megszakítás lezárul. Tartsa meg a kimeneti és helyreállítási fájlokat, amíg meg nem érti eredetüket.

Diagnosztika​

Kapcsolatteszt​

A Test connection csak modelllistát vagy rövid generálást is ellenőrizhet. Utána futtasson kis valódi feladatot a választott modellel és kimeneti formával.

Folyamat és fejlesztői diagnosztika​

A folyamatjelző állapotot, hibákat és helyeket mutat; az API-aktivitás megkülönbözteti a várakozást a befejezéstől. Csak szükség esetén engedélyezzen debugot. Hosszú diagnosztikai kérés kvótát fogyaszthat. Jelentésekben jegyzetek, részválaszok, végpontok és kulcsok lehetnek. Megosztás előtt helyben ellenőrizze és tisztítsa őket, a tisztított profilok metaadatait is.

Gyakori hibák​

Hiányzó vagy érvénytelen kulcs​

401: profil, végpont és véletlen szóközök. 403: fiók, projekt, modelljog és számlázás. Az újrapróbálás nem javít hibás hitelesítő adatot.

Hálózat​

Az Obsidian eszközéről ellenőrizze a szervert, portot, protokollt és útvonalat. Ollama/LM Studio fusson elérhető modellel. A localhost ezt az eszközt jelenti, nem más számítógépet. Válasszon megfelelő profilt; a fallback automatikus, nincs általános transportkapcsoló.

429 korlát​

Csökkentse az egyidejű kéréseket, nézze meg a hívás/tokenkvótát és a kulcs egyéb forgalmát. Újrapróbálás csak bizonyos átmeneti hibát kezel.

Nem található modell​

Használja a Fetch models műveletet vagy ismert modell/deployment ID-t. Ellenőrizze az API-t és régiót. Példák elavulhatnak; Azure deploymentet, Ark endpoint-ID-t igényelhet.

Hiányzó hivatkozás vagy fogalom​

Ellenőrizze a tényleges kimenetet, használható forrást, válaszformátumot és engedélyezett fogalommappát. Önálló kinyeréskor kezdetben csak címek vannak, visszahivatkozás nélkül. Hiányzó jelölésnél próbálja az alaputasítást.

Hiányzó vagy máshová került kimenet​

Olvassa a jelentett _processed.md, _<language>.md vagy complete útvonalat. Fordítási mappahibánál a forrásmappa lehet a cél. Ismétlés előtt vizsgálja a jogosultságot és konfliktusokat.

Fájlok megszakítás után​

Kész írás megmarad, elfogadott kérés befejeződhet. Törlés vagy a teljes mappa újrafuttatása előtt ellenőrizze a fájlokat és helyreállítási ütközéseket.

Diagram vagy alkalmazásexport​

A típusok egymás után készülnek. Egy hiba nem állítja le a többit; a megszakítás leállítja a várakozó típusokat és megőrzi a kész fájlokat. Az export az előnézetből vagy előzményekből új modellkérés nélkül ismételhető. Generálási hiba esetén a típust újra kell generálni. A v1/v2 rekordok olvashatók maradnak.

A diagram-HTML nagyítható grafikát, a strukturált összefoglaló HTML szöveget, szerkezetet és hivatkozásokat tartalmaz. A szerkeszthető HTML/SVG egy megjelenítő neve, nem webes szerkesztő. Szerkesztéshez használja a natív forrást. A prezentációk, köztük a PPTX és MP4 exportja külön beállításokat és függőségeket használ. Diagramkézikönyv.

Hibajelentés​

  1. Szintetikus jegyzet és próbamappa segítségével reprodukáljon.
  2. Adja meg a verziókat, műveletet, modellt, szükséges beállítást és várt/tényleges eredményt.
  3. Minimális fájlt/naplót csatoljon kulcsok, privát tartalom és felesleges végpontmetaadat nélkül.
  4. Jelezze, előáll-e egy fájllal és alaputasítással.
  5. Nyisson GitHub Issue bejegyzést.

Egy képernyőkép ritkán bizonyít formátum- vagy megszakítási hibát. Lehetőség szerint adjon forrást/kimenetet vagy minimális lépéseket.

Tovább​