機器翻譯

本頁由 AI 自動翻譯，可能存在錯誤。如有歧義，請以簡體中文原文為準。

簡體中文原文 · 回報翻譯問題

系統架構閱讀地圖

pplx-tools（pplx-export / pplx-ask）的機制層參考：依賴關係、運行管線、 狀態機、資料契約與可靠性邊界。面向任務的說明請從使用指南開始。

範圍與事實來源

本區面向接手維護專案的 agent 與工程師，解釋 pplx_export/ 的系統架構。 行號引用使用 file.py:NN，均相對 pplx_export/。頁面內容於 2026-07-23 對照倉庫核實（__version__ = "0.1.0"， pplx_export/__init__.py:31）；當前程式碼和測試仍是最終事實來源。

1. 從系統地圖開始

• 架構總覽——分層結構、模組職責與真實 import 依賴圖。

2. 沿運行流程閱讀

• 匯出管線——抓取、原始回應保留、模式識別與 Markdown 渲染。
• 子代理與中斷——後台產物歸屬與中斷/續跑語義。
• pplx-ask 與多帳戶——串流發問和多帳戶 cookie 切換。

3. 理解資料與可靠性

• 資料模型與目錄契約——模型、寫入邊界和磁碟歸檔契約。
• 限頻與錯誤處理——節流、退避、終態與錯誤分流。
• 離線運維機制——零網路重渲、關係圖重建和本地維護管線。

4. 相關參考

• Web API 參考——已觀察到的 REST/GraphQL 契約、回應語義與 發現記錄。
• 維護者指南——測試架構、貢獻者工作流和模擬 fixture 契約。