Skip to main content

Virheiden ratkaiseminen

💡TL;DR

Enimmäiset Notemd ongelmat kuuluvat neljään kategorioon: API pääongelmat, verkon yhteyshäiriöt, tunnistusvirheet (401/403) sekä käyttömääräpiirteet (429). Sisäistöinen yhteystesti ja diagnostiikkapaneeli tunnistavat perustasan nopeasti. Tämä sivu kattaa kaikki yleisimmät virheilmoitukset, niiden syyn ja ratkaisun. Ongelmille, jotka ei ole tähän listattu, raportoi ne GitHub Issues -sivustolla diagnostiikkatulostuksen kanssa.

Tämä kuuluu Obsidian AI-tietojen hallintasuunnitelmaan.

Yleenvaate​

Notemd riippuu ulkopuolisista palveluista – LLM tarjoajista ja hakukoneista API – mikä tarkoittaa, että enintään ongelmat syntyvät pluginin itsestä ulkopuolella. Asetuksissa oleva diagnostiikkapaneeli tarjoaa strukturoituksen viimeisestä API kutsusta, mukaan lukien päätös URL, vastausstatus ja virhekehys. Tarkista se alati ennen lisäksi tutkimista.

Kuidas se toimii: Diagnostiikka​

Yhteystesti​

Jokaisessa tarjoajan konfigurointiosassa on "Testaa yhteyttä" -painikka. Sen painamisella lähetetään minimiisti API päätös (yleensä mallilista tai lyhyt täyttö) ja ilmoitetaan onnistuminen tai konkreettinen HTTP virhe. Tämä on nopein tapa vahvistaa, että sinun API avainsi ja perus URL ovat oikeita.

Diagnostiikkapaneeli​

Asetukset --> Notemd --> Diagnostiikka näyttää:

PoliiviSisältö
Viimainen tarjoajaMillainen tarjoaja kutsuti viimeisin
Viimainen malliMillainen malli kutsuti viimeisin
Viimeinen tilaHTTP-tilastokoodi tai transpordivirhe
Viimainen vikaKerrottompi virheilmoitus API-ltä
Viimeinen pyytös URLViimeisen pyytön täysin URL (poistettu API-avain)
Viimeisen vastauksen sisuKortennettu vastauskehys (esim. 500 merkkiä)

Kopioi koko diagnostiikan tulostus, kun raportoi ongelmista GitHubissa.

Yleisimmät virheet​

API Avain on väärä tai puuttuu​

Symptomi: HTTP 401 tai “Vääri API-avain annettu”

Syy: API-avain puuttuu, sisältää tyhjiä tiloja tai kuuluu toiseen tarjoajaan.

Parannus:

  1. Värittele, onko avainilla edessä tai sisällä tilaa.
  2. Väliaikaisesti vahvista, että avain sopii valituun palveluntarjoajalle (OpenAI-avain ei toimi Anthropic- kanssa).
  3. Tarkista, että sinun kontollesi on krediteja tai aktiivinen tila
  4. Klikkaa "Test Connection", jotta voit vahvistaa

Verkon / yhteyden virheet​

Oireet: ERR_CONNECTION_REFUSED, ERR_TIMED_OUT, Socket hang up, Network request failed

Syy: API-palautteepiste ei ole käytettävissä sinun laitteestasi.

Palautteet:

  1. Tarkista oma internet-yhteyshäiriöt
  2. Jos olet proxy- tai tulevyrjyn takana, vahvistaa, että API-domaani ei ole estetty
  3. Ollama-tilanteessa: vahvista, että ollama serve käy (ollama list pitää palauttaamaan mallit)
  4. LMStudio-tilanteessa: vahvista, että serveri käy localhost:1234-palvelussa
  5. Yritä toisen transportin – mobiilikäyttäjät pitävät varmistamaan, että requestUrl-transportti on aktiivinen
  6. Aktivoi enableStableApiCall automaattisten uudellepyyntien suorittamiseen ajutettavissa virheissä

403 Kielletty​

Oireet: HTTP 403

Syy: Sinun API-avainesi on voimassa, mutta seillä ei ole oikeuksia pyytämään resurssille.

