Skip to content

贡献指南

欢迎参与 ParrotClaw 项目!项目托管在 Gitee


贡献流程

1. Fork 项目

项目主页 点击右上角的 Fork 按钮,将仓库 fork 到你的 Gitee 账号下。

2. 克隆到本地

bash
git clone https://gitee.com/<你的用户>/parrot_claw.git
cd parrot_claw

3. 添加上游仓库

bash
git remote add upstream https://gitee.com/alexcai/parrot_claw.git

4. 创建功能分支

bash
git checkout -b feat/your-feature-name

5. 修改代码并提交

bash
git add .
git commit -m "feat: 添加 xxx 功能"

提交信息建议遵循 Conventional Commits 规范:

类型说明
feat新功能
fix修复 Bug
docs文档更新
refactor重构
chore构建/工具链相关

6. 推送到你的仓库

bash
git push origin feat/your-feature-name

7. 发起 Pull Request

在 Gitee 上进入你的 fork 仓库,点击"Pull Request" → "新建 Pull Request",选择你的分支,目标分支为 alexcai/parrot_clawmain 分支。填写变更说明后提交。


注意事项

  • 先开 Issue 讨论 — 大的功能变更建议先提 Issue 讨论方向,避免做无用功
  • 保持单次 PR 专注 — 一个 PR 解决一个问题,不要混在一起
  • 同步上游 — 提交 PR 前先拉取上游最新代码:
bash
git fetch upstream
git rebase upstream/main
  • 测试 — 确保代码编译通过,运行 flutter analyze 无错误

基于 MIT 协议发布