Comandi disponibili nella CLI
Comprendi come il binario alti distribuito instrada una riga di comando, quali namespace sono raggiungibili in questo rilascio, cosa significa ogni codice di uscita e dove viene eseguito ogni comando.
Panoramica
Questa pagina indicizza CLI nativa, manifest delle azioni cliente e connessioni specifiche dei backend. Usa Comandi Engine per lavorare sul progetto locale e Comandi job e Cloud per le operazioni dei servizi. Gli esempi si applicano all'interfaccia 0.1.9.
Due parser, un solo binario
Il parser nativo gestisce release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls, e compute. Gestisce anche analyze run e le forme Evolve esplicite capabilities, analyze, run, cx-search, measured-ppa, e artifact. Gli altri comandi cliente usano il manifest delle azioni incorporato. mcp serve avvia il server MCP stdio.
Cosa esclude questo instradamento
eda inspect, reports parse, ide init, e le forme Evolve elencate sono comandi instradati nativamente. La loro disponibilità non è più limitata dalle omissioni di dispatch del vecchio archivio. Le capacità dell'Engine determinano comunque quali input o operazioni sono supportati.
L'azione cliente di una sola parola evolve è separata da quella nativa evolve run e compute rtl-evolve. I loro schemi di richiesta non sono intercambiabili. L'azione di una sola parola trace del manifest resta mascherata dal namespace nativo trace; usa i sottocomandi nativi invece di presumere che l'enumerazione del manifest garantisca una grafia CLI corrispondente.
Flag globali
Usa --json all'inizio per output strutturato nativo, per esempio alti --json xls capabilities. Posizionalo prima del namespace o dopo il sottocomando nativo completo, non tra le parole di una forma Evolve instradata. Usa alti --help per il riepilogo generale e --help sull'operazione foglia per argomenti accettati e limiti. I comandi foglia nativi accettano anche -h.
L'output JSON è specifico del comando. Gli envelope dell'Engine contengono il risultato del figlio come stringa, i comandi dei servizi restituiscono ricevute e i collegamenti ai terminali trasmettono byte. Consulta Riferimento dei comandi.
Comandi meta e account
Comando | Comportamento |
|---|---|
| Mostra la versione della CLI |
| Mostra il manifest delle 25 azioni cliente |
| Ispeziona l'installazione autenticata e le sue capacità |
| Riporta la configurazione dell'ambiente senza verificare l'identità del server |
| I comandi legacy di primo livello rifiutano l'identità non verificata con uscita |
| Il comando legacy non può rimuovere credenziali ereditate dal processo padre |
| Avvia il flusso PKCE nativo nel browser e archivia una sessione CLI privata |
| Chiede al server l'identità della sessione corrente |
| Aggiorna o revoca la sessione CLI nativa |
| Fornisce MCP stdio nella modalità cliente o XLS locale selezionata |
Sessioni Cloud e credenziali legacy dell'ambiente sono distinte. Consulta Autenticazione CLI.
Codici di uscita
Tratta ogni risultato non nullo come errore, a meno che il contratto del comando specifico definisca un'azione di recupero. Parsing/ammissione restituiscono comunemente 2, errori runtime e HTTP 1, engine indisponibili 127, ed esecuzione installata non valida o errori di avvio 126. Gli engine possono propagare i propri stati. Il manifest cliente usa separatamente 3 per un rifiuto di classe e 4 per un rifiuto prima del dispatch. Un numero di stato da solo non ne identifica l'origine.
Dove viene eseguito cosa
Superficie | Esecuzione e autorità |
|---|---|
| Engine nativi inclusi nel pacchetto sulla macchina corrente |
| Strumenti Google XLS installati separatamente e vincolati sulla macchina Linux corrente |
| La directory locale selezionata, compresi recupero e mutazioni native serializzate |
| Route API native con sessione bearer emessa dal browser e permessi di organizzazione/progetto verificati dal server |
| Un servizio HTTP DDS legacy selezionato dall'operatore con il contratto esistente del segreto di servizio |
| Solo validazione offline di sorgenti ed envelope |
| Il servizio job Cloud configurato, soggetto a disponibilità e permessi |
MCP cliente predefinito | Dispatch del client Cloud; il trasporto stdio non rende locale l'esecuzione |
| Strumenti XLS locali fissi, senza dispatch Cloud cliente |
Quali sottocomandi usano –runner
I comandi di compatibilità rtl compile, rtl synthesize, physical run, px analyze, e isa run usano per impostazione predefinita local. Selezionare cloud o private su questi comandi emette un piano di dispatch preliminare; non è esecuzione remota. I loro argomenti engine -- sono accettati solo per il dispatch locale.
La famiglia job usa --runner per selezionare un Job Service, con un contratto diverso. L’adattatore ritirato alti-engine-job non è nell'inventario del rilascio dei 24 runner; non interpretare la sintassi accettata local/private come un servizio consegnato.
Come viene individuato un engine locale
Mantieni integro il rilascio installato. XLS, compute, RTL impacchettato, DDS nativo e percorsi PX/CX tipizzati richiedono l'eseguibile fratello indicato. La verifica di fiducia dell'installazione lega i runner protetti agli hash del catalogo e alle ricevute; nessun fallback PATH o ricevuta fornita dall'utente può ripristinare quel confine. I vecchi resolver di compatibilità possono riportare sibling o path; ispeziona la ricevuta dell'operazione effettivamente eseguita.
Quale engine serve ciascun namespace
Il payload contiene alti, alti-mcp, e questi 24 runner engine:
Comandi | Engine inclusi nel pacchetto |
|---|---|
RTL, analisi, SV, verifica |
|
ISA, Evolve |
|
Fisico, PX |
|
Trace, Labs |
|
Tcl, EIDB, EDA, report |
|
XLS e compute |
|
DDS nativo |
|
alti-rtl-runner non è incluso nel pacchetto. I comandi di compatibilità con identità confermata che lo richiedono non diventano supportati solo perché hanno un help. L'eseguibile desktop usato da ide open è distribuito separatamente.
Envelope delle ricevute
Schema o output | Interpretazione |
|---|---|
| Con |
| Validazione offline; |
| Risultato della valutazione Tcl installata con limiti definiti |
| Stato di avvio del processo desktop, non prova del completamento del caricamento di un progetto |
| Stato HTTP del servizio legacy e corpo della risposta con limiti definiti |
| Stato di completamento dell'installer/uninstaller con diagnostica dell'helper su stderr |
stdout del terminale Cloud | Byte del terminale in streaming, non una singola ricevuta JSON |
Il campo stdout di un envelope engine è una stringa contenente il risultato nativo. Senza --json, l'output nativo può essere salvato direttamente e passato integro a un comando DDS apply corrispondente. Non ridurre mai un piano di creazione al solo hash.
Variabili d'ambiente
Variabile | Ambito |
|---|---|
| Credenziali del client legacy per azioni/job cliente e ambito dell'organizzazione |
| Override dell'origine API legacy; valore predefinito |
| Selezione legacy del tipo di principal; non è un permesso di esecuzione |
| Consenso al caricamento dei sorgenti per azioni MCP cliente |
|
|
| Origine esplicita del servizio DDS legacy; Cloud nativo usa argomenti propri per endpoint/sessione |
| Autenticazione esistente del servizio legacy; non è una sessione bearer Cloud nativa |
| Posizioni degli strumenti Icarus esterni di proprietà dell'host per il valutatore RTL nativo |
Cloud nativo usa --session-dir, con valore predefinito ~/.local/state/altifigence/cloud-cli. Non copiarvi file di sessione desktop, non registrare token nei log né inviare segreti di servizio a endpoint arbitrari.
Risultati dell'Engine
Leggi il risultato effettivo dell'Engine e i suoi limiti. Il rilevamento della GPU non è esecuzione su GPU, un digest del contenuto non è una firma e una stima temporale senza signoff non è un'approvazione finale dell'implementazione. La pagina successiva elenca i comandi engine.
Risolvere un comando prima di usarlo negli script
alti --version
alti --help
alti ide cloud --help
alti xls run --help
Verifica l'help sull'esatta operazione foglia che intendi invocare. Un nome corrispondente in alti commands non sostituisce l'help del parser nativo, le capacità installate o la disponibilità runtime. Conserva la versione CLI con gli script, poiché schemi delle richieste e ricevute sono versionati.