配置文件位置

WSL Dashboard 的配置文件和日志默认存储在用户的个人目录下：

文件/目录	路径	说明
配置目录	~\.wsldashboard\	存放所有持久化数据的根目录
设置文件	~\.wsldashboard\settings.toml	所有的 UI 设置、路径配置等
日志目录	~\.wsldashboard\logs\	存放运行日志文件

TIP

~ 代表当前 Windows 用户的家目录（通常是 C:\Users\用户名）。

开机自启动 (/scheduler)

WSL Dashboard 提供了可靠的开机自启动机制。

工作原理

当您在设置中开启“开机自启动”时，应用并不会简单地将快捷方式放入“启动”文件夹，而是通过 Windows 任务计划程序 (Task Scheduler) 创建一个高性能的启动任务。

• 静默启动: 任务计划程序启动时会附带 /scheduler 参数。该参数会引导应用直接以最小化状态启动到系统托盘，不会弹出主窗口干扰您的工作。
• 自动修复: 每次手动启动应用时，它都会检查并自动修复由于路径移动或权限问题导致的启动任务失效，确保自启动始终有效。

可用配置项

在应用的“设置”视图中，您可以调整以下选项：

通用设置

• 语言: 选择 UI 界面语言（支持简体中文、英文等 20+ 种语言）。
• 默认安装目录: 设置新 WSL 实例的默认存放路径。
• 开机自启动: 开启后，WSL Dashboard 将随 Windows 启动。
• 启动时最小化到托盘: 开启后，应用启动后将直接进入系统托盘，不显示主窗口（静默模式）。

界面与行为

• 外观主题: 支持浅色、深色或跟随系统。
• 退出行为: 可设置点击关闭按钮时是“退出程序”还是“最小化到系统托盘”。
• 自动检查更新: 设置检查新版本的频率。

日志配置

• 日志目录: 指定日志文件的存储位置。
• 日志级别: 提供 Error, Warn, Info, Debug, Trace 五个级别，默认为 Info。如遇问题，建议调至 Debug 或 Trace 以获取更多调试信息。

配置文件 (settings.toml)

应用的所有配置均持久化在 ~\.wsldashboard\settings.toml 中。您可以手动编辑该文件，但建议通过 UI 界面进行修改。

重置配置

若要将所有设置恢复为默认值，请删除 ~\.wsldashboard 文件并重新启动 WSL Dashboard。