Zum Hauptinhalt springen

​
CLI-Kosten und Zustimmung

Diese Seite beschreibt die veröffentlichte CLI 0.14.1. Die CLI ruft die Plattform-APIs direkt auf und verwaltet Befehle und gespeicherte Kostenschätzungen lokal; die Anmeldung erfolgt über Passport. Beginnen Sie mit dem vollständigen Ablauf.
  1. Führen Sie evolink estimate mit dem endgültigen Modell und den endgültigen Eingaben aus und zeigen Sie die geschätzten Kosten.
  2. Generieren Sie nach der Zustimmung zu diesem Modell, diesen Parametern und diesen Kosten mit der gespeicherten quote_id und --confirm.
  3. Schätzen Sie erneut und holen Sie die Zustimmung ein, wenn sich Eingabe oder Anmeldung ändern, der Preis steigt oder das Preisangebot abläuft. Verwenden Sie kein anderes Preisangebot wieder. Sagt der Benutzer ausdrücklich, dass nicht geschätzt oder bestätigt werden soll, verwenden Sie generate --skip-estimate anstelle der Schritte 1–2.
  4. Fragen Sie den ursprünglichen Auftrag und die Kontonutzung ab. Eine Kostenschätzung belegt weder eine tatsächliche Abbuchung noch eine Erstattung.
Status der Kostenschätzung, Einschränkungen der öffentlichen Preise, Zustimmung und Budgets finden Sie unter Modelle, Kosten und Kontingente. In den veröffentlichten Versionen vergleicht max_cost_usd nur mit Kostenschätzungen vor dem Absenden; es begrenzt die endgültige Abbuchung nicht. Preisangebote gelten 24 Stunden ab der Kostenschätzung und sind an die ursprüngliche Identität, das Modell und die Eingaben gebunden. Die Generierung schätzt vor dem Absenden erneut: Dieselbe Eingabe wird abgesendet, wenn ihr Preis dem genehmigten Preis entspricht oder darunter liegt, auch unter später geänderten Preisregeln; bei einem höheren Preis (price_changed), einer geänderten Eingabe (quote_input_changed) oder einem abgelaufenen Preisangebot (quote_expired) wird dagegen nichts gesendet, und es sind eine neue Kostenschätzung und Zustimmung nötig. Preisangebote sind keine Zahlungsbelege. --confirm drückt die Zustimmung zu diesem Auftrag aus; es ersetzt weder die Anmeldung noch die Ausführungsberechtigung des Hosts. Modell-, Guthaben- und Auftragsabfragen senden keine Generierung ab. Die Generierung wird abgerechnet; Größen- und Aufbewahrungsgrenzen des Dateidienstes gelten gesondert. Als Richtwert für die Umrechnung gelten etwa 68 Credits pro 1 $; maßgeblich sind die tatsächlich zurückgegebenen Werte und die Kontoeinträge. Siehe gemeinsame Zugriffsregeln; die Schritte zum An- und Abmelden für diesen Weg stehen weiterhin auf dieser Seite.

​
Anmeldung, Berechtigungen und Kontingente

Passport übernimmt die Anmeldung im Browser, und der sichere Speicher des Systems bewahrt die Anmeldedaten der CLI auf. Die eigentlichen Plattformanfragen verwenden den vorhandenen, mit OAuth verknüpften Key. CLI und Remote-MCP können Kontozugriff, Key-Kontingente und Berechtigungen gemeinsam nutzen. Das Pausieren oder Ändern eines gemeinsam genutzten Keys wirkt sich auf alle aus, die ihn verwenden; jede OAuth-Sitzung wird getrennt abgemeldet.
Um sich von dieser lokalen CLI abzumelden, führen Sie gesondert aus:
Ein lokales MCP, das mit einem persönlichen API Key konfiguriert ist, verwendet die Berechtigungen dieses Keys; die CLI-Anmeldung autorisiert keinen separaten MCP-Prozess. Guthaben, Tages- und Gesamtkontingente, Modellzugriff und Werkzeugberechtigungen können das Absenden verhindern. Ein fehlgeschlagener Auftrag wird nicht berechnet, und die beim Absenden reservierten Credits werden automatisch wieder gutgeschrieben; eine Verbindungstrennung oder Abmeldung belegt nicht, dass eine Erstattung abgeschlossen ist.

