Skip to Content
Руководство для пользователейВозможностиComputer Use

Computer Use

В Qwen Code входит скилл computer-use, который обучает модель управлению настольными приложениями через два отдельно устанавливаемых пакета:

bundled computer-use skill -> @qwen-code/node-repl-mcp -> @qwen-code/cua-sdk/computer-use -> native cua-driver accessibility backend

Qwen Code не включает MCP-сервер, SDK или нативный драйвер. Скилл устанавливает внешние пакеты автоматически, если они отсутствуют.

Warning

Computer Use может читать UI приложений и управлять вводом мыши и клавиатуры. Используйте его только в доверенных средах и внимательно проверяйте одобрения MCP.

Автоматическая настройка

Требуется Node.js 22 или новее и npm.

При первом использовании скилл самостоятельно выполняет следующие команды:

qwen mcp add --scope user node-repl npx -y @qwen-code/node-repl-mcp@0.1.0 npm install --no-save --package-lock=false @qwen-code/cua-sdk@0.20.0

Перезапустите Qwen Code после первого добавления MCP-сервера. Затем скилл продолжает задачу рабочего стола через node_repl.

Установка SDK не изменяет package.json и lockfile, но записывает в node_modules рабочего пространства. Его postinstall загружает и проверяет нативный пакет для текущей платформы.

Удаление конфигурации MCP или установки SDK в рабочем пространстве отключает путь выполнения; устаревшего фолбэка нет.

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

Попросите Qwen Code использовать $computer-use для задачи рабочего стола. После бутстрапа он следует стандартному рабочему процессу Computer Use:

  1. находит точное приложение и окно;
  2. считывает полное состояние доступности;
  3. действует через текущие семантические токены элементов, когда это возможно;
  4. получает свежее состояние после каждой мутации;
  5. проверяет запрошенный результат; и
  6. закрывает клиент SDK и сбрасывает REPL.

Драйвер — единственный компонент, который вычисляет диффы наблюдений. Код модели использует типизированные методы SDK и не диспатчит произвольные имена инструментов драйвера.

Разрешения

Node REPL — это MCP-сервер, который выполняет написанный моделью JavaScript с обычными правами Node.js. Его вызовы следуют обычному потоку одобрения MCP Qwen Code. SDK также применяет нативную авторизацию.

На macOS для наблюдения доступности и ввода требуется разрешение Accessibility. Скриншоты дополнительно требуют разрешения Screen Recording. macOS может привязать выдачу разрешения к терминалу или IDE, из которых запущен Qwen Code. Windows и Linux используют свои платформенные средства доступности и ввода.

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

  • Если node_repl всё ещё недоступен после автоматической настройки, перезапустите Qwen Code и проверьте сервер командой qwen mcp list.
  • Если импорт SDK всё ещё не работает после автоматической настройки, убедитесь, что Qwen Code запущен из рабочего пространства, где был установлен пакет.
  • После таймаута, отмены, сбоя или краха ядра заново выполните бутстрап клиента SDK и запросите свежее состояние.

См. также

Last updated on