CLI-Befehlsreferenz
Für das veröffentlichte @evolinkai/cli 0.14.1. Verwenden Sie evolink —help oder evolink COMMAND —help —json für Ihre installierte Version. Die fachlichen Befehle unterstützen —json. Ersetzen Sie MODEL_ID, QUOTE_ID, TASK_ID und UPLOAD_ID durch die tatsächlich zurückgegebenen Werte.Authentifizierung, Diagnose und Skills
Siehe Installation.
Agent-Werte: all/codex/claude-code/cursor/gemini/opencode/copilot/openclaw/hermes; Standard all. Der Assistent muss die Skill-Erkennung weiterhin prüfen.
Die Ausgabe von
setup, doctor und auth login enthält update (status, update_available, latest_version, command); andere Befehle geben höchstens einmal am Tag einen Hinweis auf stderr aus, wenn eine neuere Version existiert. Setzen Sie EVOLINK_CLI_UPDATE_CHECK=0, um die Prüfungen auszuschalten; siehe So erfahren Sie von einer neuen Version.
Modelle, Eingaben und Dokumentation
Die Dokumentationssuche nutzt den mitgelieferten Index der offiziellen Modellreferenzen, kein Live-Crawling der Website. Die Empfehlung beruht auf dokumentierten Eingaben, Stichwörtern und redaktionellen Präferenzen der Plattform, nicht auf einer Beliebtheitsrangliste. Preise pro Einheit sind keine Preisangebote für einen Auftrag.
Preisangebote und Generierung
Erstellen Sie input.json mit den echten Parametern des Modells und holen Sie dann ein kostenloses Preisangebot ein:
Ein erfolgreiches Preisangebot liefert quote_id, gilt 24 Stunden ab der Kostenschätzung (
expires_at) und ist an Anmeldung, Backend, Modell und die genauen Eingaben gebunden. Die Generierung liest die Preisregeln vor dem Absenden erneut: Dieselbe Eingabe wird abgesendet, wenn ihr Preis dem genehmigten Preis entspricht oder darunter liegt, auch unter später geänderten Regeln; ein höherer Preis schlägt mit price_changed fehl, eine geänderte Eingabe mit quote_input_changed und ein abgelaufenes Preisangebot mit quote_expired. In diesen Fällen wird nichts gesendet, und es sind ein neues Preisangebot und eine neue Zustimmung nötig. Fehlgeschlagene oder wegen der Obergrenze abgelehnte Kostenschätzungen sind keine verwendbaren Preisangebote. Eine Kostenschätzung, der abrechnungsrelevante Nutzung fehlt, schlägt fehl, nennt jeden fehlenden Wert und die Option, mit der er angegeben wird, und speichert kein Preisangebot. Zeigen Sie Spezifikationen, Kostenspanne und Warnungen, warten Sie auf die ausdrückliche Zustimmung und wählen Sie dann den passenden Befehl:
quote_superseded fehl; der Fehler nennt das aktuelle Preisangebot oder dessen Auftrag. Ein Preisangebot, dessen Absenden bereits begonnen hat, lässt sich nicht aktualisieren (submission_already_started); nehmen Sie stattdessen dessen Auftrag wieder auf. Eine Aktualisierung, die läuft, während eine andere dasselbe Preisangebot ersetzt, liefert quote_refresh_conflict.
Ein Preisangebot aus --inputs-file deckt den gesamten Batch ab: generate --quote QUOTE_ID --confirm sendet alle Eingaben auf einmal ab (bis zu 10 gleichzeitig) und liefert für jede Eingabe die Auftragskennung oder den Fehler, ohne zu warten; --wait ist für einen einzelnen Auftrag gedacht. Holen Sie die Ergebnisse mit tasks batch --ids ab.
Nur wenn der Benutzer ausdrücklich gesagt hat, dass nicht geschätzt oder bestätigt werden soll:
--skip-estimate sendet ohne Preisangebot ab, auch mit --inputs-file: Der Preis wird nicht geprüft, der Auftrag wird nach tatsächlicher Nutzung abgerechnet, und das Ergebnis weist darauf hin (estimate_skipped). Ungültige Eingaben werden weiterhin abgelehnt, und ein ausdrückliches --max-cost-usd gilt weiterhin: Eine Anfrage, die darüber liegt oder deren Preis sich nicht dagegen prüfen lässt, wird nicht abgesendet. --skip-estimate lässt sich nicht mit --quote oder --confirm kombinieren. Der Befehl speichert einen Datensatz mit eigener Anfragekennung und liefert eine quote_id für tasks resume.
—wait wartet auf den vorhandenen Auftrag. Timeout 1–86400 Sekunden, Standard 1800. Zeitüberschreitung oder Ctrl-C brechen den Auftrag auf dem Server nicht ab. Der Timeout umfasst jeden Lesevorgang, jede Wiederholung und jede Pause; ist die Grenze erreicht, meldet wait_timeout den letzten verifizierten Status und dessen read_at oder status_check: unverified, wenn der neueste Status nicht gelesen werden konnte. Vollständige Kostenschätzungen verwenden für die Prüfung beim Absenden standardmäßig den Höchstwert ihres Preisangebots. Siehe Grenzen des Budgets.
Aufträge, Batches und Wiederaufnahme
Die Zeitfilterung wirkt nur auf die ausgewählte Seite. Der Verlauf umfasst das Konto, nicht nur diesen Chat. Eine leere Seite kann nicht beweisen, dass nichts abgesendet wurde; total wird vor der lokalen Zeitfilterung ermittelt. Batch-Kennungen sind 1–50 durch Kommas getrennte Werte.
Mit einer Auftragskennung verwenden Sie get/wait. Bei einer verlorenen Antwort auf das Absenden setzen Sie das ursprüngliche Preisangebot mit seiner Anfragekennung und Anmeldung fort. Bei einem Batch sendet
tasks resume --quote QUOTE_ID die Eingaben nach, die nicht abgesendet wurden; angenommene Eingaben liefern ihre ursprünglichen Aufträge ohne erneute Abbuchung zurück. tasks resume wiederholt die Anfrage mit derselben Anfragekennung nur innerhalb von 23 Stunden nach dem ersten Absenden (EvoLink bewahrt die Kennung 24 Stunden auf); danach lehnt der Befehl mit recovery_window_passed ab. Er folgt auch der Regel für Preisangebote: Bei abgelaufenem Preisangebot (quote_expired) oder höherem Preis (price_changed) wird nichts gesendet. Prüfen Sie in jedem dieser Fälle mit tasks batch oder tasks list, was durchgegangen ist, und schätzen Sie nur den Rest als neue Generierung oder neuen Batch. Sind Datensätze verloren oder abgelaufen oder wurde das Konto gewechselt, prüfen Sie Verlauf und Konsole, bevor Sie eine weitere kostenpflichtige Anfrage stellen. Die CLI hat keinen Befehl zum Abbrechen.
Guthaben und Auftragsnutzung
Uploads und Download der Originale
JSON, Exit-Codes und Konfiguration
—json schreibt eine JSON-Zeile mit schema_version:1 und ok auf stdout. Der Fortschritt geht an stderr. Fehler verwenden ok:false/error und einen Exit-Code ungleich null; Ctrl-C beendet den Befehl in der Regel mit dem Exit-Code 130. Ein Auftrag mit status:failed ist etwas anderes als ein fehlgeschlagener Abfrageaufruf. Prüfen Sie zuerst ok des Befehls, dann den Status des Auftrags. Lokale Datensätze verbleiben in ~/.evolink-media; Anmeldedaten nutzen den sicheren Speicher des Betriebssystems. Kopieren Sie dieses Verzeichnis nicht, um eine Anmeldung zu migrieren, und löschen Sie keine Datensätze zu Preisangeboten oder zur Wiederaufnahme, um eine Übermittlung mit ungewissem Ausgang zu beheben. Die erweiterte Option —server wählt die OAuth-Ressource und Identitätsbindung, standardmäßig https://mcp.evolink.ai/mcp, ohne die REST-Ausführung zu ändern. Behalten Sie für —api-url/—files-url die Produktionsstandards bei; beliebige externe URLs werden abgelehnt. —token-stdin ist ein OAuth-Zugriffstoken für einen einzelnen Befehl, kein API Key der Plattform, und nicht für setup gedacht. Geben Sie Tokens nicht in Befehlsargumenten oder Logs an. Es gibt keinen Befehl für ein allgemeines run, Text-Chat, Abbrechen, Guthabenaufladung, Key-Verwaltung oder eigene Alias-Dateien. Nutzen Sie dafür die entsprechende Konsole oder API.Ausführungspfad der CLI und APIs
Seit CLI 0.8.0 laufen Medienanfragen über Terminal oder Agent → EvoLink CLI → REST-API der Plattform. Eingabeprüfungen, Modellreferenzen, Kostenschätzung und Ergebnisformatierung laufen lokal; die fachliche Ausführung ruft kein tools/call des Remote-MCP auf.Befehle und Backend-Vorgänge
quote_id, —confirm und die Wiederaufnahmedateien der CLI bilden einen Ablauf im Client ab, keine neuen Backend-Felder. Die veröffentlichte CLI 0.14.1 schätzt anhand der öffentlichen Preisregeln (Referenzpreise, ohne Kontorabatte). —max-cost-usd ist keine Obergrenze für die endgültige Abrechnung.
Anfragen, Wiederaufnahme und Automatisierung
Speichern Sie Preisangebot und Anfragekennung dauerhaft, bevor Sie absenden. REST verwendet die vorhandenen Kennungen Idempotency-Key / X-Evo-Run-Id. Führen Sie nach einer verlorenen Antwort die Wiederaufnahme mit dem ursprünglichen Preisangebot durch; ändern Sie weder Identität noch Eingaben noch Kennungen, um erneut abzusenden. Datensätze des Clients allein beweisen keine einheitliche Idempotenz des Backends über alle Produktionsknoten hinweg. Skripte sollten zuerst ok prüfen, dann den Auftragsstatus, dann Ergebnisse und Kostenfelder. Speichern Sie quote_id, task_id und Download-Manifeste, statt sich auf die letzte Terminalzeile zu verlassen. Abfragefehler, fehlgeschlagene Aufträge und fehlgeschlagene Downloads erfordern eine unterschiedliche Behandlung. Wiederholen Sie kostenpflichtige Übermittlungen nicht bedingungslos. Die Sitzungen von CLI und nativem MCP werden getrennt verwaltet, das Konto-OAuth teilt derzeit jedoch Berechtigungen, Limits und Pausenstatus vonEvoLink MCP (OAuth). Für native Verbindungen nutzen Sie die separate MCP-Dokumentation.