維護者指南¶
在不削弱歸檔保真度或測試隔離性的前提下修改 pplx-tools 所需的契約與工作流。
1. 選擇對應文件¶
- 測試體系架構——測試分層、信任邊界和離線快照提供的 保證。
- 測試實踐——當前測試清單與貢獻者工作流。
- Fixtures 與快照——模擬數據來源、目錄約定、golden 生成和殘留檢查。
2. 本地品質閉環¶
uv run python scripts/audit_docs.py
uv run python tests/scrub_fixtures.py --check
uv run pytest tests
uv run mkdocs build --strict
git diff --check
Fixture 輸入是確定性的模擬數據,不來自真實帳戶、即時 API 回應、web_archive/
或任何私有歸檔。