title: Referência de configurações
Referência de configurações
A tela de configurações do Koharu atualmente expõe seis áreas principais:
AppearanceEnginesAPI KeysKeybindsRuntimeAbout
Esta página documenta a superfície atual de configurações conforme implementada no app.
Appearance
A aba Appearance atualmente inclui:
- tema:
Light,DarkouSystem - 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:
DetectorBubble DetectorFont DetectorSegmenterOCRTranslatorInpainterRenderer
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:
OpenAIGeminiClaudeDeepSeekDeepLGoogle Cloud TranslationCaiyunOpenAI 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 Compatiblerequer umaBase URLcustomizada; os modelos são descobertos dinamicamente chamandoGET /v1/modelscontra essa URL- provedores de tradução automática (
DeepL,Google Cloud Translation,Caiyun) precisam apenas de uma chave de API; oCaiyunsuporta 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/Rpara 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 + ZeCtrl + Shift + Z(Cmd + ZeCmd + Shift + Zno 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 comCtrl + Ynã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 PathHTTP Connect TimeoutHTTP Read TimeoutHTTP Max Retries
Comportamento atual:
Data Pathcontrola onde o Koharu armazena pacotes de runtime, modelos baixados, manifests de página e blobs de imagemHTTP Connect Timeoutdefine quanto tempo o Koharu aguarda ao estabelecer conexões HTTPHTTP Read Timeoutdefine quanto tempo o Koharu aguarda ao ler responses HTTPHTTP Max Retriescontrola 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.tomlarmazena a config compartilhada do app, comodata,http,pipelineebaseUrldos provedores- as chaves de API dos provedores são armazenadas separadamente de
config.tomlpelo 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.