Erster Erfolg mit der CLI

Eine kleine XLS-Anfrage auf der CPU auswerten und optional eine Offline-Job-Hülle samt Quellgrenze validieren.

Überblick

Schließen Sie zuerst Verifizierung und Installation ab. Die folgenden Befehle verwenden alti aus dem installierten Verzeichnis PREFIX/bin. Führen Sie sie als gewöhnlicher Benutzer aus, nicht als root.

Eine kleine XLS-Auswertung auf der CPU durchführen

Diese Anfrage addiert zwei 8-Bit-Werte. Sie verwendet die begrenzte native XLS-Engine, benötigt weder Google-Toolchain noch GPU oder Cloud-Sitzung und macht Überlauf im Ergebnis sichtbar.

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

Verlangen Sie Exit-Code 0 und das Engine-Ergebnis für beide Vektoren: bits[8]:0x0 und bits[8]:0x13. Dies belegt nur, dass diese Eingaben ausgewertet wurden. Für umfassendere DSLX-Sprachunterstützung verwenden Sie den separaten Google-XLS-Pfad.

Optionale Offline-Job-Vorprüfung

Der folgende Workflow liest das Aktionsmanifest und validiert eine Job-Hülle sowie eine lokale Quelldatei. Er liest keine Zugangsdaten, kontaktiert keinen Server, lädt keine Quelle hoch, reicht keine Arbeit ein und führt keine RTL-Engine aus. Sein Beleg beschreibt nur lokale Validierung; Einreichung und Serverzuständigkeit bleiben false.

1. Das ausgelieferte Aktionsmanifest untersuchen

Bash
alti commands

Ein erfolgreicher Befehl schreibt ein JSON-Array nach stdout und nichts nach stderr. Jeder Eintrag enthält name, description, inputSchema, executes und class. Die aktuelle öffentliche CLI liefert 25 Einträge. Der Wert von executes beschreibt den Dispatch-Vertrag; der Befehl kann weiterhin eine lokale Engine, Kontoberechtigung oder einen gehosteten Dienst benötigen.

2. Eine private lokale Quelle vorbereiten

Erstellen Sie einen privaten Workspace im aktuellen Arbeitsverzeichnis, das Ihrem Benutzer gehört:

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

Speichern Sie diese harmlose Quelle als $ALTI_WORKSPACE/inputs/rtl/top.sv:

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

Machen Sie die Quelle nur für ihren Eigentümer les- und schreibbar:

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

Die Vorprüfung lehnt eine Quelle ab, die außerhalb des Workspaces liegt, mehr als einmal verlinkt ist, nicht dem aktuellen Benutzer gehört oder für eine Gruppe oder andere Benutzer beschreibbar ist. Lockern Sie die Berechtigungsprüfung nicht.

Speichern Sie Folgendes als $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" }
}

Der Client ersetzt Platzhalter-URI und Digest in seiner Validierungskopie im Speicher durch die gewählte workspacerelative Quelle und den berechneten SHA-256.

3. Den Offline-Beleg erzeugen

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

Ein erfolgreiches Ergebnis ist ein JSON-Objekt auf stdout mit folgendem Vertrag:

Feld

Erforderliche Interpretation

receipt_schema

altifigence.cli.engine-job-preflight.v1

status

client_preflight_valid

submitted

Erforderlicher Wert: false

server_authority_verified

Erforderlicher Wert: false

job_schema, job_id, operation

Die Identität der lokal validierten Hülle

execution_placement

Die angeforderte Platzierung in der Hülle, kein Einreichungsnachweis

source.workspace_uri

Die normalisierte workspacerelative Quell-URI

source.sha256, source.size_bytes

Der lokal berechnete Quellnachweis

Exit-Status 0 bedeutet nur, dass diese Client-Vorprüfung bestanden wurde. Er bedeutet nicht, dass die Quelle kompiliert wurde, ein Server den Job akzeptiert hat oder Arbeit ausgeführt wurde.

Fehlerausgabe und Exit-Status

Mit --json schreibt eine fehlgeschlagene Validierung keinen Erfolgsbeleg nach stdout, sondern ein altifigence.cli.error.v1-Objekt nach stderr. Beispielsweise erzeugt fehlerhaftes Job-JSON ENGINE_JOB_JSON_INVALID mit retryable: false und beendet sich mit Status 1.

Für Manifestprüfung und Offline-Vorprüfung:

Exit-Status

Bedeutung

0

Das Manifest wurde ausgegeben oder die Offline-Client-Vorprüfung bestanden

1

Fehler im Register, bei I/O, Quellgrenzen oder Job-Validierung

2

Fehler in Befehlszeilensyntax oder Argumentverarbeitung

Andere alti-Befehle verwenden Exit-Statuswerte, die diese Tabelle nicht aufführt. 3 ist CLASS_NOT_ALLOWED; 4 kennzeichnet eine vor dem Dispatch abgelehnte Anfrage; sowohl alti whoami als auch alti login enden in diesem Release mit 4; ein Engine-gestützter Befehl reicht den eigenen Exit-Status der Engine durch, zusätzlich 126, wenn die Engine nicht gestartet werden kann, und 127, wenn sie nicht gefunden wird. Wenn Ihr Skript jemals mehr als die beiden obigen Befehle ausführt, verwenden Sie den vollständigen Vertrag in der Befehlsreferenz und behandeln Sie standardmäßig jeden Status ungleich null als Fehler.

Halten Sie stdout und stderr getrennt und prüfen Sie den Exit-Status, bevor Sie einen Beleg parsen. Verwenden Sie die Seiten für Engine- und Cloud-Befehle für explizite Ausführung oder Einreichung; beides geschieht nicht als Nebeneffekt einer Offline-Vorprüfung.

Den nächsten Schritt wählen

Bewahren Sie das CPU-Ergebnis mit zwei Vektoren als schnelle Installationsprüfung auf. Ändern Sie zur Auswertung Ihres eigenen Designs jeweils nur eine Eingabe und behalten Sie vollständige Anfrage und Ergebnis. Eine weitergehende Sprachfunktion kann den separaten Google-XLS-Pfad benötigen; ein CUDA-Lauf erfordert explizite Backend-Auswahl und ein nutzbares Gerät.

Fahren Sie für grafische RTL-Arbeit fort mit Erster RTL-Lauf in DDS. Verwenden Sie für Skripte Engine-Befehle. Melden Sie sich für entfernt gespeicherte Dateien über native Cloud-Authentifizierung an und wählen Sie die richtige Organisation und das richtige Projekt.