mirror of
https://github.com/RooVetGit/Roo-Code.git
synced 2026-09-09 22:31:08 +00:00
141 lines
5.5 KiB
Markdown
Generated
141 lines
5.5 KiB
Markdown
Generated
<div align="center">
|
||
<sub>
|
||
|
||
[English](../../CONTRIBUTING.md) • [Català](../ca/CONTRIBUTING.md) • [Deutsch](../de/CONTRIBUTING.md) • [Español](../es/CONTRIBUTING.md) • [Français](../fr/CONTRIBUTING.md) • [हिंदी](../hi/CONTRIBUTING.md) • [Bahasa Indonesia](../id/CONTRIBUTING.md) • [Italiano](../it/CONTRIBUTING.md) • [日本語](../ja/CONTRIBUTING.md)
|
||
|
||
</sub>
|
||
<sub>
|
||
|
||
[한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • [Polski](../pl/CONTRIBUTING.md) • [Português (BR)](../pt-BR/CONTRIBUTING.md) • [Русский](../ru/CONTRIBUTING.md) • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • <b>繁體中文</b>
|
||
|
||
</sub>
|
||
</div>
|
||
|
||
# 為 Roo Code 做出貢獻
|
||
|
||
Roo Code 是一個由社群驅動的專案，我們非常重視每一份貢獻。為了簡化協作，我們採用 [「問題優先」的方法](#問題優先方法)，這意味著所有的 [拉取請求 (PR)](#提交拉取請求) 都必須先連結到一個 GitHub 問題。請仔細閱讀本指南。
|
||
|
||
## 目錄
|
||
|
||
- [在您貢獻之前](#在您貢獻之前)
|
||
- [尋找和規劃您的貢獻](#尋找和規劃您的貢獻)
|
||
- [開發和提交流程](#開發和提交流程)
|
||
- [法律](#法律)
|
||
|
||
## 在您貢獻之前
|
||
|
||
### 1. 行為準則
|
||
|
||
所有貢獻者都必須遵守我們的 [行為準則](./CODE_OF_CONDUCT.md)。
|
||
|
||
### 2. 專案路線圖
|
||
|
||
我們的路線圖指導著專案的方向。請將您的貢獻與這些關鍵目標保持一致：
|
||
|
||
### 可靠性第一
|
||
|
||
- 確保差異編輯和命令執行始終可靠。
|
||
- 減少阻礙常規使用的摩擦點。
|
||
- 保證在所有地區和平台上的流暢操作。
|
||
- 擴大對各種人工智慧提供商和模型的強大支援。
|
||
|
||
### 增強的使用者體驗
|
||
|
||
- 簡化使用者介面/使用者體驗，以提高清晰度和直觀性。
|
||
- 不斷改進工作流程，以滿足開發人員對日常使用工具的高期望。
|
||
|
||
### 在代理效能上領先
|
||
|
||
- 建立全面的評估基準 (evals) 來衡量真實世界的生產力。
|
||
- 讓每個人都能輕鬆執行和解釋這些評估。
|
||
- 發布能顯示評估分數明顯提高的改進。
|
||
|
||
在您的 PR 中提及與這些領域的一致性。
|
||
|
||
### 3. 加入 Roo Code 社群
|
||
|
||
- **主要方式：** 加入我們的 [Discord](https://discord.gg/roocode) 並私訊 **Hannes Rudolph (`hrudolph`)**。
|
||
- **替代方式：** 經驗豐富的貢獻者可以透過 [GitHub 專案](https://github.com/orgs/RooCodeInc/projects/1) 直接參與。
|
||
|
||
## 尋找和規劃您的貢獻
|
||
|
||
### 貢獻類型
|
||
|
||
- **錯誤修復：** 解決程式碼問題。
|
||
- **新功能：** 新增功能。
|
||
- **文件：** 改進指南和清晰度。
|
||
|
||
### 問題優先方法
|
||
|
||
所有貢獻都始於使用我們精簡範本的 GitHub 問題。
|
||
|
||
- **檢查現有問題**：在 [GitHub 問題](https://github.com/RooCodeInc/Roo-Code/issues) 中搜尋。
|
||
- **使用以下範本建立問題**：
|
||
- **增強功能：** 「增強請求」範本（著重於使用者利益的簡單語言）。
|
||
- **錯誤：** 「錯誤報告」範本（最少的重現步驟 + 預期與實際 + 版本）。
|
||
- **想參與其中嗎？** 在問題上評論“領取”，並在[Discord](https://discord.gg/roocode)上私訊 **Hannes Rudolph (`hrudolph`)** 以獲得分配。分配將在帖子中確認。
|
||
- **PR 必須連結到問題。** 未連結的 PR 可能會被關閉。
|
||
|
||
### 決定做什麼
|
||
|
||
- 查看 [GitHub 專案](https://github.com/orgs/RooCodeInc/projects/1) 中的「問題 [未分配]」問題。
|
||
- 如需文件，請造訪 [Roo Code 文件](https://github.com/RooCodeInc/Roo-Code-Docs)。
|
||
|
||
### 報告錯誤
|
||
|
||
- 首先檢查現有的報告。
|
||
- 使用 [「錯誤報告」範本](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 建立一個新錯誤，並提供：
|
||
- 清晰、編號的重現步驟
|
||
- 預期與實際結果
|
||
- Roo Code 版本（必需）；如果相關，還需提供 API 提供商/模型
|
||
- **安全問題**：透過 [安全公告](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) 私下報告。
|
||
|
||
## 開發和提交流程
|
||
|
||
### 開發設定
|
||
|
||
1. **複製和克隆：**
|
||
|
||
```
|
||
git clone https://github.com/您的使用者名稱/Roo-Code.git
|
||
```
|
||
|
||
2. **安裝依賴項：**
|
||
|
||
```
|
||
pnpm install
|
||
```
|
||
|
||
3. **偵錯：** 使用 VS Code 開啟（`F5`）。
|
||
|
||
### 編碼指南
|
||
|
||
- 每個功能或修復一個集中的 PR。
|
||
- 遵循 ESLint 和 TypeScript 的最佳實踐。
|
||
- 編寫清晰、描述性的提交，並引用問題（例如，`修復 #123`）。
|
||
- 提供全面的測試（`npm test`）。
|
||
- 在提交前變基到最新的 `main` 分支。
|
||
|
||
### 提交拉取請求
|
||
|
||
- 如果希望獲得早期回饋，請以 **草稿 PR** 開始。
|
||
- 遵循拉取請求範本，清晰地描述您的變更。
|
||
- 在 PR 描述/標題中連結問題（例如，“修復 #123”）。
|
||
- 為使用者介面變更提供螢幕截圖/影片。
|
||
- 指明是否需要更新文件。
|
||
|
||
### 拉取請求政策
|
||
|
||
- 必須引用一個已分配的 GitHub 問題。要獲得分配：在問題上評論“領取”，並在[Discord](https://discord.gg/roocode)上私訊 **Hannes Rudolph (`hrudolph`)**。分配將在帖子中確認。
|
||
- 未連結的 PR 可能會被關閉。
|
||
- PR 必須通過 CI 測試，與路線圖保持一致，並有清晰的文件。
|
||
|
||
### 審查流程
|
||
|
||
- **每日分類：** 維護人員進行快速檢查。
|
||
- **每週深入審查：** 全面評估。
|
||
- **根據回饋及時迭代**。
|
||
|
||
## 法律
|
||
|
||
透過貢獻，您同意您的貢獻將根據 Apache 2.0 授權進行授權，這與 Roo Code 的授權一致。
|