Команды

Этот документ описывает все команды, поддерживаемые Qwen Code, помогая эффективно управлять сессиями, настраивать интерфейс и контролировать его поведение.

Команды Qwen Code активируются через определенные префиксы и делятся на три категории:

Тип префикса	Описание функции	Типичный случай использования
Слэш-команды (`/`)	Контроль на метауровне самого Qwen Code	Управление сессиями, изменение настроек, получение справки
Ат-команды (`@`)	Быстрое введение содержимого локальных файлов в диалог	Позволяет ИИ анализировать указанные файлы или код в директориях
Восклицательные команды (`!`)	Прямое взаимодействие с системной оболочкой	Выполнение системных команд, таких как `git status`, `ls` и т.д.

1. Команды с косой чертой (`/`)

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

1.1 Управление сессиями и проектами

Эти команды помогают сохранять, восстанавливать и подводить итоги проделанной работы.

Команда	Описание	Примеры использования
`/init`	Анализировать текущую директорию и создать начальный файл контекста	`/init`
`/summary`	Сгенерировать сводку проекта на основе истории разговора	`/summary`
`/compress`	Заменить историю чата сводкой для экономии токенов	`/compress`
`/resume`	Возобновить предыдущую сессию разговора	`/resume`
`/restore`	Восстановить файлы в состояние до выполнения инструмента	`/restore` (список) или `/restore <ID>`

1.2 Управление интерфейсом и рабочей областью

Команды для настройки внешнего вида интерфейса и рабочей среды.

Команда	Описание	Примеры использования
`/clear`	Очистить содержимое экрана терминала	`/clear` (горячая клавиша: `Ctrl+L`)
`/theme`	Изменить визуальную тему Qwen Code	`/theme`
`/vim`	Включить/выключить режим редактирования Vim в области ввода	`/vim`
`/directory`	Управление рабочей областью с поддержкой нескольких каталогов	`/dir add ./src,./tests`
`/editor`	Открыть диалог выбора поддерживаемого редактора	`/editor`

1.3 Настройки языка

Команды специально для управления языком интерфейса и вывода.

Команда	Описание	Примеры использования
`/language`	Просмотр или изменение настроек языка	`/language`
→ `ui [язык]`	Установить язык интерфейса	`/language ui ru-RU`
→ `output [язык]`	Установить язык вывода LLM	`/language output Russian`

Доступные встроенные языки интерфейса: zh-CN (упрощенный китайский), en-US (английский), ru-RU (русский), de-DE (немецкий)
Примеры языков вывода: Chinese, English, Japanese и т.д.

1.4 Управление инструментами и моделями

Команды для управления инструментами и моделями ИИ.

Команда	Описание	Примеры использования
`/mcp`	Список настроенных серверов и инструментов MCP	`/mcp`, `/mcp desc`
`/tools`	Отображение текущего списка доступных инструментов	`/tools`, `/tools desc`
`/skills`	Список и запуск доступных навыков	`/skills`, `/skills <name>`
`/approval-mode`	Изменение режима одобрения для использования инструментов	`/approval-mode <mode (auto-edit)> --project`
→`plan`	Только анализ, без выполнения	Безопасный обзор
→`default`	Требуется одобрение для правок	Повседневное использование
→`auto-edit`	Автоматическое одобрение правок	Доверенная среда
→`yolo`	Автоматическое одобрение всего	Быстрое прототипирование
`/model`	Переключение модели, используемой в текущей сессии	`/model`
`/extensions`	Список всех активных расширений в текущей сессии	`/extensions`
`/memory`	Управление контекстом инструкций ИИ	`/memory add Важная информация`

1.5 Информация, настройки и справка

Команды для получения информации и выполнения системных настроек.

Команда	Описание	Примеры использования
`/help`	Отобразить справочную информацию о доступных командах	`/help` или `/?`
`/about`	Отобразить информацию о версии	`/about`
`/stats`	Отобразить подробную статистику для текущей сессии	`/stats`
`/settings`	Открыть редактор настроек	`/settings`
`/auth`	Изменить метод аутентификации	`/auth`
`/bug`	Сообщить о проблеме в Qwen Code	`/bug Button click unresponsive`
`/copy`	Скопировать содержимое последнего вывода в буфер обмена	`/copy`
`/quit`	Немедленно выйти из Qwen Code	`/quit` или `/exit`

