Consulta Exprés por Lotes Xdcc para Openclaw

El motor de consulta utiliza la biblioteca estándar de Python. El proceso guiado de registro requiere Playwright; si no está disponible, la skill informa del problema en lugar de omitir silenciosamente las comprobaciones de registro. Utiliza el punto de entrada incluido onboard.py para completar el flujo de comprobación de credenciales, registro, validación y consulta.

# Primer uso: indica el teléfono y la contraseña del cliente para el registro
python onboard.py --phone <customer-phone> --password <customer-password> --file orders.txt --output results

# Cuenta existente o credenciales guardadas: consulta un archivo de números de seguimiento
python onboard.py --file orders.txt --output results

# Valida las credenciales guardadas sin ejecutar una consulta
python onboard.py --validate-only

# Ejecuta la autoprueba estática del paquete y crea una distribución ZIP
python scripts\/selftest.py
python scripts\/package.py

El cliente debe completar personalmente la verificación por SMS y control deslizante. No solicites ni guardes el número de teléfono completo si para el seguimiento solo se necesitan los cuatro últimos dígitos. Mantén las credenciales de la API fuera del código fuente y de la documentación pública.

Las credenciales se guardan en ~\/ .workbuddy\/xdcc-credentials.env con estas claves:

La entrada de seguimiento se puede proporcionar en un archivo con un registro NO o NO,TEL por línea, mediante números de seguimiento en línea con --nos o mediante un CSV de mapeo de teléfonos con --telmap. Se puede utilizar un valor común --tel como alternativa. La salida admite JSON, CSV UTF-8 con BOM para abrirlo directamente en Excel e informes TXT legibles.

Los resultados incluyen el estado y la descripción del envío, marcas de tiempo de recogida／despacho／firma, ciudades de recogida y entrega, detalles de la empresa de mensajería, indicadores de duración y tiempo de espera, y eventos de seguimiento como TraceList, LastTrace y Count. Los agregados incluyen la distribución de estados, el total de tiempos de espera, los promedios y máximos de las horas de firma, la distribución de empresas de mensajería y los errores. La documentación de referencia se encuentra en references\/api_reference.md, references\/onboarding_guide.md y references\/SECURITY_AUDIT.md.