Light Switch 公用程式

Light Switch 是一個 PowerToys 工具，會根據一天中的時間自動在光暗模式間切換你的 Windows 主題。 您可以配置 Light Switch 為使用您所在位置的日出和日落時間自動更改 themes ，或設置最適合您日常生活的自定義時間表。

使用 Light Switch 的好處包括：

  • 減輕眼睛疲勞 - 在低光源環境下，黑暗對 themes 眼睛更容易
  • 更長的電池續航力 - 深色有助於 themes 延長配備 OLED 顯示器的裝置的電池續航力
  • 自動適應 - 無需全天手動更改themes

如何啟用和使用 Light Switch

Light Switch 可以透過開啟 PowerToys 「設定」並變更「 啟用」 Light Switch 開關來啟動或停用。 然後，您可以配置設定，以根據當地的日出和日落時間或手動設定的時間指定在明暗 themes 之間切換的時間。

設定的 Light Switch 動畫 GIF。

下列設定可用於 Light Switch：

Setting Description
啟用 Light Switch 開啟或關閉公用程式Light Switch。
主題切換快捷方式 設定鍵盤快速鍵以手動切換淺色和深色 themes。
排程模式 根據你的位置，可以選擇使用暗色模式，從日落到日出）、固定時間（設定特定時間），或跟隨夜燈（與Windows夜燈時間表同步）。 請注意，你必須啟用並同步定位服務，日落轉日出模式才能正常運作。 您還可以使用 關閉 模式禁用時間表，同時仍然可以訪問快捷方式來切換您的主題。
地點 手動輸入座標，或使用定位服務根據當地日出與日落時間自動切換光暗模式。
以分鐘為單位偏移 根據指定的分鐘數來調整 themes，使其在日出和日落之前或之後切換。
開啟深色模式 設定使用手動模式時切換到深色模式的時間。
開啟燈光模式 設定使用手動模式時切換到燈光模式的時間。
將深色模式套用至 選擇是否 Light Switch 將深色模式套用至 系統 （工作列、開始和其他系統 UI） 和/或 應用程式 （支援的應用程式）。
套用監視器設定至 當啟用 Power Display 工具時，請選擇一個 Power Display 設定檔，以應用在 Light Switch 到 WindowsDark 模式設定檔 和當轉換到 Light 模式設定檔 時的設定檔。 這會讓你儲存的螢幕亮度、對比度和色溫設定自動切換，並搭配系統主題。

命令行介面

Light Switch 包含命令列介面，可控制執行中的 Light Switch 服務，讓你能從腳本和終端機檢查或更改主題。 PowerToys它會把 bin 資料夾加到你的 PATH，所以你可以從 PowerToys.LightSwitch.CLI.exe Terminal、PowerShell 或命令提示字元的任何資料夾執行 Windows。 如果安裝時 PowerToys終端機已經開啟，請開啟新的終端機，讓它載入更新後的 PATH。

必須在 PowerToys 中啟用 Light Switch，且其服務必須正在執行。 CLI 不會自動啟動 PowerToys 或開啟 Light Switch。

命令 Description
status 顯示目前的系統和應用程式 themes、主題目標 Light Switch 的變更、排程模式，以及是否啟動手動覆蓋。
light 將淺色主題套用到「 套用暗色模式 」選中的目標（系統、 應用程式或兩者）。
dark 將暗色主題套用到選定的目標上。
toggle 將選取的項目在明亮與深色之間切換，就像 主題切換快捷鍵 一樣。
schedule enable [--mode <mode>] 開啟排程功能。 使用 fixed-hours 搭配 sunset-to-sunrise、follow-night-light 或 --mode 來選擇排程。
schedule disable 將排程模式設為 關閉即可關閉排程。
Option Description
--json 寫一個單一的 JSON 物件，包括錯誤相關欄位。
-h，--help 顯示說明。 未聯絡該服務。
--version 顯示 CLI 版本。 不會聯絡該服務。

當 light、dark 或 toggle 設定的主題與排程不同時，Light Switch 會將該主題保留為手動覆寫狀態，直到下一次排程變更或你更改相關設定為止。

schedule enable --mode 使用已在 Light Switch 設定中儲存的時間、地點和偏移量。 若省略 --mode，當排程已啟動時，指令會成功。 如果排程模式為 關閉，指令會失敗，並要求你指定模式。

使用範例

# Check the current theme and schedule state
PowerToys.LightSwitch.CLI.exe status

# Switch the configured targets to dark mode
PowerToys.LightSwitch.CLI.exe dark

# Turn on the sunset-to-sunrise schedule
PowerToys.LightSwitch.CLI.exe schedule enable --mode sunset-to-sunrise

# Get the current state as JSON
PowerToys.LightSwitch.CLI.exe status --json

當 --json時，輸出包含一個 version、一個 success 值，以及一個 state 物件，或一個具有 code 和 message 的 error 物件。 例如：

{"version":1,"success":true,"state":{"systemTheme":"dark","appsTheme":"dark","changeSystem":true,"changeApps":true,"scheduleMode":"FixedHours","manualOverride":true}}

CLI 回傳以下退出代碼：

退出代碼 Meaning
0 成功。
1 指令失敗、主題無法讀取或更改，或服務回傳意想不到的回應。
2 參數或設定無效。
3 Light Switch服務無法使用。 在 PowerToys 中開啟 Light Switch，然後再試一次。
4 指令逾時或服務連線中斷。 變更可能仍已套用，所以在再試之前先執行 status 。

CLI 從不會重試會自動更改主題或排程的指令。

安裝 PowerToys

此工具是 MicrosoftPowerToys 專為高端使用者設計的工具之一。 它提供了一套實用的工具，幫助你調整並簡化 Windows 體驗，提升生產力。 若要安裝 PowerToys，請參閱 安裝 PowerToys。

  • 上次更新時間：