Traduzione automatica
Questa pagina è stata tradotta automaticamente dall'IA e potrebbe contenere errori. In caso di dubbi, fare riferimento alla versione inglese.
Mappa di lettura dell'architettura¶
Riferimento a livello di meccanismo per gli strumenti pplx (pplx-export / pplx-ask):
dipendenze, pipeline, macchine a stati, contratti dati e confini di affidabilità.
Per un utilizzo orientato alle attività, inizia con la Guida utente.
Ambito e fonte di verità
Queste pagine spiegano l'architettura di pplx_export/ per agenti e
ingegneri che mantengono il progetto. I riferimenti alle righe usano file.py:NN,
relativi a pplx_export/. Le descrizioni sono state verificate rispetto al
repository il 2026-07-23 (__version__ = "0.1.0",
pplx_export/__init__.py:31); il codice e i test correnti rimangono autorevoli.
1. Inizia con la mappa del sistema¶
- Panoramica dell'architettura — livelli, responsabilità dei moduli e grafico delle dipendenze a livello di import.
2. Segui un flusso di esecuzione¶
- Pipeline di esportazione — recupero, conservazione della risposta grezza, rilevamento della modalità e rendering Markdown.
- Sub-agenti e interruzioni — attribuzione del payload e semantica di interruzione/ripresa.
- pplx-ask e account — query in streaming e cambio cookie multi-account.
3. Comprendi dati e affidabilità¶
- Modello dati e contratto di directory — modelli, confini di scrittura e contratto di archivio su disco.
- Limitazione della frequenza e gestione degli errori — throttling, backoff, stati terminali e instradamento degli errori.
- Operazioni offline — re-rendering senza rete, ricostruzione delle relazioni e pipeline di manutenzione locale.
4. Riferimenti correlati¶
- Riferimento API Web — contratti REST/GraphQL osservati, semantica delle risposte e note di scoperta.
- Guida per il manutentore — architettura dei test, flusso di lavoro del contributore e contratti di fixture simulati.