<p align="center">
          <a href="https://marketplace.visualstudio.com/items?itemName=ZooCodeOrganization.zoo-code"><img src="https://img.shields.io/badge/VS_Code_Marketplace-007ACC?style=flat&logo=visualstudiocode&logoColor=white" alt="VS Code Marketplace"></a>
          <a href="https://x.com/ZooCodeDev"><img src="https://img.shields.io/badge/ZooCode-000000?style=flat&logo=x&logoColor=white" alt="X"></a>
          <a href="https://youtube.com/@roocodeyt?feature=shared"><img src="https://img.shields.io/badge/YouTube-FF0000?style=flat&logo=youtube&logoColor=white" alt="YouTube"></a>
          <a href="https://discord.gg/VxfP4Vx3gX"><img src="https://img.shields.io/badge/Join%20Discord-5865F2?style=flat&logo=discord&logoColor=white" alt="Join Discord"></a>
          <a href="https://www.reddit.com/r/ZooCode/"><img src="https://img.shields.io/badge/Join%20r%2FZooCode-FF4500?style=flat&logo=reddit&logoColor=white" alt="Join r/ZooCode"></a>
          <a href="https://github.com/Zoo-Code-Org/Zoo-Code/issues"><img src="https://img.shields.io/badge/GitHub-Issues-181717?style=flat&logo=github&logoColor=white" alt="GitHub Issues"></a>
        </p>
        <p align="center">
          <em>快速取得協助 → <a href="https://discord.gg/VxfP4Vx3gX">加入 Discord</a> • 比較喜歡非同步？→ <a href="https://www.reddit.com/r/ZooCode/">加入 r/ZooCode</a></em>
        </p>

        # Zoo Code

        > 您的 AI 驅動開發團隊，就在您的編輯器中

        ## 我們是 Zoo Code

