A CLI da Lingo.dev liga a sua base de código a um motor de localização através da configuração do seu projeto. Cada lingo push passa pelo seu motor — aplicando automaticamente a sua voz da marca, glossário, regras e configuração do modelo. Sem alterações ao código, sem novas dependências.
O que muda#
| Antes | Depois | |
|---|---|---|
| Pipeline de tradução | Pipeline predefinido da Lingo.dev | O seu motor de localização |
| Voz da marca | Nenhuma | Aplicada por idioma de destino |
| Glossário | Nenhum | Correspondência semântica em cada pedido |
| Regras | Nenhumas | Incluídas por idioma de destino |
| Seleção de modelo | Predefinição da Lingo.dev | A configuração do seu modelo com fallback |
| Revisão de qualidade | Nenhuma | Os avaliadores de IA configurados são executados automaticamente |
Configuração#
Ligar ao seu motor
Execute lingo link na raiz do projeto:
lingo linkEscolha (ou crie) uma organização e um motor de localização. link escreve orgId e engineId em .lingo/config.json — faça commit para que todas as execuções usem o mesmo motor. Também pode encontrar o ID de um motor no dashboard; começa por eng_ (por exemplo, eng_SxjMwMsfOIsvV1wh).
Autenticar
lingo loginAbre um browser para autenticar e guarda uma sessão. Para CI ou utilização não interativa, passe antes uma chave de API:
lingo login --api-key lk_...…ou defina-a como variável de ambiente:
export LINGO_API_KEY="lk_..."Gere uma chave de API na página API Keys do dashboard.
Push
lingo pushA CLI envia os ficheiros de origem para o seu motor e grava os resultados traduzidos de volta no disco — aplicando automaticamente a sua voz da marca, glossário, regras e configuração do modelo.
Referência de configuração#
.lingo/config.json#
| Campo | Descrição |
|---|---|
orgId | Organização a que o motor pertence. Definida por lingo link. |
engineId | Motor que executa a tradução (eng_...). Definido por lingo link. |
sourceLocale, targetLocales e files funcionam da mesma forma que em qualquer projeto — consulte Configuration.
Variáveis de ambiente#
| Variável | Obrigatório | Predefinição | Descrição |
|---|---|---|---|
LINGO_API_KEY | Para CI | - | A sua chave de API da Lingo.dev (em vez de lingo login) |
LINGO_API_URL | Não | https://api.lingo.dev | URL base da API personalizada (para self-hosted ou staging) |
O que esperar#
Cada tradução produzida pelo CLI passa pelo pipeline completo do seu motor:
- Voz da marca define o tom e o nível de formalidade por idioma
- Itens do glossário garantem terminologia exata através de correspondência semântica
- Regras aplicam regras linguísticas específicas do idioma
- Configurações de modelo selecionam o LLM certo com fallback automático
- Avaliadores de IA avaliam automaticamente a qualidade após cada pedido
As traduções aparecem em Reports com o tipo de gatilho api, juntamente com pedidos da API e integrações.
