Comandos

Este documento detalha todos os comandos suportados pelo Qwen Code, ajudando você a gerenciar sessões com eficiência, personalizar a interface e controlar seu comportamento.

Os comandos do Qwen Code são acionados por meio de prefixos específicos e se dividem em três categorias:

1. Comandos de Barra (/)

Os comandos de barra são usados para gerenciar sessões, a interface e o comportamento básico do Qwen Code.

1.1 Gerenciamento de Sessão e Projeto

Esses comandos ajudam você a salvar, restaurar e resumir o progresso do trabalho.

1.2 Controle de Interface e Workspace

Comandos para ajustar a aparência da interface e o ambiente de trabalho.

1.3 Configurações de Idioma

Comandos específicos para controlar o idioma da interface e da saída.

• Idiomas de UI integrados disponíveis: zh-CN (Chinês Simplificado), en-US (Inglês), ru-RU (Russo), de-DE (Alemão)
• Exemplos de idioma de saída: Chinese, English, Japanese, etc.

1.4 Gerenciamento de Ferramentas e Modelos

Comandos para gerenciar ferramentas e modelos de IA.

1.5 Skills Integrados

Esses comandos invocam skills integrados que fornecem fluxos de trabalho especializados.

Consulte Code Review para a documentação completa do /review.

1.6 Pergunta Paralela (/btw)

O comando /btw permite fazer perguntas rápidas e paralelas sem interromper ou afetar o fluxo principal da conversa.

Como funciona:

• A pergunta paralela é enviada como uma chamada de API separada com o contexto recente da conversa (até as últimas 20 mensagens)
• A resposta é exibida acima do Composer — você pode continuar digitando enquanto aguarda
• A conversa principal não é bloqueada — ela continua de forma independente
• A resposta da pergunta paralela não faz parte do histórico da conversa principal
• As respostas são renderizadas com suporte completo a Markdown (blocos de código, listas, tabelas, etc.)

Atalhos de Teclado (Modo Interativo):

Exemplo:

(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)

Modos de Execução Suportados:

1.7 Informações, Configurações e Ajuda

Comandos para obter informações e realizar configurações do sistema.

1.8 Atalhos Comuns

1.9 Subcomandos de Autenticação da CLI

Além do comando de barra /auth dentro da sessão, o Qwen Code fornece subcomandos independentes da CLI para gerenciar a autenticação diretamente pelo terminal:

2. Comandos @ (Inserindo Arquivos)

Os comandos @ são usados para adicionar rapidamente o conteúdo de arquivos ou diretórios locais à conversa.

Nota: Espaços nos caminhos precisam ser escapados com barra invertida (ex.: @My\ Documents/file.txt)

3. Comandos de Exclamação (!) - Execução de Comandos Shell

Os comandos de exclamação permitem executar comandos do sistema diretamente dentro do Qwen Code.

Variáveis de Ambiente: Comandos executados via ! definirão a variável de ambiente QWEN_CODE=1.

4. Comandos Personalizados

Salve prompts usados com frequência como comandos de atalho para melhorar a eficiência do trabalho e garantir consistência.

Visão Rápida

Regras de Prioridade: Comandos do projeto > Comandos do usuário (o comando do projeto é usado quando os nomes são iguais)

Regras de Nomeação de Comandos

Tabela de Mapeamento de Caminho de Arquivo para Nome de Comando

Regras de Nomeação: O separador de caminho (/ ou \) é convertido em dois-pontos (:)

Especificação do Formato de Arquivo Markdown (Recomendado)

Comandos personalizados usam arquivos Markdown com frontmatter YAML opcional:

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

Formato de Arquivo TOML (Obsoleto)

Mecanismo de Processamento de Parâmetros

1. Injeção Contextual ({{args}})

2. Processamento Padrão de Parâmetros

🚀 Injeção de Conteúdo Dinâmico

3. Execução de Comando Shell (!{...})

Exemplo: Geração de Mensagem de Commit Git

---
description: Generate Commit message based on staged changes
---
 
Please generate a Commit message based on the following diff:
 
```diff
!{git diff --staged}
```

4. Injeção de Conteúdo de Arquivo (@{...})

Exemplo: Comando de Code Review

---
description: Code review based on best practices
---
 
Review {{args}}, reference standards:
 
@{docs/code-standards.md}

Exemplo Prático de Criação

Tabela de Etapas para Criação do Comando “Refatoração para Função Pura”

---
description: Refactor code to pure function
---
 
Please analyze code in current context, refactor to pure function.
Requirements:
 
1. Provide refactored code
2. Explain key changes and pure function characteristic implementation
3. Maintain function unchanged

Resumo das Melhores Práticas para Comandos Personalizados

Tabela de Recomendações de Design de Comandos

Tabela de Lembrete de Recursos de Segurança