> 你可能已經看到 Roo 團隊 🦘🦘🦘 的[最近公告](https://x.com/mattrubens/status/2046636598859559114)。簡單來說，團隊在把重心放到 [Roomote](https://roomote.dev/) 的同時，正在逐步減少 Roo Code 的活躍開發。這個消息讓很多 Roo 使用者都很難受；這個外掛對這個社群意義重大。
>
> 我們想感謝整個 Roo 團隊為這個外掛投入的努力。這裡不會逐一點名，但大家都能認同，他們既是卓越的開發者，也是同樣令人敬佩的優秀的人。感謝 Roo 團隊。
>
> Roo 使用者來自各種不同背景。有人在日常工作中專業使用它，也有人用它來構思難以想像的複雜 workflow。有人用它來改進 Roo 本身，也有人用它來改進 Roo 所使用的模型（超級 meta）。我們想表達的是，這個社群非常多元。雖然袋鼠 🦘🦘🦘 是高貴又有代表性的動物，但我們覺得由不同物種組成的「Zoo」🐘🦡🦒🦓🦛🦧🦭🦦 更能反映這個外掛使用者的多樣性。
>
> 因此我們想宣布，**Zoo Code** 將繼續開發這個重要專案。核心團隊由先前曾為 Roo 做出貢獻、並且非常在乎這個外掛的開發者所組成。我們會持續更新模型、修正 bug，並推出新功能。但最重要的是，我們想傾聽你們——讓這個外掛如此特別的社群。歡迎加入我們的 [Discord](https://discord.gg/VxfP4Vx3gX)、[Reddit](https://www.reddit.com/r/ZooCode)，或是[建立 PR 或 issue](https://github.com/Zoo-Code-Org/Zoo-Code)；但更重要的是，我們希望你能繼續作為社群的一分子，保持參與、保持連結、保持活躍。
>
> _-Zoo Code Team_

## 從 Roo Code 遷移到 Zoo Code

你可以在 [Roo→Zoo 遷移指南](https://docs.zoocode.dev/roo-to-zoo-migration) 中找到從 Roo Code 遷移到 Zoo Code 的快速說明。我們希望在大家轉移過程中盡可能提供協助，這也是我們設立 [Reddit](https://www.reddit.com/r/ZooCode) 和 [Discord](https://discord.gg/VxfP4Vx3gX) 社群的原因。如果你遇到問題或有任何疑問，歡迎加入後直接提問。

## v3.55.0 新功能

**Zoo Code 首個功能版本** 以 Marketplace 交接為基礎，帶來了一個新的供應商、Roo Code 的上游 sunset merge，以及一輪涵蓋聊天、供應商設定與渲染的使用者可見修正。

- 新增 Xiaomi MiMo 一級 API 供應商支援。
- 合入 Roo Code 的上游 sunset merge 與相關平台更新。
- 修正 MCP 登入文案、Gemini 全工具組請求，以及 OpenAI 在不支援 temperature 的模型上的處理。
- 修正 Markdown 單波浪號渲染與診斷暫存檔命名。
- 改善 Z.AI、GLM 與 Vertex AI 的供應商預設值與區域覆蓋。

<details>
  <summary>🌐 支援語言</summary>

- [English](../../README.md)
- [Català](../ca/README.md)
- [Deutsch](../de/README.md)
- [Español](../es/README.md)
- [Français](../fr/README.md)
- [हिंदी](../hi/README.md)
- [Bahasa Indonesia](../id/README.md)
- [Italiano](../it/README.md)
- [日本語](../ja/README.md)
- [한국어](../ko/README.md)
- [Nederlands](../nl/README.md)
- [Polski](../pl/README.md)
- [Português (BR)](../pt-BR/README.md)
- [Русский](../ru/README.md)
- [Türkçe](../tr/README.md)
- [Tiếng Việt](../vi/README.md)
- [简体中文](../zh-CN/README.md)
- [繁體中文](../zh-TW/README.md)
- ...
  </details>

---

## Zoo Code 能為您做什麼？

- 從自然語言描述生成程式碼
- 使用模式進行調整：程式碼、架構師、詢問、偵錯和自訂模式
- 重構和偵錯現有程式碼
- 編寫和更新文件
- 回答關於您程式碼庫的問題
- 自動化重複性任務
- 使用 MCP 伺服器

## 模式

Zoo Code 會配合您的工作方式，而非要您配合它：

- 程式碼模式：日常開發、編輯和檔案操作
- 架構師模式：規劃系統、規格和遷移
- 詢問模式：快速回答、解釋和文件
- 偵錯模式：追蹤問題、新增日誌、鎖定根本原因
- 自訂模式：為您的團隊或工作流程建置專門的模式

更多資訊：[使用模式](https://docs.zoocode.dev/basic-usage/using-modes) • [自訂模式](https://docs.zoocode.dev/advanced-usage/custom-modes)

## 教學和功能影片

<div align="center">

|                                                                                                                                                                     |                                                                                                                                                                  |                                                                                                                                                                    |
| :-----------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| <a href="https://www.youtube.com/watch?v=Mcq3r1EPZ-4"><img src="https://img.youtube.com/vi/Mcq3r1EPZ-4/maxresdefault.jpg" width="100%"></a><br><b>安裝 Zoo Code</b> | <a href="https://www.youtube.com/watch?v=ZBML8h5cCgo"><img src="https://img.youtube.com/vi/ZBML8h5cCgo/maxresdefault.jpg" width="100%"></a><br><b>設定設定檔</b> | <a href="https://www.youtube.com/watch?v=r1bpod1VWhg"><img src="https://img.youtube.com/vi/r1bpod1VWhg/maxresdefault.jpg" width="100%"></a><br><b>程式碼庫索引</b> |
|   <a href="https://www.youtube.com/watch?v=iiAv1eKOaxk"><img src="https://img.youtube.com/vi/iiAv1eKOaxk/maxresdefault.jpg" width="100%"></a><br><b>自訂模式</b>    |   <a href="https://www.youtube.com/watch?v=Ho30nyY332E"><img src="https://img.youtube.com/vi/Ho30nyY332E/maxresdefault.jpg" width="100%"></a><br><b>檢查點</b>   |  <a href="https://www.youtube.com/watch?v=HmnNSasv7T8"><img src="https://img.youtube.com/vi/HmnNSasv7T8/maxresdefault.jpg" width="100%"></a><br><b>上下文管理</b>  |

</div>
<p align="center">
<a href="https://docs.zoocode.dev/tutorial-videos">更多快速教學和功能影片...</a>
</p>

## 資源

- **[文件](https://docs.zoocode.dev):** 安裝、設定和掌握 Zoo Code 的官方指南。
- **[YouTube 頻道](https://youtube.com/@roocodeyt?feature=shared):** 觀看教學和功能實際操作。
- **[Discord 伺服器](https://discord.gg/VxfP4Vx3gX):** 加入社群以獲得即時協助和討論。
- **[Reddit 社群](https://www.reddit.com/r/ZooCode):** 分享您的經驗，看看其他人正在建立什麼。
- **[GitHub Issues](https://github.com/Zoo-Code-Org/Zoo-Code/issues):** 回報問題並追蹤開發進度。
- **[功能請求](https://github.com/Zoo-Code-Org/Zoo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop):** 有想法嗎？與開發人員分享。

---

## 本機設定與開發

1. **複製**儲存庫：

```sh
git clone https://github.com/Zoo-Code-Org/Zoo-Code.git
```

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

```sh
pnpm install
```

3. **執行擴充功能**:

有幾種方法可以執行 Zoo Code 擴充功能：

### 開發模式（F5）

若要進行開發，請使用 VSCode 的內建偵錯功能：

在 VSCode 中按 `F5`（或前往 **執行** → **開始偵錯**）。這將在執行 Zoo Code 擴充功能的新 VSCode 視窗中開啟。

- 對 webview 的變更將立即顯示。
- 對核心擴充功能的變更也將自動熱重載。

### 自動化 VSIX 安裝

要將擴充功能建置為 VSIX 套件並直接安裝到 VSCode 中：

```sh
pnpm install:vsix [-y] [--editor=<command>]
```

此命令將：

- 詢問要使用的編輯器命令（code/cursor/code-insiders） - 預設為“code”
- 解除安裝任何現有版本的擴充功能。
- 建置最新的 VSIX 套件。
- 安裝新建置的 VSIX。
- 提示您重新啟動 VS Code 以使變更生效。

選項：

- `-y`: 跳過所有確認提示並使用預設值
- `--editor=<command>`: 指定編輯器命令（例如 `--editor=cursor` 或 `--editor=code-insiders`）

### 手動 VSIX 安裝

如果您希望手動安裝 VSIX 套件：

1.  首先，建置 VSIX 套件：
    ```sh
    pnpm vsix
    ```
2.  將在 `bin/` 目錄中產生一個 `.vsix` 檔案（例如 `bin/zoo-code-<version>.vsix`）。
3.  使用 VSCode CLI 手動安裝：
    ```sh
    code --install-extension bin/zoo-code-<version>.vsix
    ```

---

我們使用 [changesets](https://github.com/changesets/changesets) 進行版本控制和發布。有關發行說明，請查看我們的 `CHANGELOG.md`。

---

## 免責聲明

**請注意**，Zoo Code **不**對與 Zoo Code 相關的任何程式碼、模型或其他工具、任何相關的第三方工具或任何由此產生的輸出作出任何陳述或保證。您承擔使用任何此類工具或輸出的**所有風險**；此類工具均按**「原樣」**和**「可用」**的基礎提供。此類風險可能包括但不限於智慧財產權侵權、網路漏洞或攻擊、偏見、不準確、錯誤、缺陷、病毒、停機、財產損失或損害和/或人身傷害。您對自己使用任何此類工具或輸出負全部責任（包括但不限於其合法性、適當性和結果）。

---

## 貢獻

我們歡迎社群貢獻！請從閱讀我們的 [CONTRIBUTING.md](CONTRIBUTING.md) 開始。

---

## 授權

[Apache 2.0 © 2025 Zoo Code Org](../../LICENSE)

---

**盡情享受 Zoo Code！** 不論你是讓它保持短牽繩控制，還是讓它自主行動，我們都迫不及待想看看你會打造出什麼。如果你有問題或功能想法，請開一個 [issue](https://github.com/Zoo-Code-Org/Zoo-Code/issues) 或發起一個 [discussion](https://github.com/Zoo-Code-Org/Zoo-Code/discussions)。祝你寫程式愉快！
