Consulta Expressa em Lote Xdcc para Openclaw

O mecanismo de consulta usa a biblioteca padrão do Python. O fluxo guiado de cadastro requer Playwright; se ele não estiver disponível, a skill informa o problema em vez de ignorar silenciosamente as verificações de cadastro. Use o ponto de entrada incluído onboard.py para executar o fluxo completo de verificação de credenciais, cadastro, validação e consulta.

# Primeiro uso: forneça o telefone e a senha do cliente para o cadastro
python onboard.py --phone <customer-phone> --password <customer-password> --file orders.txt --output results

# Conta existente ou credenciais salvas: consulte um arquivo de números de rastreamento
python onboard.py --file orders.txt --output results

# Valide as credenciais salvas sem executar uma consulta
python onboard.py --validate-only

# Execute o autoteste estático do pacote e crie uma distribuição ZIP
python scripts\/selftest.py
python scripts\/package.py

O cliente deve concluir pessoalmente a verificação por SMS e pelo controle deslizante. Não solicite nem armazene o número de telefone completo quando apenas os quatro últimos dígitos forem necessários para o rastreamento. Mantenha as credenciais da API fora do código-fonte e da documentação pública.

As credenciais são armazenadas em ~\/ .workbuddy\/xdcc-credentials.env usando estas chaves:

A entrada de rastreamento pode ser fornecida em um arquivo com um registro NO ou NO,TEL por linha, por números de rastreamento em linha via --nos ou por um CSV de mapeamento de telefones via --telmap. Um valor compartilhado --tel pode ser usado como alternativa. A saída oferece suporte a JSON, CSV UTF-8 com BOM para abertura direta no Excel e relatórios TXT legíveis.

Os resultados incluem o estado e a descrição da remessa, horários de coleta／despacho／assinatura, cidades de coleta e entrega, detalhes da transportadora, indicadores de duração e tempo limite e eventos de rastreamento como TraceList, LastTrace e Count. Os agregados abrangem a distribuição de status, os totais de tempo limite, as médias e os picos dos horários de assinatura, a distribuição de transportadoras e as falhas. A documentação de apoio está em references\/api_reference.md, references\/onboarding_guide.md e references\/SECURITY_AUDIT.md.