| --- |
| 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](keyboard-shortcuts.md). |
|
|
| ## 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 |
|
|
| - [Usar APIs compatíveis com OpenAI](../how-to/use-openai-compatible-api.md) |
| - [Modelos e provedores](../explanation/models-and-providers.md) |
| - [Referência da API HTTP](http-api.md) |
|
|
