CONTRIBUTING.zh.md
Rama main · réplica de lectura del repositorio original.
# Cherry Studio 贡献指南
[English](CONTRIBUTING.md) | 中文
欢迎加入 Cherry Studio 贡献者社区！我们致力于让 Cherry Studio 成为一个能够长期创造价值的项目，并期待更多开发者参与。无论你经验丰富还是刚刚入门，你的贡献都会帮助我们更好地服务用户并提升软件质量。
## 参与方式
你可以通过以下方式参与：
1. **贡献代码**：帮助开发新功能或优化现有代码。请确保代码遵循项目规范并通过全部相关测试。
2. **修复缺陷**：发现 bug 后欢迎提交修复。提交前请确认问题已经解决，并包含相关测试。
3. **维护 Issue**：协助标记、分类和解决 GitHub Issue。
4. **产品设计**：参与产品设计讨论，帮助改进用户体验和界面设计。
5. **编写文档**：帮助改进用户手册、API 文档和开发者指南。
6. **社区维护**：参与社区讨论、回答用户问题并推动社区活动。
7. **推广使用**：通过博客、社交媒体等渠道推广 Cherry Studio，吸引更多用户和开发者。
## 开始之前
请先阅读[行为准则](CODE_OF_CONDUCT.md)和[许可证](LICENSE)。
## 配置开发环境
请参阅[开发者指南](docs/dev/contrib/development.md)，了解配置本地开发环境所需的前置条件、安装步骤和可用命令。
关于项目架构、技术栈、约定和可用命令的完整概览，请参阅 [`CLAUDE.md`](CLAUDE.md)。
## 开始贡献
为了帮助你熟悉代码库，建议优先处理带有以下一个或多个标签的 Issue：[good-first-issue](https://github.com/CherryHQ/cherry-studio/labels/good%20first%20issue)、[help-wanted](https://github.com/CherryHQ/cherry-studio/labels/help%20wanted)或 [bug](https://github.com/CherryHQ/cherry-studio/labels/bug)。欢迎任何形式的帮助。
### 测试
没有测试的功能视为不存在。为了确保代码真正有效，相关流程应由单元测试和功能测试覆盖。因此，请在贡献时同时考虑可测试性。所有测试都可以在本地运行，不依赖 CI。详情请参阅[开发者指南](docs/dev/contrib/development.md)中的“Testing”部分。
### Pull Request 自动测试
Cherry Studio 组织成员创建的非 Draft pull request（PR）会自动触发测试。新贡献者创建的 PR 最初会带有 `needs-ok-to-test` 标签，不会自动运行测试。Cherry Studio 组织成员添加 `/ok-to-test` 后，测试流水线才会创建。
### 考虑使用 Draft Pull Request
并非所有 pull request 在创建时都已经可以评审。作者可能希望先展开讨论、尚未确定方向，或变更还未完成。请考虑创建 [draft pull request](https://github.blog/2019-02-14-introducing-draft-pull-requests/)。Draft PR 会跳过 CI，从而节省资源；reviewer 也不会被自动分配，社区可以据此理解该 PR 尚未准备完成。
将 Draft 标记为 ready for review 后，reviewer 才会被分配。
### 贡献者条款合规
每位贡献者都必须证明自己有权合法贡献代码。贡献者通过有意识地签署 commit 表示遵守[许可证](LICENSE)。
签署 commit 时，commit message 应包含相应声明。
```
Signed-off-by: Your Name <your.email@example.com>
```
可以使用以下命令创建带 signoff 的 commit：[git commit --signoff](https://git-scm.com/docs/git-commit#Documentation/git-commit.txt---signoff)：
```
git commit --signoff -m "Your commit message"
```
### 代码评审与合并
维护者会尽力在合理时间内帮助你实现用例，并及时提供建设性反馈。如果在评审中遇到阻碍，或 PR 长时间没有得到处理，请在相关 Issue 中留言，或通过[社区](README.md#-community)联系我们。
### 参与 Test Plan
Test Plan 旨在为用户提供更稳定的应用体验和更快的迭代速度。详情请参阅 [Test Plan](docs/dev/contrib/test-plan.md)。
### 其他建议
- **联系开发者**：提交 PR 前，可以先联系开发者进行讨论或寻求帮助。
## 重要贡献规范与关注领域
提交 Pull Request 前，请阅读以下重要信息：
### 分支策略
`main` 是所有活跃开发的默认分支——feature、refactor、optimization 和 fix 都应提交到这里。
## 联系我们
如果有任何问题或建议，可以通过以下方式联系我们：
- WeChat：kangfenmao
- [GitHub Issues](https://github.com/CherryHQ/cherry-studio/issues)
感谢你的支持与贡献！期待与你一起让 Cherry Studio 变得更好。