Cakupan perintah CLI
Pahami bagaimana biner alti yang disertakan merutekan baris perintah, namespace yang dapat diakses dalam rilis ini, arti setiap kode keluar, dan lokasi eksekusi setiap perintah.
Gambaran umum
Halaman ini mengindeks CLI native, manifes tindakan pelanggan, dan koneksi khusus backend. Gunakan Perintah Engine untuk pekerjaan desain lokal dan Perintah Job dan Cloud untuk operasi layanan. Contoh berlaku untuk antarmuka 0.1.9.
Dua parser, satu biner
Parser native menangani release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls, dan compute. Parser ini juga menangani analyze run dan bentuk Evolve eksplisit capabilities, analyze, run, cx-search, measured-ppa, dan artifact. Perintah pelanggan lainnya menggunakan manifes tindakan bawaan. mcp serve memulai server MCP stdio.
Hal yang dikecualikan oleh perutean ini
eda inspect, reports parse, ide init, dan bentuk Evolve yang tercantum dirutekan sebagai perintah native. Ketersediaannya tidak lagi dibatasi oleh pengiriman yang terlewat pada arsip lama. Kemampuan engine tetap menentukan masukan atau operasi yang didukung.
Tindakan pelanggan satu kata evolve terpisah dari evolve run dan compute rtl-evolve native. Skema permintaannya tidak dapat dipertukarkan. Tindakan manifes satu kata trace tetap tertutupi oleh namespace trace native; gunakan subperintah native alih-alih menganggap pencantuman manifes menjamin ejaan CLI yang cocok.
Flag global
Gunakan --json di awal untuk keluaran terstruktur native, misalnya alti --json xls capabilities. Tempatkan sebelum namespace atau setelah subperintah native lengkap, bukan di antara kata-kata bentuk Evolve yang dirutekan. Gunakan alti --help untuk ringkasan tingkat atas dan --help pada operasi paling spesifik untuk argumen dan batas yang diterima. Perintah native paling spesifik juga menerima -h.
Keluaran JSON khusus untuk tiap perintah. Envelope engine memuat hasil anak sebagai string, perintah layanan mengembalikan tanda terima, dan koneksi terminal melakukan streaming byte. Lihat Referensi Perintah.
Perintah meta dan akun
Perintah | Perilaku |
|---|---|
| Cetak versi CLI |
| Cetak manifes tindakan pelanggan berisi 25 entri |
| Periksa pemasangan terautentikasi dan kemampuannya |
| Laporkan konfigurasi lingkungan tanpa memverifikasi identitas server |
| Perintah tingkat atas lama menolak identitas yang belum terverifikasi dengan status keluar |
| Perintah lama tidak dapat menghapus kredensial yang diwarisi dari proses induknya |
| Mulai alur PKCE browser native dan simpan sesi CLI pribadi |
| Minta identitas sesi saat ini dari server |
| Segarkan atau cabut sesi CLI native |
| Sajikan MCP stdio dalam mode pelanggan atau XLS lokal yang dipilih |
Sesi Cloud dan kredensial lingkungan lama berbeda. Lihat Autentikasi CLI.
Kode keluar
Anggap setiap hasil bukan nol sebagai kegagalan kecuali kontrak perintah tertentu mendefinisikan tindakan pemulihan. Parsing/penerimaan biasanya mengembalikan 2, kegagalan runtime dan HTTP 1, engine tidak tersedia 127, dan eksekusi terpasang tidak valid atau kegagalan peluncuran 126. Engine dapat meneruskan statusnya sendiri. Manifes pelanggan secara terpisah menggunakan 3 untuk penolakan kelas dan 4 untuk penolakan sebelum pengiriman. Angka status saja tidak mengidentifikasi sumbernya.
Lokasi eksekusi
Antarmuka | Eksekusi dan kewenangan |
|---|---|
| Engine native dalam paket di mesin saat ini |
| Alat Google XLS yang dipatok dan dipasang secara terpisah di mesin Linux saat ini |
| Direktori lokal yang dipilih, termasuk pemulihan dan mutasi native yang diserialkan |
| Rute API native dengan sesi bearer yang diterbitkan browser dan izin organisasi/proyek yang diperiksa server |
| Layanan HTTP DDS lama yang dipilih operator dengan kontrak rahasia layanan yang sudah ada |
| Hanya validasi sumber dan envelope secara luring |
| Layanan job Cloud yang dikonfigurasi, tunduk pada kesiapan dan izin |
MCP pelanggan default | Pengiriman melalui klien Cloud; transport stdio tidak membuat eksekusi menjadi lokal |
| Alat XLS lokal tetap, tanpa pengiriman Cloud pelanggan |
Subperintah yang memiliki –runner
Perintah kompatibilitas rtl compile, rtl synthesize, physical run, px analyze, dan isa run secara default menggunakan local. Memilih cloud atau private pada perintah tersebut mengeluarkan rencana pengiriman scaffold; ini bukan eksekusi jarak jauh. Argumen engine -- hanya diterima untuk pengiriman lokal.
Dalam kelompok job, opsi --runner memilih Job Service dan merupakan kontrak berbeda. Adapter alti-engine-job yang dihentikan tidak ada dalam inventaris rilis 24 runner; jangan menafsirkan sintaks local/private yang diterima sebagai layanan yang sudah disediakan.
Cara engine lokal ditemukan
Pertahankan keutuhan rilis yang terpasang. XLS, compute, RTL terkemas, DDS native, dan jalur PX/CX bertipe memerlukan executable pendamping yang dinamai. Pemeriksaan kepercayaan pemasangan mengikat runner yang dilindungi ke hash katalog dan tanda terima; fallback PATH atau tanda terima yang diberikan pengguna tidak memperbaiki batas tersebut. Resolver kompatibilitas lama dapat melaporkan sibling atau path; periksa tanda terima untuk operasi yang benar-benar Anda jalankan. Alat eksternal seperti Icarus memiliki konfigurasi host terpisah.
Engine pendukung setiap namespace
Payload memuat alti, alti-mcp, dan 24 runner engine berikut:
Perintah | Engine dalam paket |
|---|---|
RTL, analisis, SV, verifikasi |
|
ISA, Evolve |
|
Fisik, PX |
|
Trace, Labs |
|
Tcl, EIDB, EDA, laporan |
|
XLS dan compute |
|
DDS native |
|
alti-rtl-runner tidak disertakan dalam paket. Perintah kompatibilitas identitas commit yang memintanya tidak mendapatkan dukungan hanya karena bantuannya ada. Executable desktop yang digunakan oleh ide open didistribusikan secara terpisah.
Envelope tanda terima
Skema atau keluaran | Interpretasi |
|---|---|
| Dengan |
| Validasi luring; |
| Hasil evaluasi Tcl terpasang yang terbatas |
| Status peluncuran proses desktop, bukan bukti proyek selesai dimuat |
| Status HTTP layanan lama dan isi respons terbatas |
| Status penyelesaian pemasang/pencopot dengan diagnostik helper di stderr |
Stdout terminal Cloud | Byte terminal yang dialirkan, bukan satu tanda terima JSON |
Field stdout pada envelope engine adalah string yang memuat hasil native. Tanpa --json, keluaran native tersebut dapat langsung disimpan dan diberikan secara utuh ke perintah apply DDS yang cocok. Jangan pernah menyederhanakan rencana pembuatan menjadi hash saja.
Variabel lingkungan
Variabel | Cakupan |
|---|---|
| Kredensial klien tindakan/job pelanggan lama dan cakupan organisasi |
| Override origin API lama; default |
| Pemilihan jenis principal lama; bukan izin untuk mengeksekusi |
| Persetujuan unggah sumber untuk tindakan MCP pelanggan |
|
|
| Origin layanan DDS lama yang eksplisit; Cloud native menggunakan argumen endpoint/sesi sendiri |
| Autentikasi layanan lama yang sudah ada; bukan sesi bearer Cloud native |
| Lokasi alat Icarus eksternal yang dikelola host untuk evaluator RTL native |
Cloud native menggunakan --session-dir, dengan default ~/.local/state/altifigence/cloud-cli. Jangan menyalin berkas sesi desktop ke dalamnya, mencatat token di log, atau mengirim rahasia layanan ke endpoint sembarang.
Hasil engine
Baca hasil engine yang sebenarnya dan batasannya. Penelusuran GPU bukan eksekusi GPU, digest isi bukan tanda tangan, dan estimasi timing non-signoff bukan signoff implementasi. Halaman berikutnya mencantumkan perintah engine.
Tentukan perintah sebelum membuat skrip
alti --version
alti --help
alti ide cloud --help
alti xls run --help
Periksa bantuan pada operasi paling spesifik yang ingin Anda panggil. Nama yang cocok dalam alti commands tidak menggantikan bantuan parser native, kemampuan terpasang, atau ketersediaan runtime. Simpan versi CLI bersama skrip karena skema permintaan dan tanda terima memiliki versi.