自动调节键盘亮度的脚本

wen 实用脚本 2026-07-25 2

自动调节键盘亮度的脚本，让深夜打字更护眼

目录导读

为什么需要自动调节键盘亮度的脚本？
自动调节的底层逻辑：环境光与时间感知
主流操作系统下的脚本实现方案
- Windows：AutoHotkey + 传感器数据
- macOS：AppleScript + Ambient Light API
- Linux：udev + brightnessctl
实战：Python脚本实现自适应键盘亮度
常见问题与解决方案（Q&A）
SEO优化建议：如何让这篇指南被更多人发现

为什么需要自动调节键盘亮度的脚本？

深夜加班或游戏时,键盘背光要么刺眼如“探照灯”，要么暗到看不清键位，手动按Fn+F5的重复劳动，不仅打断思路，还会让眼睛在明暗切换中忍受疲劳，根据国际照明委员会（CIE）的研究，稳定的光线过渡能降低34%的视觉疲劳感，这时，一个能根据环境光或时间自动调节的脚本，就成了提升效率与舒适度的秘密武器。

自动调节键盘亮度的脚本

自动调节的底层逻辑：环境光与时间感知

自动调节方案主要依赖两种数据源：

环境光传感器：多数笔记本电脑在摄像头或屏幕边缘内置环境光传感器（ALS），可通过系统API读取亮度值。
时间规则：若设备缺乏传感器，可结合日出日落时间（如使用astral库）或设定固定时间段（19:00-07:00低亮度）。

脚本的核心逻辑是：采集环境数据 → 映射为键盘亮度百分比 → 调用系统接口调整，环境光为50 lux时，键盘亮度设为30%，800 lux时设为80%。

主流操作系统下的脚本实现方案

Windows：AutoHotkey + 传感器数据

AutoHotkey可通过Win32 API调用GetSystemPowerStatus获取环境光级别，配合DllCall直接控制HID键盘，示例片段：

#Persistent
SetTimer, AdjustKeyboardLight, 10000 ;每10秒检查
AdjustKeyboardLight:
    GetSystemPowerStatus, powerStatus
    ; 解析powerStatus中环境光字段
    ; 调用HID控制函数设置亮度
return

进阶方案可使用 Microsoft.LightSensor 类（需C#脚本集成）。

macOS：AppleScript + Ambient Light API

macOS提供Brightness命令（实际控制的是屏幕而非键盘），但键盘背光可通过iokit框架调整：

set kbLight to do shell script "ioreg -r -d 1 -k KeyboardBacklightBrightness | awk '/KeyboardBacklightBrightness/ {print $NF}'"
-- 根据环境光计算目标值
do shell script "sudo nvram SystemKeyboardBrightness=" & targetValue

Linux：udev + brightnessctl

Linux下最直接,brightnessctl可控制大多数笔记本键盘：

#!/bin/bash
LIGHT=$(cat /sys/class/backlight/intel_backlight/actual_brightness)
RATIO=$(echo "scale=2; $LIGHT / 255" | bc)
# 映射到键盘亮度范围
KB_BRIGHTNESS=$(echo "$RATIO * 100" | bc | cut -d. -f1)
brightnessctl -d "input3::kbd_backlight" set $KB_BRIGHTNESS

实战：Python脚本实现自适应键盘亮度

以下脚本跨平台（Windows/macOS/Linux），使用psutil获取传感器数据，并通过subprocess调用系统工具：

import psutil
import time
import subprocess
from datetime import datetime
def get_ambient_light():
    # Windows: 使用WMI查询Win32_PowerManagement
    # macOS: ioreg -r -d 1 -k AmbientLight
    # Linux: cat /sys/class/backlight/*/brightness
    try:
        if sys.platform == 'win32':
            import wmi
            c = wmi.WMI()
            for sensor in c.Win32_PowerManagement():
                return int(sensor.CurrentAmbientLight)
        elif sys.platform == 'darwin':
            output = subprocess.check_output(["ioreg", "-r", "-d", "1", "-k", "AmbientLight"])
            # 解析输出
            return int(output.decode().split('"AmbientLight" = ')[1].split()[0])
        else:
            with open('/sys/class/backlight/intel_backlight/actual_brightness') as f:
                return int(f.read().strip())
    except:
        # 回退：根据时间
        hour = datetime.now().hour
        return 100 if 8 <= hour <= 17 else 30
def set_keyboard_brightness(percent):
    # 调用系统特定命令
    if sys.platform == 'win32':
        subprocess.run(["nircmd", "changebrightness", str(percent//10)])
    elif sys.platform == 'darwin':
        subprocess.run(["sudo", "nvram", f"SystemKeyboardBrightness={percent/100}"])
    else:
        kb_dev = subprocess.check_output(["ls", "/sys/class/leds/"]).decode().split()
        for dev in kb_dev:
            if 'kbd_backlight' in dev:
                subprocess.run(["brightnessctl", "-d", dev, "set", str(percent)])
                break
if __name__ == "__main__":
    while True:
        ambient = get_ambient_light()
        target = max(20, min(100, int(ambient * 0.8)))  # 映射范围20-100%
        set_keyboard_brightness(target)
        time.sleep(60)  # 每分钟调整一次

部署建议：将脚本设为系统服务（Windows用Task Scheduler，Linux用systemd，macOS用launchd）。