CONTRIBUTING.md

参与贡献

感谢你对 Any Auto Register 的关注！欢迎提交 Issue 和 Pull Request。

开发环境

python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

运行测试

pytest

运行单个测试文件：

pytest tests/test_api_health.py -v

提交规范

使用 Conventional Commits：

• feat: 新功能
• fix: 修复
• docs: 文档
• refactor: 重构
• test: 测试
• chore: 构建/工具

添加新平台

1. 在 platforms/ 下新建目录
2. 实现 plugin.py（继承 BasePlatform，用 @register 装饰器注册）
3. 实现 protocol_mailbox.py（协议模式注册逻辑）
4. 可选：实现 browser_register.py 和 browser_oauth.py
5. 在 resources/platform_capabilities.json 中添加平台能力声明
6. 添加对应的测试

代码风格

• Python 代码遵循 PEP 8
• 类型注解尽量完整
• 中文注释和日志