1.6 Общие сочетания клавиш

Сочетание клавиш	Функция	Примечание
`Ctrl/cmd+L`	Очистить экран	Эквивалентно `/clear`
`Ctrl/cmd+T`	Переключить описание инструмента	Управление инструментами MCP
`Ctrl/cmd+C`×2	Подтверждение выхода	Безопасный механизм выхода
`Ctrl/cmd+Z`	Отменить ввод	Редактирование текста
`Ctrl/cmd+Shift+Z`	Повторить ввод	Редактирование текста

2. Команды @ (Добавление файлов)

Команды @ используются для быстрого добавления содержимого локальных файлов или каталогов в разговор.

Формат команды	Описание	Примеры
`@<путь_к_файлу>`	Вставить содержимое указанного файла	`@src/main.py Объясни этот код`
`@<путь_к_каталогу>`	Рекурсивно прочитать все текстовые файлы в каталоге	`@docs/ Кратко опиши содержание этих документов`
Отдельный символ `@`	Используется при обсуждении самого символа `@`	`@ Для чего используется этот символ в программировании?`

Примечание: Пробелы в путях должны экранироваться обратной косой чертой (например, @My\ Documents/file.txt)

3. Команды с восклицательным знаком (`!`) - выполнение команд оболочки

Команды с восклицательным знаком позволяют выполнять системные команды непосредственно в Qwen Code.

Формат команды	Описание	Примеры
`!<команда оболочки>`	Выполнить команду в подоболочке	`!ls -la`, `!git status`
Отдельный `!`	Переключиться в режим оболочки, любой ввод выполняется непосредственно как команда оболочки	`!`(ввод) → Ввести команду → `!`(выход)

Переменные окружения: для команд, выполняемых через !, будет установлена переменная окружения QWEN_CODE=1.

4. Пользовательские команды

Сохраняйте часто используемые подсказки в виде команд-шаблонов, чтобы повысить эффективность работы и обеспечить согласованность.

Примечание: Пользовательские команды теперь используют формат Markdown с необязательным заголовком YAML. Формат TOML устарел, но все еще поддерживается для обратной совместимости. При обнаружении файлов TOML будет отображено приглашение к автоматическому переносу.

Краткий обзор

Функция	Описание	Преимущества	Приоритет	Применимые сценарии
Пространство имен	Подкаталог создает команды с двоеточием в имени	Лучшая организация команд
Глобальные команды	`~/.qwen/commands/`	Доступны во всех проектах	Низкий	Персональные часто используемые команды, кросс-проектное использование
Команды проекта	`<корневой каталог проекта>/.qwen/commands/`	Специфичные для проекта, поддаются контролю версий	Высокий	Совместное использование в команде, специфичные команды проекта

Правила приоритета: Команды проекта > Пользовательские команды (при совпадении имен используется команда проекта)

Правила именования команд

Таблица сопоставления пути к файлу и имени команды

Расположение файла	Сгенерированная команда	Пример вызова
`~/.qwen/commands/test.md`	`/test`	`/test Параметр`
`<project>/git/commit.md`	`/git:commit`	`/git:commit Сообщение`

Правила именования: Разделитель пути (/ или \) преобразуется в двоеточие (:)

Спецификация формата файла Markdown (рекомендуется)

Пользовательские команды используют файлы Markdown с необязательным YAML frontmatter:


---
description: Необязательное описание (отображается в /help)
---
 
Содержимое вашего запроса здесь.
Используйте {{args}} для внедрения параметров.

Поле	Обязательное	Описание	Пример
`description`	Необязательно	Описание команды (отображается в /help)	`description: Инструмент анализа кода`
Тело запроса	Обязательно	Содержимое запроса, отправляемое модели	Любое содержимое Markdown после frontmatter

Формат файла TOML (устаревший)

Устаревший: формат TOML по-прежнему поддерживается, но будет удален в будущей версии. Пожалуйста, перейдите на формат Markdown.

Поле	Обязательное	Описание	Пример
`prompt`	Обязательное	Содержимое запроса, отправляемого модели	`prompt = "Please analyze code: {{args}}"`
`description`	Необязательное	Описание команды (отображается в /help)	`description = "Code analysis tool"`

Механизм обработки параметров

