WebCull - Documentation - Ausgabe Und Limits

Ausgabe

CLI-Antworten Begrenzt Und Lesbar Halten

Verwenden Sie klare Limits bei Listenbefehlen. So bleibt die Terminalausgabe bei großen Konten lesbar und Agent-Tools erhalten Ergebnisse, die klein genug für eine sorgfältige Prüfung sind.

Nutzungslimits

Aktuelle CLI-Nutzung Prüfen

Führen Sie webcull limits aus, um die aktuelle Lese- und Schreibnutzung des ausgewählten Kontos zu sehen, bevor Sie viele Befehle ausführen.

webcull limits --account <account-hash>

Steuerung

Dieselben Steuerelemente Fuer Lesebefehle Verwenden

--account <hash|id>

Wählt aus, welches lokal autorisierte WebCull-Konto das Token für diesen Befehl bereitstellt. Agenten sollten den Kontohash verwenden.

--limit <n>

Maximale Anzahl zurückgegebener Zeilen oder Knoten.

--page <n>

Seitennummer für Befehle, die Seiteneinteilung unterstützen.

--fields <list>

Durch Kommas getrennte Felder wie id,title,url,parent_id,modified.

--max-chars <n>

Maximale Antwortgröße.

--max-metadata-chars <n>

Maximale Textlänge für lange Lesezeichendetailfelder.

--format json|jsonl

Formatiertes JSON ist die Standardeinstellung. JSONL gibt ein Element pro Zeile aus, wenn eine Antwort eine Elementliste enthält.

Beispiele

Mit Kleinen Nutzlasten Beginnen

webcull bookmarks tree --account <account-hash> --path / --max-depth 1 --limit 25 --max-chars 8000 --fields id,type,title,modified
webcull graph around --account <account-hash> --stack-id 2301 --depth 1 --limit 50 --max-chars 12000
webcull bookmarks get --account <account-hash> --ids 2302 --fields id,title,url,notes --max-metadata-chars 1200

Wenn eine Antwort zu breit ist, reduzieren Sie zuerst Felder, dann lange Textfelder und anschließend Zeilenlimits. Erhöhen Sie jeweils nur ein Limit.

Hinweise zu Wiederholungsversuchen

Strukturierte Antworten für Wiederholungsversuche beachten

Die CLI behält wiederholbare Antwortcodes bei, damit Personen, Skripte und Agenten ohne Rätselraten reagieren können. request_busy bedeutet, dass noch eine andere Anfrage für dasselbe Konto ausgeführt wird. request_lock_unavailable bedeutet, dass die Anfragekoordination nicht geprüft werden konnte. Warten Sie die angegebene Zeit, bevor Sie es erneut versuchen.

{
  "success": "false",
  "code": "request_busy",
  "retry_after_ms": 1000
}

Eine throttled-Antwort enthält retry_after_seconds. Warten Sie mindestens so lange und verringern Sie dann Limits, Ausgabegröße oder Abfrageumfang, bevor Sie fortfahren. Die CLI wiederholt Schreibvorgänge nicht automatisch.