mirror of
https://github.com/RooVetGit/Roo-Code.git
synced 2026-09-07 08:26:51 +00:00
138 lines
4.7 KiB
Markdown
Generated
138 lines
4.7 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 是一個由社群驅動的專案，我們深深重視每一份貢獻。為了簡化協作流程，我們採用 [Issue-First](#issue-first-方式) 原則，這表示所有 [Pull Request (PR)](#提交-pull-request) 必須先關聯至 GitHub Issue。請仔細閱讀本指南。
|
||
|
||
## 目錄
|
||
|
||
- [貢獻前須知](#貢獻前須知)
|
||
- [尋找與規劃你的貢獻](#尋找與規劃你的貢獻)
|
||
- [開發與提交流程](#開發與提交流程)
|
||
- [法律聲明](#法律聲明)
|
||
|
||
## 貢獻前須知
|
||
|
||
### 1. 行為準則
|
||
|
||
所有貢獻者必須遵守我們的[行為準則](./CODE_OF_CONDUCT.md)。
|
||
|
||
### 2. 專案藍圖
|
||
|
||
我們的藍圖指引專案方向。請將你的貢獻與這些關鍵目標保持一致：
|
||
|
||
### 可靠性優先
|
||
|
||
- 確保差異編輯和命令執行始終可靠
|
||
- 減少阻礙常規使用的摩擦點
|
||
- 確保在所有語言環境和平台上順暢運行
|
||
- 擴展對各種 AI 供應商和模型的強大支援
|
||
|
||
### 增強使用者體驗
|
||
|
||
- 簡化使用者介面，提高清晰度和直覺性
|
||
- 持續改進工作流程，滿足開發者對日常工具的高期望
|
||
|
||
### 引領代理效能
|
||
|
||
- 建立全面的評估基準（evals）衡量實際工作中的生產力
|
||
- 讓每個人都能輕鬆執行和解讀這些評估
|
||
- 提供明顯提升評分的改進
|
||
|
||
在 PR 中請提及與這些領域的關聯。
|
||
|
||
### 3. 加入 Roo Code 社群
|
||
|
||
- **主要方式：** 加入我們的 [Discord](https://discord.gg/roocode) 並私訊 **Hannes Rudolph (`hrudolph`)**。
|
||
- **替代方式：** 有經驗的貢獻者可透過 [GitHub Projects](https://github.com/orgs/RooCodeInc/projects/1) 直接參與。
|
||
|
||
## 尋找與規劃你的貢獻
|
||
|
||
### 貢獻類型
|
||
|
||
- **Bug 修正：** 解決程式碼問題。
|
||
- **新功能：** 新增功能。
|
||
- **文件：** 完善指南和提高清晰度。
|
||
|
||
### Issue-First 方式
|
||
|
||
所有貢獻必須從 GitHub Issue 開始。
|
||
|
||
- **檢查現有 issue：** 搜尋 [GitHub Issues](https://github.com/RooCodeInc/Roo-Code/issues)。
|
||
- **建立 issue：** 使用適當範本：
|
||
- **Bug：** 「Bug Report」範本。
|
||
- **功能：** 「Detailed Feature Proposal」範本。開始前需獲得批准。
|
||
- **認領 issue：** 留言並等待正式分配。
|
||
|
||
**未關聯已批准 issue 的 PR 可能會被關閉。**
|
||
|
||
### 決定要做什麼
|
||
|
||
- 查看 [GitHub 專案](https://github.com/orgs/RooCodeInc/projects/1) 中未分配的「Good First Issues」。
|
||
- 文件相關，請訪問 [Roo Code Docs](https://github.com/RooCodeInc/Roo-Code-Docs)。
|
||
|
||
### 回報 Bug
|
||
|
||
- 先檢查是否已有相關報告。
|
||
- 使用 [「Bug Report」範本](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) 建立新 bug 報告。
|
||
- **安全問題：** 透過 [security advisories](https://github.com/RooCodeInc/Roo-Code/security/advisories/new) 私下回報。
|
||
|
||
## 開發與提交流程
|
||
|
||
### 開發環境設定
|
||
|
||
1. **Fork & Clone：**
|
||
|
||
```
|
||
git clone https://github.com/你的帳號/Roo-Code.git
|
||
```
|
||
|
||
2. **安裝相依套件：**
|
||
|
||
```
|
||
npm run install:all
|
||
```
|
||
|
||
3. **除錯：** 在 VS Code 中按 `F5` 開啟。
|
||
|
||
### 程式碼規範
|
||
|
||
- 每個 PR 專注於一個功能或修正。
|
||
- 遵循 ESLint 和 TypeScript 最佳實踐。
|
||
- 撰寫清晰的提交訊息，引用相關 issue（如 `Fixes #123`）。
|
||
- 提供完整測試（`npm test`）。
|
||
- 提交前先在最新 `main` 分支上進行 rebase。
|
||
|
||
### 提交 Pull Request
|
||
|
||
- 如需早期回饋，可先提交**草稿 PR**。
|
||
- 清晰描述你的更改，遵循 Pull Request 範本。
|
||
- 為 UI 變更提供截圖/影片。
|
||
- 說明是否需要更新文件。
|
||
|
||
### Pull Request 政策
|
||
|
||
- 必須引用已批准並分配的 issue。
|
||
- 不遵守政策的 PR 可能會被關閉。
|
||
- PR 應通過 CI 測試，符合藍圖，並有清晰文件。
|
||
|
||
### 審查流程
|
||
|
||
- **每日篩查：** 維護者快速檢查。
|
||
- **每週深入審查：** 全面評估。
|
||
- **根據回饋快速迭代**。
|
||
|
||
## 法律聲明
|
||
|
||
提交貢獻即表示你同意你的貢獻將基於 Apache 2.0 授權條款，與 Roo Code 的授權一致。
|