​
Speicherung und Gültigkeitsdauer

Die Standardgültigkeit von Preisangeboten, Referenzen, Upload-Autorisierungen und Original-URLs steht unter Aufträge, Referenzen und Ergebnisse. Maßgeblich sind die tatsächlich zurückgegebenen Werte; ob Belege unterstützt werden, hängt vom Deployment des Dateidienstes ab.

​
CLI-Fehlerbehebung: die fehlgeschlagene Phase finden

Prüfen Sie Version und Zugriff auf demselben Rechner, unter demselben Betriebssystembenutzer und im selben Terminal, in dem die CLI ausgeführt wird. Diese Abfragen senden keine Generierung ab:
Klären Sie die aktuelle Phase, bevor Sie fortfahren. Die Verbindungsprüfung erfordert keine kostenpflichtige Generierung; generieren Sie nicht wiederholt, um die Installation zu testen.

​
Umgebung und Installation: fehlende Befehle, Berechtigungen, Zeitüberschreitungen

Schritt 1: Tatsächliche Ausführungsumgebung prüfen. Führen Sie im Terminal aus, das Ihr Agent verwendet:
Die CLI benötigt Node.js 22+. Bei command not found oder einem unter Windows nicht erkannten Befehl installieren Sie Node.js und öffnen Sie das Terminal erneut. Eine Installation auf dem Desktop installiert die CLI nicht in SSH, WSL oder einem Container. Schritt 2: Installationsort von npm prüfen.
Wählen Sie die Befehle zur Pfadprüfung für Ihr System:
Schritt 3: Erneut prüfen. Installieren oder aktualisieren Sie, nachdem das konkrete Problem behoben ist, und führen Sie evolink --version aus. Fahren Sie erst mit der Anmeldung fort, wenn der Befehl funktioniert. Siehe vollständige Installation.

​
Anmeldung und Callbacks: Browser öffnet sich nicht oder Anmeldung unvollständig

  1. Lassen Sie evolink auth login oder setup laufen. Öffnet sich kein Browser, öffnen Sie den Link dieses Versuchs manuell, prüfen Sie das Konto und stimmen Sie zu.
  2. Kehren Sie zum ursprünglichen Terminal zurück und warten Sie auf den Abschluss. Nach der Zustimmung landet der Browser auf der Seite von EvoLink MCP mit dem Hinweis „EvoLink-Freigabe erhalten“; das bedeutet nur, dass der Callback angekommen ist, nicht, dass die Verbindung zum Konto geprüft ist. Beenden Sie den Befehl nicht vorzeitig.
  3. Prüfen Sie die gespeicherte Authentifizierung und den tatsächlichen Kontozugriff getrennt:
Achten Sie auf authenticated: true beziehungsweise auf tatsächliche Guthabendaten. Starten Sie nach einer Zeitüberschreitung einen neuen Versuch mit einem neuen Link, statt einen Autorisierungscode wiederzuverwenden. Für eine längere Wartezeit:
--no-browser erfordert weiterhin einen Browser-Callback. Es ist keine Authentifizierung per Gerätecode oder ohne Browser. Geben Sie keinen API Key als OAuth-Token für eine Remote-Verbindung ein.

​
Skills und Berechtigungen: Der Agent nutzt installierte Dateien nicht

  1. Prüfen Sie das Verzeichnis des Benutzers, unter dem der Agent läuft. Verwenden Sie das passende --agent; für Codex:
  1. current: true bedeutet, dass die installierten Dateien zur CLI passen. Bei fehlenden oder veralteten Dateien verwenden Sie evolink skills install --agent codex. Behalten Sie bei modified lokale Änderungen bei; lösen Sie bei conflict den in Konflikt stehenden Skill oder die ungültigen Metadaten auf, statt das gesamte Skill-Verzeichnis zu löschen.
  2. Bitten Sie den Agenten zu bestätigen, dass er evolink-cli erkennt und liest. Aktualisieren Sie bei Bedarf oder öffnen Sie eine neue Unterhaltung. Prüfen Sie die erforderlichen Befehlsberechtigungen im Host; Einschränkungen der Organisation müssen in deren eigenen Einstellungen behandelt werden.
