CLI 命令介面 — Altifigence Documentation

了解已發行的 alti 二進位檔如何路由命令列、本次發行可使用的命名空間、各結束碼的意義，以及每個命令實際執行的位置。

概觀

本頁索引原生 CLI、客戶動作資訊清單及依後端區分的連線。本機設計工作請使用引擎命令，服務操作請使用作業與 Cloud 命令。範例適用於 0.1.9 介面。

兩個解析器，一個二進位檔

原生解析器處理 release, capabilities, rtl, sv, verification, trace, labs, tcl, eidb, eda, reports, physical, px, isa, ide, job, xls 及 compute。它也處理 analyze run 及明確的 Evolve 形式 capabilities, analyze, run, cx-search, measured-ppa 及 artifact。其餘客戶命令使用內嵌動作資訊清單。mcp serve 會啟動 stdio MCP 伺服器。

此路由排除的情況

eda inspect, reports parse, ide init 及所列 Evolve 形式都是由原生路由處理的命令。其可用性不再受較舊封存檔漏掉分派的問題限制。引擎能力仍決定支援哪些輸入或操作。

單字客戶動作 evolve 與原生 evolve run 及 compute rtl-evolve 不同。它們的要求結構描述不可互換。資訊清單的單字 trace 動作仍被原生 trace 命名空間遮蔽；請使用原生子命令，不要假設資訊清單列出動作就保證有相符的 CLI 拼法。

全域旗標

使用前置 --json 取得原生結構化輸出，例如 alti --json xls capabilities。將它放在命名空間前，或完整原生子命令後，不要插入已路由 Evolve 形式的字詞之間。使用 alti --help 取得頂層摘要，並在末端操作上使用 --help 查看接受的引數及限制。原生末端命令也接受 -h.

JSON 輸出依命令而異。引擎封套將子程序結果存為字串，服務命令傳回回條，終端機連接則串流位元組。請參閱命令參考.

中繼與帳戶命令

命令	行為
`alti` `version`, `alti` `--version`	列印 CLI 版本
`alti` `commands`	列印含 25 項目的客戶動作資訊清單
`alti` `capabilities`	檢查已驗證安裝及其能力
`alti` `auth` `status`	回報環境設定，但不驗證伺服器身分
`alti` `login`, `alti` `whoami`	舊頂層命令以結束碼拒絕未驗證身分：`4`
`alti` `logout`	舊命令無法移除從父程序繼承的認證
`alti` `ide` `cloud` `login`	啟動原生瀏覽器 PKCE 流程並儲存私有 CLI 工作階段
`alti` `ide` `cloud` `whoami`	向伺服器查詢目前工作階段身分
`alti` `ide` `cloud` `refresh`, `alti` `ide` `cloud` `logout`	更新或撤銷原生 CLI 工作階段
`alti` `mcp` `serve`	在所選客戶或本機 XLS 模式提供 stdio MCP

Cloud 工作階段與舊環境認證不同。請參閱 CLI 驗證.

結束碼

除非特定命令契約定義復原動作，否則每個非零結果都視為失敗。解析／准入通常傳回 2，執行階段及 HTTP 失敗傳回 1，不可用引擎傳回 127，無效的已安裝執行或啟動失敗傳回 126。引擎可直接傳遞自身狀態。客戶資訊清單另以 3 表示類別拒絕，並以 4 表示分派前拒絕。狀態數字本身無法識別來源。

各項操作執行位置

介面	執行與權限
`xls`, `compute`、具型別的本機引擎命令	目前電腦上的封裝原生引擎
`xls` `upstream`	目前 Linux 電腦上另外安裝且固定版本的 Google XLS 工具
`ide` `workspace`	所選本機目錄，包含復原與序列化原生變更
`ide` `cloud`	原生 API 路由，使用瀏覽器發出的 bearer 工作階段及伺服器檢查的組織／專案權限
`ide` `service`	操作者選擇的舊 DDS HTTP 服務，使用其既有服務機密契約
`job` `validate`	僅限離線來源及封套驗證
`job` `...` `--runner` `cloud`, `analyze` `run`	設定的 Cloud 作業服務，受就緒狀態與權限限制
預設客戶 MCP	Cloud 用戶端分派；stdio 傳輸不代表在本機執行
`ALTI_MCP_MODE=local-xls` MCP	固定的本機 XLS 工具，不經客戶 Cloud 分派

哪些子命令使用 –runner

相容性命令 rtl compile, rtl synthesize, physical run, px analyze 及 isa run 預設為 local。在這些命令上選擇 cloud 或 private 會輸出鷹架分派計畫，不是遠端執行。其 -- 引擎引數只接受本機分派。

