Github Actions：qwen-code-action

Обзор

qwen-code-action — это GitHub Action, который интегрирует Qwen Code в ваш рабочий процесс через Qwen Code CLI . Он выступает как автономный агент для важных рутинных задач кодирования, так и коллаборатор по запросу, которому можно быстро делегировать работу.

Используйте его для ревью пул-реквестов GitHub, триажа задач, анализа и модификации кода и многого другого с помощью Qwen Code в диалоговом режиме (например, @qwencoder исправь эту проблему) прямо в ваших репозиториях GitHub.

Возможности

Автоматизация: Запускайте рабочие процессы на основе событий (например, открытие задачи) или по расписанию (например, ночью).
Коллаборация по запросу: Запускайте рабочие процессы в комментариях к задачам и пул-реквестам, упоминая Qwen Code CLI (например, @qwencoder /review).
Расширяемость с помощью инструментов: Используйте возможности Qwen Code по вызову инструментов для взаимодействия с другими CLI, такими как GitHub CLI (gh).
Настраиваемость: Используйте файл QWEN.md в репозитории для предоставления проектно-специфичных инструкций и контекста Qwen Code CLI.

Быстрый старт

Начните работу с Qwen Code CLI в вашем репозитории всего за несколько минут:

1. Получите API-ключ Qwen

Получите API-ключ на DashScope (платформа Alibaba Cloud для работы с ИИ).

2. Добавьте его как секрет GitHub

Сохраните ваш API-ключ как секрет с именем QWEN_API_KEY в вашем репозитории:

Перейдите в Settings > Secrets and variables > Actions вашего репозитория.
Нажмите New repository secret.
Имя: QWEN_API_KEY, Значение: ваш API-ключ.

3. Обновите .gitignore

Добавьте следующие записи в ваш файл .gitignore:


# настройки qwen-code-cli
.qwen/

# учётные данные GitHub App
gha-creds-*.json

4. Выберите рабочий процесс

У вас есть два варианта настройки рабочего процесса:

Вариант A: Используйте команду настройки (рекомендуется)

Запустите Qwen Code CLI в терминале:
```
qwen
```
В Qwen Code CLI в терминале введите:
```
/setup-github
```

Вариант B: Скопируйте рабочие процессы вручную

Скопируйте готовые рабочие процессы из каталога examples/workflows в каталог .github/workflows вашего репозитория. Обратите внимание: рабочий процесс qwen-dispatch.yml также должен быть скопирован, так как он запускает выполнение остальных рабочих процессов.

5. Попробуйте

Ревью пул-реквеста:

Откройте пул-реквест в репозитории и дождитесь автоматического ревью.
Напишите комментарий @qwencoder /review в существующем пул-реквесте, чтобы вручную запустить ревью.

Триаж задачи:

Откройте задачу и дождитесь автоматического триажа.
Напишите комментарий @qwencoder /triage в существующей задаче, чтобы вручную запустить триаж.

Общая помощь ИИ:

В любой задаче или пул-реквесте укажите @qwencoder и ваш запрос.
Примеры:
- @qwencoder объясни это изменение кода
- @qwencoder предложи улучшения для этой функции
- @qwencoder помоги мне отладить эту ошибку
- @qwencoder напиши модульные тесты для этого компонента

Рабочие процессы

Этот action предоставляет несколько готовых рабочих процессов для различных сценариев использования. Каждый из них предназначен для копирования в каталог .github/workflows вашего репозитория и последующей настройки.

Qwen Code Dispatch

Этот рабочий процесс выступает в качестве центрального диспетчера для Qwen Code CLI, направляя запросы в соответствующий рабочий процесс в зависимости от инициирующего события и команды, указанной в комментарии. Подробное руководство по настройке диспетчерского рабочего процесса см. в документации по рабочему процессу Qwen Code Dispatch.

Триаж задач

Этот action можно использовать для автоматического триажа GitHub Issues по расписанию или по событию. Пример рабочей настройки триажа задач см. в рабочем процессе автоматического триажа задач .

Ревью пул-реквестов

Этот action можно использовать для автоматического ревью пул-реквестов при их открытии. Подробное руководство по настройке системы ревью PR см. в документации по рабочему процессу ревью PR GitHub.

Помощник Qwen Code CLI

Этот тип action можно использовать для вызова универсального диалогового ИИ-помощника Qwen Code в пул-реквестах и задачах для выполнения широкого круга задач. Подробное руководство по настройке универсального рабочего процесса Qwen Code CLI см. в документации по рабочему процессу помощника Qwen Code.

Конфигурация

Входные данные

