Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 22 additions & 47 deletions locales/zh-TW/CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,74 +2,49 @@

## 我們的承諾

為了營造開放和友善的環境,我們作為
貢獻者和維護者承諾參與我們的項目和
我們的社區將成為每個人免受騷擾的體驗,無論年齡、體型、
殘疾、種族、性別特徵、性別認同和表達、
經驗水平、教育程度、社會經濟地位、國籍、個人
外貌、種族、宗教或性認同和性取向如何。
為了營造開放且友善的環境,我們身為貢獻者與維護者,承諾讓參與本專案及社群的體驗,對每個人都不帶有騷擾,不論其年齡、體型、身心障礙、族裔、性徵、性別認同與表現、經驗程度、教育程度、社經地位、國籍、個人外表、種族、宗教信仰、或性傾向。

## 我們的標準
## 我們的準則

有助於創造積極環境的行為示例
包括:
有助於創造正面環境的行為包括:

- 使用友善和包容的語言
- 尊重不同的觀點和經驗
- 尊重不同的觀點與經驗
- 優雅地接受建設性批評
- 關注對社區最有利的事物
- 對其他社區成員表現同理心
- 著重於對社群最有利的事情
- 對其他社群成員展現同理心

參與者不可接受的行為示例包括
參與者不可接受的行為包括

- 使用與性相關的語言或圖像以及不受歡迎的性關注或
進展
- 惡意攻擊、侮辱/貶損評論以及個人或政治攻擊
- 公開或私下騷擾
- 未經明確許可發布他人的私人信息,如實體或電子
地址
- 在專業環境中可能被合理地認為不適當的其他行為
- 使用帶有性暗示的言語或影像,以及不受歡迎的性關注或騷擾
- 挑釁、羞辱/貶低他人的評論,以及人身或政治攻擊
- 公開或私下的騷擾行為
- 未經他人明確許可,公開他人的私人資料,如實體或電子郵件地址
- 其他在專業環境中可被合理認定為不恰當的行為

## 我們的責任

項目維護者有責任明確行為標準,
並應採取適當和公平的糾正措施來
應對任何不可接受的行為。
專案維護者有責任釐清可接受行為的標準,並應對任何不可接受的行為採取適當且公平的糾正措施。

項目維護者有權利和責任刪除、編輯或
拒絕與本行為準則不符的評論、提交、代碼、維基編輯、問題和其他貢獻,
或暫時或永久禁止任何其他被認為不適當、
威脅、冒犯或有害的行為的貢獻者。
專案維護者有權利和責任移除、編輯或拒絕不符合本行為準則的評論、提交、程式碼、維基編輯、議題和其他貢獻,或暫時或永久封鎖任何他們認為有不當、威脅、冒犯或有害行為的貢獻者。

## 範圍
## 範疇

本行為準則適用於項目空間和公共空間,
當個人代表項目或其社區時。代表
項目或社區的示例包括使用官方項目電子郵件地址、
通過官方社交媒體帳戶發布,或在線上或線下活動中擔任指定
代表。項目的代表行為可能會由
項目維護者進一步定義和澄清。
本行為準則適用於專案空間及公開場合,當個人代表本專案或其社群時都必須遵守。代表本專案或社群的情況包括:使用官方專案電子郵件地址、透過官方社群媒體帳號發文,或在線上或實體活動中擔任指定代表。專案維護者可進一步定義並釐清專案代表的其他情況。

## 執行

可以通過聯繫項目團隊 [email protected] 來報告
辱罵、騷擾或其他不可接受的行為。所有
投訴將被審查和調查,並將導致被認為
必要且適合情況的回應。項目團隊有
義務對事件的報告者保密。
具體執行政策的更多細節可能會單獨公布。
如發生辱罵、騷擾或其他不可接受的行為,請透過 [email protected] 聯絡專案團隊回報。所有申訴都將被審查和調查,並做出必要且合適的回應。專案團隊有義務為事件回報者保密。具體執行政策的更多細節可能另行公佈。

未真誠遵循或執行行為準則的項目維護者
可能會面臨由項目
領導其他成員確定的暫時或永久性後果。
未遵守或未切實執行本行為準則的專案維護者,可能會面臨由專案領導團隊其他成員所決定的暫時或永久的處置。

