設定檔位置

WSL Dashboard 的設定檔和日誌預設儲存在使用者的個人目錄中：

檔案/目錄	路徑	說明
設定目錄	~\.wsldashboard\	存放所有永續資料的根目錄
設定檔	~\.wsldashboard\settings.toml	所有 UI 設定、路徑設定等
日誌目錄	~\.wsldashboard\logs\	執行日誌檔的存放位置

TIP

~ 代表目前 Windows 使用者的主目錄（通常為 C:\Users\使用者名稱）。

開機自啟動 (/scheduler)

WSL Dashboard 提供可靠的開機自啟動機制。

運作原理

在設定中啟用「開機自啟動」後，應用程式不僅僅是在「啟動」資料夾中放置捷徑，而是透過 Windows 工作排程器 建立高效能的啟動工作。

• 靜默啟動: 工作排程器以 /scheduler 參數啟動。此參數使應用程式不顯示主視窗，直接以最小化狀態啟動至系統匣，不打擾您的工作。
• 自動修復: 每次手動啟動應用程式時，會自動檢查並修復因路徑移動或權限問題導致的啟動工作失敗，確保自動啟動始終有效。

可用設定選項

在應用程式的「設定」檢視中，您可以調整以下選項：

一般設定

• 語言: 選擇 UI 介面語言（支援 20 多種語言，如繁體中文、英文等）。
• 預設安裝目錄: 設定新 WSL 執行個體的預設儲存路徑。
• 開機自啟動: 啟用後，WSL Dashboard 將隨 Windows 一起啟動。
• 啟動時最小化至系統匣: 啟用後，應用程式啟動後會立即最小化至系統匣，不顯示主視窗（靜默模式）。

介面與行為

• 外觀主題: 支援亮色模式、深色模式或跟隨系統。
• 關閉行為: 可設定點擊關閉按鈕時「結束程式」或「最小化至系統匣」。
• 自動更新檢查: 設定檢查新版本的頻率。

日誌設定

• 日誌目錄: 指定日誌檔的存放位置。
• 日誌等級: 提供 Error、Warn、Info、Debug、Trace 五個等級，預設為 Info。遇到問題時，建議調整為 Debug 或 Trace 以獲取更多除錯資訊。

設定檔 (settings.toml)

應用程式的所有設定均永續儲存在 ~\.wsldashboard\settings.toml 中。您也可以手動編輯此檔案，但建議透過 UI 介面進行變更。

重置設定

若要將所有設定還原為預設值，請刪除 ~\.wsldashboard 檔案並重新啟動 WSL Dashboard。