Python如何实现电脑定时自动降低屏幕亮度与系统音量以保护视力健康
Windows 环境下使用 winsdk 与 pycaw 精准调控亮度与音量
在Windows操作系统中，若想通过Python脚本实现屏幕亮度与系统音量的自动化调节，您会发现系统并未提供官方的Python直接控制接口。因此，我们需要借助封装了系统底层API的第三方库来完成这一任务。目前业界公认的高效解决方案是：屏幕亮度控制选用winsdk库（完美适配Windows 10及Windows 11系统），而系统音量控制则推荐使用pycaw库（该库兼容性强且维护更新积极）。这两大工具的优势在于，它们无需依赖任何外部图形界面工具或PowerShell脚本，能够以纯后台服务的方式静默运行，完全不会干扰用户的正常操作。
安装过程极为简便，仅需执行一条pip命令：pip install winsdk pycaw
在安装前，有两点关键提示需要注意：winsdk的安装过程可能耗时稍长，因为它可能需要Visual Studio Build Tools或较新版本的pip环境支持。若安装后运行脚本时遇到ModuleNotFoundError: No module named 'winrt'这类错误，无需担心，通常只需单独执行pip install winrt安装其依赖库即可顺利解决。
定时任务执行务必采用 schedule 结合后台进程，避免使用 time.sleep
定时触发功能是整个自动化保护方案的核心，但这里存在一个初学者极易踏入的误区：直接使用time.sleep函数来实现定时。这种方法为何不可取？因为sleep会阻塞主线程的执行，一旦电脑进入睡眠或屏幕锁定状态，整个循环便会停滞，导致定时任务彻底失效。那么，真正可靠且高效的定时方案是什么？答案是采用schedule这款轻量级的Python任务调度库，配合独立的线程进行轮询检查；或者，为了实现最高级别的稳定性，可以直接将脚本配置为Windows系统服务或通过“任务计划程序”来触发。
针对不同的使用场景，建议采用以下策略：
- 开发与测试阶段：建议使用
schedule库，并通过threading模块启动一个独立的后台线程来运行调度器。这样做既能避免阻塞主控制台，也便于实时监控和调试代码。 - 长期部署与稳定运行：强烈推荐使用Windows内置的“任务计划程序”（Task Scheduler）来定时启动您的Python脚本。这是最稳定可靠的方式，即使电脑处于锁屏或待机状态，任务也能被准时唤醒执行。
- 需要严格避免的做法：切勿使用在
while True无限循环中嵌入sleep(60)的写法。这种方案不仅会产生累积性时间误差（时间漂移），而且同样无法适应系统电源状态的切换，可靠性极差。
以下是一段适用于开发阶段的示例代码（核心逻辑展示，非完整实现）：
import schedule
import threading
import time
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秒检查一次待执行任务，平衡响应速度与CPU资源占用
threading.Thread(target=run_scheduler, daemon=True).start()
set_brightness() 函数在多显示器环境下默认仅调节主屏，需主动枚举所有屏幕
使用winsdk库调节屏幕亮度时，在多显示器工作场景下有一个至关重要的细节需要注意。该库的亮度控制接口基于Windows.System.Power和Windows.Graphics.Display命名空间，但其默认操作对象通常是“当前活跃的主显示器”。如果您连接了扩展屏幕，简单地调用DisplayRequest().request_active()是无法切换控制目标的——此API的主要功能是阻止屏幕进入休眠。
那么，正确的多显示器亮度控制方法是什么？若需同步调节所有连接的屏幕，您需要先借助wmi或screeninfo等库获取到系统的完整显示器列表，然后针对每个显示器的独立句柄分别调用SetBrightness方法。不过，对于大多数仅需调节主屏幕亮度的用户而言，可以采用一种更简洁的实现方式：直接针对主显示器（通常索引为0）进行操作，并务必添加异常处理机制以增强脚本的健壮性。
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通常需要管理员（Administrator）权限。因此，必须以管理员身份运行您的Python脚本，否则API调用将会失败。
音量控制需区分「系统主音量」与「应用程序音量」，pycaw 默认设置全局音量
在音量控制方面，pycaw库提供了极为精细的控制能力。它可以通过ISimpleAudioVolume接口单独调节任一应用程序的音量。然而，在“定时护眼”这个具体应用场景下，我们的目标通常是快速降低整体的系统声音环境，而非单独调低某个浏览器或音乐播放软件的音量。因此，我们更常使用的是控制系统主音量的接口。
操作时需掌握以下几个核心要点：
- 使用
IAudioEndpointVolume接口来获取系统主音量控制器，调用SetMasterVolumeLevelScalar(0.3)即可将主音量设置为30%（参数有效范围为0.0至1.0）。 - 需要了解的是，人耳对音量的感知并非线性关系。标量值0.3大约对应-10分贝（dB），在实际听觉感受上已是相当显著的音量降低。
- 如果脚本需要在特定时间（如早晨）恢复音量，一个良好的实践是预先保存用户设定的原始音量值，而不是武断地硬编码恢复为100%。因为用户可能原本就将系统音量设置得较低。
- 相比之下，不建议采用
pywin32模拟键盘音量键（keybd_event）的方式，这种方法不仅可靠性低，还可能意外干扰用户当前的键盘输入操作。
还有一个极易被忽略的技术细节：当您的脚本首次运行时，如果系统当前正处于静音状态，那么调用SetMasterVolumeLevelScalar并不会自动解除静音。您必须额外调用一次SetMute(0)来明确关闭静音状态，音量调节才会实际生效。