Palautteet:

  1. Mõned mudelid nõuavad erilist juurdepääsu (nt GPT-4 Azure kaudu nõuab paigaldusnime)
  2. Mõned pakkujad piiravad mudeleid paketi taseme järgi – kontrollige oma kontot
  3. Võivad kehtida piirkondlikud piirangud (mõned Hiina pakkujad blokeerivad rahvusvahelised IP-id ning vastupidi)
  4. Kontrollige, kas mudeli nimi on õigesti kirjutatud (nt gpt-4o mitte gpt-4o-mini, kui mini-mudel on kõik, mida teie pakett lubab)

Sageduspiirang (429)​

Sümptom: HTTP 429 või „Sageduspiirang ületatud“

Põhjus: Liiga palju päringuid lühikese aja jooksul.

Lahendus:

  1. Vähendage batchConcurrency väärtust 1 või 2 peale
  2. Oodake mõni minut enne uuesti proovimist
  3. Vaadake oma paketi taseme kohta pakkuja sageduspiirangute dokumentatsiooni
  4. Lülitage sisse enableStableApiCall automaatseks korduskatseteks koos tagasilöögiga
  5. Kaaluge ülemiste piirangutega pakkuja kasutamist (DeepSeek, Ollama)

Mudel ei leitud​

Sümptom: „Mudel ei leitud“ või HTTP 404

Põhjus: Mudeli nimi ei eksisteeri valitud pakkuja juures.

Parannus:

  1. Klikkaa "Get Model List", jotta näet kaikki saatavilla olevat mallit sinun tarjoajasi jaoks
  2. Mõned mallin nimet muuttuvat ajan myötä – kontrolloi aktuaalista nimeä tarjoajan dokumentaatiosta
  3. Ollama: käynnita ollama list, jotta näet pullattuja mallia; vain ladattuudet mallit ovat saatavilla

Ei linkkejä / Ei konsepteja luodut​

Oire: Komento käynnistyy mutta ei tuoda väljontaa

Syy: LLM lähetti tühjan tai analysoitamattoman vastauksen.

Parannus:

  1. Tarkista diagnostikan paneeli aktuaisen LLM vastauksen osalta
  2. Proovi suurempia mahdollisuuksia omavia mallia (mõned väikeset mallid kävelevät rakennyttyn väljontin kanssa)
  3. Veendu, että märkintössä on piisavasti sisältöä (>50 sanaa)
  4. Tarkista omaan kohandettua käyttäjäkysymyksää vastuoluisien ohjeiden osalta
  5. Poista ajutisesti samasanojen tukkiminen, jotta näet, onko se liian aggressiivisesti filtreerivä

Doubao-palvelun ID puuttuu​

Oire: Vika ByteDance Doubao-tarjoajan käyttössä

Syy: Doubao vaatii Ark-palvelun ID-d (muoto: ep-xxxxxxxx-xxxx-xxxx) mallin nimen sijaan.

Fix: Asenna vaihtoehtoisen mallin sijaan sinun todellinen päätuspisteiden ID Volcengine-konsolista.

Konfigurointi​

DiagnostiikasätteetSijaintiTarkoitus
Testa yhteyttäSättimet --> Tarjoajan osaVäliaikaisesti kontrolloi API-avain ja yhteyden toiminta
Saada mallien listaSättimet --> Tarjoajan osaVarmista, millat mallit ovat käytettävissä
enableStableApiCallSättimet --> Edistyneet sättimetAktivoi uudelleenpyynnöt taustapäivittämisen kanssa
batchConcurrencySättimet --> PaketitKontrolloi parallellisuutta, jotta ei syntyy kiirustaksoja

Kuidas raportoida ongelmia​

Jos sinun ongelman ei ole ylälä mainittu:

  1. Avaa Asetukset --> Notemd --> Diagnostiikka
  2. Kopioi koko diagnostiikan tulostus
  3. Avaa GitHub Issue-sivu github.com/Jacobinwwey/obsidian-NotEMD/issues
  4. Sisällyttä: Obsidian versio, Notemd versio, tarjoaja, malli, diagnostiikan tulostus sekä toistamiseen tarvittavat toimet
  5. Poista oma API-avain yhdistetyistä logista

Järguvät toimet​

  • LLM Tarjoajat -- Täysin tarjoajien konfigurointitietot
  • Pakkettyyn töihin -- Suurten toimintojen samalla aikana suorittaminen ja uudelleenkokeutusasetukset
  • Omakohdat -- Vastaanottamattoman LLM-toiminnon korjaaminen ohjeiden muuttamisen avulla