assistant_discovery: not_checked bedeutet, dass das Laden durch den Host weiterhin ungeprüft ist. Eine Datei SKILL.md oder eine gelesene Dokumentationsseite beweist nicht, dass der Agent die CLI ausführen kann. Synchronisieren Sie die Skills nach dem Aktualisieren der CLI. Verwenden Sie --replace-modified erst, wenn Sie entschieden haben, lokale Änderungen zu ersetzen; Sicherungen liegen unter ~/.evolink-media/skill-backups/. Verzeichnisse und Inhalte sind unter Für Agenten lesbare Ressourcen aufgeführt.

​
Modelle und Preise: leere Suche, ungültige Parameter, unvollständige Kostenschätzung

  1. Suchen Sie in den aktuellen Modellen und verwenden Sie die zurückgegebene kanonische ID. Eine Familie, ein Anzeigename oder ein Alias ist nicht unbedingt eine gültige ID zum Absenden. Formulieren Sie die Suche breiter, ohne erforderliche Funktionen für Referenzen aufzugeben.
  2. Prüfen Sie models show / models schema für dieses Modell. Prüfen Sie Pflichtfelder, Schreibweise, Enum-Werte, numerische Grenzen und sich gegenseitig ausschließende Referenzen. Übernehmen Sie nicht die Felder duration, size oder quality eines anderen Modells.
  3. Schätzen Sie erneut und prüfen Sie input_valid, problems, estimate.status, basis und warnings. Eine geänderte Eingabe oder Identität, ein höherer Preis oder ein abgelaufenes Preisangebot erfordern eine neue Kostenschätzung und Zustimmung.
Ergänzen Sie bei needs_input die Eingabe oder die abrechnungsrelevante Nutzung, die missing_usage und usage_help nennen, mit --media-seconds oder --pricing-parameters; no_price ist nicht verwendbar, und partial ist keine Gesamtsumme. Eine unbekannte Dauer oder unbekannte Multiplikatoren für Referenzen lassen sich nicht mit einem Einstiegspreis auffüllen. Behalten Sie das Budget bei; entfernen Sie nicht stillschweigend Obergrenzen, wechseln Sie keine Keys und verringern Sie keine Spezifikationen, um eine Ablehnung zu umgehen. Hat in der Suche, in models show oder in models recommend kein Modell einen Preis und steht in pricing_warning der Text Public pricing rules are unavailable or invalid, ist die CLI 0.10.1 oder älter: Diese Versionen verwerfen alle Preise, wenn der Katalog eine gestaffelte Regel ohne multiplier enthält, wie sie seit dem 12. Oktober veröffentlicht ist. Führen Sie mit npm install -g @evolinkai/cli@latest das Upgrade auf 0.10.2 oder neuer durch und führen Sie dann evolink skills install aus. Ab 0.10.2 wird ein Modell, dessen Regeln nicht gelesen werden können, ausgelassen und in pricing_warning genannt; andere Modelle behalten ihre Preise. Die Kostenschätzungen der veröffentlichten Clients auf Basis öffentlicher Standardpreise sind keine kontospezifischen, verbindlichen Preisangebote, und max_cost_usd ist keine Obergrenze für die endgültige Abrechnung. Siehe Kosten und Befehlsreferenz.

​
Zeitüberschreitung bei der Generierung, laufende Aufträge oder Übermittlungen mit unbekanntem Ausgang

1

Ursprünglichen Auftrag abfragen, wenn eine Kennung vorliegt

Eine Zeitüberschreitung beim Warten bricht die Generierung nicht ab. Verwenden Sie für mehrere Aufträge batch oder list und laden Sie die Originale nach dem Abschluss herunter. Liefert eine Abfrage status_check: unverified (task_response_invalid, task_identity_mismatch oder task_status_unknown), konnte der neueste Status nicht verifiziert werden: Fragen Sie denselben Auftrag erneut ab, statt zu generieren. Ein Ergebnis von generate mit submission_state: accepted hat bereits eine Auftragskennung, auch wenn sein Status fehlt.
2

Ursprüngliches Preisangebot wiederaufnehmen, wenn keine Auftragskennung zurückkam

