掌握Windows-Auto-Night-Mode命令行参数：从基础到高级的完整指南

Windows-Auto-Night-Mode是一款能够根据时间或日出日落自动切换Windows 10/11明暗主题的实用工具。除了直观的图形界面外，它还提供了丰富的命令行参数支持，让高级用户能够通过脚本或快捷方式实现更灵活的主题控制。本文将详细介绍所有可用命令行参数及其使用场景，帮助你轻松掌握这款工具的高级用法。

核心功能概览

Windows-Auto-Night-Mode通过命令行参数提供了对主题切换、系统状态查询、自动启动管理等核心功能的控制。这些参数可以通过工具的可执行文件（如AutoDarkModeShell.exe）直接调用，也可以集成到批处理脚本或任务计划中实现自动化操作。

图1：Windows-Auto-Night-Mode的时间设置界面，可通过命令行参数控制相关功能

主题切换基础参数

快速切换主题

• --switch：触发主题切换（根据当前配置自动选择明暗主题）
• --swap：立即交换当前主题（明→暗或暗→明）
• --light：切换到浅色主题
• --dark：切换到深色主题

使用示例：

AutoDarkModeShell.exe --dark

这条命令会立即将系统主题切换为深色模式，无论当前时间或配置如何。

强制主题模式

• --force-light：强制切换到浅色主题并锁定
• --force-dark：强制切换到深色主题并锁定
• --no-force：解除主题强制锁定，恢复自动切换

使用场景：在特定应用场景下临时锁定主题，例如进行演示或截图时保持统一外观。

高级控制参数

延迟与跳过控制

• --delay-by <分钟>：延迟指定分钟数后执行主题切换
• --toggle-skip-next：切换是否跳过下一次自动切换
• --clear-postpone-queue：清除所有已设置的延迟切换任务
• --get-postpone-status：查询当前延迟切换状态

示例：

AutoDarkModeShell.exe --delay-by 60

这条命令会将下一次主题切换延迟60分钟。

系统状态查询

• --get-requested-theme：获取当前请求的主题状态
• --get-current-colorization：获取当前系统颜色配置
• --alive：检查服务是否正在运行

实用脚本片段：

@echo off AutoDarkModeShell.exe --get-requested-theme > theme.txt set /p current_theme=<theme.txt if "%current_theme%"=="Dark" ( echo 当前主题为深色模式 ) else ( echo 当前主题为浅色模式 )

系统管理参数

自动启动管理

• --add-autostart：添加到系统自动启动
• --remove-autostart：从自动启动中移除
• --get-autostart-state：查询自动启动状态
• --validate-autostart：验证自动启动配置

服务控制

• --exit：关闭服务
• --restart：重启服务
• --detect-monitors：重新检测显示器配置
• --clean-monitors：清除显示器配置缓存

更新与维护参数

• --check-for-update：检查是否有更新
• --check-for-update-notify：检查更新并显示通知
• --check-for-downgrade-notify：检查是否需要降级并显示通知
• --update：执行更新
• --update-failed：通知更新失败状态

使用示例： 创建一个计划任务，每周日检查更新：

AutoDarkModeShell.exe --check-for-update-notify

特殊功能参数

• --location-access：请求位置访问权限
• --geolocator-is-updating：查询地理位置更新状态
• --get-learned-theme-names：获取已学习的主题名称

测试与诊断参数

• --test：运行测试命令
• --test2：运行第二个测试命令
• --test-error：测试错误处理
• --test-notifications：测试通知功能
• --test-notifications2：测试第二种通知样式

实际应用场景

场景1：创建快捷方式快速切换主题

在桌面创建指向AutoDarkModeShell.exe的快捷方式，在"目标"字段添加参数：

"C:\Program Files\Windows-Auto-Night-Mode\AutoDarkModeShell.exe" --swap

双击此快捷方式即可快速切换主题。

场景2：任务计划定时切换

通过Windows任务计划程序，设置在特定时间执行：

AutoDarkModeShell.exe --force-dark

实现每天固定时间自动切换到深色模式。

场景3：系统启动时恢复主题设置

在系统启动脚本中添加：

AutoDarkModeShell.exe --no-force

确保系统启动后解除可能的主题锁定，恢复自动切换功能。

总结

Windows-Auto-Night-Mode的命令行参数为用户提供了强大的主题控制能力，无论是日常快速操作还是高级自动化脚本，都能满足不同用户的需求。通过本文介绍的参数和示例，你可以轻松实现主题切换的个性化和自动化，让Windows主题管理更加高效便捷。

掌握这些命令行参数，你将能够充分发挥Windows-Auto-Night-Mode的潜力，打造更智能、更个性化的系统主题体验。如需了解更多详细信息，可以查看项目中的源代码文件，如AutoDarkModeSvc/Communication/Command.cs获取最新的命令定义。