加入 MAREF 社区

Agent 治理是集体努力的结果。以下是你参与的方式。

参与方式

代码贡献

为核心框架、适配器或工具贡献代码。所有贡献通过 GitHub PR 审查后合并。

提交 PR →

文档改进

改进教程、修复错别字、翻译内容或为社区撰写新的指南。

改进文档 →

报告问题

发现了 Bug?有功能请求?在 GitHub 上提交 Issue,附上清晰的描述。

提交 Issue →

社区讨论

加入 GitHub Discussions 的讨论。分享想法、提出问题或帮助他人。

加入讨论 →

开发环境搭建

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): descriptionfix(security): descriptiondocs(readme): description

PR 要求

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

项目治理

MAREF 由核心维护者团队治理。重大决策通过 RFC 和社区讨论做出。

100+
GitHub Stars
4,300+
测试通过
82%
代码覆盖率

保持联系

在 GitHub 上关注 MAREF,及时了解版本发布、RFC 和社区新闻。