Felsökning
Översikt
Anteckna Notemd-/Obsidian-version, OS, åtgärd, protokoll, modell och minimala steg. Kör inte om innan avbrottet slutförts. Bevara utdata och återställningsfiler tills deras ursprung är klart.
Diagnostik
Anslutningstest
Test connection kan bara kontrollera en modellista eller göra kort generering. Kör därefter en riktig liten uppgift med vald modell och önskat utdataformat.
Förlopp och utvecklardiagnostik
Förlopp visar status, fel och platser; API-aktivitet skiljer väntande och färdiga anrop. Aktivera debug vid behov. Lång diagnostik kan förbruka kvoter. Rapporter kan innehålla anteckningar, delsvar, endpointdetaljer och nycklar. Granska och maskera lokalt före delning, även metadata i maskerade profiler.
Vanliga fel
Saknad eller ogiltig nyckel
401: kontrollera profil, adress och oavsiktliga blanksteg. 403: kontrollera konto, projekt, modellbehörighet och betalning. Omförsök reparerar inte felaktiga uppgifter.
Nätverk
Kontrollera värd, port, protokoll och sökväg från Obsidian-enheten. Ollama/LM Studio måste köras med modellen tillgänglig. localhost är denna enhet. Välj rätt profil; fallback väljs automatiskt, inte med en transportknapp.
Begränsning 429
Sänk samtidighet och kontrollera anrops-/tokenkvoter och annan användning av nyckeln. Omförsök löser bara vissa tillfälliga fel.
Modell saknas
Använd Fetch models eller känt modell-/deployment-ID. Kontrollera API-version och region. Exempel kan vara gamla; Azure kräver deployment och Ark kan kräva endpoint-ID.
Inga länkar eller begrepp
Kontrollera verklig resultatfil, källa, svarsformat och aktiverad begreppsmapp. Fristående extraktion börjar med bara titlar och utan bakåtlänkar. Jämför standardprompten om markörer saknas.
Utdata saknas eller hamnar fel
Läs rapporterad _processed.md, _<language>.md eller complete-sökväg. Misslyckad översättningsmapp kan ge fallback till källmapp. Kontrollera konflikter och rättigheter före omkörning.
Filer efter avbrott
Färdiga skrivningar bevaras; accepterade anrop kan avslutas. Granska filer och återställningskonflikter innan radering eller ny hel mappkörning.
Diagram eller inbyggd export
Typer genereras i följd. Ett fel stoppar inte de andra; avbrytning stoppar väntande typer och behåller färdiga filer. Försök exportera igen via förhandsvisning eller historik utan en ny modellförfrågan. Genereringsfel kräver att typen genereras igen. Återställningsposter v1/v2 kan fortfarande läsas.
Diagram-HTML innehåller en zoombar bild; HTML för strukturerad sammanfattning innehåller text, struktur och belägg. Redigerbar HTML/SVG är en renderare, inte en webbredigerare. Använd den ursprungliga källfilen för redigering. Presentationsexport, inklusive PPTX och MP4, har separata inställningar och beroenden. Diagramhandbok.
Rapportera fel
- Reproducera med syntetisk anteckning i testmapp.
- Ange versioner, åtgärd, modell, nödvändiga inställningar och förväntat/faktiskt resultat.
- Bifoga minimala filer/loggar utan nycklar, privat text eller onödig metadata.
- Ange om felet finns på en fil med standardprompter.
- Öppna GitHub Issues.
En skärmbild bevisar sällan ensam ett format- eller avbrottsfel. Bifoga källa/resultat eller minimal reproduktion där det går.