系统空闲钩子并非现成跨平台api，而是需按平台差异实现：windows用getlastinputinfo，linux组合dbus或evdev，macos用cgeventsourcesecondssincelasteventtype，统一封装为get_user_idle_seconds()接口。
什么是系统空闲钩子，C++里没有现成接口
Windows 有 SetThreadExecutionState 和 GetLastInputInfo 配合实现“空闲检测”，Linux/macOS 根本没有等价的系统级“空闲钩子”API。所谓跨平台空闲钩子，本质是自己轮询+聚合多源信号：键盘/鼠标事件、屏幕活动、进程 CPU 占用、甚至窗口焦点变化。别指望一个函数调用就能注册到系统空闲事件——那是误解。
Linux 下怎么可靠获取用户空闲时间
Linux 没有全局空闲 API，xdotool 或 xprintidle 依赖 X11，Wayland 下失效；/proc/sys/kernel/nmi_watchdog 或 /sys/class/power_supply/ 完全不相关。最可行的是组合：evdev 读取输入设备事件 + systemd-idle（仅 systemd 环境）+ dbus 监听 org.freedesktop.ScreenSaver 的 ActiveChanged 信号。但注意：dbus 方法在无桌面环境（如 headless server）下直接不可用。
- 优先尝试 D-Bus 接口：
org.freedesktop.ScreenSaver.GetIdleTime，返回毫秒，但需确保dbus-daemon运行且服务已激活 - fallback 到
evtest类方式：打开/dev/input/event*（需 root 或 input 组权限），监听EV_KEY和EV_REL事件，维护最后活动时间戳 - 避免轮询
/proc/stat的cpu行——它反映的是 CPU 空闲，不是用户空闲
macOS 怎么拿到等效的 idle 时间
macOS 提供了明确的 API：IOPMCopyBatteryInfo 不行，CGEventSourceSecondsSinceLastEventType 才是正解。它返回自指定事件类型（如 kCGAnyInputEventType）以来的秒数，精度约 0.1 秒，无需权限，也不依赖 GUI 进程是否前台。
- 调用前必须链接
-framework CoreGraphics，否则链接失败报undefined symbol: _CGEventSourceSecondsSinceLastEventType - 不要用
IOKit查电源状态——那只是设备供电状态，和用户是否操作无关 - 注意该函数在后台进程（如 launchd daemon）中仍有效，但若 app 被 sandbox 限制且未声明
com.apple.security.device.input权限，可能返回 0
如何封装成统一 C++ 接口并处理差异
别写宏开关拼接平台代码，用编译期多态或运行时虚函数分发。核心是定义统一语义：get_user_idle_seconds() 返回整数秒，0 表示活跃，负值表示不可用（如权限不足或服务未就绪）。
- Windows：调用
GetLastInputInfo→GetTickCount差值 → 除以 1000，注意lastInput.dwTime可能回绕，需用GetTickCount检查 - Linux：先尝试 D-Bus，失败则 fallback 到 evdev 监听（需提前枚举可用 event 设备，跳过
event0这类可能被占用的设备） - macOS：直接调
CGEventSourceSecondsSinceLastEventType(kCGAnyInputEventType)，结果四舍五入为整秒 - 所有平台都应加 500ms 缓冲：比如检测到 29.6 秒空闲，对外返回 30 秒，避免抖动误判
最容易被忽略的是权限与初始化时机：Linux evdev 需要 runtime 获取设备节点权限，macOS sandbox profile 必须显式包含输入权限，Windows 上服务进程默认无法调用 GetLastInputInfo（会返回 0）——得用 WTSSendInput 或切换到交互式会话上下文。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
