Ir para o conteúdo

Referência de configurações

A tela de configurações do Yomika atualmente expõe sete áreas principais:

  • Appearance
  • Engines
  • API Keys
  • AI
  • 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 Yomika 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 Yomika 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.

AI

A aba AI gerencia a conexão opcional com o Codex usada pelo fluxo de geração de imagens. Ela mostra o estado atual da conta e oferece entrada por código de dispositivo e saída. Essa conexão é separada das chaves configuradas em API Keys.

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 pela roda do mouse, o pan pela ferramenta Mão ou por 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 a configuração do runtime compartilhado e a manutenção do armazenamento de modelos:

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

Comportamento atual:

  • Data Path controla onde o Yomika armazena pacotes de runtime, manifests de página e blobs de imagem
  • Model Library usa <Data Path>/models por padrão ou outra pasta absoluta
  • Use existing adota o cache na pasta escolhida; Move current models valida e move o cache gerenciado pelo Yomika
  • o painel mostra o uso de disco, limpa arquivos temporários e exclui ou baixa novamente modelos locais
  • mudar a biblioteca exige reiniciar; descarregue modelos locais e conclua ou cancele trabalhos ativos primeiro
  • HTTP Connect Timeout define quanto tempo o Yomika aguarda ao estabelecer conexões HTTP
  • HTTP Read Timeout define quanto tempo o Yomika 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 proxlavee
  • o link do repositório

A verificação compara a versão local com o release mais recente de proxlavee/yomika ao iniciar e manualmente na aba About. Quando há uma versão nova, abre a página de Releases; o Yomika não baixa nem instala atualizações do aplicativo.

Modelo de persistência

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

  • config.toml armazena caminhos de dados e modelos, 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