Метод обработки	Синтаксис	Применимые сценарии	Особенности безопасности
Контекстно-зависимая инъекция	`{{args}}`	Требуется точный контроль параметров	Автоматическое экранирование в shell
Обычная обработка параметров	Без специальных обозначений	Простые команды, добавление параметров	Добавляется как есть
Инъекция команды shell	`!{command}`	Требуется динамический контент	Перед выполнением требуется подтверждение

1. Инъекция с учетом контекста (`{{args}}`)

Сценарий	Конфигурация TOML	Метод вызова	Фактический эффект
Прямая инъекция	`prompt = "Fix: {{args}}"`	`/fix "Button issue"`	`Fix: "Button issue"`
В команде shell	`prompt = "Search: !{grep {{args}} .}"`	`/search "hello"`	Выполнить `grep "hello" .`

2. Обработка параметров по умолчанию

Ситуация ввода	Метод обработки	Пример
Есть параметры	Добавляются в конец запроса (разделены двумя разрывами строк)	`/cmd parameter` → Исходный запрос + параметр
Нет параметров	Отправить запрос как есть	`/cmd` → Исходный запрос

🚀 Вставка динамического содержимого

Тип вставки	Синтаксис	Порядок обработки	Назначение
Содержимое файла	`@{путь к файлу}`	Обрабатывается первым	Вставка статических справочных файлов
Команды оболочки	`!{команда}`	Обрабатывается в середине	Вставка результатов динамического выполнения
Замена параметров	`{{args}}`	Обрабатывается последним	Вставка пользовательских параметров

3. Выполнение команд оболочки (`!{...}`)

Операция	Взаимодействие с пользователем
1. Разбор команды и параметров	-
2. Автоматическое экранирование в оболочке	-
3. Показ диалога подтверждения	✅ Подтверждение пользователя
4. Выполнение команды	-
5. Вставка вывода в подсказку	-

Пример: Генерация сообщения коммита


---
description: Генерация сообщения коммита на основе подготовленных изменений
---
 
Пожалуйста, сгенерируйте сообщение коммита на основе следующего диффа:
 
```diff
!{git diff --staged}
```

4. Вставка содержимого файлов (`@{...}`)

Тип файла	Статус поддержки	Метод обработки
Текстовые файлы	✅ Полная поддержка	Прямая вставка содержимого
Изображения/PDF	✅ Мультимодальная поддержка	Кодирование и вставка
Бинарные файлы	⚠️ Ограниченная поддержка	Может быть пропущено или усечено
Каталог	✅ Рекурсивная вставка	Следование правилам .gitignore

Пример: Команда проверки кода


---
description: Проверка кода на основе лучших практик
---
 
Проверить {{args}}, справочные стандарты:
 
@{docs/code-standards.md}

Практический пример создания

Таблица создания команды “Рефакторинг чистой функции”

Операция	Команда/Код
1. Создать структуру папок	`mkdir -p ~/.qwen/commands/refactor`
2. Создать файл команды	`touch ~/.qwen/commands/refactor/pure.md`
3. Редактировать содержимое команды	См. полный код ниже.
4. Протестировать команду	`@file.js` → `/refactor:pure`


---
description: Рефакторинг кода в чистую функцию
---
 
Проанализируйте код в текущем контексте и рефакторите его в чистую функцию.
Требования:
 
1. Предоставить рефакторенный код
2. Объяснить ключевые изменения и реализацию характеристик чистой функции
3. Сохранить функцию без изменений

Сводка рекомендаций по созданию пользовательских команд

Таблица рекомендаций по проектированию команд

Практические рекомендации	Рекомендуемый подход	Избегать
Именование команд	Использовать пространства имен для организации	Избегать чрезмерно общих имен
Обработка параметров	Четко использовать `{{args}}`	Полагаться на добавление по умолчанию (легко запутаться)
Обработка ошибок	Использовать вывод ошибок Shell	Игнорировать сбои выполнения
Организация файлов	Организовывать по функциям в каталогах	Все команды в корневом каталоге
Поле описания	Всегда предоставлять четкое описание	Полагаться на автоматически генерируемое описание

Таблица напоминаний о функциях безопасности

Механизм безопасности	Эффект защиты	Операции пользователя
Экранирование оболочки	Предотвращение внедрения команд	Автоматическая обработка
Подтверждение выполнения	Избежание случайного выполнения	Диалог подтверждения
Отчет об ошибках	Помощь в диагностике проблем	Просмотр информации об ошибке