zen-code-docs/website/content/ru/ide-integration.md

Интеграция с 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" и установите его вручную.