Maschinenübersetzung
Diese Seite wurde automatisch von KI übersetzt und kann Fehler enthalten. Bei Unklarheiten konsultieren Sie die englische Quelle.
Architektur-Lesekarte¶
Referenz auf Mechanismenebene für pplx-Werkzeuge (pplx-export / pplx-ask):
Abhängigkeiten, Pipelines, Zustandsmaschinen, Datenverträge und Zuverlässigkeitsgrenzen.
Für aufgabenorientierte Nutzung beginnen Sie mit der Benutzeranleitung.
Umfang und Quelle der Wahrheit
Diese Seiten erklären die Architektur von pplx_export/ für Agenten und
Ingenieure, die das Projekt warten. Zeilenverweise verwenden file.py:NN,
relativ zu pplx_export/. Die Beschreibungen wurden am 2026-07-23 gegen das Repository
geprüft (__version__ = "0.1.0", pplx_export/__init__.py:31); aktueller Code und Tests bleiben maßgeblich.
1. Beginnen Sie mit der Systemkarte¶
- Architekturübersicht — Schichten, Modulverantwortlichkeiten und der Import-Abhängigkeitsgraph.
2. Folgen Sie einem Laufzeitablauf¶
- Export-Pipeline — Abrufen, Rohantwort-Speicherung, Moduserkennung und Markdown-Rendering.
- Sub-Agenten und Unterbrechungen — Payload- Zuordnung und Unterbrechungs-/Fortsetzungssemantik.
- pplx-ask und Konten — Streaming-Abfragen und Multi-Konto-Cookie-Wechsel.
3. Verstehen Sie Daten und Zuverlässigkeit¶
- Datenmodell und Verzeichnisvertrag — Modelle, Schreib- grenzen und der On-Disk-Archivvertrag.
- Ratenbegrenzung und Fehlerbehandlung — Drosselung, Backoff, Endzustände und Fehlerweiterleitung.
- Offline-Betrieb — Neu-Rendering ohne Netzwerk, Beziehungsneuerstellung und lokale Wartungspipelines.
4. Verwandte Referenzen¶
- Web-API-Referenz — beobachtete REST/GraphQL-Verträge, Antwortsemantik und Erkennungshinweise.
- Wartungsanleitung — Testarchitektur, Beitrags- workflow und simulierte Fixture-Verträge.