Команды

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

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

1. Slash-команды (/)

Slash-команды используются для управления сессиями, интерфейсом и базовым поведением 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 Управление инструментами и моделями

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

1.5 Встроенные skills

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

Полную документацию по /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 сообщений, только текст — вызовы инструментов и ответы фильтруются) отправляется модели с кратким системным промптом.
• Резюме отображается приглушенным цветом с префиксом ❯, чтобы отличаться от обычных ответов ассистента.
• Откажется с inline-ошибкой, если выполняется ход модели или обрабатывается другая команда. Если нет подходящего диалога или базовая генерация завершается сбоем, /recap покажет короткое информационное сообщение вместо резюме — ручная команда всегда что-то отвечает.

Автозапуск при возвращении:

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

Пример:

> /recap

❯ Refactoring loopDetectionService.ts to address long-session OOM caused by
  unbounded streamContentHistory and contentStats. The next step is to
  implement option B (LRU sliding window with FNV-1a) pending confirmation.

1.8 Просмотр diff (/diff)

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

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

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

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

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

Diff для каждого хода требует включения контрольных точек файлов (по умолчанию включено в интерактивном режиме). Когда контрольные точки файлов отключены, доступен только источник “Current”.

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

Пример:

┌ /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                     │
└─────────────────────────────────────────────────────────────────────┘

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

В headless-режиме (--prompt) или неинтерактивном контексте /diff выводит текстовое резюме рабочего дерева против 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. Команды с восклицательным знаком (!) — Выполнение Shell-команд

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

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

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

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

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

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

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

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

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

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

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

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

Формат TOML-файлов (Устарел)

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

1. Контекстное внедрение ({{args}})

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

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

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

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

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

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

Пример: Команда для Code Review

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

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

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

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

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

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

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

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

Эти команды выполняются из shell как 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

Подсказка о наличии дополнительных сессий выводится в stderr, чтобы конвейеризация в jq оставалась безопасной.

Примеры:

# Показать последние 20 сессий (по умолчанию)
qwen sessions list
 
# Показать последние 50 сессий
qwen sessions list --limit 50
 
# Вывести в формате JSON для скриптов
qwen sessions list --json | jq .