Fehlerbehebung

Praktische Lösungen für die Probleme, auf die Sie am wahrscheinlichsten stoßen.

Authentifizierungsfehler

Wenn ein Befehl einen Authentifizierungsfehler zurückgibt, prüfen Sie, welche Identität (falls überhaupt) die CLI auflöst:

suya auth whoami     # calls the API and prints the resolved identity
suya auth status     # local auth status, no server call

Stellen Sie für Agenten und CI sicher, dass SUBAYA_API_KEY in der Shell exportiert ist, die suya ausführt:

echo "${SUBAYA_API_KEY:?SUBAYA_API_KEY is not set}"

Denken Sie an die Priorität der Anmeldedaten: Das Flag --token gewinnt, dann SUBAYA_API_KEY, dann das lokal gespeicherte OAuth-Token. Wenn Sie sich vor langer Zeit angemeldet haben, stellt ein erneutes suya auth login das lokale Token wieder her. Siehe Authentifizierung & API-Schlüssel.

Befehle treffen den falschen Host

Jeder Befehl kommuniziert standardmäßig mit https://subaya-dev.com. Wenn Anfragen fehlschlagen oder unerwartet landen, prüfen Sie, ob Sie nicht versehentlich ein --host übergeben haben:

suya auth whoami --host https://subaya-dev.com

Überschreiben Sie --host nur, wenn Sie einen abweichenden API-Endpunkt ansteuern möchten.

`suya sim run` findet die Testbench nicht

Der --tb-Pfad wird innerhalb des --source-Baums interpretiert, nicht relativ zum Arbeitsverzeichnis Ihrer Shell. Wenn der Lauf eine fehlende Testbench meldet, überprüfen Sie, ob der Pfad innerhalb des hochgeladenen Quellverzeichnisses aufgelöst wird:

suya sim run --source . --tb tb/top_tb.sv --top top --tool ryusim

Zwei Dinge sind zu prüfen:

Der --tb-Pfad existiert unterhalb des --source-Verzeichnisses.
Der --source-Baum ist 4 MB oder kleiner — entfernen Sie Build-Artefakte und große Binärdateien, bevor Sie ihn einreichen.

Die vollständige Simulationsoberfläche finden Sie unter CLI: sim.

`suya repo connect` / `repo create` schlägt fehl

Beide repo-Befehle erfordern die Installations-ID der GitHub-App über --installation:

suya repo connect --installation <id> --owner <o> --repo <r>
suya repo create  --installation <id> --name <n>

Wenn Sie noch keine Installations-ID haben, installieren Sie zuerst die GitHub-App — siehe Ein GitHub-Repo verbinden. Bestätigen Sie den aktuellen Verbindungsstatus mit:

suya repo status

Veraltete CLI

Wenn ein Befehl oder Flag fehlt oder das Verhalten nicht mit dieser Dokumentation übereinstimmt, ist Ihre CLI möglicherweise veraltet. Prüfen und aktualisieren Sie sie:

suya version            # show version metadata
suya update --check     # report whether a newer release exists
suya update             # upgrade to the latest release

Immer noch festgefahren?

Führen Sie den Befehl erneut mit -v/--verbose für zusätzliche Diagnosen aus oder mit --json für maschinenlesbare Ausgabe.
Prüfen Sie den Dienststatus auf der Seite Status.
Durchsuchen Sie die vollständige Befehlsoberfläche in der CLI-Referenz.