Behalten Sie die ursprüngliche Identität, das Preisangebot und die Anfragekennung bei. Wechseln Sie weder Konto noch Preisangebot noch Kennung, um erneut zu generieren. Ein unbekannter Ausgang bedeutet nicht, dass nichts abgesendet oder abgebucht wurde.
3

Nachweise sichern, bevor Sie den Fehlschlag behandeln

Halten Sie die ursprüngliche Auftragskennung, den Fehlercode und den Zeitpunkt fest. Ein nachweislich fehlgeschlagener Auftrag wird nicht berechnet, und die beim Absenden reservierten Credits werden automatisch wieder gutgeschrieben. Es gibt keinen nutzbaren öffentlichen Befehl zum Abbrechen. Das Schließen des Terminals oder das Beenden des Wartens bricht den Auftrag auf dem Server nicht ab.
Bei einem Preisangebot, das noch nicht abgesendet wurde und abgelaufen ist oder dessen Eingabe sich geändert hat oder dessen Preis gestiegen ist, schätzen Sie erneut und holen Sie die Zustimmung erneut ein. Nehmen Sie vorhandene Aufträge oder Übermittlungen mit unbekanntem Ausgang zuerst wieder auf. Siehe die Befehlsreferenz für Aufträge.

​
Fehlgeschlagene oder zu große Uploads und Uploads mit unbekanntem Ausgang

  1. Prüfen Sie den absoluten Pfad, die Berechtigungen und das echte Format auf dem Rechner, auf dem der Agent ausgeführt wird. Ein Remote-Host oder Container kann einen Desktop-Pfad nicht direkt lesen.
  2. Lokale CLI-Uploads sind auf 95 MiB begrenzt; Modelle können strengere Grenzen für Format, Anzahl oder Größe setzen. Prüfen Sie zuerst die Modelldokumentation. Chat-Anhänge müssen zu lesbaren Dateien oder erreichbaren URLs werden.
  3. Bewahren Sie nach einem unbekannten Ausgang die ursprüngliche upload_id auf und fragen Sie sie ab:
  1. Belegabfragen hängen vom Deployment des Dateidienstes ab. outcome_unknown belegt nicht, dass nichts hochgeladen wurde. Fordern Sie Ersatz-Uploads erst nach nachweislichem Fehlschlag oder nach Ablauf der Gültigkeit an. Referenzen bleiben in der Regel 72 Stunden erhalten; laden Sie abgelaufene Eingaben erneut hoch, aktualisieren Sie die Anfrage, schätzen Sie erneut und holen Sie vor der Generierung die Zustimmung ein.
Upload-Methoden finden Sie unter Abläufe für Referenzen, die Felder der Belege in der Befehlsreferenz. Geben Sie einmalige Upload-URLs, private signierte URLs oder Keys nicht im Chat weiter.

​
Downloads und Vorschauen

Fragen Sie den ursprünglichen Auftrag ab, vergewissern Sie sich, dass er abgeschlossen ist, und verwenden Sie dessen Original-URL. Bevorzugen Sie download der CLI; siehe CLI-Referenz. Downloads verwenden bereits einen Produkt-UA. HTTP- und Formatprüfungen, das Python-Beispiel mit Produkt-User-Agent, abgelaufene Links und graue Vorschauen stehen unter Fehlerbehebung beim Download. Nehmen Sie Aufträge mit unbekanntem Ausgang wieder auf, statt neu zu generieren oder Vorschauen zu bearbeiten.

​
Informationen für den Support

Folgen Sie der Support-Checkliste mit Versionen, fehlgeschlagener Phase, Kennungen und geschwärzten Fehlern. Bewahren Sie die Diagnosedaten dieses Wegs auf; geben Sie keine Keys, Tokens, privaten URLs oder Umgebungsauszüge weiter.

​
Fehlerbehebung für eine native MCP-Verbindung

CLI und MCP sind getrennte Einstiegspunkte. Zu nativem OAuth, Werkzeugerkennung und lokalem stdio siehe MCP-Fehlerbehebung. Eine erfolgreiche CLI-Installation bestätigt keinen MCP-Zugriff. Dieser Kompatibilitätseintrag erhält alte Links; CLI-Befehle, Anmeldung und Skills sind oben behandelt.