Интеграция с 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 не запущено или не инициализировалось корректно.
  • Решение:
    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 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” и установите его вручную.