e075fbfa90
* Add roadmap to CONTRIBUTING * Update locales/zh-TW/CONTRIBUTING.md Co-authored-by: ellipsis-dev[bot] <65095814+ellipsis-dev[bot]@users.noreply.github.com> --------- Co-authored-by: ellipsis-dev[bot] <65095814+ellipsis-dev[bot]@users.noreply.github.com>
6.5 KiB
貢獻於 Roo Code
我們很高興您有興趣為 Roo Code 做出貢獻。無論您是修復錯誤、新增功能，還是改進我們的文檔，每一份貢獻都使 Roo Code 變得更智慧！為了保持我們社區的活力和友善，所有成員必須遵守我們的行為準則。
加入我們的社區
我們強烈鼓勵所有貢獻者加入我們的 Discord 社區！成為我們 Discord 伺服器的一部分可幫助您：
- 獲得關於您貢獻的即時幫助和指導
- 與其他貢獻者和核心團隊成員連接
- 了解專案發展和優先事項的最新情況
- 參與塑造 Roo Code 未來的討論
- 尋找與其他開發者合作的機會
報告錯誤或問題
錯誤報告有助於為每個人改進 Roo Code！在創建新問題之前，請搜索現有問題以避免重複。當您準備報告錯誤時，請前往我們的問題頁面，在那裡您會找到幫助您填寫相關信息的模板。
🔐 重要： 如果您發現安全漏洞，請使用 Github 安全工具私下報告。
決定從事何種工作
尋找一個良好的首次貢獻機會？查看我們 Roo Code Issues Github 專案中 "Issue [Unassigned]" 部分的問題。這些專門為新貢獻者及我們需要一些幫助的領域精心挑選！
我們也歡迎對我們的文檔進行貢獻！無論是修正錯別字、改進現有指南，還是創建新的教育內容 - 我們希望建立一個社區驅動的資源庫，幫助每個人充分利用 Roo Code。您可以點擊任何頁面上的 "Edit this page" 快速進入 Github 中編輯文件的正確位置，或者您可以直接進入 https://github.com/RooVetGit/Roo-Code-Docs。
如果您計劃從事更大的功能開發，請先創建一個功能請求，這樣我們可以討論它是否符合 Roo Code 的願景。您也可以查看下方的專案路線圖，看看您的想法是否符合我們的策略方向。
專案路線圖
Roo Code 有一個明確的開發路線圖，指導我們的優先事項和未來方向。了解我們的路線圖可以幫助您：
- 使您的貢獻與專案目標保持一致
- 識別您的專業知識最有價值的領域
- 理解某些設計決策背後的背景
- 為支持我們願景的新功能找到靈感
我們當前的路線圖專注於六個關鍵支柱：
提供商支援
我們的目標是支援儘可能多的提供商：
- 更加多功能的 "OpenAI Compatible" 支援
- xAI, Microsoft Azure AI, Alibaba Cloud Qwen, IBM Watsonx, Together AI, DeepInfra, Fireworks AI, Cohere, Perplexity AI, FriendliAI, Replicate
- 增強對 Ollama 和 LM Studio 的支援
模型支援
我們希望 Roo 在儘可能多的模型上運行良好，包括本地模型：
- 透過自訂系統提示和工作流程支援本地模型
- 基準評估和測試案例
系統支援
我們希望 Roo 在每個人的電腦上都能良好運行：
- 跨平台終端整合
- 對 Mac、Windows 和 Linux 的強大一致支援
文檔
我們希望為所有用戶和貢獻者提供全面、易於存取的文檔：
- 擴展的用戶指南和教程
- 清晰的 API 文檔
- 更好的貢獻者指導
- 多語言文檔資源
- 互動式示例和代碼示例
穩定性
我們希望顯著減少錯誤數量並增加自動化測試：
- 調試日誌開關
- 用於發送錯誤/支援請求的「機器/任務資訊」複製按鈕
國際化
我們希望 Roo 能說每個人的語言：
- 我們希望 Roo Code 說每個人的語言
- Queremos que Roo Code hable el idioma de todos
- हम चाहते हैं कि Roo Code हर किसी की भाषा बोले
- نريد أن يتحدث Roo Code لغة الجميع
我們特別歡迎推進我們路線圖目標的貢獻。如果您正在處理符合這些支柱的內容，請在您的 PR 描述中提及。
開發設置
- 克隆存儲庫：
git clone https://github.com/RooVetGit/Roo-Code.git
- 安裝依賴項：
npm run install:all
- 啟動網頁視圖（帶有 HMR 的 Vite/React 應用）：
npm run dev
- 調試：
在 VSCode 中按
F5（或運行 → 開始調試）打開一個加載了 Roo Code 的新會話。
網頁視圖的更改將立即顯示。核心擴展的更改將需要重新啟動擴展主機。
或者，您可以構建一個 .vsix 文件並直接在 VSCode 中安裝：
npm run build
一個 .vsix 文件將出現在 bin/ 目錄中，可以使用以下命令安裝：
code --install-extension bin/roo-cline-<version>.vsix
編寫和提交代碼
任何人都可以為 Roo Code 貢獻代碼，但我們要求您遵循以下準則，以確保您的貢獻能夠順利整合：
-
保持拉取請求的專注性
- 將 PR 限制在單一功能或錯誤修復上
- 將較大的更改分成較小的、相關的 PR
- 將更改分成可以獨立審查的邏輯提交
-
代碼質量
- 所有 PR 必須通過 CI 檢查，包括 linting 和格式化
- 提交前解決任何 ESLint 警告或錯誤
- 回應 Ellipsis（我們的自動代碼審查工具）的所有反饋
- 遵循 TypeScript 最佳實踐並保持類型安全
-
測試
- 為新功能添加測試
- 運行
npm test確保所有測試通過 - 如果您的更改影響到它們，請更新現有測試
- 在適當的情況下包括單元測試和集成測試
-
提交準則
- 編寫清晰、描述性的提交消息
- 使用 #issue-number 在提交中引用相關問題
-
提交前
- 將您的分支重新基於最新的 main
- 確保您的分支成功構建
- 再次檢查所有測試是否通過
- 檢查您的更改中是否有任何調試代碼或控制台日誌
-
拉取請求描述
- 清楚描述您的更改做了什麼
- 包括測試更改的步驟
- 列出任何重大更改
- 為 UI 更改添加截圖
貢獻協議
通過提交拉取請求，您同意您的貢獻將根據與專案相同的許可證（Apache 2.0）進行許可。