Traduction automatique
Cette page a été traduite automatiquement par IA et peut contenir des erreurs. En cas de doute, référez-vous à la source anglaise.
Carte de lecture de l'architecture¶
Référence au niveau mécanisme pour les outils pplx (pplx-export / pplx-ask) :
dépendances, pipelines, machines d'état, contrats de données et limites
de fiabilité. Pour une utilisation orientée tâches, commencez par le Guide utilisateur.
Périmètre et source de vérité
Ces pages expliquent l'architecture de pplx_export/ pour les agents et
les ingénieurs qui maintiennent le projet. Les références de lignes utilisent file.py:NN,
relatives à pplx_export/. Les descriptions ont été vérifiées par rapport au
dépôt le 2026-07-23 (__version__ = "0.1.0",
pplx_export/__init__.py:31) ; le code et les tests actuels restent faisant autorité.
1. Commencez par la carte système¶
- Vue d'ensemble de l'architecture — couches, responsabilités des modules et le graphe de dépendances au niveau des importations.
2. Suivez un flux d'exécution¶
- Pipeline d'exportation — récupération, conservation de la réponse brute, détection de mode et rendu Markdown.
- Sous-agents et interruptions — attribution de charge utile et sémantique d'interruption/reprise.
- pplx-ask et comptes — requêtes en streaming et changement de cookie multi-compte.
3. Comprenez les données et la fiabilité¶
- Modèle de données et contrat de répertoire — modèles, limites d'écriture et contrat d'archive sur disque.
- Limitation de débit et gestion des erreurs — limitation, backoff, états terminaux et routage des erreurs.
- Opérations hors ligne — re-rendu sans réseau, reconstruction des relations et pipelines de maintenance locaux.
4. Références connexes¶
- Référence de l'API Web — contrats REST/GraphQL observés, sémantique des réponses et notes de découverte.
- Guide du mainteneur — architecture de test, flux de travail du contributeur et contrats de fixtures simulés.