# Glossário pt-BR — DeepSeek Harness Web GUI

Este glossário fixa a terminologia do pacote de idioma pt-BR da GUI Web do DeepSeek Harness. Toda tradução de `common`, `conversation`, `trajectory`, `chat`, `settings.models` e `workspace` deve seguir estas escolhas.

## 1. Tabela de termos

| Termo em inglês | Tradução fixa | Observação |
| --- | --- | --- |
| session | sessão | Fem. "Nova sessão", "Arquivar sessão". |
| workspace | workspace | Manter em inglês, masc. ("o workspace"). Consagrado em ferramentas dev; evita "espaço de trabalho" longo em rótulos. |
| tool | ferramenta | Fem. Nomes próprios de ferramentas (bash, read…) não se traduzem — ver seção 4. |
| tool call | chamada de ferramenta | Plural: "chamadas de ferramenta". Nunca "call de tool". |
| subtool call | chamada de subferramenta | Consistente com "tool call". |
| subagent | subagente | Masc. "{count} subagentes em execução". |
| agent | agente | Masc. Refere-se ao agente de codificação. |
| skill | skill | Manter em inglês, fem. ("a skill"). Nomes de skills nunca se traduzem. |
| plan mode | modo de plano | "Plan awaiting review" → "Plano aguardando revisão". |
| plan | plano | Masc. |
| goal | objetivo | Masc. "Objetivo ativo", "Objetivo · Rodada {round}". |
| goal round | rodada (do objetivo) | "Round {round}" → "Rodada {round}". |
| trajectory | trajetória | Fem. Nome da visão "Trajectory" → "Trajetória". |
| turn | turno | Masc. "Turno {turn}", "Entre turnos". |
| step | etapa | Fem. "Etapa {step}", "{count} etapas". Não usar "passo". |
| approval | aprovação | "Waiting for approval" → "Aguardando aprovação". |
| permission | permissão | Fem. |
| background job | tarefa em segundo plano | Nunca "job de background". |
| workflow | workflow | Manter em inglês, masc. Termo do produto (ferramenta `workflow`). |
| prompt | prompt | Manter em inglês, masc. |
| system prompt | prompt do sistema | "System Prompt Updated" → "Prompt do sistema atualizado". |
| model | modelo | Masc. |
| provider | provedor | Masc. "Provedor / modelo". |
| preset | predefinição | Fem. |
| compaction | compactação | Fem. "Compacting context…" → "Compactando o contexto…". |
| context | contexto | Masc. "{percent} do contexto usado". |
| context window | janela de contexto | Fem. |
| token | token | Manter em inglês, masc.; plural "tokens". Abreviações "tok" e "tok/s" não mudam. |
| attachment | anexo | Masc. "image attachments" → "anexos de imagem". |
| deliverable | entregável | Masc. |
| commit | commit | Manter em inglês, masc. ("o commit"). |
| branch | branch | Manter em inglês, fem. ("a branch"). Ação "Branch into a new conversation" → "Ramificar em uma nova conversa". |
| pull request | pull request | Manter em inglês, masc. ("o pull request"); abreviação "PR" permitida. |
| sandbox | sandbox | Manter em inglês, masc. ("o sandbox"). |
| checkpoint | checkpoint | Manter em inglês, masc. |
| fork (session) | fork | Manter em inglês. "Fork session" → "Criar fork da sessão". |
| queue / queued message | fila / mensagem na fila | "Queue" (ação) → "Enfileirar"; "{n} queued messages" → "{n} mensagens na fila". |
| steer | direcionar | "Steer queued message" → "Direcionar mensagem na fila". |
| retry | nova tentativa / tentar novamente | Substantivo: "nova tentativa"; botão: "Tentar novamente". |
| usage | uso | Masc. "Turn usage" → "Uso do turno". |
| cache hit | acerto de cache | "Cache hit {percent}%" → "Acerto de cache {percent}%". |
| thinking / think | raciocínio | "Thinking" (bloco) → "Raciocínio". |
| diff | diff | Manter em inglês, masc. |
| terminal | terminal | Masc. |
| API key | chave de API | Fem. "API key missing" → "Chave de API ausente". |
| settings | configurações | Fem. plural. |
| run (subst.) | execução | "the run" → "a execução". |
| full access | acesso total | "Enable Full access" → "Ativar acesso total". |

## 2. Regras de registro

