CONTRIBUTING.md

Contributing to Wootype

Git 工作流程

分支策略

我们使用 Git Flow 风格的分支管理：

• master: 稳定版本分支
• develop: 开发集成分支
• feature/*: 功能分支
• bugfix/*: 修复分支
• release/*: 发布分支

开发流程

1. 创建功能分支

   git checkout develop
   git pull origin develop
   git checkout -b feature/your-feature-name

2. 提交更改

   git add -A
   git commit -m "feat: add new feature description
   
   Detailed description of the changes."

3. 合并到 develop

   git checkout develop
   git merge feature/your-feature-name
   git push origin develop

提交信息规范

遵循 Conventional Commits:

• feat: 新功能
• fix: 修复
• docs: 文档
• style: 格式调整
• refactor: 重构
• perf: 性能优化
• test: 测试
• chore: 构建/工具

Git 别名

项目配置了常用别名：

git st      # status
git co      # checkout
git br      # branch
git ci      # commit
git lg      # log --oneline --graph --all
git lg5     # log --oneline -5

版本标签

• v0.1.0-phase1 - 阶段一：共存架构
• v0.2.0-phase2 - 阶段二：服务化 (计划中)
• v0.3.0-phase3 - 阶段三：语义操作系统 (计划中)

开发指南

运行测试

cargo test

代码检查

cargo clippy
cargo fmt --check

提交前检查清单

• 代码可以编译
• 测试通过
• Clippy 无警告
• 代码已格式化
• 提交信息符合规范