Contributing

Before You Start

Open an issue first for anything beyond a small fix. This saves everyone time if the change is out of scope or needs a different approach.

pip install -e .[dev]
pytest tests -q

To run a single test file:

pytest tests/test_engine.py -v

Keep each PR focused on one change
Add or update tests for behavior changes
Update both README.en.md and README.zh-CN.md if the user-facing behavior changes

Improvements to backup execution, YAML configuration, diff generation, CLI usability, and documentation.

Enterprise-only integrations (credential vaults, web APIs, alerting systems) should live in separate repositories.