本文介绍使用 Python 的 pynput 库实现仅响应鼠标和键盘输入的空闲时间检测方案，避免 GetLastInputInfo() 因捕获游戏控制器等非目标设备事件而导致误判的问题。
本文介绍使用 python 的 `pynput` 库实现仅响应鼠标和键盘输入的空闲时间检测方案，避免 `getlastinputinfo()` 因捕获游戏控制器等非目标设备事件而导致误判的问题。
在 Windows 平台开发用户行为监控、自动锁屏或节能策略时，常需判断用户是否处于“真实空闲”状态。系统级 API GetLastInputInfo() 虽然便捷，但其底层监听的是所有原始输入设备（包括 HID 类游戏手柄、绘图板、VR 控制器等），导致即使用户未操作键鼠，仅轻微晃动手柄也会重置空闲计时——这在游戏场景或专业外设环境中尤为干扰。
更精准的解决方案是主动监听且限定设备类型：仅注册鼠标与键盘事件，完全忽略其他 HID 设备。pynput 是一个跨平台、轻量、易用的 Python 库，它通过操作系统原生接口（Windows 上为 Raw Input + WH_KEYBOARD_LL/WH_MOUSE_LL 钩子）捕获输入，且默认只响应标准键鼠设备，天然规避了非目标外设干扰。
以下是一个完整、可运行的示例：
from time import time
from pynput.keyboard import Listener as KeyListener
from pynput.mouse import Listener as MouseListener
idle_time = time()
txt = "You've been idle for {:.1f} seconds."
def on_activity():
global idle_time
print(txt.format(time() - idle_time))
idle_time = time()
if __name__ == '__main__':
# 启动键盘监听：任意按键触发重置
KeyListener(on_press=lambda key: on_activity()).start()
# 启动鼠标监听：移动、点击、滚动均触发重置
with MouseListener(
on_move=lambda x, y: on_activity(),
on_click=lambda x, y, button, pressed: on_activity(),
on_scroll=lambda x, y, dx, dy: on_activity()
) as mouse_listener:
mouse_listener.join() # 阻塞主线程，保持监听活跃✅ 关键优势说明：
- ✅ 设备隔离性：pynput 不依赖全局输入队列，而是通过低级钩子直接过滤输入源，游戏手柄、触摸屏、语音设备等不会触发回调；
- ✅ 事件粒度可控：可单独启用/禁用 on_move、on_click 等，例如仅关注按键和点击（忽略微小移动），提升空闲判定合理性；
- ✅ 无管理员权限要求：相比直接调用 RegisterRawInputDevices，pynput 封装已处理权限与线程同步，开箱即用。
⚠️ 注意事项：
- 在 PyInstaller 打包时，需显式添加 --hidden-import=pynput，否则可能因动态导入失败；
- 若需后台长期运行（如服务程序），建议将监听逻辑置于独立线程，并配合 threading.Event 实现优雅退出；
- macOS/Linux 下行为一致，但底层机制不同（如 macOS 使用 Quartz Event Taps），无需额外适配。
总结而言，当精度优先于系统调用简洁性时，pynput 提供了一种平衡开发效率与设备选择自由度的理想路径——它让“用户是否真正在用电脑”这一判断回归到最核心的交互设备（键盘与鼠标），而非被外围硬件噪声所掩盖。