qwen*api_key: *(Необязательно)_ API-ключ для Qwen API.
qwen*cli_version: *(Необязательно, по умолчанию: latest)_ Версия Qwen Code CLI для установки. Может быть “latest”, “preview”, “nightly”, конкретным номером версии или git-веткой, тегом или коммитом. Для получения дополнительной информации см. Релизы Qwen Code CLI .
qwen*debug: (Необязательно) Включить отладочное логирование и потоковый вывод.
qwen*model: (Необязательно) Модель для использования с Qwen Code.
prompt: (Необязательно, по умолчанию: You are a helpful assistant.) Строка, передаваемая в аргумент --prompt CLI Qwen Code.
settings: (Необязательно) Строка в формате JSON, записываемая в .qwen/settings.json для настройки проектных параметров CLI. Подробнее см. в документации по файлам настроек .
use*qwen_code_assist: (Необязательно, по умолчанию: false) Использовать ли Code Assist для доступа к модели Qwen Code вместо стандартного ключа API Qwen Code. Дополнительную информацию см. в документации CLI Qwen Code .
use*vertex_ai: (Необязательно, по умолчанию: false) Использовать ли Vertex AI для доступа к модели Qwen Code вместо стандартного ключа API Qwen Code. Дополнительную информацию см. в документации CLI Qwen Code .
extensions: (Необязательно) Список расширений CLI Qwen Code для установки.
upload*artifacts: (Необязательно, по умолчанию: false) Загружать ли артефакты в GitHub Action.
use*pnpm: (Необязательно, по умолчанию: false) Использовать ли pnpm вместо npm для установки qwen-code-cli.
workflow*name: (Необязательно, по умолчанию: ${{ github.workflow }}) Имя рабочего процесса GitHub, используется для телеметрии.

Выходные данные

summary: Суммарный вывод выполнения CLI Qwen Code.
error: Вывод ошибки выполнения CLI Qwen Code, если таковая была.

Переменные репозитория

Рекомендуется задать следующие значения как переменные репозитория, чтобы их можно было переиспользовать во всех workflows. Как вариант, вы можете задать их прямо во входах действия в отдельных workflows или для переопределения значений уровня репозитория.

Имя	Описание	Тип	Обязательно	Когда обязательно
`DEBUG`	Включает отладочное логирование для CLI Qwen Code.	Переменная	Нет	Никогда
`QWEN_CLI_VERSION`	Управляет устанавливаемой версией CLI Qwen Code.	Переменная	Нет	Фиксация версии CLI
`APP_ID`	Идентификатор GitHub App для кастомной аутентификации.	Переменная	Нет	Использование кастомного GitHub App

Чтобы добавить переменную репозитория:

Перейдите в Settings > Secrets and variables > Actions > New variable вашего репозитория.
Введите имя переменной и значение.
Сохраните.

Подробнее о переменных репозитория см. в документации GitHub по переменным .

Секреты

Вы можете задать следующие секреты в вашем репозитории:

Имя	Описание	Обязательно	Когда обязательно
`QWEN_API_KEY`	Ваш ключ API Qwen из DashScope.	Да	Требуется во всех workflows, вызывающих Qwen.
`APP_PRIVATE_KEY`	Приватный ключ для вашего GitHub App (формат PEM).	Нет	Использование кастомного GitHub App.

Чтобы добавить секрет:

Перейдите в Settings > Secrets and variables > Actions > New repository secret.
Введите имя секрета и значение.
Сохраните.

Дополнительную информацию см. в официальной документации GitHub по созданию и использованию зашифрованных секретов .

Аутентификация

Для этого действия требуется аутентификация в GitHub API и, опционально, в сервисах Qwen Code.

Аутентификация в GitHub

Вы можете аутентифицироваться в GitHub двумя способами:

Стандартный GITHUB_TOKEN: Для простых сценариев использования действие может использовать стандартный GITHUB_TOKEN, предоставляемый рабочим процессом.
Пользовательское приложение GitHub (рекомендуется): Для наиболее безопасной и гибкой аутентификации мы рекомендуем создать собственное приложение GitHub.

Подробные инструкции по настройке аутентификации как для Qwen, так и для GitHub можно найти в документации по аутентификации.

Расширения

CLI Qwen Code можно расширить с помощью дополнительных функций через расширения. Эти расширения устанавливаются из исходного кода из их репозиториев GitHub.

Подробные инструкции по настройке и конфигурированию расширений можно найти в документации по расширениям.

Кастомизация

Создайте файл QWEN.md в корне вашего репозитория, чтобы предоставить контекст и инструкции, специфичные для проекта, для CLI Qwen Code. Это полезно для определения соглашений о кодировании, архитектурных шаблонов или других правил, которым модель должна следовать для данного репозитория.

Участие в разработке

Мы приветствуем вклад в проект! Ознакомьтесь с Руководством по участию CLI Qwen Code для получения более подробной информации о том, как начать.