ARK CUA

Was macht ARK CUA?

Betreiben Sie ARK CUA über die gebündelte Python-CLI. Behalten Sie den gesamten Gateway-Zugriff innerhalb der CLI bei und fordern Sie niemals einen AgentPlan-API-Schlüssel im Chat an.

Befehlsoberfläche

python3 <skill-verzeichnis>/scripts/cua.py <befehl> [optionen]

Parsen Sie das einzelne JSON-Objekt, das jeder Aufruf ausgibt:

• Erfolg: ok: true, mit data und manchmal next.
• Fehler: ok: false, mit error.code und manchmal next.setup_command.

Lesen Sie references/commands.md für nicht-kernbezogene Befehle. Lesen Sie references/auth.md, references/outcomes.md oder references/troubleshooting.md nur, wenn der entsprechende Zustand eintritt.

Kern-Workflow

1. Führen Sie auth status aus.
2. Bei AUTH_REQUIRED, TOKEN_EXPIRED oder REFRESH_FAILED geben Sie den zurückgegebenen setup_command weiter. Bitten Sie den Benutzer, diesen in seinem eigenen lokalen Terminal auszuführen und den AgentPlan-API-Schlüssel über die versteckte Eingabeaufforderung einzugeben. Führen Sie den interaktiven Login niemals aus einer Agent-Sitzung aus und akzeptieren Sie den Schlüssel niemals im Chat.
3. Nachdem der Benutzer den erfolgreichen Login bestätigt hat, führen Sie erneut auth status aus.
4. Führen Sie einmal delegate --objective "<benutzeranfrage>" aus. Bewahren Sie die Benutzeranfrage unverändert, ohne sie zu planen oder zu zerlegen.
5. Notieren Sie data.invocation_id; reichen Sie niemals dieselbe Anfrage erneut ein.
6. Verfolgen Sie data.outcome bis zum Endzustand:
   • in_progress: führen Sie next.command aus und beobachten Sie weiter.
   • needs_input: geben Sie data.input_request.question wörtlich weiter, dann übermitteln Sie die Antwort des Benutzers mit answer.
   • completed: verwenden Sie data.result.text als maßgebliches Ergebnis.
   • failed: melden Sie den Fehler; wiederholen Sie nur, wenn angefordert und sicher.
   • cancelled: melden Sie den Abbruch.

Wenn die Aufgabenerstellung ACTIVE_RUN_CONFLICT zurückgibt, wurde die neue Anfrage nicht gestartet. Stoppen Sie, teilen Sie dem Benutzer mit, dass der Desktop beschäftigt ist, und wiederholen Sie nicht oder untersuchen Sie die vorhandene Aufgabe, es sei denn, der Benutzer fragt explizit danach.

Spezielle Anliegen routen

• Spezifischer Desktop oder wiederverwendbarer Kontext: verwenden Sie desktop list, task run, context und task continue.
• Lieferung lokaler Dateien: entfernen Sie nur lokale Zustellungsformulierungen aus dem CUA-Ziel, lassen Sie CUA ein registriertes Artefakt exportieren, dann verwenden Sie artifact list und artifact save.
• Gesundheits- oder Konfigurationsprüfung: verwenden Sie ping, diagnose oder model get; erstellen Sie keine Aufgabe nur, um die Verfügbarkeit zu testen.
• Stoppen einer aktiven Aufgabe: verwenden Sie cancel nur, wenn der Benutzer explizit darum bittet.

Sicherheit und Ergebnisintegrität

• Verwenden Sie das gebündelte Gateway in assets/config.json; erlauben Sie dieselben aufruf- und umgebungsbezogenen Überschreibungen wie ap-cua-skill.
• Konfigurieren Sie Anmeldeinformationen genau wie ap-cua-skill: lösen Sie --api-key, dann AP_CUA_AGENTPLAN_API_KEY, AGENTPLAN_API_KEY oder ARK_API_KEY auf, dann verwenden Sie die versteckte lokale Terminal-Eingabeaufforderung, wenn kein Schlüssel anderweitig verfügbar ist. Validieren und speichern Sie erfolgreiche Anmeldeinformationen im lokalen 0600-Cache.
• Geben Sie niemals API-Schlüssel, Cache-Inhalte, Autorisierungsheader, Benutzerantworten oder Artefakt-Bytes preis.
• Schlussfolgern Sie niemals auf Abschluss aus Fortschrittstext oder einem nicht-endgültigen Zustand.
• Behandeln Sie result.text nur dann als maßgeblich, wenn outcome == completed.
• Lehnen Sie es ab, vorhandene lokale Dateien zu überschreiben. Erfordern Sie einen neuen Ausgabepfad für artifact save.
• Lehnen Sie HTML-/Interstitial-Antworten als Artefakte ab und schreiben Sie sie nicht auf die Festplatte.
• Akzeptieren Sie keinen Base64-Text oder einen externen Freigabelink als heruntergeladene Datei; erfordern Sie ein registriertes Artefakt.
• Umgehen Sie keine CUA-Fragen, ändern Sie keine dauerhaften Modelleinstellungen, verwalten Sie keine Zeitpläne, geben Sie keine Desktop-Zugangstickets preis oder führen Sie Desktop-Neustart-/Zurücksetzungsvorgänge durch.