Интеграция с IDE

Qwen Code можно интегрировать с вашей IDE для более удобной и контекстно-зависимой работы. Такая интеграция позволяет CLI лучше понимать ваше рабочее пространство и включает мощные функции, такие как native in-editor diffing.

На данный момент единственной поддерживаемой IDE является Visual Studio Code , а также другие редакторы, которые поддерживают расширения VS Code.

Возможности

Контекст рабочей области: CLI автоматически получает информацию о вашей рабочей области, чтобы предоставлять более релевантные и точные ответы. Этот контекст включает:
- 10 последних открытых файлов в вашей рабочей области.
- Активную позицию курсора.
- Любой выделенный текст (до лимита 16 КБ; более длинные выделения будут обрезаны).
Встроенный diff: Когда Qwen предлагает изменения в коде, вы можете просматривать эти изменения прямо во встроенном diff-редакторе вашей IDE. Это позволяет легко просматривать, редактировать и принимать или отклонять предложенные изменения.
Команды VS Code: Вы можете получить доступ к функциям Qwen Code прямо из палитры команд VS Code (Cmd+Shift+P или Ctrl+Shift+P):
- Qwen Code: Run: Запускает новую сессию Qwen Code во встроенном терминале.
- Qwen Code: Accept Diff: Принимает изменения в активном diff-редакторе.
- Qwen Code: Close Diff Editor: Отклоняет изменения и закрывает активный diff-редактор.
- Qwen Code: View Third-Party Notices: Отображает уведомления о сторонних библиотеках для расширения.

Установка и настройка

Есть три способа настроить интеграцию с IDE:

1. Автоматический запрос (рекомендуется)

Когда вы запускаете Qwen Code внутри поддерживаемого редактора, он автоматически определит ваше окружение и предложит подключиться. Если вы ответите “Yes”, необходимая настройка будет выполнена автоматически, включая установку соответствующего расширения и включение соединения.

2. Ручная установка через CLI

Если вы ранее отклонили запрос или хотите установить расширение вручную, вы можете выполнить следующую команду внутри Qwen Code:


/ide install

Эта команда найдет правильное расширение для вашей IDE и установит его.

3. Ручная установка из маркетплейса

Вы также можете установить расширение напрямую из маркетплейса.

Для Visual Studio Code: Установите из VS Code Marketplace .
Для форков VS Code: Чтобы поддерживать форки VS Code, расширение также опубликовано в Open VSX Registry . Следуйте инструкциям вашего редактора по установке расширений из этого реестра.

После любого метода установки рекомендуется открыть новое окно терминала, чтобы убедиться, что интеграция активирована правильно. После установки вы можете использовать /ide enable для подключения.

Использование

Включение и отключение

Вы можете управлять интеграцией с IDE прямо из CLI:

Чтобы включить подключение к IDE, выполните:
```
/ide enable
```
Чтобы отключить подключение, выполните:
```
/ide disable
```

Когда подключение включено, Qwen Code автоматически попытается подключиться к расширению-компаньону в IDE.

Проверка статуса

Чтобы проверить статус подключения и посмотреть контекст, который CLI получил от IDE, выполните:


/ide status

Если подключение установлено, эта команда покажет, к какой IDE выполнено подключение, и список недавно открытых файлов, о которых известно.

(Примечание: Список файлов ограничен 10 последними открытыми файлами в вашем workspace и включает только локальные файлы на диске.)

Работа с Diffs

Когда вы просите Gemini изменить файл, он может открыть представление diff прямо в вашем редакторе.

Чтобы принять diff, вы можете выполнить любое из следующих действий:

Нажать иконку с галочкой в заголовке редактора diff.
Сохранить файл (например, с помощью Cmd+S или Ctrl+S).
Открыть Command Palette и выполнить команду Qwen Code: Accept Diff.
Ответить yes в CLI при запросе.

Чтобы отклонить diff, вы можете:

