scriptoriumadmin/Roo-Code
1
0
Fork 0
mirror of https://github.com/RooVetGit/Roo-Code.git synced 2026-10-07 02:58:15 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
Roo-Code/locales/zh-TW/CONTRIBUTING.md
Smartsheet-JB-Brown 919bb121d0
Jbbrown/bedrock caching (#2071) 
* Bedrock prompt caching

* remove whitespace only change to src/api/providers/base-provider.ts

* remove integration test that calls bedrock

* PR prep cleanup

* test file and redundant code cleanup

* updated multi-cache-point

* optimized cache strategy

* cache logic updated. commit before trying to simplify newConversationPlacements

* simplified initial cachePoint logic

* fix the missing caching params for claude 3.7 on bedrock

* undo unintentional changes to README.md files

* fix merge bug that hid use prompt cache checkbox

* prep for PR

* remove unintended changes

* revert .gitignore change

* undo unintended changes

* Issue 1998 - Unable to use ARN. https://github.com/RooVetGit/Roo-Code/issues/1998 - Simplify region extraction from Arns. Change example of ARN use from the foundational model ARN to an inference profile ARN which is what is needed.

* small updates to error message

* more flexible support for ARNs and hardening of ARN handling

* update comment on regex use for platform indipendent cosideration

* small code comment update

* remove duplicative logic to add a region to the arn when cross-region is selected

* Update README files from main branch

* improve error handling when on-demand throughput is not avialable for a foundational model

* fix prompt router bug

* minor tweaks for simplicity

* error messgae formatting

* set new version of bedrock runtime package

* fixes: 2229 - complete prompt doesn't work and appears like a no-op

* remove commented out logger.debug blocks per PR review request

* localize new prompt cache UI inputs

* single source of truth for AWS Region information

---------

Co-authored-by: Matt Rubens <mrubens@users.noreply.github.com>
2025-04-03 13:05:29 -04:00

6.4 KiB
Raw Permalink Blame History

參與貢獻 Roo Code

我們非常歡迎您參與貢獻 Roo Code。無論是修正錯誤、新增功能或改善文件，每一份貢獻都能讓 Roo Code 變得更加出色！為了維持社群的活力與友善氛圍，所有成員皆須遵守我們的行為準則。

加入我們的社群

我們強烈建議所有貢獻者加入我們的 Discord 社群！加入 Discord 伺服器後，您可以：

  • 即時取得貢獻相關的協助與指引
  • 與其他貢獻者及核心團隊成員交流
  • 掌握專案的最新進展與優先事項
  • 參與討論，共同塑造 Roo Code 的未來
  • 尋找與其他開發者合作的機會

回報錯誤或問題

回報錯誤能幫助我們改善 Roo Code！在建立新議題前，請先搜尋現有議題，避免重複回報。當您準備好回報錯誤時，請前往我們的 議題頁面，您將找到協助填寫相關資訊的範本。

🔐 重要： 若您發現安全性漏洞，請透過 GitHub 安全性通報工具進行私密回報。

決定貢獻方向

正在尋找適合新手的貢獻機會嗎？請查看我們 Roo Code Issues GitHub 專案中的「Issue [Unassigned]」區塊。這些議題特別適合新進貢獻者，也是我們最需要協助的領域！

我們也歡迎您對文件提出貢獻！無論是修正錯字、改善現有指南，或建立新的教學內容，我們都希望打造一個由社群推動的知識庫，協助每個人充分運用 Roo Code。您可以點選任何頁面上的「編輯此頁面」按鈕，快速前往 GitHub 上的檔案編輯介面，或直接造訪 https://github.com/RooVetGit/Roo-Code-Docs。

若您計畫開發較大型的功能，請先建立一個功能請求，讓我們能討論該功能是否符合 Roo Code 的願景。您也可以參考下方的專案藍圖，確認您的想法是否符合我們的策略方向。

專案藍圖

Roo Code 擁有明確的開發藍圖，指引我們的優先事項與未來方向。了解我們的藍圖能協助您：

  • 讓您的貢獻與專案目標保持一致
  • 找到最能發揮您專長的領域
  • 理解特定設計決策的脈絡
  • 為支援我們願景的新功能尋找靈感

目前的藍圖聚焦於六大核心支柱：

供應商支援

我們致力於完善各家供應商的支援：

  • 對於「OpenAI 相容」API 的更全面支援
  • 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 描述中提及。

開發環境設定

  1. 複製儲存庫：
git clone https://github.com/RooVetGit/Roo-Code.git
  1. 安裝相依套件：
npm run install:all
  1. 啟動網頁檢視（Vite/React 應用程式，支援 HMR）：
npm run dev
  1. 除錯： 在 VSCode 中按下 F5（或選擇執行 → 開始除錯）以開啟載入 Roo Code 的新工作階段。

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

或者，您也可以建置 .vsix 檔案並直接在 VSCode 中安裝：

npm run build

建置完成後，.vsix 檔案會出現在 bin/ 目錄中，可使用以下指令安裝：

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

撰寫與提交程式碼

任何人都能為 Roo Code 貢獻程式碼，但請遵守以下準則，確保您的貢獻能順利整合：

  1. 保持 Pull Request 聚焦

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

  2. 程式碼品質

    • 所有 PR 必須通過包含程式碼檢查與格式化的 CI 檢查
    • 提交前解決所有 ESLint 警告或錯誤
    • 回應 Ellipsis（我們的自動化程式碼審查工具）的所有建議
    • 遵循 TypeScript 最佳實務並維持型別安全

  3. 測試

    • 為新功能新增測試
    • 執行 npm test 確保所有測試通過
    • 如果變更影響現有測試，請更新測試
    • 在適當情況下包含單元測試和整合測試

  4. 提交準則

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

  5. 提交前

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

  6. PR 描述

    • 清楚描述您的變更內容
    • 包含測試變更的步驟
    • 列出任何重大變更
    • 為使用者介面變更附上截圖

貢獻協議

透過提交 Pull Request，您同意您的貢獻將依照與專案相同的授權條款（Apache 2.0）進行授權。