Doorgaan naar de hoofdinhoud

Problemen oplossen

💡TL;DR
Reproduceer op één wegwerpnotitie met dezelfde provider, model en taakinstellingen. Bekijk voortgang en uitvoerpad. Scheid authenticatie, generatie, parsing en schrijven; een verbindingstest controleert niet de hele workflow.

Overzicht​

Noteer Notemd/Obsidian-versies, OS, actie, protocol, model en minimale stappen. Begin niet opnieuw terwijl annulering nog afrondt. Bewaar uitvoer en herstelbestanden totdat hun herkomst duidelijk is.

Diagnostiek​

Verbindingstest​

Verbinding testen kan alleen een modellijst controleren of kort genereren. Voer daarna een echte kleine taak uit voor het gekozen model en uitvoercontract.

Voortgang en ontwikkelaarsdiagnostiek​

Voortgang meldt status, fouten en locaties; API-activiteit onderscheidt wachtende en afgeronde aanvragen. Zet debug alleen zo nodig aan. Lange providerdiagnostiek kan quota verbruiken. Rapporten kunnen notities, deelantwoorden, endpointdetails en sleutels bevatten. Controleer en redigeer lokaal vóór delen; ook geredigeerde profielen vereisen metadatacontrole.

Veelvoorkomende fouten​

Ongeldige of ontbrekende sleutel​

401: juiste provider/endpoint en geen onbedoelde spaties. 403: accountrechten, project, modeltoegang en facturering. Herhalen repareert geen onjuiste gegevens.

Netwerk​

Controleer host, poort, protocol en route vanaf het Obsidian-apparaat. Ollama/LM Studio moeten draaien met het model beschikbaar. localhost is dit apparaat, niet een andere computer. Kies het juiste profiel; fallback wordt automatisch gekozen, niet via een transportknop.

Limiet 429​

Verlaag gelijktijdigheid en bekijk aanvraag-/tokenquota en andere gebruikers van dezelfde sleutel. Herhalingen lossen slechts sommige tijdelijke fouten op.

Model niet gevonden​

Gebruik Fetch models of een bekend model/deployment. Controleer API-versie en regio. Voorbeelden kunnen verouderd zijn; Azure vereist deployment en Ark kan endpoint-ID vereisen.

Controleer het echte uitvoerbestand, bruikbare bron, responseformaat en een ingestelde actieve conceptmap. Afzonderlijke extractie begint met alleen titels en zonder teruglinks. Vergelijk met de standaardprompt als markers zijn verwijderd.

Uitvoer weg of elders​

Lees het gemelde _processed.md, _<language>.md of complete-pad. Bij mislukte vertaalmapcreatie kan de bronmap worden gebruikt. Controleer botsingen en rechten voor herhaling.

Bestanden na annulering​

Afgeronde schrijfbewerkingen blijven en geaccepteerde aanvragen kunnen aflopen. Controleer bestanden en herstelconflicten voordat je wist of de hele map opnieuw draait.

Diagram of native export​

Typen worden achtereenvolgens gemaakt. Eén fout blokkeert de overige niet; annuleren stopt wachtende typen en bewaart voltooide bestanden. Herhaal exports vanuit het voorbeeld of de geschiedenis zonder nieuwe modelaanvraag. Na een generatiefout moet dat type opnieuw worden gemaakt. v1/v2-herstelgegevens blijven leesbaar.

Diagram-HTML bevat een zoombare afbeelding; HTML met een gestructureerde samenvatting bevat tekst, structuur en verwijzingen. Bewerkbaar HTML/SVG is een renderer, geen webeditor. Gebruik de oorspronkelijke bron voor bewerking. Presentatie-export, waaronder PPTX en MP4, behoudt afzonderlijke instellingen en afhankelijkheden. Diagramhandleiding.

Een fout melden​

  1. Reproduceer met synthetische notitie en testmap.
  2. Vermeld versies, actie, model, noodzakelijke instellingen en verwacht/werkelijk resultaat.
  3. Voeg minimale artefacten en logs toe zonder sleutels, privé-inhoud of overbodige endpointmetadata.
  4. Meld of het op één bestand met standaardprompts gebeurt.
  5. Open GitHub Issues.

Een screenshot alleen bewijst zelden een formaat- of annuleringsprobleem. Geef waar mogelijk bron/uitvoer of een minimale reeks stappen.

Verder​