命令系列 job 的 --runner 用於選擇 Job Service，是不同契約。已退役的 alti-engine-job 配接器不在含 24 個執行器的發行清單中；不要把可接受的 local/private 語法解讀為已交付服務。

如何尋找本機引擎

請保持已安裝發行版本完整。XLS、compute、packed RTL、native DDS 及具型別的 PX／CX 路徑需要指定的同層執行檔。已安裝信任檢查將受保護執行器繫結至目錄雜湊及回條；沒有 PATH 備援或使用者提供的回條能修復此界線。較舊相容性解析器可能回報 sibling 或 path；請檢查您實際執行操作的回條。Icarus 等外部工具另有主機設定。

各命名空間使用的引擎

酬載包含 alti, alti-mcp 及以下 24 個引擎執行器：

命令	封裝引擎
RTL、分析、SV、驗證	`alti-rtlc`, `alti-rtl`, `alti-rtl-analyze`, `alti-sv-frontend`, `alti-sv-immediate-review`, `alti-sv-interprocess-review`, `alti-golden-diff`
ISA、Evolve	`alti-cx`, `alti-evolve`
實體設計、PX	`alti-physical-runner`, `alti-px-runner`, `alti-px-sta-graph-check`
Trace、Labs	`alti-trace`, `alti-lab`
Tcl、EIDB、EDA、報告	`alti-tcl`, `alti-tcl-local-runner`, `alti-eidb-local-runner`, `alti-eda-artifact-inspect`, `alti-reports`
XLS 與 compute	`alti-xls`, `alti-compute`, `alti-packed-cuda`, `alti-rtl-cuda`
原生 DDS	`alti-ide-workspace`

alti-rtl-runner 未封裝。要求它的已提交身分相容性命令，不會只因有說明就獲得支援。ide open 使用的桌面執行檔另外散布。

回條封套

結構描述或輸出	解讀方式
`altifigence.local-engine-execution.v1`	使用 `--json` 時，包含命令、執行檔、解析方式、狀態、`exitCode` 及擷取的引擎串流
`altifigence.cli.engine-job-preflight.v1`	離線驗證；`submitted` 及 `server_authority_verified` 仍為 false
`altifigence.cli.tcl-evaluation.v1`	有範圍限制的已安裝 Tcl 求值結果
`altifigence.ide-launcher-receipt.v1`	桌面程序啟動狀態，不證明專案已完成載入
`altifigence.dds.service-receipt.v1`	舊服務 HTTP 狀態及有大小限制的回應內文
`altifigence.cli.release-bootstrap.v1`	安裝／解除安裝完成狀態；輔助診斷在 stderr
Cloud 終端機 stdout	串流終端機位元組，不是單一 JSON 回條

引擎封套的 stdout 是包含原生結果的字串。不使用 --json 時，可直接儲存原生輸出，並完整傳入相符的 DDS apply 命令。絕不要只留下編寫計畫的雜湊。

環境變數

變數	範圍
`ALTI_TOKEN`, `ALTI_ORG_ID`	舊客戶動作／作業用戶端認證及組織範圍
`ALTI_API_BASE`	舊 API 來源覆寫；預設為 `https://api.altifigence.com`
`ALTI_BYO`	舊主體種類選擇；不是執行許可
`ALTI_ALLOW_SOURCE_UPLOAD`	客戶 MCP 動作的來源上傳同意
`ALTI_MCP_MODE`	`customer` 為預設，或明確使用 `local-xls`
`ALTI_STUDIO_ENDPOINT`	明確的舊 DDS 服務來源；原生 Cloud 使用自己的端點／工作階段引數
`ALTI_STUDIO_SERVICE_SECRET`	現有舊服務驗證；不是原生 Cloud bearer 工作階段
`ALTIF_RTL_IVERILOG`, `ALTIF_RTL_VVP`	原生 RTL 求值器使用的主機擁有外部 Icarus 工具位置

原生 Cloud 使用 --session-dir，預設為 ~/.local/state/altifigence/cloud-cli。不要將桌面工作階段檔案複製至此、記錄權杖，或將服務機密傳送至任意端點。

引擎結果

請閱讀實際引擎結果及其限制。GPU 探索不等於 GPU 執行，內容摘要不等於簽章，非簽核時序估計不等於實作簽核。下一頁列出相關的引擎命令.

撰寫指令碼前先確認命令

alti --version
alti --help
alti ide cloud --help
alti xls run --help

檢查您打算呼叫的精確末端命令說明。alti commands 中的相符名稱，不能取代原生解析器說明、已安裝能力或執行階段可用性。請在指令碼中記錄 CLI 版本，因為要求結構描述與回條都有版本。