WebCull - Documentation - Salida Y Limites

Salida

Mantener Las Respuestas CLI Limitadas Y Legibles

Use límites claros en comandos de lista. Esto mantiene legible la salida de terminal en cuentas grandes y da a las herramientas de agente resultados suficientemente pequeños para revisarlos con cuidado.

Límites de uso

Consultar el uso actual de la CLI

Ejecute webcull limits para ver el uso actual de lectura y escritura de la cuenta seleccionada antes de ejecutar muchos comandos.

webcull limits --account <account-hash>

Controles

Usar Los Mismos Controles En Comandos De Lectura

--account <hash|id>

Selecciona qué cuenta de WebCull autorizada localmente proporciona el token para este comando. Los agentes deben usar el hash de la cuenta.

--limit <n>

Número máximo de filas o nodos devueltos.

--page <n>

Número de página para los comandos que admiten paginación.

--fields <list>

Campos separados por comas, como id,title,url,parent_id,modified.

--max-chars <n>

Tamaño máximo de respuesta.

--max-metadata-chars <n>

Longitud máxima del texto para campos largos de detalles de marcadores.

--format json|jsonl

JSON con formato es el valor predeterminado. JSONL imprime un elemento por línea cuando una respuesta contiene una lista de elementos.

Ejemplos

Empezar Con Cargas Pequenas

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

Cuando una respuesta es demasiado amplia, reduzca primero los campos, luego los campos de texto largo y después los límites de filas. Aumente un límite a la vez.

Guía de reintentos

Respetar las respuestas estructuradas de reintento

La CLI conserva los códigos de respuesta que permiten reintentos para que las personas, los scripts y los agentes puedan responder sin hacer suposiciones. request_busy significa que aún se está ejecutando otra solicitud para la misma cuenta. request_lock_unavailable significa que no se pudo comprobar la coordinación de solicitudes. Espera el tiempo indicado antes de volver a intentarlo.

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

Una respuesta throttled incluye retry_after_seconds. Espera al menos ese tiempo y luego reduce los límites, el tamaño de la salida o el alcance de la consulta antes de continuar. La CLI no reintenta automáticamente las escrituras.