Tradução automática
Esta página foi traduzida automaticamente por IA e pode conter erros. Se algo não estiver claro, consulte a fonte em inglês.
Mapa de leitura da arquitetura¶
Referência de mecanismo para ferramentas pplx (pplx-export / pplx-ask):
dependências, pipelines, máquinas de estado, contratos de dados e limites
de confiabilidade. Para uso orientado a tarefas, comece com o Guia do usuário.
Escopo e fonte da verdade
Estas páginas explicam a arquitetura do pplx_export/ para agentes e
engenheiros que mantêm o projeto. As referências de linha usam file.py:NN,
relativas a pplx_export/. As descrições foram verificadas em relação ao
repositório em 2026-07-23 (__version__ = "0.1.0",
pplx_export/__init__.py:31); o código e os testes atuais permanecem como autoridade.
1. Comece pelo mapa do sistema¶
- Visão geral da arquitetura — camadas, responsabilidades dos módulos e o grafo de dependências em nível de importação.
2. Siga um fluxo de execução¶
- Pipeline de exportação — busca, retenção de resposta bruta, detecção de modo e renderização Markdown.
- Subagentes e interrupções — atribuição de payload e semântica de interrupção/retomada.
- pplx-ask e contas — consultas em streaming e alternância de cookies entre múltiplas contas.
3. Entenda dados e confiabilidade¶
- Modelo de dados e contrato de diretório — modelos, limites de escrita e o contrato de arquivamento em disco.
- Limitação de taxa e tratamento de erros — limitação, backoff, estados terminais e roteamento de erros.
- Operações offline — re-renderização sem rede, reconstrução de relacionamentos e pipelines de manutenção local.
4. Referências relacionadas¶
- Referência da API Web — contratos REST/GraphQL observados, semântica de resposta e notas de descoberta.
- Guia do mantenedor — arquitetura de teste, fluxo de trabalho do contribuidor e contratos de fixtures simuladas.