加入 MAREF 社区

1. 克隆仓库

git clone https://github.com/maref-org/maref.git
cd maref

2. 安装依赖

pip install -e ".[dev]"

3. 运行测试

pytest tests/ -v --cov=src/maref

4. 代码质量

ruff check src/          # 代码检查
mypy src/                 # 类型检查
pytest tests/             # 运行所有测试

编码规范

• • Python: PEP 8 + ruff + mypy strict mode
• • TypeScript: ESLint + strict mode
• • 所有安全关键函数必须使用 @security_critical

提交信息格式

使用 conventional commits：feat(module): description、fix(security): description、docs(readme): description

PR 要求

• • 所有测试必须通过
• • 代码覆盖率不能降低
• • 新功能必须包含测试
• • 公共 API 需要更新文档