Opções de configuração

Localização dos arquivos de configuração

Os arquivos de configuração e os logs do WSL Dashboard são armazenados por padrão no diretório pessoal do usuário:

Arquivo/Diretório	Caminho	Descrição
Diretório de configuração	~\.wsldashboard\	Diretório raiz que armazena todos os dados persistentes
Arquivo de configurações	~\.wsldashboard\settings.toml	Todas as configurações de UI, caminhos, etc.
Diretório de logs	~\.wsldashboard\logs\	Armazena os arquivos de log de execução

TIP

~ representa o diretório pessoal do usuário atual do Windows (geralmente C:\Users\nome-de-usuário).

Início automático com o Windows (/scheduler)

O WSL Dashboard oferece um mecanismo confiável de inicialização automática com o Windows.

Como funciona

Quando você ativa a "inicialização automática" nas configurações, o aplicativo não simplesmente coloca um atalho na pasta "Inicializar"; em vez disso, cria uma tarefa de inicialização de alto desempenho por meio do Agendador de Tarefas do Windows (Task Scheduler).

• Inicialização silenciosa: o Agendador de Tarefas inicia com o parâmetro /scheduler. Esse parâmetro faz o aplicativo iniciar diretamente minimizado na bandeja do sistema, sem exibir a janela principal e interferir no seu trabalho.
• Reparo automático: sempre que o aplicativo é iniciado manualmente, ele verifica e repara automaticamente tarefas de inicialização que falharam devido a alterações de caminho ou problemas de permissão, garantindo que a inicialização automática permaneça sempre funcional.

Opções de configuração disponíveis

Na visualização "Configurações" do aplicativo, você pode ajustar as seguintes opções:

Configurações gerais

• Idioma: selecione o idioma da interface (suporta chinês simplificado, inglês e mais de 20 idiomas).
• Diretório de instalação padrão: define o caminho de armazenamento padrão para novas instâncias WSL.
• Início automático com o Windows: quando ativado, o WSL Dashboard iniciará junto com o Windows.
• Minimizar para a bandeja ao iniciar: quando ativado, o aplicativo vai diretamente para a bandeja do sistema após iniciar, sem exibir a janela principal (modo silencioso).

Interface e comportamento

• Tema de aparência: suporta claro, escuro ou seguir o sistema.
• Comportamento ao sair: define se o botão de fechar deve "sair do programa" ou "minimizar para a bandeja do sistema".
• Verificar atualizações automaticamente: define a frequência de verificação de novas versões.

Configuração de logs

• Diretório de logs: define o local de armazenamento dos arquivos de log.
• Nível de log: oferece cinco níveis: Error, Warn, Info, Debug, Trace; o padrão é Info. Se encontrar problemas, é recomendável alterar para Debug ou Trace para obter mais informações de depuração.

Arquivo de configuração (settings.toml)

Todas as configurações do aplicativo são persistidas em ~\.wsldashboard\settings.toml. Você pode editar esse arquivo manualmente, mas é recomendável fazer alterações pela interface.

Redefinir configurações

Para restaurar todas as configurações aos valores padrão, exclua ~\.wsldashboard e reinicie o WSL Dashboard.