## 歸屬
## 來源說明

本行為準則改編自 [Cline 的版本][cline_coc] 的 [貢獻者公約][homepage],版本 1.4,
可在 https://www.contributor-covenant.org/version/1/4/code-of-conduct.html 獲取
本行為準則改編自 [貢獻者公約][homepage] 第 1.4 版的 [Cline 版本][cline_coc],原文可參考:
https://www.contributor-covenant.org/version/1/4/code-of-conduct.html

[cline_coc]: https://github.com/cline/cline/blob/main/CODE_OF_CONDUCT.md
[homepage]: https://www.contributor-covenant.org

關於本行為準則的常見問題解答,請參見
關於本行為準則的常見問題解答,請參考:
https://www.contributor-covenant.org/faq
156 changes: 78 additions & 78 deletions locales/zh-TW/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,82 +1,82 @@
# 貢獻於 Roo Code
# 參與貢獻 Roo Code

我們很高興您有興趣為 Roo Code 做出貢獻。無論您是修復錯誤、新增功能,還是改進我們的文檔,每一份貢獻都使 Roo Code 變得更智慧!為了保持我們社區的活力和友善,所有成員必須遵守我們的[行為準則](CODE_OF_CONDUCT.md)。
我們非常歡迎您參與貢獻 Roo Code。無論是修正錯誤、新增功能或改善文件,每一份貢獻都能讓 Roo Code 變得更加出色!為了維持社群的活力與友善氛圍,所有成員皆須遵守我們的[行為準則](CODE_OF_CONDUCT.md)。

## 加入我們的社區
## 加入我們的社群

