本文介绍了在Windows系统下利用Python自动化定时调低屏幕亮度和系统音量以保护视力的实用方案，通过winsdk（需管理员权限）精准控制主屏亮度、pycaw稳定调节全局音量，并强调必须避开time.sleep等阻塞式定时陷阱，推荐采用schedule配合后台线程或更可靠的Windows任务计划程序实现锁屏/休眠下仍准时执行；同时详述了常见报错（如权限拒绝、winrt缺失）、多屏适配技巧、音量非线性感知处理及静音状态兼容等关键细节，为开发者提供了一套开箱即用、静默稳定、兼顾健壮性与用户体验的护眼自动化实践指南。

Windows 下用 winsdk 和 pycaw 控制亮度与音量

Windows 本身不提供直接调亮度的 Python 原生接口，得靠系统级 API 封装。亮度用 winsdk（需 Windows 10/11），音量用 pycaw（兼容性好、维护活跃）。两者都不依赖第三方 GUI 工具或 PowerShell 脚本，适合后台静默运行。

安装命令：
pip install winsdk pycaw

注意：winsdk 安装较慢，可能需要 Visual Studio Build Tools 或较新版本的 pip；若报 ModuleNotFoundError: No module named 'winrt'，先运行 pip install winrt。

定时执行必须用 schedule + 后台进程，别用 time.sleep

time.sleep 阻塞主线程，一旦进休眠或锁屏就停摆，无法保证准时执行。真正可用的是 schedule 库配合独立线程轮询，或者注册为 Windows 服务/计划任务。

• 开发调试阶段：用 schedule + threading 启一个后台线程，避免阻塞控制台
• 长期运行推荐：用 Windows 任务计划程序（Task Scheduler）触发脚本，更稳定、锁屏也不影响
• 不要用 while True + sleep(60) —— 时间漂移严重，且无法响应系统电源状态变化

示例片段（非完整）：

import schedule
import threading
def set_night_mode():
set_brightness(30)  # 自定义函数
set_volume(20)
schedule.every().day.at("22:00").do(set_night_mode)
schedule.every().day.at("07:00").do(set_day_mode)
def run_scheduler():
while True:
schedule.run_pending()
time.sleep(10)  # 每10秒检查一次，省资源
threading.Thread(target=run_scheduler, daemon=True).start()

set_brightness() 在多显示器下默认只改主屏，需显式枚举

winsdk 的亮度接口基于 Windows.System.Power 和 Windows.Graphics.Display，但实际生效对象是「当前活动显示器」。如果接了副屏，调用 DisplayRequest().request_active() 并不能切换目标——它只是防止屏幕熄灭。

正确做法是用 wmi 或 screeninfo 先获取显示器列表，再对每个句柄调用 SetBrightness。但更轻量的方式是：只操作主屏（多数人需求），并加判断防错：

from winsdk.windows.devices.display import DisplayMonitor
try:
主屏通常 index 0，但需 try/catch 防无权限
monitor = DisplayMonitor.from_id(0)
monitor.set_brightness(30)
except Exception as e:
print(f"Brightness set failed: {e}")  # 常见 PermissionError 或 NotSupported

常见错误：OSError: [WinError -2147024891] Access is denied —— 必须以管理员权限运行脚本，否则亮度 API 直接拒绝。

音量控制要区分「系统音量」和「应用音量」，pycaw 默认设全局

pycaw 的 ISimpleAudioVolume 接口可调单个进程音量，但默认示例都是改系统主音量（IAudioEndpointVolume）。保护视力场景下，你大概率只想压低所有声音，而不是只调微信或 Chrome。

关键点：

• 用 IAudioEndpointVolume 获取主音量接口，SetMasterVolumeLevelScalar(0.3) 设为 30%（参数是 0.0–1.0）
• 音量值不是线性感知，0.3 对应约 -10dB，实际听感已明显降低
• 若需恢复，记得缓存原始值，别硬编码回 1.0 —— 用户可能本来就把音量调得很低
• 不建议用 pywin32 发送音量键消息（keybd_event），不可靠且会干扰用户当前输入

容易被忽略的细节：脚本首次运行时，若系统处于静音状态，SetMasterVolumeLevelScalar 不会自动取消静音，得额外调 SetMute(0)。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《定时调低亮度音量，护眼实用方法》文章吧，也可关注golang学习网公众号了解相关技术文章。