diff --git a/locales/zh-tw/CODE_OF_CONDUCT.md b/locales/zh-tw/CODE_OF_CONDUCT.md index 9f8791ecd9..b5439fa180 100644 --- a/locales/zh-tw/CODE_OF_CONDUCT.md +++ b/locales/zh-tw/CODE_OF_CONDUCT.md @@ -2,46 +2,48 @@ ## 我們的承諾 -為了促進一個開放和歡迎的環境，我們作為貢獻者和維護者承諾，使我們的項目和社區的參與對每個人來說都是一個無騷擾的體驗，不論年齡、體型、殘疾、種族、性別特徵、性別認同和表達、經驗水平、教育程度、社會經濟地位、國籍、個人外貌、種族、宗教或性取向。 +為了營造開放且友善的環境，我們身為貢獻者與維護者，承諾讓參與本專案及社群的體驗，對每個人都不帶有騷擾，不論其年齡、體型、身心障礙、族裔、性徵、性別認同與表現、經驗程度、教育程度、社經地位、國籍、個人外表、種族、宗教信仰、或性傾向。 -## 我們的標準 +## 我們的準則 -有助於創造積極環境的行為示例包括： +有助於創造正面環境的行為包括： -- 使用歡迎和包容的語言 -- 尊重不同的觀點和經驗 -- 優雅地接受建設性的批評 -- 專注於對社區最有利的事情 -- 對其他社區成員表示同情 +- 使用友善和包容的語言 +- 尊重不同的觀點與經驗 +- 優雅地接受建設性批評 +- 著重於對社群最有利的事情 +- 對其他社群成員展現同理心 -參與者不可接受的行為示例包括： +參與者不可接受的行為包括： -- 使用性化語言或圖像以及不受歡迎的性注意或挑逗 -- 騷擾、侮辱/貶低性評論和個人或政治攻擊 -- 公開或私下騷擾 -- 未經明確許可發布他人的私人信息，例如物理或電子地址 -- 其他在專業環境中合理認為不適當的行為 +- 使用帶有性暗示的言語或影像，以及不受歡迎的性關注或騷擾 +- 挑釁、羞辱/貶低他人的評論，以及人身或政治攻擊 +- 公開或私下的騷擾行為 +- 未經他人明確許可，公開他人的私人資料，如實體或電子郵件地址 +- 其他在專業環境中可被合理認定為不恰當的行為 ## 我們的責任 -項目維護者有責任澄清可接受行為的標準，並預期對任何不可接受行為的實例採取適當和公平的糾正行動。 +專案維護者有責任釐清可接受行為的標準，並應對任何不可接受的行為採取適當且公平的糾正措施。 -項目維護者有權利和責任刪除、編輯或拒絕與本行為準則不符的評論、提交、代碼、維基編輯、問題和其他貢獻，或暫時或永久禁止任何他們認為不適當、威脅、冒犯或有害的貢獻者。 +專案維護者有權利和責任移除、編輯或拒絕不符合本行為準則的評論、提交、程式碼、維基編輯、議題和其他貢獻，或暫時或永久封鎖任何他們認為有不當、威脅、冒犯或有害行為的貢獻者。 -## 範圍 +## 範疇 -此行為準則適用於項目空間內以及當個人代表項目或其社區時的公共空間。代表項目或社區的示例包括使用官方項目電子郵件地址、通過官方社交媒體帳戶發布或作為在線或離線活動的指定代表。項目的代表可能由項目維護者進一步定義和澄清。 +本行為準則適用於專案空間及公開場合，當個人代表本專案或其社群時都必須遵守。代表本專案或社群的情況包括：使用官方專案電子郵件地址、透過官方社群媒體帳號發文，或在線上或實體活動中擔任指定代表。專案維護者可進一步定義並釐清專案代表的其他情況。 ## 執行 -濫用、騷擾或其他不可接受行為的實例可以通過聯繫項目團隊 hi@cline.bot 來報告。所有投訴將被審查和調查，並將根據情況作出必要和適當的回應。項目團隊有義務對事件的報告者保密。具體執行政策的詳細信息可能會單獨發布。 +如發生辱罵、騷擾或其他不可接受的行為，請透過 hi@cline.bot 聯絡專案團隊回報。所有申訴都將被審查和調查，並做出必要且合適的回應。專案團隊有義務為事件回報者保密。具體執行政策的更多細節可能另行公佈。 -未能善意遵循或執行行為準則的項目維護者可能會面臨由項目領導層其他成員決定的暫時或永久後果。 +未遵守或未切實執行本行為準則的專案維護者，可能會面臨由專案領導團隊其他成員所決定的暫時或永久的處置。 -## 歸屬 +## 來源說明 -此行為準則改編自 [Contributor Covenant][homepage]，版本 1.4，可在 https://www.contributor-covenant.org/version/1/4/code-of-conduct.html 獲得。 +本行為準則改編自[貢獻者公約][homepage]第 1.4 版，可在此查閱： +https://www.contributor-covenant.org/version/1/4/code-of-conduct.html [homepage]: https://www.contributor-covenant.org -有關此行為準則的常見問題的答案，請參見 https://www.contributor-covenant.org/faq +關於本行為準則的常見問題解答，請參考： +https://www.contributor-covenant.org/faq diff --git a/locales/zh-tw/CONTRIBUTING.md b/locales/zh-tw/CONTRIBUTING.md index 698a897c50..55120e9635 100644 --- a/locales/zh-tw/CONTRIBUTING.md +++ b/locales/zh-tw/CONTRIBUTING.md @@ -1,82 +1,85 @@ -# 貢獻於 Cline +# 貢獻至 Cline -我們很高興您有興趣為 Cline 做出貢獻。無論您是修復錯誤、添加功能還是改進我們的文檔，每一個貢獻都讓 Cline 更加智能！為了保持我們的社區充滿活力和歡迎，所有成員必須遵守我們的[行為準則](CODE_OF_CONDUCT.md)。 +我們非常感謝您有意願貢獻至 Cline。無論是修正程式錯誤、新增功能或改善文件，每一份貢獻都能讓 Cline 更加出色！為了維持社群的活力與友善，所有成員都必須遵守我們的[行為準則](CODE_OF_CONDUCT.md)。 -## 報告錯誤或問題 +## 回報程式錯誤或問題 -錯誤報告有助於讓 Cline 對每個人都更好！在創建新問題之前，請[搜索現有問題](https://github.com/cline/cline/issues)以避免重複。當您準備報告錯誤時，請前往我們的[問題頁面](https://github.com/cline/cline/issues/new/choose)，您會找到一個模板來幫助您填寫相關信息。 +程式錯誤回報能幫助 Cline 變得更好！在建立新的議題之前，請先[搜尋現有議題](https://github.com/cline/cline/issues)，避免重複。當您準備好回報程式錯誤時，請前往我們的[議題頁面](https://github.com/cline/cline/issues/new/choose)，您會找到協助填寫相關資訊的範本。
- 🔐 重要： 如果您發現安全漏洞，請使用Github 安全工具私下報告。 + 🔐 重要： 若您發現安全性漏洞，請使用 GitHub 安全性工具進行私密回報。
-## 決定要做什麼 +## 決定要處理的工作 -尋找一個好的首次貢獻？查看標有["good first issue"](https://github.com/cline/cline/labels/good%20first%20issue)或["help wanted"](https://github.com/cline/cline/labels/help%20wanted)的問題。這些是專門為新貢獻者和我們希望得到幫助的領域策劃的！ +想找適合第一次貢獻的工作嗎？請檢視標示為[「good first issue」](https://github.com/cline/cline/labels/good%20first%20issue)或[「help wanted」](https://github.com/cline/cline/labels/help%20wanted)的議題。這些議題特別適合新手貢獻者，我們也非常歡迎您的協助！ -我們也歡迎對我們[文檔](https://github.com/cline/cline/tree/main/docs)的貢獻！無論是修正錯別字、改進現有指南還是創建新的教育內容 - 我們希望建立一個由社區驅動的資源庫，幫助每個人充分利用 Cline。您可以從深入研究 `/docs` 並尋找需要改進的領域開始。 +我們也歡迎對[文件](https://github.com/cline/cline/tree/main/docs)的貢獻！無論是修正錯字、改善現有指南或建立新的教學內容，我們都期待能建立一個由社群共同維護的知識庫，協助每個人充分運用 Cline。您可以從 `/docs` 開始，尋找需要改善的地方。 -如果您計劃開發一個更大的功能，請先創建一個[功能請求](https://github.com/cline/cline/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop)，以便我們討論它是否符合 Cline 的願景。 +若您計畫處理較大的功能，請先建立一個[功能請求](https://github.com/cline/cline/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop)，以便我們討論該功能是否符合 Cline 的願景。 -## 開發設置 +## 開發環境設定 -1. **VS Code 擴展** +1. **VS Code 擴充套件** + - 開啟專案時，VS Code 會提示您安裝建議的擴充套件 + - 這些擴充套件是開發所需，請接受所有安裝提示 + - 若您已關閉提示，可從擴充套件面板手動安裝 - - 打開項目時，VS Code 會提示您安裝推薦的擴展 - - 這些擴展是開發所需的 - 請接受所有安裝提示 - - 如果您忽略了提示，可以從擴展面板手動安裝它們 +2. **本機開發** + - 執行 `npm run install:all` 安裝相依套件 + - 執行 `npm run test` 在本機執行測試 + - 提交 PR 前，執行 `npm run format:fix` 格式化您的程式碼 -2. **本地開發** - - 運行 `npm run install:all` 安裝依賴項 - - 運行 `npm run test` 本地運行測試 - - 提交 PR 之前，運行 `npm run format:fix` 格式化您的代碼 +## 撰寫與提交程式碼 -## 編寫和提交代碼 +任何人都可以貢獻程式碼至 Cline，但我們要求您遵守以下指引，以確保您的貢獻能順利整合： -任何人都可以為 Cline 貢獻代碼，但我們要求您遵循以下指南，以確保您的貢獻能夠順利集成： +1. **保持 Pull Request 聚焦** + - 每個 PR 限制在單一功能或錯誤修正 + - 將較大的變更拆分成較小且相關的 PR + - 將變更拆分成邏輯性的提交，以便獨立審查 -1. **保持 Pull Requests 集中** - - - 將 PR 限制在單個功能或錯誤修復 - - 將較大的更改拆分為較小的相關 PR - - 將更改分為邏輯提交，可以獨立審查 - -2. **代碼質量** - - - 運行 `npm run lint` 檢查代碼風格 - - 運行 `npm run format` 自動格式化代碼 - - 所有 PR 必須通過包括 lint 和格式化在內的 CI 檢查 +2. **程式碼品質** + - 執行 `npm run lint` 檢查程式碼風格 + - 執行 `npm run format` 自動格式化程式碼 + - 所有 PR 必須通過包含程式碼風格檢查與格式化的 CI 檢查 - 提交前解決所有 ESLint 警告或錯誤 - - 遵循 TypeScript 最佳實踐並保持類型安全 + - 遵循 TypeScript 最佳實務並維持型別安全 3. **測試** + - 為新功能新增測試 + - 執行 `npm test` 確保所有測試通過 + - 若您的變更影響現有測試，請更新測試 + - 適當時包含單元測試與整合測試 - - 為新功能添加測試 - - 運行 `npm test` 確保所有測試通過 - - 如果您的更改影響現有測試，請更新它們 - - 在適當的地方包括單元測試和集成測試 +4. **使用 Changesets 管理版本** + - 使用 `npm run changeset` 為任何面向使用者的變更建立 changeset + - 選擇適當的版本升級： + - `major` 重大變更 (1.0.0 → 2.0.0) + - `minor` 新功能 (1.0.0 → 1.1.0) + - `patch` 錯誤修正 (1.0.0 → 1.0.1) + - 撰寫清晰且描述性的 changeset 訊息，說明影響 + - 僅文件變更不需建立 changeset -4. **提交指南** +5. **提交指引** + - 撰寫清晰且描述性的提交訊息 + - 使用慣用提交格式（例如：「feat:」、「fix:」、「docs:」） + - 在提交中引用相關議題，使用 #issue-number - - 撰寫清晰、描述性的提交消息 - - 使用常規提交格式（例如 "feat:"、"fix:"、"docs:"） - - 在提交中引用相關問題，使用 #issue-number +6. **提交前檢查** + - 將您的分支 rebase 到最新的 main + - 確保您的分支可以成功建置 + - 再次確認所有測試通過 + - 檢查您的變更是否包含除錯程式碼或 console 紀錄 -5. **提交前** - - - 將您的分支重新基於最新的 main - - 確保您的分支成功構建 - - 仔細檢查所有測試是否通過 - - 檢查您的更改是否有任何調試代碼或控制台日誌 - -6. **Pull Request 描述** - - 清楚地描述您的更改內容 - - 包括測試更改的步驟 - - 列出任何重大更改 - - 為 UI 更改添加截圖 +7. **Pull Request 說明** + - 清楚描述您的變更內容 + - 包含測試變更的步驟 + - 列出任何重大變更 + - 若有使用者介面變更，請附上截圖 ## 貢獻協議 -通過提交 pull request，您同意您的貢獻將根據與項目相同的許可證（[Apache 2.0](LICENSE)）進行許可。 +提交 Pull Request 即表示您同意您的貢獻將依照專案相同的授權條款（[Apache 2.0](LICENSE)）進行授權。 -記住：貢獻於 Cline 不僅僅是編寫代碼 - 這是關於成為一個塑造 AI 輔助開發未來的社區的一部分。讓我們一起創造一些驚人的東西！🚀 +請記住：貢獻至 Cline 不只是撰寫程式碼，更是成為塑造 AI 輔助開發未來的社群一份子。讓我們一起打造令人驚艷的成果吧！🚀 diff --git a/locales/zh-tw/README.md b/locales/zh-tw/README.md index e12bcad546..6ef9d5f9ca 100644 --- a/locales/zh-tw/README.md +++ b/locales/zh-tw/README.md @@ -1,4 +1,8 @@ -# Cline – OpenRouter 上的 \#1 +
+English | Español | Deutsch | 日本語 | 简体中文 | 繁體中文 | 한국어 +
+ +# Cline – OpenRouter 第一名的 AI 工具

