Машинный перевод
Эта страница была автоматически переведена ИИ и может содержать ошибки. Если что-то неясно, обращайтесь к английскому источнику.
Карта чтения архитектуры¶
Справочник на уровне механизмов для инструментов pplx (pplx-export / pplx-ask):
зависимости, конвейеры, конечные автоматы, контракты данных и границы
надежности. Для использования, ориентированного на задачи, начните с Руководства пользователя.
Область применения и источник истины
Эти страницы объясняют архитектуру pplx_export/ для агентов и
инженеров, поддерживающих проект. Ссылки на строки используют file.py:NN,
относительно pplx_export/. Описания были проверены по репозиторию
на 2026-07-23 (__version__ = "0.1.0",
pplx_export/__init__.py:31); текущий код и тесты остаются авторитетными.
1. Начните с карты системы¶
- Обзор архитектуры — уровни, обязанности модулей и граф зависимостей на уровне импорта.
2. Проследите поток выполнения¶
- Конвейер экспорта — получение, сохранение необработанных ответов, определение режима и рендеринг Markdown.
- Под-агенты и прерывания — атрибуция полезной нагрузки и семантика прерывания/возобновления.
- pplx-ask и учетные записи — потоковые запросы и переключение куки для нескольких учетных записей.
3. Понимание данных и надежности¶
- Модель данных и контракт каталога — модели, границы записи и контракт архива на диске.
- Ограничение скорости и обработка ошибок — троттлинг, откат, терминальные состояния и маршрутизация ошибок.
- Автономные операции — повторный рендеринг без сети, перестроение связей и локальные конвейеры обслуживания.
4. Связанные ссылки¶
- Справочник веб-API — наблюдаемые контракты REST/GraphQL, семантика ответов и заметки об обнаружении.
- Руководство сопровождающего — архитектура тестов, рабочий процесс участника и контракты симулированных фикстур.