Risoluzione dei problemi

L'app non verrà installata né aperta

Windows

Se SmartScreen blocca il programma di installazione, scegli Ulteriori informazioni → Esegui comunque. La build desktop è firmata in codice, quindi normalmente non viene visualizzata.

Se l'app viene installata ma non si avvia, prova a installarla da Microsoft Store anziché dal programma di installazione diretto: la build dello Store gestisce le proprie dipendenze.

macOS

Se macOS si rifiuta di aprire l'app, apri Impostazioni di sistema → Privacy e sicurezza e consenti l'accesso, quindi avvialo di nuovo.

Assicurati di aver trascinato 9xchat in Applicazioni anziché eseguirlo dall'immagine disco montata.

Linux

Verifica che il file scaricato sia contrassegnato come eseguibile. In caso contrario, imposta il bit eseguibile su di esso ed eseguilo di nuovo.

Mobile

Installalo tramite Google Play o App Store in modo che gli aggiornamenti arrivino automaticamente. Se l'app non si avvia, aggiornala, quindi riavvia il dispositivo.

Le risposte falliscono o si interrompono parzialmente

Lavora attraverso questi in ordine:

1. Controlla la tua connessione. I modelli cloud richiedono l'accesso a Internet. I modelli locali lo fanno no: se le richieste cloud falliscono ma quelle locali funzionano, il problema è la rete o il provider, non 9xchat.

2. Controlla il saldo del tuo credito. Se stai utilizzando i crediti 9xchat e loro li hanno finiscono, le richieste si fermano. Ricarica o passa alla tua chiave API.

3. Controlla la tua chiave API. Se hai portato la tua chiave, conferma che sia ancora valido e ha una quota rimasta con quel fornitore.

4. Prova un modello diverso. Se un modello fallisce e un altro ha successo, il problema è con quello specifico modello o fornitore.

Un modello manca o non verrà caricato

• I modelli cloud necessitano di crediti o di una chiave API configurata per questo fornitore. In Libreria → Modelli, un provider rimane contrassegnato come Inattivo finché non aggiungi la sua chiave: quell'etichetta è il modo più veloce per vedere ciò verso cui non hai alcun percorso.

• I modelli locali necessitano che il tuo corridore locale venga avviato prima che 9xchat possa raggiungerli. Avvialo prima, quindi riapri l'elenco dei modelli.

La tua chiave API è stata rifiutata

L'errore è a carico del provider, quindi c'è anche la correzione:

1. Incolla di nuovo la chiave, senza spazi iniziali o finali.
2. Conferma che la chiave appartiene al provider sotto cui l'hai aggiunta.
3. Verificare che la chiave esista ancora e che non sia stata revocata o ruotata.
4. Verifica di aver impostato la fatturazione e la quota rimanente con quel fornitore: a una chiave valida senza saldo fallisce allo stesso modo di una chiave errata.
5. Conferma che il modello che hai scelto sia quello che il tuo account può utilizzare. Alcuni i modelli necessitano di un livello separato con il fornitore.

Le chiavi vengono archiviate crittografate sul tuo computer. Se una chiave smette di funzionare ovunque, sostituiscila presso il provider invece di reinstallare 9xchat.

Un modello locale non si connetterà

1. Avvia il tuo runner locale e verifica che risponda all'esterno di 9xchat.
2. Conferma che sia in ascolto sull'indirizzo e sulla porta prevista da 9xchat.
3. Conferma che il modello stesso venga tirato e caricato, non solo il corridore che corre.
4. Riapri Libreria → Modelli in modo che l'elenco si aggiorni.

I modelli locali non necessitano di chiavi né crediti. Se un modello locale funziona e uno cloud no, il problema è la tua chiave, il tuo saldo o la rete.

Uno strumento o un server MCP non funziona

1. Verifica che lo strumento sia abilitato. Ogni strumento ha un interruttore Abilitato sotto Libreria → Strumenti.

2. Controlla il piano. Gli strumenti Agentic e la ricerca web in tempo reale richiedono Pro: vedi Crediti, Pro e utilizzo.

3. Leggi la riga sulla sicurezza. Indica di quali autorizzazioni ha bisogno lo strumento. Uno strumento che non riesce a raggiungere ciò di cui ha bisogno fallisce invece di chiedere.

4. Per i server MCP, verificare che siano stati forniti i segreti richiesti: una voce ancora contrassegnato con Richiede configurazione non è stato configurato. L'anteprima della configurazione mostra il comando esatto che esegue, che vale la pena rileggere se il server non si avvia mai.