Нажать иконку ‘x’ в заголовке редактора diff.
Закрыть вкладку редактора diff.
Открыть Command Palette и выполнить команду Qwen Code: Close Diff Editor.
Ответить no в CLI при запросе.

Вы также можете изменить предложенные изменения прямо в представлении diff перед их принятием.

Если вы выберете ‘Yes, allow always’ в CLI, изменения больше не будут отображаться в IDE, так как они будут автоматически приниматься.

Использование в песочнице

Если вы используете Qwen Code в песочнице, обратите внимание на следующее:

На macOS: Для интеграции с IDE требуется доступ к сети, чтобы взаимодействовать с расширением-компаньоном IDE. Вы должны использовать профиль Seatbelt, который разрешает доступ к сети.
В Docker-контейнере: Если вы запускаете Qwen Code внутри Docker (или Podman) контейнера, интеграция с IDE всё ещё может подключиться к расширению VS Code, запущенному на вашей хост-машине. CLI настроен таким образом, чтобы автоматически находить IDE-сервер по адресу host.docker.internal. Обычно никакой дополнительной настройки не требуется, но вам может понадобиться убедиться, что ваша конфигурация Docker-сети разрешает подключения из контейнера к хосту.

Устранение неполадок

Если у вас возникли проблемы с интеграцией IDE, ниже приведены некоторые распространённые сообщения об ошибках и способы их устранения.

Ошибки подключения

Сообщение: 🔴 Disconnected: Failed to connect to IDE companion extension for [IDE Name]. Please ensure the extension is running and try restarting your terminal. To install the extension, run /ide install.
- Причина: Qwen Code не смог найти необходимые переменные окружения (QWEN_CODE_IDE_WORKSPACE_PATH или QWEN_CODE_IDE_SERVER_PORT) для подключения к IDE. Обычно это означает, что расширение-компаньон IDE не запущено или не инициализировалось корректно.
- Решение:
  1. Убедитесь, что вы установили расширение Qwen Code Companion в вашей IDE и что оно включено.
  2. Откройте новое окно терминала в вашей IDE, чтобы убедиться, что оно получает правильное окружение.
Сообщение: 🔴 Disconnected: IDE connection error. The connection was lost unexpectedly. Please try reconnecting by running /ide enable
- Причина: Подключение к расширению-компаньону IDE было потеряно.
- Решение: Выполните команду /ide enable, чтобы попытаться переподключиться. Если проблема сохраняется, откройте новое окно терминала или перезапустите вашу IDE.

Ошибки конфигурации

Сообщение: 🔴 Disconnected: Directory mismatch. Qwen Code is running in a different location than the open workspace in [IDE Name]. Please run the CLI from the same directory as your project's root folder.
- Причина: Текущая рабочая директория CLI находится вне папки или workspace, открытого в вашем IDE.
- Решение: Перейдите с помощью cd в ту же директорию, которая открыта в вашем IDE, и перезапустите CLI.
Сообщение: 🔴 Disconnected: To use this feature, please open a single workspace folder in [IDE Name] and try again.
- Причина: В вашем IDE открыто несколько папок workspace или ни одна папка не открыта. Для корректной работы интеграции с IDE требуется одна корневая папка workspace.
- Решение: Откройте одну папку проекта в вашем IDE и перезапустите CLI.

Общие ошибки

Сообщение: IDE integration is not supported in your current environment. To use this feature, run Qwen Code in one of these supported IDEs: [List of IDEs]
- Причина: Вы запускаете Qwen Code в терминале или среде, которая не является поддерживаемой IDE.
- Решение: Запустите Qwen Code из встроенного терминала поддерживаемой IDE, например VS Code.
Сообщение: No installer is available for [IDE Name]. Please install the IDE companion manually from its marketplace.
- Причина: Вы выполнили команду /ide install, но CLI не имеет автоматического установщика для вашей конкретной IDE.
- Решение: Откройте маркетплейс расширений вашей IDE, найдите “Qwen Code Companion” и установите его вручную.