Traducción automática
Esta página fue traducida automáticamente por IA y puede contener errores. Si algo no está claro, consulte la fuente en inglés.
Mapa de lectura de arquitectura¶
Referencia a nivel de mecanismo para las herramientas pplx (pplx-export / pplx-ask):
dependencias, tuberías, máquinas de estado, contratos de datos y límites
de confiabilidad. Para uso orientado a tareas, comience con la Guía de usuario.
Alcance y fuente de verdad
Estas páginas explican la arquitectura de pplx_export/ para agentes e
ingenieros que mantienen el proyecto. Las referencias de línea usan file.py:NN,
relativas a pplx_export/. Las descripciones se verificaron contra el
repositorio el 2026-07-23 (__version__ = "0.1.0",
pplx_export/__init__.py:31); el código y las pruebas actuales siguen siendo autoritativos.
1. Comience con el mapa del sistema¶
- Visión general de la arquitectura — capas, responsabilidades de los módulos y el gráfico de dependencias a nivel de importación.
2. Siga un flujo de ejecución¶
- Tubería de exportación — obtención, retención de respuestas sin procesar, detección de modo y renderizado Markdown.
- Subagentes e interrupciones — atribución de carga útil y semántica de interrupción/reanudación.
- pplx-ask y cuentas — consultas en streaming y cambio de cookies entre cuentas múltiples.
3. Comprenda los datos y la confiabilidad¶
- Modelo de datos y contrato de directorio — modelos, límites de escritura y el contrato de archivo en disco.
- Límite de velocidad y manejo de errores — limitación, retroceso, estados terminales y enrutamiento de errores.
- Operaciones sin conexión — re-renderizado sin red, reconstrucción de relaciones y tuberías de mantenimiento local.
4. Referencias relacionadas¶
- Referencia de API web — contratos REST/GraphQL observados, semántica de respuestas y notas de descubrimiento.
- Guía del mantenedor — arquitectura de pruebas, flujo de trabajo del colaborador y contratos de fixtures simulados.