@@ -8,7 +12,7 @@
-在 VS Marketplace 下載 +從 VS Marketplace 下載 Discord @@ -17,29 +21,29 @@ r/cline -功能請求 +功能建議 -我們正在招聘！ +新手上路
-認識 Cline，一個可以使用你的 **CLI** 和 **編輯器** 的 AI 助手。 +認識 Cline，一個可以使用您的**命令列介面** (CLI) 和**程式編輯器** (Editor) 的 AI 助理。 -感謝 [Claude 3.7 Sonnet 的代理編碼能力](https://www.anthropic.com/claude/sonnet)，Cline 可以一步步處理複雜的軟件開發任務。通過允許他創建和編輯文件、探索大型項目、使用瀏覽器和執行終端命令（在你授予權限後），他可以提供超越代碼完成或技術支持的幫助。Cline 甚至可以使用 Model Context Protocol (MCP) 創建新工具並擴展自己的能力。雖然自主 AI 腳本傳統上在沙盒環境中運行，但此擴展提供了一個人機交互的 GUI 來批准每個文件更改和終端命令，提供了一種安全且可訪問的方式來探索代理 AI 的潛力。 +感謝 [Claude 3.7 Sonnet 的代理式程式設計能力](https://www.anthropic.com/claude/sonnet)，Cline 能夠逐步處理複雜的軟體開發任務。透過能讓他建立和編輯檔案、探索大型專案、使用瀏覽器，以及執行終端機指令（在您授權後）的工具，他能以超越程式碼自動完成或技術支援的方式協助您。Cline 甚至能使用模型上下文協定（Model Context Protocol，MCP）來建立新工具並擴展自己的功能。雖然自主 AI 腳本傳統上會在沙箱環境中執行，但這個擴充套件提供了人機互動的圖形介面，讓您可以核准每個檔案變更和終端機指令，提供一個安全且容易使用的方式來探索代理式 AI 的潛力。 -1. 輸入你的任務並添加圖像，將模型轉換為功能應用程序或通過截圖修復錯誤。 -2. Cline 首先分析你的文件結構和源代碼 AST，運行正則表達式搜索，並閱讀相關文件以了解現有項目。通過仔細管理添加到上下文中的信息，Cline 即使在大型複雜項目中也能提供有價值的幫助，而不會使上下文窗口過載。 -3. 一旦 Cline 獲得所需信息，他可以： - - 創建和編輯文件 + 監控 linter/編譯器錯誤，從而主動修復諸如缺少導入和語法錯誤等問題。 - - 直接在你的終端中執行命令並監控其輸出，從而在編輯文件後對開發服務器問題做出反應。 - - 對於 Web 開發任務，Cline 可以在無頭瀏覽器中啟動網站，點擊、輸入、滾動並捕獲截圖和控制台日誌，從而修復運行時錯誤和視覺錯誤。 -4. 當任務完成時，Cline 將通過終端命令如 `open -a "Google Chrome" index.html` 向你展示結果，你可以通過點擊按鈕運行該命令。 +1. 輸入您的任務，並可以加入圖片來將設計稿轉換成功能性應用程式，或使用截圖來修正錯誤。 +2. Cline 會先分析您的檔案結構和程式碼 AST、執行正規表達式搜尋，並讀取相關檔案，以便在現有專案中快速掌握狀況。透過仔細管理加入上下文的資訊，Cline 可以在不超過上下文視窗的情況下，為大型且複雜的專案提供有價值的協助。 +3. 一旦 Cline 取得所需資訊後，他可以： + - 建立和編輯檔案，並在過程中監控程式碼檢查工具/編譯器的錯誤，讓他能主動修正缺少的匯入語句和語法錯誤等問題。 + - 直接在您的終端機中執行指令並監控其輸出，讓他能夠在編輯檔案後回應開發伺服器的問題。 + - 對於網頁開發任務，Cline 可以在無頭瀏覽器中啟動網站、點選、輸入、捲動並擷取螢幕截圖和主控台記錄，讓他能修正執行時錯誤和視覺問題。 +4. 當任務完成時，Cline 會以終端機指令（如 `open -a "Google Chrome" index.html`）向您呈現結果，您只需點選按鈕即可執行。 -> [!提示] -> 使用 `CMD/CTRL + Shift + P` 快捷鍵打開命令面板並輸入 "Cline: Open In New Tab" 將擴展作為標籤在編輯器中打開。這讓你可以與文件資源管理器並排使用 Cline，更清楚地看到他如何改變你的工作空間。 +> [!TIP] +> 使用 `CMD/CTRL + Shift + P` 快速鍵開啟命令選擇區，輸入「Cline: Open In New Tab」即可在編輯器中以分頁方式開啟擴充套件。這讓您可以同時檢視檔案總管，並更清楚地看到 Cline 如何變更您的工作區。 --- @@ -47,115 +51,137 @@ ### 使用任何 API 和模型 -Cline 支持 OpenRouter、Anthropic、OpenAI、Google Gemini、AWS Bedrock、Azure 和 GCP Vertex 等 API 提供商。你還可以配置任何兼容 OpenAI 的 API，或通過 LM Studio/Ollama 使用本地模型。如果你使用 OpenRouter，擴展會獲取他們的最新模型列表，讓你在新模型可用時立即使用。 +Cline 支援 OpenRouter、Anthropic、OpenAI、Google Gemini、AWS Bedrock、Azure 和 GCP Vertex 等 API 提供者。您也可以設定任何與 OpenAI 相容的 API，或透過 LM Studio/Ollama 使用本機模型。若您使用 OpenRouter，此擴充套件會擷取他們最新的模型列表，讓您能在新模型推出時立即使用。 -擴展還會跟蹤整個任務循環和單個請求的總令牌和 API 使用成本，讓你在每一步都了解支出情況。 - - +此擴充套件也會追蹤整個任務迴圈和個別請求的 token 總數和 API 使用成本，讓您隨時掌握費用支出。 +
-### 在終端中運行命令 +### 在終端機中執行指令 -感謝 VSCode v1.93 中的新 [終端 shell 集成更新](https://code.visualstudio.com/updates/v1_93#_terminal-shell-integration-api)，Cline 可以直接在你的終端中執行命令並接收輸出。這使他能夠執行廣泛的任務，從安裝包和運行構建腳本到部署應用程序、管理數據庫和執行測試，同時適應你的開發環境和工具鏈以正確完成工作。 +感謝 [VSCode v1.93 的終端機整合更新](https://code.visualstudio.com/updates/v1_93#_terminal-shell-integration-api)，Cline 可以直接在您的終端機中執行指令並接收輸出。這讓他能執行各種任務，從安裝套件和執行建置腳本到部署應用程式、管理資料庫和執行測試，同時適應您的開發環境和工具鏈，以正確完成工作。 -對於長時間運行的進程如開發服務器，使用“在運行時繼續”按鈕讓 Cline 在命令後台運行時繼續任務。當 Cline 工作時，他會在過程中收到任何新的終端輸出通知，讓他對可能出現的問題做出反應，例如編輯文件時的編譯時錯誤。 - - +對於開發伺服器等長時間執行的程序，使用「繼續執行中的程序」按鈕讓 Cline 在指令於背景執行時繼續任務。當 Cline 工作時，他會收到任何新的終端機輸出通知，讓他能回應可能出現的問題，例如編輯檔案時的編譯錯誤。 +
-### 創建和編輯文件 +### 建立和編輯檔案 -Cline 可以直接在你的編輯器中創建和編輯文件，向你展示更改的差異視圖。你可以直接在差異視圖編輯器中編輯或恢復 Cline 的更改，或在聊天中提供反饋，直到你對結果滿意。Cline 還會監控 linter/編譯器錯誤（缺少導入、語法錯誤等），以便他在過程中自行修復出現的問題。 +Cline 可以直接在您的編輯器中建立和編輯檔案，並顯示變更的差異檢視。您可以直接在差異檢視編輯器中編輯或還原 Cline 的變更，或在聊天中提供意見回饋，直到您滿意結果為止。Cline 也會監控程式碼檢查工具/編譯器的錯誤（缺少的匯入語句、語法錯誤等），讓他能自行修正過程中出現的問題。 -Cline 所做的所有更改都會記錄在你的文件時間軸中，提供了一種簡單的方法來跟蹤和恢復修改（如果需要）。 - - +所有 Cline 做的變更都會記錄在您檔案的時間軸中，提供簡單的方式來追蹤和還原修改。 +
### 使用瀏覽器 -借助 Claude 3.5 Sonnet 的新 [計算機使用](https://www.anthropic.com/news/3-5-models-and-computer-use) 功能，Cline 可以啟動瀏覽器，點擊元素，輸入文本和滾動，在每一步捕獲截圖和控制台日誌。這允許進行交互式調試、端到端測試，甚至是一般的網頁使用！這使他能夠自主修復視覺錯誤和運行時問題，而無需你親自操作和複製粘貼錯誤日誌。 +透過 Claude 3.5 Sonnet 的新[電腦使用](https://www.anthropic.com/news/3-5-models-and-computer-use)功能，Cline 可以啟動瀏覽器、點選元素、輸入文字和捲動，在每個步驟擷取螢幕截圖和主控台記錄。這讓互動式除錯、端對端測試，甚至一般網頁使用成為可能！這讓他能獨立修正視覺問題和執行時錯誤，而不需要您手動複製錯誤記錄。 -試試讓 Cline “測試應用程序”，看看他如何運行 `npm run dev` 命令，在瀏覽器中啟動你本地運行的開發服務器，並執行一系列測試以確認一切正常。[在這裡查看演示。](https://x.com/sdrzn/status/1850880547825823989) - - +試著請 Cline 「測試應用程式」，觀察他如何執行 `npm run dev`、在瀏覽器中啟動您的本機開發伺服器，並執行一系列測試來確認一切正常運作。[點此觀看示範](https://x.com/sdrzn/status/1850880547825823989)。 +
-### “添加一個工具……” +### 「新增一個工具來...」 -感謝 [Model Context Protocol](https://github.com/modelcontextprotocol)，Cline 可以通過自定義工具擴展他的能力。雖然你可以使用 [社區製作的服務器](https://github.com/modelcontextprotocol/servers)，但 Cline 可以創建和安裝適合你特定工作流程的工具。只需讓 Cline “添加一個工具”，他將處理所有事情，從創建新的 MCP 服務器到將其安裝到擴展中。這些自定義工具將成為 Cline 工具包的一部分，準備在未來的任務中使用。 +感謝[模型上下文協定](https://github.com/modelcontextprotocol)，Cline 可以透過自訂工具擴展他的功能。雖然您可以使用[社群製作的伺服器](https://github.com/modelcontextprotocol/servers)，但 Cline 可以改為建立專門為您的工作流程量身打造的工具。只要請 Cline 「新增工具」，他就會處理所有事情，從建立新的 MCP 伺服器到將其安裝到擴充套件中。這些自訂工具就會成為 Cline 工具箱的一部分，隨時可用於未來的任務。 -- “添加一個獲取 Jira 工單的工具”：檢索工單 AC 並讓 Cline 開始工作 -- “添加一個管理 AWS EC2 的工具”：檢查服務器指標並上下擴展實例 -- “添加一個獲取最新 PagerDuty 事件的工具”：獲取詳細信息並讓 Cline 修復錯誤 - - +- 「新增一個擷取 Jira 工單的工具」：取得工單驗收條件並讓 Cline 開始工作 +- 「新增一個管理 AWS EC2 的工具」：檢查伺服器指標並調整執行個體規模 +- 「新增一個擷取最新 PagerDuty 事件的工具」：取得詳細資訊並請 Cline 修復錯誤 +
-### 添加上下文 +### 新增上下文 -**`@url`：** 粘貼一個 URL 以供擴展獲取並轉換為 markdown，當你想給 Cline 提供最新文檔時非常有用 - -**`@problems`：** 添加工作區錯誤和警告（“問題”面板）以供 Cline 修復 - -**`@file`：** 添加文件內容，這樣你就不必浪費 API 請求批准讀取文件（+ 輸入以搜索文件） - -**`@folder`：** 一次添加文件夾的文件，以進一步加快你的工作流程 - - +**`@url`：**貼上網址讓擴充套件擷取並轉換為 Markdown，當您想給 Cline 最新文件時很有用 +**`@problems`：**新增工作區的錯誤和警告（「問題」面板）給 Cline 修正 +**`@file`：**新增檔案內容，讓您不必浪費 API 請求來核准讀取檔案（+ 輸入以搜尋檔案） +**`@folder`：**一次新增整個資料夾的檔案，讓您的工作流程更快速 +
-### 檢查點：比較和恢復 +### 檢查點：比較和還原 -當 Cline 完成任務時，擴展會在每一步拍攝你的工作區快照。你可以使用“比較”按鈕查看快照和當前工作區之間的差異，並使用“恢復”按鈕回滾到該點。 +當 Cline 處理任務時，擴充套件會在每個步驟擷取您工作區的快照。您可以使用「比較」按鈕檢視快照與目前工作區的差異，並使用「還原」按鈕回到該時間點。 -例如，當使用本地 Web 服務器時，你可以使用“僅恢復工作區”快速測試應用程序的不同版本，然後在找到要繼續構建的版本時使用“恢復任務和工作區”。這讓你可以安全地探索不同的方法而不會丟失進度。 - - +例如，在使用本機網頁伺服器時，您可以使用「僅還原工作區」來快速測試應用程式的不同版本，然後在找到想要繼續開發的版本時使用「還原任務和工作區」。這讓您能安全地探索不同方法而不會失去進度。 +
## 貢獻 -要為項目做出貢獻，請從我們的 [貢獻指南](CONTRIBUTING.md) 開始，了解基礎知識。你還可以加入我們的 [Discord](https://discord.gg/cline) 在 `#contributors` 頻道與其他貢獻者聊天。如果你正在尋找全職工作，請查看我們在 [招聘頁面](https://cline.bot/join-us) 上的開放職位！ +要為專案貢獻，請先閱讀我們的[貢獻指南](CONTRIBUTING.md)來了解基礎知識。您也可以加入我們的 [Discord](https://discord.gg/cline)，在 `#contributors` 頻道與其他貢獻者交流。如果您在尋找全職工作，請檢視我們[職涯頁面](https://cline.bot/join-us)上的職缺！

-本地開發說明 +本機開發說明 -1. 克隆倉庫 _(需要 [git-lfs](https://git-lfs.com/))_： - ```bash - git clone https://github.com/cline/cline.git - ``` -2. 在 VSCode 中打開項目： - ```bash - code cline - ``` -3. 安裝擴展和 webview-gui 的必要依賴： - ```bash - npm run install:all - ``` -4. 按 `F5`（或 `運行`->`開始調試`）啟動以打開一個加載了擴展的新 VSCode 窗口。（如果你在構建項目時遇到問題，可能需要安裝 [esbuild problem matchers 擴展](https://marketplace.visualstudio.com/items?itemName=connor4312.esbuild-problem-matchers)） +1. 複製程式碼庫（需要 [git-lfs](https://git-lfs.com/)）： + + ```bash + git clone https://github.com/cline/cline.git + ``` + +2. 在 VSCode 中開啟專案： + + ```bash + code cline + ``` + +3. 安裝擴充套件和網頁介面所需的相依套件： + + ```bash + npm run install:all + ``` + +4. 按下 `F5`（或選擇「執行」->「開始除錯」）來啟動並開啟一個已載入擴充套件的新 VSCode 視窗。（如果建置專案時遇到問題，您可能需要安裝 [esbuild problem matchers 擴充套件](https://marketplace.visualstudio.com/items?itemName=connor4312.esbuild-problem-matchers)）
-## 許可證 +
+建立 Pull Request + +1. 在建立 PR 前，產生一個 changeset 項目： + + ```bash + npm run changeset + ``` + + 這會提示您填寫： + - 變更類型（major、minor、patch） + - `major` → 重大變更（1.0.0 → 2.0.0） + - `minor` → 新功能（1.0.0 → 1.1.0） + - `patch` → 錯誤修正（1.0.0 → 1.0.1） + - 您的變更說明 + +2. 提交您的變更和產生的 `.changeset` 檔案 + +3. 推送您的分支並在 GitHub 上建立 PR。我們的 CI 會： + - 執行測試和檢查 + - Changesetbot 會建立一個顯示版本影響的評論 + - 當合併到 main 時，changesetbot 會建立一個 Version Packages PR + - 當 Version Packages PR 合併時，就會發布新版本 + +
+ +## 授權條款 [Apache 2.0 © 2025 Cline Bot Inc.](./LICENSE)