trans4 / docs /pt-BR /reference /settings.md
Mayo
docs: update to match current implementation
725264a unverified
metadata
title: Referência de configurações

Referência de configurações

A tela de configurações do Koharu atualmente expõe seis áreas principais:

  • Appearance
  • Engines
  • API Keys
  • Keybinds
  • Runtime
  • About

Esta página documenta a superfície atual de configurações conforme implementada no app.

Appearance

A aba Appearance atualmente inclui:

  • tema: Light, Dark ou System
  • idioma da UI a partir da lista de traduções embutidas
  • Rendering Font, que é usada quando o Koharu renderiza o texto traduzido na página

Alterações de tema, idioma e fonte de renderização aplicam-se imediatamente no frontend.

Engines

A aba Engines seleciona o backend usado para cada etapa do pipeline:

  • Detector
  • Bubble Detector
  • Font Detector
  • Segmenter
  • OCR
  • Translator
  • Inpainter
  • Renderer

Esses valores são armazenados na config compartilhada do app e salvos imediatamente quando alterados.

API Keys

A aba API Keys cobre atualmente estes provedores embutidos:

  • OpenAI
  • Gemini
  • Claude
  • DeepSeek
  • DeepL
  • Google Cloud Translation
  • Caiyun
  • OpenAI Compatible

Cada provedor aparece como um accordion com um indicador de status (status dot):

  • verde — pronto (chave salva e descoberta bem-sucedida)
  • âmbar — falta configuração obrigatória (chave de API ou, para OpenAI Compatible, uma base URL)
  • vermelho — a descoberta falhou contra o endpoint configurado
  • cinza — sem configuração ainda

Comportamento atual:

  • as chaves de API dos provedores não são escritas em config.toml
  • no macOS e no Windows, as chaves de API dos provedores são armazenadas pelo keyring do sistema
  • no Linux, as chaves de API dos provedores são armazenadas no armazenamento local de credenciais do Koharu sob o diretório de dados do app com permissões somente para o usuário dono
  • as base URLs dos provedores são armazenadas na config do app
  • OpenAI Compatible requer uma Base URL customizada; os modelos são descobertos dinamicamente chamando GET /v1/models contra essa URL
  • provedores de tradução automática (DeepL, Google Cloud Translation, Caiyun) precisam apenas de uma chave de API; o Caiyun suporta um conjunto limitado de idiomas de destino
  • limpar uma chave a remove do armazenamento de credenciais

O response da API intencionalmente redacta as chaves salvas em vez de retornar o segredo bruto.

O armazenamento local de credenciais no Linux depende das permissões do filesystem em vez de criptografia em nível de sistema operacional.

Keybinds

A aba Keybinds permite remapear os atalhos de troca de ferramenta e de tamanho de pincel, além dos atalhos de desfazer e refazer.

Comportamento atual:

  • os padrões são V/M/B/E/R para as ferramentas Selecionar / Bloco / Pincel / Borracha / Pincel de Reparo
  • os padrões são [ e ] para o passo do tamanho do pincel
  • os padrões são Ctrl + Z e Ctrl + Shift + Z (Cmd + Z e Cmd + Shift + Z no macOS) para desfazer e refazer
  • o zoom do canvas (Ctrl + roda), o pan (Ctrl + arrastar), o select-all (Ctrl + A) e o fallback legado de refazer com Ctrl + Y não são remapeáveis
  • conflitos são destacados no editor; você pode redefinir tudo para os padrões na mesma tela

As preferências de atalhos ficam armazenadas na camada de preferências do frontend, não em config.toml.

Para a lista completa de padrões, veja Atalhos de teclado.

Runtime

A aba Runtime agrupa configurações que exigem reinicialização e afetam o runtime local compartilhado:

  • Data Path
  • HTTP Connect Timeout
  • HTTP Read Timeout
  • HTTP Max Retries

Comportamento atual:

  • Data Path controla onde o Koharu armazena pacotes de runtime, modelos baixados, manifests de página e blobs de imagem
  • HTTP Connect Timeout define quanto tempo o Koharu aguarda ao estabelecer conexões HTTP
  • HTTP Read Timeout define quanto tempo o Koharu aguarda ao ler responses HTTP
  • HTTP Max Retries controla as retentativas automáticas para falhas transitórias de HTTP
  • esses valores HTTP são usados pelo client HTTP compartilhado do runtime para downloads e requests baseados em provedores
  • aplicar as alterações salva a config e reinicia o app desktop porque o client de runtime é construído na inicialização

About

A aba About atualmente mostra:

  • a versão atual do app
  • se existe um release mais novo no GitHub
  • o link do autor
  • o link do repositório

No modo de app empacotado, a verificação de versão compara a versão local do app com o último release no GitHub em mayocream/koharu.

Modelo de persistência

O comportamento atual das configurações é dividido em camadas de armazenamento:

  • config.toml armazena a config compartilhada do app, como data, http, pipeline e baseUrl dos provedores
  • as chaves de API dos provedores são armazenadas separadamente de config.toml pelo armazenamento de credenciais da plataforma descrito acima
  • as preferências de tema, idioma e fonte de renderização são armazenadas na camada de preferências do frontend

Ou seja, limpar as preferências do frontend não é o mesmo que limpar as chaves de API salvas dos provedores ou a config compartilhada de runtime.

Páginas relacionadas