システムアーキテクチャ読解マップ¶
pplx-tools（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 とマルチアカウント——ストリーミング質問とマルチアカウント Cookie 切り替え。
3. データと信頼性を理解する¶
- データモデルとディレクトリ契約——モデル、書き込み境界、ディスクアーカイブ契約。
- レート制限とエラー処理——スロットリング、バックオフ、終端状態、エラーの振り分け。
- オフライン運用メカニズム——ネットワークなしでの再レンダリング、関係グラフ再構築、ローカルメンテナンスパイプライン。
4. 関連リファレンス¶
- Web API リファレンス——観測された REST/GraphQL 契約、レスポンスセマンティクス、 発見記録。
- メンテナーガイド——テストアーキテクチャ、コントリビューターワークフロー、モックフィクスチャ契約。