Questa pagina è tradotta dalla documentazione inglese. Comandi, identificatori ed esempi restano invariati. Runtime 7.24.4 · SDK 2.6.7. Testo inglese

Lingue della TUI e configurazione iniziale

Stato: attivo

Ambito: stato attuale

Ultima revisione: 2026-09-14

Responsabile: runtime di ax-code

La TUI di AX Code supporta inglese (en), cinese tradizionale (zh-TW), cinese semplificato (zh-CN), giapponese (ja), coreano (ko), spagnolo (es), portoghese brasiliano (pt-BR), francese (fr), tedesco (de), russo (ru), indonesiano (id), turco (tr), vietnamita (vi) e italiano (it). Le superfici localizzate includono configurazione, navigazione, comandi comuni, aiuto della tastiera, controlli del prompt, scelte dei provider, decisioni sui permessi, finestre di sessione, stato del runtime e presentazione di Council/Arena.

Esegui /language (alias /lang) per scegliere in modo indipendente la lingua dell’interfaccia e la lingua della conversazione. Il selettore delle lingue mostra ogni lingua nel proprio sistema di scrittura. I cambiamenti dell’interfaccia si applicano subito. I cambiamenti della conversazione si applicano ai prompt successivi e ai comandi slash appoggiati al modello, incluse le richieste Council e Arena. Auto conserva il comportamento esistente della conversazione. Le istruzioni esplicite dell’utente e le regole del progetto hanno la precedenza sulla preferenza. I comandi di shell vengono inviati invariati.

Il messaggio originale dell’utente viene conservato. Le preferenze di conversazione viaggiano separatamente; AX Code non traduce il compito prima dell’esecuzione. Commenti nel codice, commit e documenti seguono le regole del progetto, con l’inglese richiesto per impostazione predefinita quando è selezionata una preferenza di conversazione esplicita. Identificatori tecnici, percorsi, comandi, output grezzo degli strumenti e prove citate restano invariati.

Configurazione iniziale

Un’installazione interattiva nuova, senza provider o sessione configurati, offre una configurazione rapida dopo l’inizializzazione:

1. Scegli la lingua dell’interfaccia. Tutte e quattordici le lingue sono disponibili insieme; usa i tasti freccia per scorrere l’elenco nei terminali corti.
2. Connetti un provider e seleziona un modello tramite le finestre di connessione esistenti. Scegli, secondo il caso, una CLI di programmazione installata, un’API cloud, un runtime locale, un endpoint GPU privato o un gateway AX Trust.
3. Avvia un compito. Una revisione in sola lettura è un primo compito utile; ispeziona i comandi e il loro ambito prima di approvare.

Puoi saltare la configurazione e riaprirla con /setup. Annullare la configurazione del provider torna alla lista di controllo. Gli utenti già configurati, le sessioni riprese e gli avvii espliciti --prompt non vengono interrotti. Gli errori di caricamento e di connessione restano separati da un’installazione non configurata. Selezionare un modello stabilisce la prontezza della configurazione; la prima richiesta controlla la connessione live. La configurazione non concede permessi, non installa runtime e non scarica modelli automaticamente.

Configurazione

I predefiniti facoltativi stanno in tui.json, non nell’impostazione legacy language del runtime:

{
  "interface_language": "zh-TW",
  "conversation_language": "ja"
}

Valori dell’interfaccia: en, zh-TW, zh-CN, ja, ko, es, pt-BR, fr, de, ru, id, tr, vi, it. La conversazione accetta anche auto. I predefiniti sono en e auto. Le scelte fatte tramite /language vengono salvate nello stato locale della TUI e scavalcano questi predefiniti di file. Usa /language per cambiarle di nuovo. Le scelte di lingua non cambiano le credenziali né la policy del server.

La localizzazione di Council/Arena cambia solo le etichette di presentazione. Le prove dei membri, i conteggi di supporto, l’ordine di classifica, lo stato di verifica e gli errori grezzi restano intatti. Il testo di autorizzazione fornito dal provider, l’output degli strumenti specializzati e le superfici diagnostiche specializzate possono ancora comparire nella lingua originale. L’output grezzo degli strumenti, gli identificatori tecnici, il contenuto dell’utente e la documentazione non vengono tradotti.

Per chi contribuisce, pnpm --dir packages/ax-code run check:tui-locales valida cataloghi completi, segnaposto, normalizzazione NFC, ortografie condivise riviste, protezioni del sorgente dei menu principali e il rendering delle finestre native con cambiamenti di lingua live. Mantieni cataloghi rivisti separati per ogni lingua; non derivare il cinese tradizionale solo tramite conversione dei caratteri.

I cataloghi vietnamiti usano NFC. Il troncamento della visualizzazione conserva i cluster di grafemi, incluso l’input decomposto. I controlli di rendering nativo coprono terminali da 36 e 80 colonne. I terminali configurati per rendere i caratteri di larghezza ambigua come due celle richiedono una qualificazione separata specifica del terminale; il renderer corrente non espone una modalità di test per l’ampiezza ambigua.