报告 bug 或兼容性问题
提供系统信息、Codewhale 版本、复现步骤、期望行为和可公开的日志。
提交 issue →参与国际开源社区
从一个具体的改进开始。
Codewhale 欢迎来自不同国家、语言、平台和经验水平的贡献者。清楚的 bug 报告、复现结果、文档修正、翻译和小而完整的代码补丁都会直接帮助项目。
现在就可以参与
选择适合你的贡献方式。
改进代码或测试
选择一个边界清楚的问题，提交最小补丁，并用回归测试证明修改后的行为。
查看待处理 issues →改进文档或翻译
修正不准确的说明、补充实际示例，或帮助完整语言包保持自然且与英文键一致。
阅读本地化指南 →复现和审查现有工作
验证 issue 或 pull request 在你的平台和提供商上的行为，并分享准确的测试结果。
浏览 pull requests →Pull request 流程
从问题到可审查的补丁。
- 01
选择一个明确的问题
先浏览 open issues，尤其是 good first issue 和 help wanted。如果问题尚未记录，请在开始大改动前提交带复现步骤的 issue。
浏览 open issues → - 02
Fork 并创建分支
克隆你的 fork，并使用简短的分支名，例如 fix/provider-timeout 或 docs/fleet-example。无关修改请拆成不同的 pull request。
打开仓库 → - 03
- 04
审查准备
让修改容易验证。
审查者需要看到问题、修改理由、测试证据和剩余风险。范围越清楚，反馈通常越快。
- 一个 PR 只解决一个问题，便于测试、审查和保留贡献者署名。
- 新增行为应有测试；修正文档时，请核对实际命令、配置名和当前版本。
- 修改认证、凭据、沙箱、发布流程、品牌或全局提示词前，请先提交 issue 并确认范围。
- 如果维护者需要整理或摘取补丁，原作者仍会在提交、CHANGELOG 和贡献者名单中获得署名。
本地开发
构建并运行相关检查。
仓库使用 stable Rust。先运行你所修改部分的测试，再运行格式检查、Clippy 和完整工作区测试。
git clone https://github.com/YOUR_USERNAME/CodeWhale.git cd CodeWhale git checkout -b fix/your-change cargo build cargo test -p <owning-crate> --locked cargo fmt --all -- --check cargo clippy --workspace --all-targets --all-features --locked -- -D warnings cargo test --workspace --all-features --locked