Internacionalização (i18n) e Idioma
O Qwen Code é construído para fluxos de trabalho multilíngues: ele suporta localização da interface do usuário (i18n/l10n) na CLI, permite escolher o idioma de saída do assistente e permite pacotes de idioma personalizados para a interface.
Visão Geral
Do ponto de vista do usuário, a “internacionalização” do Qwen Code abrange múltiplas camadas:
| Capacidade / Configuração | O que controla | Onde é armazenado |
|---|---|---|
/language ui | Texto da interface no terminal (menus, mensagens do sistema, prompts) | ~/.qwen/settings.json |
/language output | Idioma em que a IA responde (uma preferência de saída, não tradução da interface) | ~/.qwen/output-language.md |
| Pacotes de idioma personalizados | Substituições/extensões das traduções da interface embutidas | ~/.qwen/locales/*.js |
Idioma da Interface
Esta é a camada de localização da interface do CLI (i18n/l10n): controla o idioma dos menus, prompts e mensagens do sistema.
Configurando o Idioma da Interface
Utilize o comando /language ui:
/language ui zh-CN # Chinês
/language ui en-US # Inglês
/language ui ru-RU # Russo
/language ui de-DE # Alemão
/language ui ja-JP # JaponêsAliases também são suportados:
/language ui zh # Chinês
/language ui en # Inglês
/language ui ru # Russo
/language ui de # Alemão
/language ui ja # JaponêsDetecção Automática
Na primeira inicialização, o Qwen Code detecta a localidade do seu sistema e define automaticamente o idioma da interface.
Prioridade na detecção:
- Variável de ambiente
QWEN_CODE_LANG - Variável de ambiente
LANG - Localidade do sistema via API Intl do JavaScript
- Padrão: Inglês
Idioma da Saída do LLM
O idioma da saída do LLM controla em qual idioma o assistente de IA responde, independentemente do idioma em que você digita suas perguntas.
Como Funciona
O idioma de saída da LLM é controlado por um arquivo de regras em ~/.qwen/output-language.md. Este arquivo é incluído automaticamente no contexto da LLM durante a inicialização, instruindo-a a responder no idioma especificado.
Detecção Automática
Na primeira inicialização, se o arquivo output-language.md não existir, o Qwen Code cria um automaticamente com base na localidade do seu sistema. Por exemplo:
- A localidade do sistema
zhcria uma regra para respostas em chinês - A localidade do sistema
encria uma regra para respostas em inglês - A localidade do sistema
rucria uma regra para respostas em russo - A localidade do sistema
decria uma regra para respostas em alemão - A localidade do sistema
jacria uma regra para respostas em japonês
Configuração Manual
Use /language output <idioma> para alterar:
/language output Chinese
/language output English
/language output Japanese
/language output GermanQualquer nome de idioma funciona. O LLM será instruído a responder nesse idioma.
Após alterar o idioma de saída, reinicie o Qwen Code para que a alteração tenha efeito.
Localização do Arquivo
~/.qwen/output-language.mdConfiguração
Via Diálogo de Configurações
- Execute
/settings - Encontre “Language” em General
- Selecione seu idioma de interface preferido
Via Variável de Ambiente
export QWEN_CODE_LANG=zhIsso influencia a detecção automática na primeira inicialização (caso você não tenha definido um idioma de interface e ainda não exista o arquivo output-language.md).
Pacotes de Idioma Personalizados
Para traduções da interface, você pode criar pacotes de idioma personalizados em ~/.qwen/locales/:
- Exemplo:
~/.qwen/locales/es.jspara espanhol - Exemplo:
~/.qwen/locales/fr.jspara francês
O diretório do usuário tem precedência sobre as traduções embutidas.
Contribuições são bem-vindas! Se você quiser melhorar as traduções embutidas ou adicionar novos idiomas. Para um exemplo concreto, veja PR #1238: feat(i18n): add Russian language support .
Formato do Pacote de Idioma
// ~/.qwen/locales/es.js
export default {
Hello: 'Hola',
Settings: 'Configuración',
// ... mais traduções
};Comandos Relacionados
/language- Mostrar configurações de idioma atuais/language ui [lang]- Definir idioma da interface/language output <language>- Definir idioma de saída da LLM/settings- Abrir diálogo de configurações