Команды

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

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

1. Слеш-команды (/)

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

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

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

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

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

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

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

• Доступные встроенные языки интерфейса: zh-CN (упрощённый китайский), en-US (английский), ru-RU (русский), de-DE (немецкий), ja-JP (японский), pt-BR (португальский — Бразилия), fr-FR (французский), ca-ES (каталанский)
• Примеры языка вывода: Chinese, English, Japanese и т.д.

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

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

1.5 Встроенные навыки

Эти команды вызывают встроенные навыки, предоставляющие специализированные рабочие процессы.

Полную документацию по /review см. в разделе Code Review.

1.6 Побочный вопрос (/btw)

Команда /btw позволяет задавать быстрые побочные вопросы, не прерывая и не влияя на основной поток беседы.

Как это работает:

• Побочный вопрос отправляется как отдельный API-вызов с контекстом последнего диалога (до последних 20 сообщений)
• Ответ отображается над Composer — вы можете продолжать печатать в ожидании
• Основной диалог не блокируется — он продолжается независимо
• Ответ на побочный вопрос не становится частью истории основного диалога
• Ответы отображаются с полной поддержкой Markdown (блоки кода, списки, таблицы и т.д.)

Сочетания клавиш (интерактивный режим):

Пример:

(While the main conversation is about refactoring code)

> /btw What's the difference between let and var in JavaScript?

  ╭──────────────────────────────────────────╮
  │ /btw What's the difference between let   │
  │     and var in JavaScript?               │
  │                                          │
  │ + Answering...                           │
  │ Press Escape, Ctrl+C, or Ctrl+D to cancel│
  ╰──────────────────────────────────────────╯
  > (Composer remains active — keep typing)

(After the answer arrives)

  ╭──────────────────────────────────────────╮
  │ /btw What's the difference between let   │
  │     and var in JavaScript?               │
  │                                          │
  │ `let` is block-scoped, while `var` is    │
  │ function-scoped. `let` was introduced    │
  │ in ES6 and doesn't hoist the same way.   │
  │                                          │
  │ Press Space, Enter, or Escape to dismiss │
  ╰──────────────────────────────────────────╯
  > (Composer still active)

Поддерживаемые режимы выполнения:

1.7 Резюме сессии (/recap)

Команда /recap создает краткое резюме «на чем вы остановились» текущей сессии, чтобы вы могли продолжить старый диалог, не прокручивая страницы истории.

Как это работает:

• Использует настроенную быструю модель (настройка fastModel), если она доступна, иначе возвращается к основной модели сессии. Для резюме достаточно небольшой и дешевой модели.
• Недавний диалог (до 30 сообщений, только текст — вызовы инструментов и ответы инструментов отфильтровываются) отправляется модели с кратким системным промптом.
• Резюме отображается тусклым цветом с префиксом ❯, чтобы оно отличалось от настоящих ответов ассистента.
• Отказывает с встроенной ошибкой, если выполняется ход модели или обрабатывается другая команда. Если нет подходящего диалога или генерация не удалась, /recap показывает короткое информационное сообщение вместо резюме — ручная команда всегда что-то отвечает. Авто-запуск при возвращении после отсутствия:

Если терминал был размыт 5+ минут и снова получает фокус, автоматически генерируется и показывается саммари (только когда нет активного ответа модели; в противном случае он ждёт завершения текущего оборота и затем срабатывает). В отличие от ручной команды, авто-запуск полностью «молчит» при ошибке: если генерация завершилась ошибкой или нечего резюмировать, сообщение не добавляется в историю. Управляется настройкой general.showSessionRecap (по умолчанию: false); ручная команда /recap всегда работает независимо от этой настройки.

Пример:

> /recap

❯ Рефакторинг loopDetectionService.ts для устранения OOM при долгих сессиях,
  вызванного безграничными streamContentHistory и contentStats. Следующий шаг —
  реализация варианта B (LRU скользящее окно с FNV-1a) после подтверждения.

