Интеграция с IDE
Qwen Code можно интегрировать с вашей IDE для более удобной и контекстно-зависимой работы. Такая интеграция позволяет CLI лучше понимать ваше рабочее пространство и включает мощные функции, такие как нативное сравнение изменений прямо в редакторе.
На данный момент единственной поддерживаемой 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 внутри поддерживаемого редактора, он автоматически определит вашу среду и предложит подключиться. Если вы ответите «Да», необходимая настройка будет выполнена автоматически, включая установку расширения-компаньона и включение соединения.
2. Ручная установка через CLI
Если вы ранее отклонили запрос или хотите установить расширение вручную, вы можете выполнить следующую команду внутри Qwen Code:
/ide install
Эта команда найдет правильное расширение для вашей IDE и установит его.
3. Ручная установка из маркетплейса
Вы также можете установить расширение напрямую из маркетплейса.
- Для Visual Studio Code: Установите из VS Code Marketplace .
- Для форков VS Code: Чтобы поддерживать форки VS Code, расширение также опубликовано в Open VSX Registry . Следуйте инструкциям вашего редактора для установки расширений из этого реестра.
ПРИМЕЧАНИЕ: Расширение “Qwen Code Companion” может отображаться внизу результатов поиска. Если вы не видите его сразу, попробуйте прокрутить вниз или отсортировать по “Новым публикациям”.
После ручной установки расширения необходимо выполнить
/ide enable
в CLI, чтобы активировать интеграцию.
Использование
Включение и отключение
Вы можете управлять интеграцией с IDE прямо из CLI:
- Чтобы включить подключение к IDE, выполните:
/ide enable
- Чтобы отключить подключение, выполните:
/ide disable
При включении Qwen Code автоматически попытается подключиться к расширению-компаньону в IDE.
Проверка статуса
Чтобы проверить статус подключения и посмотреть контекст, который CLI получил от IDE, выполните:
/ide status
Если подключение установлено, эта команда покажет, к какой IDE выполнено подключение, а также список недавно открытых файлов, о которых известно.
(Примечание: Список файлов ограничен 10 последними открытыми файлами в вашем workspace и включает только локальные файлы на диске.)
Работа с Diffs
Когда вы просите модель Qwen изменить файл, она может открыть 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, так как они будут автоматически приниматься.
Использование в песочнице (Sandboxing)
Если вы используете 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 не запущено или не инициализировалось корректно. - Решение:
- Убедитесь, что вы установили расширение Qwen Code Companion в вашей IDE и что оно включено.
- Откройте новое окно терминала в вашей IDE, чтобы убедиться, что оно получило правильное окружение.
- Причина: Qwen Code не смог найти необходимые переменные окружения (
-
Сообщение:
🔴 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 workspace folder in [IDE Name] and try again.
- Причина: В вашем IDE не открыт ни один workspace.
- Решение: Откройте 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. Please install the Qwen Code Companion extension manually from the marketplace.
- Причина: Вы выполнили команду
/ide install
, но CLI не имеет автоматического установщика для вашей конкретной IDE. - Решение: Откройте маркетплейс расширений вашей IDE, найдите “Qwen Code Companion” и установите его вручную.
- Причина: Вы выполнили команду