Sandbox

Настройка среды песочницы (Docker/Podman)

В настоящее время проект не поддерживает использование функции `BUILD_SANDBOX` после установки через пакет npm

Чтобы собрать пользовательскую песочницу, необходимо получить доступ к скриптам сборки (scripts/build_sandbox.js) в репозитории исходного кода.
Эти скрипты сборки не включены в пакеты, публикуемые в npm.
В коде присутствуют жёстко заданные проверки путей, которые явно отклоняют запросы на сборку из сред, не являющихся исходным кодом.

Если вам нужны дополнительные инструменты внутри контейнера (например, git, python, rg), создайте пользовательский Dockerfile. Конкретные действия описаны ниже.

1. Сначала клонируйте проект Qwen Code: https://github.com/QwenLM/qwen-code.git

2. Убедитесь, что следующие операции выполняются в каталоге репозитория исходного кода


 
# 1. Сначала установите зависимости проекта
npm install
 
# 2. Соберите проект Qwen Code
npm run build
 
# 3. Убедитесь, что каталог `dist` был создан  
ls -la packages/cli/dist/
 
# 4. Создайте глобальную символьную ссылку в каталоге пакета CLI  
cd packages/cli  
npm link  
 
# 5. Проверьте ссылку (она теперь должна указывать на исходный код)  
which qwen  
 
# Ожидаемый вывод: /xxx/xxx/.nvm/versions/node/v24.11.1/bin/qwen  
 
# Или аналогичный путь, но это обязательно должна быть символьная ссылка  
 
# 6. Чтобы узнать подробности о символьной ссылке, вы можете увидеть конкретный путь к исходному коду  
ls -la $(dirname $(which qwen))/../lib/node_modules/@qwen-code/qwen-code  
 
# Должно отобразиться, что это символьная ссылка, указывающая на ваш каталог с исходным кодом  
 
# 7. Протестируйте версию `qwen`  
qwen -v  
 
# Команда `npm link` перезапишет глобальную установку `qwen`. Чтобы избежать неоднозначности при совпадении номеров версий, сначала удалите глобальный CLI

3. Создайте файл `Dockerfile` для песочницы в корневом каталоге вашего проекта

Путь: .qwen/sandbox.Dockerfile
Адрес официального образа в реестре: https://github.com/QwenLM/qwen-code/pkgs/container/qwen-code


# На основе официального образа песочницы Qwen (рекомендуется явно указать версию)
FROM ghcr.io/qwenlm/qwen-code:sha-570ec43
 
# Добавьте здесь дополнительные инструменты
RUN apt-get update && apt-get install -y \
    git \
    python3 \
    ripgrep

4. Создайте первый образ песочницы в корневом каталоге вашего проекта


QWEN_SANDBOX=docker BUILD_SANDBOX=1 qwen -s
 
# Проверьте, совпадает ли версия инструмента, запущенного в песочнице, с версией вашего пользовательского образа. Если версии совпадают — запуск прошёл успешно

Это создаёт образ, специфичный для вашего проекта, на основе образа песочницы по умолчанию.

Удаление ссылки `npm`

Чтобы восстановить официальный CLI qwen, удалите ссылку npm


 
# Способ 1: Отменить глобальную привязку
npm unlink -g @qwen-code/qwen-code
 
# Способ 2: Удалить привязку в каталоге packages/cli
cd packages/cli
npm unlink
 
# Проверка отмены привязки
which qwen
 
# Должно отобразиться сообщение «qwen not found» («qwen не найден»)
 
# При необходимости переустановите глобальную версию
npm install -g @qwen-code/qwen-code
 
# Проверка восстановления привязки
which qwen
qwen --version