Qwen Studio Browser Gateway

English

Неофициальный localhost-only gateway, который даёт Claude Code одно дополнительное недоверенное экспертное мнение Qwen 3.8 Max через вручную авторизованную web-сессию chat.qwen.ai.

Это не официальный Qwen API, не основной агент и не источник гарантированно правильных ответов. Пользователь входит на сайт вручную на каждом хосте; проект не переносит cookies/tokens, не обходит CAPTCHA/MFA и не даёт Qwen доступ к shell, filesystem или локальным tools.

Поток

Claude Code
  └─ MCP ask_qwen_expert
       └─ http://127.0.0.1:8798/v1/expert
            └─ FIFO, active = 1
                 └─ CDP http://127.0.0.1:9333
                      └─ одна видимая вкладка https://chat.qwen.ai
                           └─ точная Qwen3.8-Max

Перед каждым Send gateway выбирает и подтверждает qwen3.8-max / Qwen3.8-Max. Несовпадение модели, неизвестный DOM, challenge, отсутствие login или удалённый endpoint завершаются ошибкой. После Send browser generation не повторяется автоматически.

Требования

• Node.js 22+;
• Chrome/Chromium с графическим окном;
• Linux для готовых systemd user templates (сам Node.js gateway переносим);
• собственный аккаунт Qwen и право использовать web-сервис.

Установка

npm ci
npm run check
npm run build
npm test

Создайте приватную конфигурацию:

install -d -m 700 ~/.config/qwen-studio-browser-gateway
cp .env.example ~/.config/qwen-studio-browser-gateway/server.env
chmod 600 ~/.config/qwen-studio-browser-gateway/server.env

Отредактируйте server.env:

• задайте локальный QWEN_BROWSER_EXECUTABLE_PATH;
• сгенерируйте новый случайный QWEN_LOCAL_API_KEY для этого хоста;
• не меняйте loopback endpoints;
• перед использованием подтвердите актуальные ID/label сильнейшей модели в живом UI.

Не коммитьте server.env и browser profile.

Ручной вход

Запустите отдельный браузер:

set -a
source ~/.config/qwen-studio-browser-gateway/server.env
set +a
./start-qwen-browser.sh

В открытом окне войдите на https://chat.qwen.ai самостоятельно. CAPTCHA и MFA проходит только пользователь. Оставьте одну вкладку Qwen открытой.

В другом терминале запустите gateway:

set -a
source ~/.config/qwen-studio-browser-gateway/server.env
set +a
node dist/cli.js serve

Для постоянного Linux user service используйте шаблоны в systemd/ и инструкцию docs/setup.md.

Безопасные smoke-тесты

Эти запросы не запускают генерацию:

node dist/cli.js browser doctor
curl -fsS -H "Authorization: Bearer $QWEN_LOCAL_API_KEY" \
  http://127.0.0.1:8798/health
curl -fsS -H "Authorization: Bearer $QWEN_LOCAL_API_KEY" \
  http://127.0.0.1:8798/v1/models
node dist/cli.js mcp install-config

POST /v1/expert и POST /v1/chat/completions запускают реальную web-генерацию и могут расходовать quota.

Claude Code MCP

После npm run build выполните:

node dist/cli.js mcp install-config

Команда печатает переносимый JSON с текущими путями Node.js и dist/cli.js. Добавьте объект qwen-expert в MCP-конфигурацию Claude Code на этом хосте. MCP публикует только ask_qwen_expert; ответ всегда помечается как advisory и должен проверяться независимо.

Границы безопасности

• HTTP и CDP принимают только loopback endpoints.
• QWEN_WEB_URL принимает только origin https://chat.qwen.ai.
• Локальный API key обязателен.
• Prompt-ы не логируются; screenshots выключены по умолчанию.
• Одна вкладка и одна FIFO-очередь предотвращают смешивание ответов.
• Qwen не получает executable tools или локальные файлы.
• Проект не предназначен для обхода ограничений сайта или массовой автоматизации.

Подробнее: AGENTS.md, docs/architecture.md, docs/security.md, docs/troubleshooting.md.