設定選項

設定檔位置

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。