CLI 首次成功執行
在 CPU 上評估小型 XLS 請求,再視需要驗證離線作業封套與原始碼邊界。
概觀
請先完成 驗證 和 安裝。以下指令使用 alti,它位於已安裝的 PREFIX/bin。請以一般使用者執行,不要使用 root。
執行小型 CPU XLS 評估
此請求將兩個 8 位元值相加。它使用有界的原生 XLS 引擎,不需要 Google 工具鏈、GPU 或 Cloud 工作階段,並在結果中呈現溢位。
alti capabilities
alti xls eval --request - <<'JSON'
{
"schema": "altifigence.xls.operation-request.v1",
"operation": "eval",
"input_kind": "xls-ir",
"source": "package demo\ntop fn compute(x: bits[8], y: bits[8]) -> bits[8] { ret sum: bits[8] = add(x, y) }",
"top": "compute",
"backend": "cpu",
"vectors": [["255", "1"], ["0x10", "0b11"]]
}
JSON
確認結束代碼為 0,且兩個向量皆有引擎結果:bits[8]:0x0 和 bits[8]:0x13。這只能證明這些輸入已被評估。若需要更廣的 DSLX 語言支援,請使用獨立的 Google XLS 路徑。
選用的離線作業預檢
以下工作流程會讀取動作資訊清單,並驗證作業封套與一個本機原始碼檔案。它不讀取憑證、不聯絡伺服器、不上傳原始碼、不提交工作,也不執行 RTL 引擎。其回執只描述本機驗證;提交與伺服器權威狀態仍為 false。
1. 檢查隨附的動作資訊清單
alti commands
成功的指令會將一個 JSON 陣列寫入 stdout,且不向 stderr 寫入任何內容。每個項目包含 name、description、inputSchema、executes,以及 class。目前公開 CLI 傳回 25 個項目。executes 的值描述派送契約;指令仍可能需要本機引擎、帳戶權限或代管服務。
2. 準備私有本機原始碼
在目前由使用者擁有的工作目錄中建立私有工作區:
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"
將此無害原始碼儲存為 $ALTI_WORKSPACE/inputs/rtl/top.sv:
module top(input logic clock, output logic value);
always_ff @(posedge clock) value <= ~value;
endmodule
讓原始碼僅可由其擁有者讀寫:
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"
預檢會拒絕位於工作區外、具有多個硬連結、不由目前使用者擁有,或群組及其他使用者可寫入的原始碼。請勿放寬權限檢查。
將以下內容儲存為 $ALTI_WORKSPACE/job.json:
{
"schema": "altifigence.engine.job.v1",
"job_id": "offline-job-1",
"operation": {
"engine_id": "rtl-engine",
"operation_id": "analyze",
"contract_id": "rtl-analysis-request.v1"
},
"execution_placement": "cloud",
"device_preference": {
"selection": { "mode": "class", "value": "cpu" },
"fallback": "deny"
},
"resources": {
"cpu_slots": 1,
"memory_bytes": 536870912,
"device_slots": 0,
"device_memory_bytes": 0,
"max_wall_time_ms": 30000
},
"inputs": [
{
"artifact_id": "rtl-source-bundle",
"role": "source_bundle",
"artifact_schema": "rtl-source-bundle.v1",
"uri": "workspace://inputs/placeholder",
"sha256": "0000000000000000000000000000000000000000000000000000000000000000"
}
],
"cancellation": { "cancellation_id": "cancel-offline-job-1" }
}
用戶端會在記憶體中的驗證副本,將佔位 URI 與摘要取代為選取的工作區相對原始碼及計算出的 SHA-256。
3. 產生離線回執
alti --json job validate \
--job "$ALTI_WORKSPACE/job.json" \
--workspace-root "$ALTI_WORKSPACE" \
--source rtl/top.sv
成功結果是 stdout 上的一個 JSON 物件,具有以下契約:
欄位 | 必要解讀 |
|---|---|
|
|
|
|
| 必須是 |
| 必須是 |
| 本機驗證的封套識別資料 |
| 封套中的請求配置,不是提交證據 |
| 正規化的工作區相對原始碼 URI |
| 本機計算的原始碼證據 |
結束狀態 0 只表示此用戶端預檢通過。它不表示原始碼已編譯、伺服器已接受作業,或任何工作已執行。
失敗輸出與結束狀態
使用 --json 時,驗證失敗不會向 stdout 寫入成功回執,而會向 stderr 寫入一個 altifigence.cli.error.v1 物件。例如,格式錯誤的作業 JSON 會產生 ENGINE_JOB_JSON_INVALID,其中 retryable: false,並以狀態 1 結束。
對資訊清單檢查與離線預檢:
結束狀態 | 意義 |
|---|---|
| 資訊清單已輸出,或離線用戶端預檢通過 |
| 登錄、I/O、原始碼邊界或作業驗證失敗 |
| 指令列語法或引數解析失敗 |
其他 alti 指令使用本表未列出的結束狀態。3 是 CLASS_NOT_ALLOWED;4 表示請求在派送前遭拒,且 alti whoami 和 alti login 在此版本皆以 4 結束;引擎支援的指令會原樣傳遞引擎本身的結束狀態,另外在引擎無法啟動時使用 126,找不到引擎時使用 127。如果腳本會執行上述兩個指令以外的指令,請使用 指令參考 中的完整契約,並預設將每個非零狀態視為失敗。
將 stdout 與 stderr 分開保留,並在解析回執前檢查結束狀態。明確執行或提交請使用引擎與 Cloud 指令頁面;離線預檢不會附帶執行其中任何一項。
選擇下一步
將雙向量 CPU 結果保留作為快速安裝檢查。評估自己的設計時,一次變更一個輸入,並保留完整請求與結果。更大型的語言功能可能需要獨立的 Google XLS 路徑;CUDA 執行需要明確選擇後端與可用裝置。
圖形介面的 RTL 工作請繼續閱讀 DDS 首次 RTL 執行。腳本請使用 引擎指令。遠端已儲存檔案請透過 原生 Cloud 驗證 登入,並選擇正確的組織/專案。