1.8 Просмотр изменений (/diff)

Команда /diff открывает интерактивный просмотр изменений, показывающий неоткоммиченные правки и изменения по шагам. Используйте ←/→ для переключения между текущим git diff и отдельными шагами беседы, ↑/↓ для просмотра файлов и Enter для просмотра построчных изменений.

Как это работает:

В интерактивном режиме /diff открывает диалог с выбором источника сверху:

• Текущие — рабочее дерево vs HEAD (git diff HEAD). Показывает все неоткоммиченные изменения, включая проиндексированные, неиндексированные и неотслеживаемые файлы.
• T1, T2, T3, … — изменения по шагам, по одной вкладке на каждый шаг модели, который изменял файлы. Последние шаги показываются первыми. Каждая вкладка показывает превью исходного промпта для контекста.

Список файлов отображает статистику по каждому файлу (строк добавлено/удалено) с метками для особых состояний (new, deleted, untracked, binary, truncated, oversized). Нажмите Enter на файле, чтобы просмотреть его построчный diff с подсветкой синтаксиса.

Для изменений по шагам требуется включённое создание «чекпоинтов» файлов (по умолчанию включено в интерактивном режиме). Когда создание чекпоинтов выключено, доступен только источник «Текущие».

Горячие клавиши:

Пример:

┌ /diff · Turn 3 "refactor the auth middleware" ──── 3 files +45 -12 ┐
│                                                                     │
│ ◀ Current · T3 · T2 · T1 ▶                                         │
│                                                                     │
│ › src/utils/parser.ts                              +30 -8           │
│   src/utils/parser.test.ts                         +12 -2           │
│   README.md                                        +3 -2            │
│                                                                     │
│ ←/→ source · ↑/↓ file · Enter view · Esc close                     │
└─────────────────────────────────────────────────────────────────────┘

Неинтерактивный режим:

В безголовом (--prompt) или неинтерактивном контексте /diff выводит текстовую сводку о рабочем дереве vs HEAD. Навигация по шагам недоступна.

3 files changed, +45 / -12
  +30  -8  src/utils/parser.ts
  +12  -2  src/utils/parser.test.ts
   +3  -2  README.md

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

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

1.10 Часто используемые сочетания клавиш

1.11 Команды аутентификации

Используйте /auth в сеансе Qwen Code для настройки аутентификации. Используйте /doctor для проверки текущего состояния аутентификации и окружения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---
description: Optional description (displayed in /help)
---
 
Your prompt content here.
Use {{args}} for parameter injection.

Формат TOML (Устаревший)

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

1. Контекстная подстановка ({{args}})

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

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

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

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

---
description: Создать сообщение коммита на основе изменений в индексе
---
 
Пожалуйста, сгенерируйте сообщение коммита на основе следующего diff:
 
```diff
!{git diff --staged}
```

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

Пример: Команда для ревью кода

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

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

Таблица шагов создания команды «Рефакторинг в чистую функцию»

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

Краткое руководство по лучшим практикам пользовательских команд

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

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

5. Подкоманды CLI

Эти команды выполняются из оболочки как qwen <subcommand> перед запуском интерактивного сеанса.

Управление сеансами

qwen sessions list

Выводит список ваших последних сеансов Qwen Code с метаданными.

Флаги:

Человекочитаемый вывод (по умолчанию):

Таблица со столбцами: SESSION ID, STARTED (временная метка UTC), TITLE, BRANCH, PROMPT.

Вывод JSON (--json):

Выводит JSON Lines в stdout. Каждая строка представляет собой объект JSON с полями:

sessionId, startTime, mtime, prompt, gitBranch, customTitle, titleSource, filePath, cwd

Подсказка «has more sessions» отправляется в stderr, поэтому передача через конвейер в jq остается безопасной.

Примеры:

# Show last 20 sessions (default)
qwen sessions list
 
# Show last 50 sessions
qwen sessions list --limit 50
 
# Output as JSON for scripting
qwen sessions list --json | jq .