- Rótulos de botão e menu: curtos, no infinitivo ou substantivo — "Cancelar", "Salvar", "Nova sessão", "Adicionar workspace…". Nunca "Você deve cancelar" nem imperativo dirigido com "você".
- Mensagens de status: impessoais e no gerúndio ou particípio — "Carregando…", "Compactando o contexto…", "Concluído", "Falhou", "Aguardando aprovação". Não usar "Nós estamos carregando".
- Mensagens de erro: descrever o fato e, quando útil, a ação — "Falha ao carregar o histórico"; instruções de recuperação podem usar imperativo neutro ("Tente novamente"), sem "você".
- Rótulos curtos (botões, títulos de coluna, abas, tooltips de uma frase): sem ponto final. Frases completas em descrições, diálogos de confirmação e mensagens de erro levam ponto final.
- Tratar o usuário sempre de forma indireta; quando inevitável, preferir construções impessoais ("é possível…", "não é permitido…") a "você pode…".

## 3. Regras de capitalização

- Português usa caixa de sentença: apenas a primeira palavra em maiúscula (e nomes próprios). O Title Case inglês NÃO se copia.
  - "New Session" → "Nova sessão" (não "Nova Sessão").
  - "System Prompt Updated" → "Prompt do sistema atualizado".
  - "Delete workspace" → "Excluir workspace".
- Siglas e chaves fixas permanecem em maiúsculas: JSON, URL, API, HTTP, TTFT, PR, ID, IN/OUT.
- Rótulos que a fonte grafa em CAPS por estilo (ASSISTANT, SYSTEM, TOOL…) mantêm CAPS na tradução: "ASSISTENTE", "SISTEMA", "FERRAMENTA".
- Nomes de produto conservam a grafia original: DeepSeek Harness, DSH, Cordis.

## 4. O que NÃO traduzir

- Nomes de ferramentas e comandos: bash, read, write, edit, grep, glob, pwsh, web_fetch, web_search, todo_write, compact etc. — sempre na grafia exata da fonte.
- Identificadores: ids de sessão/agente/job, "Model ID", valores de "Provider ID", nomes de campo de settings.yaml.
- Caminhos de arquivo, URLs e placeholders de URL ("https://gateway.example/v1").
- Tags e termos de protocolo: JSON, HTTP, JSON-RPC, ACP, ESM, Unix timestamp.
- Nomes de produtos e marcas: DeepSeek Harness, DSH, Cordis, PNG, JPG, WebP, GIF, Cmd/Ctrl+Enter (teclas).
- Códigos e valores literais exibidos: "exit code" traduz-se ("código de saída {code}"), mas o valor e sinais ("signal {signal}" → "sinal {signal}") mantêm o conteúdo do placeholder.

## 5. Placeholders

- Sequências entre chaves — {count}, {name}, {duration}, {n}, {percent}, {provider} etc. — são copiadas EXATAMENTE: sem tradução, sem alterar maiúsculas, sem espaços extras dentro das chaves ({ count } é errado).
- O placeholder pode mudar de posição na frase para soar natural: "Deleting {provider}…" → "Excluindo {provider}…".
- Formas plurais (.one/.other) mantêm o placeholder nas duas variantes: "{count} chamada de ferramenta" / "{count} chamadas de ferramenta".
- Nunca criar nem remover placeholders; cada chave traduzida usa o mesmo conjunto da fonte.

## 6. Unidades e tempo

- Unidades compactas mantêm o formato da fonte, com espaço quando a fonte tem: "{value} ms", "{value} s", "{value} tok", "{value} tok/s".
- Abreviações de tempo relativo: "{n}d" (dias), "{n}h" (horas), "{n}min" (minutos), "{n}mês/{n}meses" → usar "{n}m" apenas se a fonte usar sufixo curto; para "months" preferir "{n}mês" para não colidir com minutos. "{n}y" → "{n}a" (anos).
- Tempo relativo: "{t} ago" → "há {t}" (o "há" vem ANTES do valor); "now" → "agora".
- Durações compostas seguem a fonte: "{minutes}m {seconds}s", "{minutes}m{seconds}s", "{seconds}s", "{milliseconds}ms".
- Datas: "{y}-{m}-{d}" mantém a ordem ISO; "{m}/{d}" pode virar "{d}/{m}" apenas se a chave permitir reordenação (placeholders nomeados) — registrar a decisão na revisão.
- Números: o separador de milhar pt-BR é "." (chave number.groupSeparator → "."); abreviações "K"/"M" ({value}K, {value}M) mantêm-se.
- Por extenso, usar formas completas em minúsculas: "segundos", "minutos", "horas"; "Duração total", "Atraso da nova tentativa".