Salta al contenuto principale

Risoluzione dei problemi

💡TL;DR

Riproduci su una nota di prova con provider, modello e impostazioni esatti. Leggi progresso e destinazione. Distingui autenticazione, generazione, parsing e scrittura: la connessione non verifica tutto il flusso.

Panoramica​

Annota versioni Notemd/Obsidian, sistema, azione, protocollo, modello e passi minimi. Attendi il termine dell’annullamento prima di un’altra attività. Conserva output e recupero finché ne conosci l’origine.

Diagnosi​

Connessione​

Testa connessione può controllare solo la lista o una breve generazione secondo il profilo. Una vera attività verifica modello e contratto di output.

Progresso e diagnostica sviluppatore​

Il progresso mostra stati, errori e percorsi. L’attività API distingue richieste pendenti e concluse. Abilita debug solo quando serve; diagnosi lunghe possono consumare quota.

I report possono contenere note, risposte parziali, endpoint o credenziali. Rivedi e ripulisci localmente. Anche profili oscurati richiedono controllo dei metadati.

Errori frequenti​

Chiave mancante o invalida​

401: chiave del provider/endpoint corretti, senza spazi. 403: permessi, progetto, accesso al modello e addebiti. I tentativi non correggono credenziali.

Rete​

Verifica host, porta, protocollo e percorso dal dispositivo Obsidian. Ollama/LM Studio richiedono server e modello pronti. localhost è quel dispositivo. Scegli il profilo corretto; i fallback sono automatici, non un selettore UI.

Quota 429​

Riduci concorrenza e controlla limiti richieste/token e altri client della chiave. Ripetere può risolvere errori temporanei, senza garantire il rispetto di ogni quota.

Modello assente​

Usa l’elenco o un nome noto di modello/deployment. Controlla versione API e regione; valori storici possono essere ritirati. Azure richiede deployment, Ark può richiedere endpoint ID.

Apri l’output effettivo, verifica fonte utile, formato della risposta e cartella concettuale attiva non vuota. Estrazione autonoma crea titoli senza backlink inizialmente. Ripristina il prompt integrato se mancano marcatori.

Output mancante o altrove​

Controlla il percorso dichiarato: _processed.md, _<language>.md o complete. La traduzione può ripiegare sulla cartella fonte se non crea quella richiesta. Verifica collisioni e permessi.

File dopo annullamento​

Le scritture concluse restano e quelle accettate possono terminare. Rivedi risultati individuali e conflitti prima di eliminare o ripetere tutto.

Diagramma o export nativo​

I tipi vengono generati in sequenza. Un errore non blocca gli altri; l’annullamento ferma quelli in attesa e conserva i file completati. Ripeti le esportazioni da anteprima o cronologia senza un’altra richiesta al modello. Un errore di generazione richiede di rigenerare quel tipo. I registri v1/v2 restano leggibili.

L’HTML del diagramma contiene una grafica ingrandibile; l’HTML del riepilogo strutturato contiene testo, struttura e riferimenti. HTML/SVG modificabile è il nome di un renderer, non di un editor web. Per modificare usa il sorgente nativo. Le presentazioni, inclusi PPTX e MP4, mantengono impostazioni e dipendenze separate. Manuale dei diagrammi.

Segnalare un errore​

  1. Riproduci con nota sintetica e cartella dedicata.
  2. Indica versioni, azione, modello, impostazioni e atteso/osservato.
  3. Allega report e artefatti minimi senza segreti o contenuti privati.
  4. Specifica se accade su un file e con prompt integrati.
  5. Apri GitHub Issues.

Uno screenshot raramente dimostra da solo un errore di formato o annullamento. Includi fonte/output o sequenza minima.

Passi successivi​