5. Isolalo. Disattiva lo strumento, fai la stessa domanda e verifica se il cambiamenti di comportamento. Questo ti dice se lo strumento è coinvolto.

La ricerca della conoscenza non trova nulla

Una raccolta deve essere indicizzata prima di poter essere ricercata.

• Verifica che i file siano stati aggiunti a una raccolta e non solo allegati a una chat.
• Verifica che lo strumento Cerca nella conoscenza sia abilitato.
• Se il tuo fornitore di incorporamenti non era raggiungibile quando hai aggiunto i file, la ricerca ricade sulla corrispondenza delle parole chiave e mancherà tutto ciò che necessitava dell'indice. Aggiungere nuovamente i file una volta che il provider è raggiungibile.

Vedi Conoscenze e ricordi.

Un allegato non verrà elaborato

• Conferma che il modello selezionato accetta quel tipo di file. Un modello di solo testo non riesce a leggere un'immagine e l'elenco dei modelli contrassegna quelli che gestiscono la visione.
• File molto grandi possono superare il contesto di un modello. Prova un estratto più piccolo o a modello con una finestra di contesto più ampia.
• Se il file si apre correttamente altrove ma non funziona qui, prova a convertirlo in un file innanzitutto il formato comune.

La generazione dell'immagine non riesce

• La generazione di immagini richiede Pro.
• Conferma di aver selezionato un modello di immagine: viene scelto separatamente dal tuo modello di chat.
• Controlla il saldo del tuo credito se stai generando crediti tramite 9xchat.
• Alcune richieste vengono rifiutate dal provider anziché da 9xchat; la riformulazione è di solito più veloce del nuovo tentativo.

La dettatura o la lettura ad alta voce falliscono

Entrambi necessitano di un fornitore audio funzionante e nessuno dei due dispone di un'opzione locale.

• Verifica che il tuo Provider di trascrizione sia impostato in Impostazioni → Predefinito Modelli.
• Concedi l'autorizzazione al microfono 9xchat nella privacy del tuo sistema operativo impostazioni: su macOS, Impostazioni di sistema → Privacy e sicurezza → Microfono.
• Entrambi necessitano di una connessione anche quando il modello di chat è locale.

L'ingresso del microfono richiede Pro; leggere ad alta voce no.

I crediti si esauriscono più velocemente del previsto

Ogni messaggio mostra il proprio costo, la latenza e la suddivisione dei token e la sessione mostra un totale parziale. Se il totale sembra sbagliato, apri le cifre per messaggio per vedere quale scambio lo spiega: contesto lungo, gettoni di ragionamento e allegati di grandi dimensioni aumentano il costo di un singolo turno.

Puoi limitare questo valore per chat abbassando i token di completamento massimi e il limite di contesto nelle impostazioni del modello e Protezione contesto riduce la quantità di cronologia inviata nuovamente con ciascun messaggio.

Per interrompere completamente la spesa dei crediti, aggiungi la tua chiave API o utilizza un modello locale.

Una funzione è disattivata o mancante

Diverse funzionalità necessitano di Pro: schede multiple, finestra mobile, mini chat, assistente rapido, strumenti di agenti, ricerca web in tempo reale, parco giochi di immagini, input del microfono e sistema di memoria. Crediti, Pro e utilizzo elenca la suddivisione completa.

Se hai già pagato, conferma che questo dispositivo ha effettuato l'accesso con l'UID che detiene l'abbonamento e che non hai superato il limite del dispositivo: un dispositivo in versione gratuita, tre in modalità Pro. Segui UID su tre dispositivi per connettere, cambiare o rimuovere un dispositivo.

Manca qualcosa su un altro dispositivo

Il tuo spazio di lavoro è archiviato localmente su ciascun dispositivo, quindi un secondo computer su cui è stato effettuato l'accesso con lo stesso UID non eredita le tue chat, note o ricordi. Ciò è previsto piuttosto che una colpa.

• Le memorie sono per dispositivo. Una nuova installazione inizia senza alcuna memoria.
• Handoff associa due dispositivi per una conversazione; non copia il resto del tuo spazio di lavoro.
• Per spostare tu stesso il materiale, utilizza Impostazioni → Dati ed esportazioni.

Il tuo abbonamento segue l'UID, quindi un dispositivo che verifica con esso accetta Pro anche se il contenuto non viaggia.

Niente qui ha aiutato

Contatta il supporto con:

• il tuo sistema operativo e la versione di 9xchat,
• il modello e il fornitore che stavi utilizzando,
• che tu avessi crediti, la tua chiave o un modello locale,
• cosa hai fatto e l'esatto errore visibile.