<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 问题](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`（或转到 **Run** → **Start Debugging**）。这将在运行 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)。祝你编码愉快！