我們強烈鼓勵所有貢獻者加入我們的 [Discord 社區](https://discord.gg/roocode)!成為我們 Discord 伺服器的一部分可幫助您
我們強烈建議所有貢獻者加入我們的 [Discord 社群](https://discord.gg/roocode)!加入 Discord 伺服器後,您可以

- 獲得關於您貢獻的即時幫助和指導
- 與其他貢獻者和核心團隊成員連接
- 了解專案發展和優先事項的最新情況
- 參與塑造 Roo Code 未來的討論
- 即時取得貢獻相關的協助與指引
- 與其他貢獻者及核心團隊成員交流
- 掌握專案的最新進展與優先事項
- 參與討論,共同塑造 Roo Code 的未來
- 尋找與其他開發者合作的機會

## 報告錯誤或問題
## 回報錯誤或問題

錯誤報告有助於為每個人改進 Roo Code!在創建新問題之前,請[搜索現有問題](https://github.com/RooVetGit/Roo-Code/issues)以避免重複。當您準備報告錯誤時,請前往我們的[問題頁面](https://github.com/RooVetGit/Roo-Code/issues/new/choose),在那裡您會找到幫助您填寫相關信息的模板
回報錯誤能幫助我們改善 Roo Code!在建立新議題前,請先[搜尋現有議題](https://github.com/RooVetGit/Roo-Code/issues),避免重複回報。當您準備好回報錯誤時,請前往我們的 [議題頁面](https://github.com/RooVetGit/Roo-Code/issues/new/choose),您將找到協助填寫相關資訊的範本

<blockquote class='warning-note'>
🔐 <b>重要:</b> 如果您發現安全漏洞,請使用 <a href="https://github.com/RooVetGit/Roo-Code/security/advisories/new">Github 安全工具私下報告</a>。
🔐 <b>重要:</b> 若您發現安全性漏洞,請透過 <a href="https://github.com/RooVetGit/Roo-Code/security/advisories/new">GitHub 安全性通報工具進行私密回報</a>。
</blockquote>

## 決定從事何種工作
## 決定貢獻方向

尋找一個良好的首次貢獻機會?查看我們 [Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) Github 專案中 "Issue [Unassigned]" 部分的問題。這些專門為新貢獻者及我們需要一些幫助的領域精心挑選
正在尋找適合新手的貢獻機會嗎?請查看我們 [Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) GitHub 專案中的「Issue [Unassigned]」區塊。這些議題特別適合新進貢獻者,也是我們最需要協助的領域

我們也歡迎對我們的[文檔](https://docs.roocode.com/)進行貢獻!無論是修正錯別字、改進現有指南,還是創建新的教育內容 - 我們希望建立一個社區驅動的資源庫,幫助每個人充分利用 Roo Code。您可以點擊任何頁面上的 "Edit this page" 快速進入 Github 中編輯文件的正確位置,或者您可以直接進入 https://github.com/RooVetGit/Roo-Code-Docs。
我們也歡迎您對[文件](https://docs.roocode.com/)提出貢獻!無論是修正錯字、改善現有指南,或建立新的教學內容,我們都希望打造一個由社群推動的知識庫,協助每個人充分運用 Roo Code。您可以點選任何頁面上的「編輯此頁面」按鈕,快速前往 GitHub 上的檔案編輯介面,或直接造訪 https://github.com/RooVetGit/Roo-Code-Docs。

如果您計劃從事更大的功能開發,請先創建一個[功能請求](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop),這樣我們可以討論它是否符合 Roo Code 的願景。您也可以查看下方的[專案路線圖](#專案路線圖),看看您的想法是否符合我們的策略方向
若您計畫開發較大型的功能,請先建立一個[功能請求](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop),讓我們能討論該功能是否符合 Roo Code 的願景。您也可以參考下方的[專案藍圖](#專案藍圖),確認您的想法是否符合我們的策略方向

## 專案路線圖
## 專案藍圖

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 的支援
- 對於「OpenAI 相容」API 的更全面支援
- xAIMicrosoft Azure AIAlibaba Cloud QwenIBM WatsonxTogether AIDeepInfraFireworks AICoherePerplexity AIFriendliAIReplicate
- 強化對 Ollama LM Studio 的支援

### 模型支援

我們希望 Roo 在儘可能多的模型上運行良好,包括本地模型
我們希望 Roo 能在更多模型上順暢運作,包括本機模型

- 透過自訂系統提示和工作流程支援本地模型
- 基準評估和測試案例
- 透過自訂系統提示與工作流程支援本機模型
- 基準測試評估與測試案例

### 系統支援

我們希望 Roo 在每個人的電腦上都能良好運行
我們希望 Roo 能在每個人的電腦上順暢運作

- 跨平台終端整合
- Mac、Windows Linux 的強大一致支援
- 跨平台終端機整合
- Mac、Windows Linux 提供穩定且一致的支援

### 文檔
### 文件

我們希望為所有用戶和貢獻者提供全面、易於存取的文檔
我們希望為所有使用者與貢獻者提供完整且易於取得的文件

- 擴展的用戶指南和教程
- 清晰的 API 文檔
- 更好的貢獻者指導
- 多語言文檔資源
- 互動式示例和代碼示例
- 擴充使用者指南與教學
- 清晰的 API 文件
- 更完善的貢獻者指引
- 多語言文件資源
- 互動式範例與程式碼範例

### 穩定性

我們希望顯著減少錯誤數量並增加自動化測試
我們希望顯著降低錯誤數量並增加自動化測試

- 調試日誌開關
- 用於發送錯誤/支援請求的「機器/任務資訊」複製按鈕
- 除錯記錄開關
- 用於傳送錯誤/支援請求的「機器/工作資訊」複製按鈕

### 國際化

Expand All @@ -87,87 +87,87 @@ Roo Code 有一個明確的開發路線圖,指導我們的優先事項和未
- हम चाहते हैं कि Roo Code हर किसी की भाषा बोले
- نريد أن يتحدث Roo Code لغة الجميع

我們特別歡迎推進我們路線圖目標的貢獻。如果您正在處理符合這些支柱的內容,請在您的 PR 描述中提及。
我們特別歡迎推動藍圖目標的貢獻。如果您的貢獻符合這些核心支柱,請在 PR 描述中提及。

## 開發設置
## 開發環境設定

1. **克隆**存儲庫
1. **複製**儲存庫

```sh
git clone https://github.com/RooVetGit/Roo-Code.git
```

2. **安裝依賴項**:
2. **安裝相依套件**:

```sh
npm run install:all
```

3. **啟動網頁視圖(帶有 HMR 的 Vite/React 應用)**:
3. **啟動網頁檢視(Vite/React 應用程式,支援 HMR)**:

```sh
npm run dev
```

4. **調試**:
在 VSCode 中按 `F5`(或**運行** → **開始調試**)打開一個加載了 Roo Code 的新會話
4. **除錯**:
在 VSCode 中按下 `F5`(或選擇**執行** → **開始除錯**)以開啟載入 Roo Code 的新工作階段

網頁視圖的更改將立即顯示。核心擴展的更改將需要重新啟動擴展主機
網頁檢視的變更會立即顯示。核心擴充功能的變更則需要重新啟動擴充主機

或者,您可以構建一個 .vsix 文件並直接在 VSCode 中安裝:
或者,您也可以建置 .vsix 檔案並直接在 VSCode 中安裝:

```sh
npm run build
```

一個 `.vsix` 文件將出現在 `bin/` 目錄中,可以使用以下命令安裝
建置完成後,`.vsix` 檔案會出現在 `bin/` 目錄中,可使用以下指令安裝

```sh
code --install-extension bin/roo-cline-<version>.vsix
```

## 編寫和提交代碼
## 撰寫與提交程式碼

任何人都可以為 Roo Code 貢獻代碼,但我們要求您遵循以下準則,以確保您的貢獻能夠順利整合
任何人都能為 Roo Code 貢獻程式碼,但請遵守以下準則,確保您的貢獻能順利整合

1. **保持拉取請求的專注性**
1. **保持 Pull Request 聚焦**

- PR 限制在單一功能或錯誤修復上
- 將較大的更改分成較小的、相關的 PR
- 將更改分成可以獨立審查的邏輯提交
- 每個 PR 限制在單一功能或錯誤修正
- 將較大的變更拆分成較小且相關的 PR
- 將變更拆分成可獨立審查的邏輯提交

2. **代碼質量**
2. **程式碼品質**

- 所有 PR 必須通過 CI 檢查,包括 linting 和格式化
- 提交前解決任何 ESLint 警告或錯誤
- 回應 Ellipsis(我們的自動代碼審查工具)的所有反饋
- 遵循 TypeScript 最佳實踐並保持類型安全
- 所有 PR 必須通過包含程式碼檢查與格式化的 CI 檢查
- 提交前解決所有 ESLint 警告或錯誤
- 回應 Ellipsis(我們的自動化程式碼審查工具)的所有建議
- 遵循 TypeScript 最佳實務並維持型別安全

3. **測試**

- 為新功能添加測試
- 運行 `npm test` 確保所有測試通過
- 如果您的更改影響到它們,請更新現有測試
- 在適當的情況下包括單元測試和集成測試
- 為新功能新增測試
- 執行 `npm test` 確保所有測試通過
- 如果變更影響現有測試,請更新測試
- 在適當情況下包含單元測試和整合測試

4. **提交準則**

- 編寫清晰、描述性的提交消息
- 使用 #issue-number 在提交中引用相關問題
- 撰寫清晰、具描述性的提交訊息
- 使用 #issue-number 在提交中引用相關議題

5. **提交前**

- 將您的分支重新基於最新的 main
- 確保您的分支成功構建
- 確保您的分支能成功建置
- 再次檢查所有測試是否通過
- 檢查您的更改中是否有任何調試代碼或控制台日誌
- 檢查您的變更中是否有任何除錯程式碼或主控台記錄

6. **拉取請求描述**
- 清楚描述您的更改做了什麼
- 包括測試更改的步驟
- 列出任何重大更改
- 為 UI 更改添加截圖
6. **PR 描述**
- 清楚描述您的變更內容
- 包含測試變更的步驟
- 列出任何重大變更
- 為使用者介面變更附上截圖

## 貢獻協議

通過提交拉取請求,您同意您的貢獻將根據與專案相同的許可證([Apache 2.0](../LICENSE))進行許可
透過提交 Pull Request,您同意您的貢獻將依照與專案相同的授權條款([Apache 2.0](../LICENSE))進行授權
Loading
Loading