维护者指南

在不削弱归档保真度或测试隔离性的前提下修改 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/ 或任何私有归档。