pynput是跨平台轻量级鼠标键盘事件录制方案，需同步时间戳、区分事件类型并保存为JSON；回放时按时间差延迟，避免权限与坐标缩放问题。
用 pynput 录制鼠标和键盘事件最直接
纯桌面自动化录制，不依赖图像识别或系统级宏工具，pynput 是目前最轻量、跨平台（Win/macOS/Linux）、权限要求最低的方案。它能真实捕获原始输入事件，不是模拟，所以录下来的动作可回放、可编辑、可条件触发。
安装只需：
pip install pynput
关键点在于：必须分别监听鼠标和键盘，且需同步时间戳——否则回放时点击和按键会错位。常见错误是只录坐标或只录键名，漏掉 time.time() 或事件类型（Button.left / Key.enter），导致回放完全失序。
- 鼠标事件必须记录
Button类型（Button.left、Button.right）、按下/释放状态（pressed）、坐标(x, y)和时间戳 - 键盘事件要区分普通键（
Key.enter）和字符键（KeyCode(char='a')），否则回放时 Ctrl+C 变成按 c 键 - 监听器不能阻塞主线程，得用
threading或with语句配合suppress避免意外终止
保存为 JSON 比二进制更易调试和手动编辑
很多人一上来就用 pickle 存，结果换环境打不开、出错没法查。JSON 是唯一推荐的序列化格式：人眼可读、Git 友好、支持注释（加个 # 行说明某段是登录流程）、方便后期加字段（比如标记“这段要循环3次”）。
立即学习“Python免费学习笔记（深入）”；
示例结构长这样：
[{"type": "mouse", "action": "press", "button": "Button.left", "x": 120, "y": 85, "ts": 1715624301.234}, {"type": "keyboard", "action": "press", "key": "Key.enter", "ts": 1715624301.567}]
注意两个坑：Button.left 这类枚举对象不能直接 JSON 序列化，得用 str(button) 转成字符串；Key.enter 同理。别用 repr()，它带多余引号和 Key. 前缀，解析麻烦。
- 写入前统一用
json.dump(..., indent=2)，别省这个参数——少缩进，后期 diff 就抓瞎 - 文件名建议含时间戳，如
rec_20240514_1422.json，避免覆盖 - 不要把录制过程和保存逻辑混在同一个函数里，先存内存 list，确认停止后再写磁盘
回放时 Controller 的延迟控制比“快慢”更重要
回放不准，90% 出在没处理好事件间隔。不是简单 sleep 固定毫秒数，而是根据录制时的时间戳做相对差值：sleep(recorded_ts[i] - recorded_ts[i-1])。否则鼠标点完按钮还没弹窗，键盘就去输密码，必失败。
pynput 的 Controller 默认是“尽力快”，但桌面应用响应有延迟（尤其 Electron 或 Java 应用），所以要在关键步骤后插检查点：
- 鼠标点击后，如果下一步是等某个窗口出现，别硬 sleep 2 秒，改用
pygetwindow查窗口标题是否存在 - 键盘输入后，若目标是文本框，可用
pyautogui.locateOnScreen找光标位置（需额外装pyautogui，但只用于校验，不用于主逻辑） - 回放脚本开头加
time.sleep(0.5)，让焦点回到目标窗口——用户录完常切走，回放时焦点在终端里，所有按键都输到 shell 了
Windows 下管理员权限会导致录制失效
如果你在 VS Code 或 CMD 以管理员身份运行录制脚本，pynput 监听器大概率收不到任何事件——这是 Windows UAC 的限制，不是 bug。现象是：鼠标动、键盘敲，但日志空空如也，on_move / on_press 根本不触发。
解决方法只有两个：要么关闭 VS Code 的管理员模式，要么改用 Windows 原生 API 的 ctypes 方案（复杂度陡增，不推荐）。macOS 和 Linux 无此问题，但 macOS 需提前在「系统设置 → 隐私与安全性 → 辅助功能」里授权 Python 进程。
验证是否生效很简单：启动录制后，随便点两下，立刻看控制台有没有输出 Mouse moved to (x, y)。没有？先关掉所有“以管理员身份运行”的终端再试。
真正难的是多显示器坐标归一化——不同 DPI 缩放下，pynput 返回的坐标是物理像素，而某些应用（如微信 PC 版）用的是逻辑坐标。这时候得自己算缩放因子，靠 win32api.GetDpiForWindow（Windows）或 CGDisplayScaleFactor（macOS）补正，不是开箱即用的功能。
