# Contributing

感谢你对本项目的关注！欢迎通过 Issue 和 Pull Request 参与贡献。

## 开发流程

1. Fork 本仓库
2. 创建特性分支：`git checkout -b feature/your-feature`
3. 提交更改：`git commit -m "feat: add your feature"`
4. 推送分支：`git push origin feature/your-feature`
5. 创建 Pull Request

## 构建与测试

```bash
# Debug 构建（包含测试）
cmake --preset default
cmake --build --preset default

# 运行测试
ctest --preset default

# Release 构建
cmake --preset release
cmake --build --preset release
```

## 代码规范

- C++/CUDA 代码遵循 `.clang-format` 规则（Google-based, 4-space indent, 100 column limit）
- 使用 `.editorconfig` 中定义的缩进和格式规则
- 新增功能请附带测试和文档更新

## 提交信息格式

推荐使用 [Conventional Commits](https://www.conventionalcommits.org/)：

| 类型 | 说明 |
|------|------|
| `feat:` | 新功能 |
| `fix:` | Bug 修复 |
| `docs:` | 文档更新 |
| `perf:` | 性能优化 |
| `refactor:` | 代码重构 |
| `test:` | 测试相关 |
| `chore:` | 构建/工具变更 |

## 需要帮助？

- 查看 [快速开始](docs/zh/QUICK_START.md) 了解项目设置
- 查看 [API 参考](docs/zh/API_REFERENCE.md) 了解接口细节
- 查看 [架构设计](docs/zh/ARCHITECTURE.md) 了解系统设计

详细的贡献指南请参阅 [中文贡献指南](docs/zh/CONTRIBUTING.md) 或 [English Contributing Guide](docs/en/CONTRIBUTING.md)。