dsh-locale-ptbr
Pacote de idioma Português (Brasil) para a GUI Web do DeepSeek Harness.
Instalado em um profile, ele acrescenta "Português (Brasil)" a Configurações → Geral e traduz a interface ao vivo. Nada no repositório do harness é alterado.
Instalar
dsh plugin --profile web add github:grstein/dsh-locale-ptbr
dsh --profile web --dump-config # confere a camada "# == @grstein/dsh-locale-ptbr"
dsh web # ou: dsh --profile <outro-perfil>
dsh plugin encaminha para o pnpm dentro do diretório do profile, então qualquer especificador aceito pelo pnpm serve (github:, um caminho local, um registry interno).
O idioma entra em Configurações → Geral → Idioma. Um navegador configurado em português seleciona Português (Brasil) sozinho no primeiro acesso; a escolha explícita fica gravada em locale.preference no settings.yaml do seu $DSH_HOME e vale por usuário.
A GUI do DeepSeek Harness em português
Remover: dsh plugin --profile web remove @grstein/dsh-locale-ptbr.
dsh web é o atalho do profile web e não aceita --profile; um profile próprio que inclua o bundle @deepseek-ai/dsh-web-app sobe com dsh --profile <nome>.
O que é traduzido
A cópia de produto da GUI Web: 33 namespaces e 1.029 chaves — conversa, trajetória, cards de ferramenta, workspace, configurações, aprovações, jobs, subagentes, comandos.
Não é traduzido, por design do harness: o texto gerado pelo modelo, dados de usuário/provedor/protocolo, a saída do CLI e do terminal, a documentação, e a cópia de boot renderizada antes do serviço de locale ativar. Texto capturado no momento do registro (por exemplo, descrições de comando no registry) mantém o idioma do registro até um novo registro.
Chaves ainda não traduzidas caem automaticamente em inglês pela cadeia de fallback pt-BR → en, então o pacote nunca mostra chave crua.
Estrutura
| Caminho | Papel |
|---|
dicts/<ns>.json | Fonte de tradução, um arquivo por namespace ({ namespace, entries }) |
client.js | Metade browser gerada: addLanguage + um register por namespace |
index.js | Metade Node (vazia); existe porque o Loader do host varre o manifesto dsh.client |
cordis.patch.yml | Camada do bundle que insere a row locale-ptbr |
keys.lock.json | Conjunto de chaves e placeholders do harness alvo |
GLOSSARY.md | Terminologia pt-BR obrigatória |
tools/extract-keys.mjs | Varredura AST de um checkout do harness → keys.lock.json + en.snapshot.json |
tools/sync.mjs | Compara o pacote com um harness mais novo e gera o delta de tradução |
tools/build-client.mjs | dicts/*.json → client.js |
tools/check-parity.mjs | Gate: chaves, placeholders e client.js atualizado |
tools/check-runtime.mjs | Gate: o artefato registra 1 idioma + 33 dicionários e descarta limpo |
.github/workflows/ | ci (gates a cada push) e drift (vigia o harness toda segunda) |
Não versionados: en.snapshot.json (texto em inglês de cada chave, fonte de tradução) e .work/ (arquivos de delta). Ambos são regeneráveis a partir de um checkout do harness.
Traduzir ou corrigir
npm install # uma vez: o único dev dependency é o typescript, usado pela extração
# edite dicts/<ns>.json
npm run build # regenera client.js
npm test # paridade de chaves, placeholders, artefato e registro em runtime
Envie client.js regenerado junto com a alteração do dicionário: o gate falha se ele estiver desatualizado.
Acompanhar uma versão nova do harness
git -C /caminho/para/deepseek-harness pull # ou clone raso da tag desejada
node tools/sync.mjs /caminho/para/deepseek-harness # relatório; sai 1 se houver diferença
node tools/sync.mjs /caminho/para/deepseek-harness --apply # adota o novo conjunto de chaves
O relatório separa três tipos de diferença, porque cada um dá trabalho diferente:
| Tipo | O que aconteceu | Efeito se nada for feito |
|---|
added | O harness registra uma chave que o pacote ainda não traduz | A chave aparece em inglês (fallback), nunca crua |
removed | O harness deixou de registrar a chave | --apply remove a entrada de dicts/; o gate rejeita chave desconhecida |
reworded | O texto em inglês mudou | A tradução antiga continua exibida e pode estar errada |
--apply reescreve keys.lock.json e en.snapshot.json, remove as chaves obsoletas de dicts/, regenera client.js e grava .work/<ns>.delta.json com apenas o que precisa de tradutor — o texto em inglês das chaves novas e, para as reformuladas, o inglês novo ao lado da tradução atual. Chaves novas não recebem texto automático de propósito: chave ausente cai em inglês, enquanto um inglês copiado para dentro do dicionário pareceria traduzido e nunca mais seria revisto.
Traduza os arquivos de delta para dentro de dicts/, e então:
npm run build && npm test
A extração exige um checkout de código-fonte do harness (ela lê packages/*/*/src pela AST); o pacote publicado no npm não traz as fontes. Um git clone --depth 1 da tag correspondente basta.
Vigilância automática
.github/workflows/drift.yml roda toda segunda-feira: faz checkout do deepseek-ai/deepseek-harness, executa tools/sync.mjs e, havendo diferença, abre (ou comenta em) uma issue com o relatório. Assim a defasagem aparece sozinha, sem depender de alguém lembrar de conferir a cada release.
Versionamento do pacote
Suba a versão em package.json a cada conjunto de traduções e anote no CHANGELOG do release qual harnessVersion ele mira — keys.lock.json guarda esse alvo. Como o fallback para inglês nunca quebra a UI, um pacote defasado degrada aos poucos em vez de falhar.
Alvo atual: @deepseek-ai/dsh-client-locale 0.1.2-alpha.1. O histórico de versões está no CHANGELOG.
Contribuir com uma correção de tradução
Divergências de terminologia são resolvidas pelo GLOSSARY.md, que é a autoridade do pacote: mudar uma palavra que ele fixa significa mudar o glossário e todos os arquivos afetados, não só um deles.
- Edite
dicts/<ns>.json (apenas valores; chaves e placeholders são intocáveis).
npm run build && npm test.- Abra um PR com o
client.js regenerado junto.
Relação com o projeto oficial
Este pacote é ecossistema, não um fork. O CONTRIBUTING do DeepSeek Harness declara que o projeto não aceita pull requests externos no momento e indica a criação de plugins próprios, marcados com o tópico dsh-plugin, como a forma de contribuir. É exatamente o que este repositório é.
Um pt-BR embutido no repositório oficial também seria caro tecnicamente: LOCALE_IDS é um par tipado ['zh', 'en'] e a forma register(ns, { zh, en }) exige os dois dicionários completos, então um terceiro idioma interno viraria erro de compilação em toda a árvore de plugins. addLanguage + register(ns, locale, dict) existem no runtime justamente para pacotes externos, com cadeia de fallback até en para tolerar tradução incompleta.
