<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

        > Твоя команда разработчиков на ИИ — прямо в редакторе

        ## Мы — Zoo Code

> Возможно, ты видел [недавнее объявление](https://x.com/mattrubens/status/2046636598859559114) команды Roo 🦘🦘🦘. Коротко: команда постепенно сворачивает активную разработку Roo Code, сосредоточившись на [Roomote](https://roomote.dev/). Эта новость тяжело далась многим пользователям Roo; этот плагин очень много значит для этого сообщества.
>
> Мы хотим поблагодарить всю команду Roo за работу, которую они вложили в этот плагин. Мы не будем перечислять здесь каждого по имени, но все можем согласиться, что это выдающиеся разработчики и, что не менее важно, невероятные люди. Спасибо команде Roo.
>
> Пользователи Roo очень разные. Кто-то использует его профессионально каждый день, кто-то — чтобы придумывать невероятно сложные workflow. Кто-то помогает улучшать сам Roo, а кто-то — модели, которые использует Roo (супер мета). Суть в том, что сообщество разнообразно, и хотя кенгуру 🦘🦘🦘 — благородное и достойное животное, нам показалось, что «Zoo» 🐘🦡🦒🦓🦛🦧🦭🦦 лучше отражает это разнообразие пользователей плагина.
>
> Поэтому мы хотим объявить, что **Zoo Code** продолжит развитие этого важного проекта. Основная команда состоит из разработчиков, которые раньше уже вносили вклад в Roo и которым действительно небезразличен этот плагин. Мы продолжим обновлять модели, исправлять ошибки и выпускать новые функции. Но больше всего мы хотим слушать вас — сообщество, которое сделало этот плагин таким особенным. Так что присоединяйся к нашему [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 Code на Zoo Code можно найти в [гайде по миграции Roo→Zoo](https://docs.zoocode.dev/roo-to-zoo-migration). Мы хотим как можно лучше помочь пользователям во время перехода, и именно для этого у нас есть [Reddit](https://www.reddit.com/r/ZooCode) и [Discord](https://discord.gg/VxfP4Vx3gX). Если у тебя возникнут проблемы или вопросы, заходи и спрашивай.

## Что нового в v3.55.0

**Первый функциональный релиз Zoo Code** развивает Marketplace-handoff и приносит нового провайдера, upstream sunset merge из Roo Code и серию заметных пользователю исправлений в чате, настройках провайдеров и рендеринге.

- Добавлен Xiaomi MiMo как полноценный API-провайдер.
- Подтянут upstream sunset merge из Roo Code и связанные обновления платформы.
- Исправлены текст на странице входа MCP, запросы Gemini с полным набором инструментов и обработка температуры OpenAI для моделей, которые её не поддерживают.
- Исправлены рендеринг 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:

Нажмите `F5` (или перейдите в меню **Выполнить** → **Начать отладку**) в VSCode. Это откроет новое окно VSCode с запущенным расширением Zoo Code.

- Изменения в веб-представлении появятся немедленно.
- Изменения в ядре расширения также будут автоматически перезагружены "на лету".

### Автоматическая установка 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.  Файл `.vsix` будет сгенерирован в каталоге `bin/` (например, `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). Приятного кодинга!
