CLI 首次成功執行

在 CPU 上評估小型 XLS 請求,再視需要驗證離線作業封套與原始碼邊界。

概觀

請先完成 驗證 和 安裝。以下指令使用 alti,它位於已安裝的 PREFIX/bin。請以一般使用者執行,不要使用 root。

執行小型 CPU XLS 評估

此請求將兩個 8 位元值相加。它使用有界的原生 XLS 引擎,不需要 Google 工具鏈、GPU 或 Cloud 工作階段,並在結果中呈現溢位。

Bash
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. 檢查隨附的動作資訊清單

Bash
alti commands

成功的指令會將一個 JSON 陣列寫入 stdout,且不向 stderr 寫入任何內容。每個項目包含 name、description、inputSchema、executes,以及 class。目前公開 CLI 傳回 25 個項目。executes 的值描述派送契約;指令仍可能需要本機引擎、帳戶權限或代管服務。

2. 準備私有本機原始碼

在目前由使用者擁有的工作目錄中建立私有工作區:

Bash
ALTI_WORKSPACE="$(mktemp -d -p "$PWD" alti-first-success.XXXXXX)"
mkdir -p "$ALTI_WORKSPACE/inputs/rtl"

將此無害原始碼儲存為 $ALTI_WORKSPACE/inputs/rtl/top.sv:

SystemVerilog
module top(input logic clock, output logic value);
    always_ff @(posedge clock) value <= ~value;
endmodule

讓原始碼僅可由其擁有者讀寫:

Bash
chmod 600 "$ALTI_WORKSPACE/inputs/rtl/top.sv"

預檢會拒絕位於工作區外、具有多個硬連結、不由目前使用者擁有,或群組及其他使用者可寫入的原始碼。請勿放寬權限檢查。

將以下內容儲存為 $ALTI_WORKSPACE/job.json:

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. 產生離線回執

Bash
alti --json job validate \
  --job "$ALTI_WORKSPACE/job.json" \
  --workspace-root "$ALTI_WORKSPACE" \
  --source rtl/top.sv

成功結果是 stdout 上的一個 JSON 物件,具有以下契約:

欄位

必要解讀

receipt_schema

altifigence.cli.engine-job-preflight.v1

status

client_preflight_valid

submitted

必須是 false

server_authority_verified

必須是 false

job_schema、job_id、operation

本機驗證的封套識別資料

execution_placement

封套中的請求配置,不是提交證據

source.workspace_uri

正規化的工作區相對原始碼 URI

source.sha256、source.size_bytes

本機計算的原始碼證據

結束狀態 0 只表示此用戶端預檢通過。它不表示原始碼已編譯、伺服器已接受作業,或任何工作已執行。

失敗輸出與結束狀態

使用 --json 時,驗證失敗不會向 stdout 寫入成功回執,而會向 stderr 寫入一個 altifigence.cli.error.v1 物件。例如,格式錯誤的作業 JSON 會產生 ENGINE_JOB_JSON_INVALID,其中 retryable: false,並以狀態 1 結束。

對資訊清單檢查與離線預檢:

結束狀態

意義

0

資訊清單已輸出,或離線用戶端預檢通過

1

登錄、I/O、原始碼邊界或作業驗證失敗

2

指令列語法或引數解析失敗

其他 alti 指令使用本表未列出的結束狀態。3 是 CLASS_NOT_ALLOWED;4 表示請求在派送前遭拒,且 alti whoami 和 alti login 在此版本皆以 4 結束;引擎支援的指令會原樣傳遞引擎本身的結束狀態,另外在引擎無法啟動時使用 126,找不到引擎時使用 127。如果腳本會執行上述兩個指令以外的指令,請使用 指令參考 中的完整契約,並預設將每個非零狀態視為失敗。

將 stdout 與 stderr 分開保留,並在解析回執前檢查結束狀態。明確執行或提交請使用引擎與 Cloud 指令頁面;離線預檢不會附帶執行其中任何一項。

選擇下一步

將雙向量 CPU 結果保留作為快速安裝檢查。評估自己的設計時,一次變更一個輸入,並保留完整請求與結果。更大型的語言功能可能需要獨立的 Google XLS 路徑;CUDA 執行需要明確選擇後端與可用裝置。

圖形介面的 RTL 工作請繼續閱讀 DDS 首次 RTL 執行。腳本請使用 引擎指令。遠端已儲存檔案請透過 原生 Cloud 驗證 登入,並選擇正確的組織/專案。