1. 项目概述一个“假装活跃”的鼠标模拟器如果你和我一样经常需要远程办公或者电脑上挂着一些需要保持“在线状态”才能运行的后台任务那你一定遇到过这个烦恼电脑明明在干活却因为长时间没有鼠标或键盘操作被系统判定为“空闲”然后自动锁屏、进入睡眠或者被某些监控软件标记为“离线”。这种时候一个能模拟鼠标微小移动的工具就成了刚需。trose/mouse-jiggler这个项目就是一个用 Python 写的、极其轻量级的鼠标模拟器。它的核心功能简单到极致让鼠标指针在屏幕上以肉眼几乎不可见的幅度和频率进行微小的、随机的移动从而欺骗操作系统让它认为用户一直在活动。你别小看这个功能在特定场景下它能解决大问题。比如远程会议时你需要暂时离开但又不想让状态显示为“离开”或者在进行一个漫长的数据下载或编译过程时你希望电脑保持唤醒避免因休眠中断任务。这个项目没有花里胡哨的界面就是一个命令行脚本但正是这种极简和高效让它成为了许多开发者和IT从业者工具箱里的“秘密武器”。我最初发现这个需求是在处理一些自动化测试脚本时。有些老旧的客户端软件会检测用户活动来维持会话脚本跑着跑着就因为“超时”被踢出来了。手动去晃鼠标显然不现实于是就开始寻找这类工具。市面上有很多选择有带GUI的独立软件也有浏览器插件但它们要么功能臃肿附带广告要么权限要求过高。trose/mouse-jiggler的 Python 实现吸引了我因为它开源、透明、可定制而且由于是脚本对系统资源的占用几乎可以忽略不计。2. 核心原理与方案选型为什么是Python和pyautogui2.1 功能本质与实现路径鼠标模拟器的技术本质是向操作系统发送模拟的输入事件。在 Windows 上这通常通过调用user32.dll中的SendInput或mouse_eventAPI 来实现在 macOS 上可以通过Quartz框架在 Linux 上则可以通过Xlib或uinput。直接调用这些系统 API 功能最强、效率最高但缺点也很明显代码与平台深度耦合需要为不同操作系统编写不同的实现并且可能涉及复杂的权限问题如在 Linux 上需要访问/dev/uinput。trose/mouse-jiggler项目选择了一条更优雅的路径使用 Python 的pyautogui库。这是一个跨平台的 GUI 自动化库它封装了底层不同操作系统的细节为开发者提供了统一的接口比如pyautogui.moveRel()用于相对移动鼠标。这样一来同一份 Python 代码就能在 Windows、macOS 和 Linux 上运行极大地提高了项目的可移植性和易用性。注意虽然pyautogui很方便但它并不是唯一选择。另一个常见的库是pynput它同样支持跨平台并且提供了更细粒度的事件监听和控制。trose/mouse-jiggler选择pyautogui我猜测主要是出于其 API 更加简洁直观对于实现“移动鼠标”这个单一功能来说pyautogui的moveRel或moveTo函数已经足够无需引入更复杂的事件管理机制。2.2 方案优势与潜在考量使用 Python pyautogui的方案带来了几个显著优势开发效率高几行核心代码就能实现功能快速验证想法。跨平台一份代码多处运行降低了使用门槛。依赖清晰主要依赖就是pyautogui安装简单pip install pyautogui。易于定制因为是脚本你可以轻松修改移动的幅度、频率、轨迹比如改成画小圆圈甚至加入随机性来让行为更“人类化”。当然这个方案也有其局限性主要是在需要后台隐藏运行或应对更严格的反自动化检测时。pyautogui的模拟是发生在用户输入层级一些安全软件可能会检测到连续的、有规律的模拟事件。但对于绝大多数用于防止系统休眠或状态检测的场景这已经完全够用且足够隐蔽。3. 环境准备与依赖安装要运行或基于trose/mouse-jiggler进行二次开发第一步就是搭建 Python 环境。这里我假设你使用的是 Windows 系统但步骤在 macOS 和 Linux 上也大同小异。3.1 Python 环境搭建首先确保你的系统安装了 Python。打开命令提示符CMD或 PowerShell输入python --version或者python3 --version如果显示了 Python 3.6 或更高的版本号如Python 3.9.13那么环境已经就绪。如果没有你需要去 Python 官网https://www.python.org/downloads/下载安装包。安装时务必勾选 “Add Python to PATH”这个选项这样系统才能在任何位置识别python命令。3.2 安装必要依赖项目核心依赖是pyautogui。使用 pip 安装非常简单pip install pyautogui在 Windows 上pyautogui可能还会依赖一些其他库来自动处理截图等功能但 pip 会自动处理这些依赖。安装过程通常很顺利。实操心得我强烈建议在安装这类工具依赖时使用虚拟环境Virtual Environment。这可以避免不同项目间的依赖冲突。创建和激活虚拟环境的命令如下# 创建名为 jiggler_env 的虚拟环境 python -m venv jiggler_env # 在 Windows 上激活 jiggler_env\Scripts\activate # 在 macOS/Linux 上激活 source jiggler_env/bin/activate激活后你的命令行提示符前会出现(jiggler_env)字样之后再用pip install pyautogui所有包都会安装在这个独立环境里。3.3 获取项目代码由于trose/mouse-jiggler是一个开源项目代码通常托管在 GitHub 上。你可以直接克隆仓库如果安装了 Gitgit clone https://github.com/trose/mouse-jiggler.git cd mouse-jiggler或者更简单的方式是直接查看项目主页将其核心的 Python 脚本内容复制下来保存为一个本地文件比如mouse_jiggler.py。对于这样一个功能集中的小工具核心代码往往就是一个单独的.py文件。4. 核心代码解析与自定义修改现在让我们深入看看这个鼠标模拟器的“心脏”是如何跳动的。一个基础版本的代码可能长这样import pyautogui import time import random import sys def jiggle_mouse(duration_seconds3600, interval_seconds10, move_pixels1): 让鼠标轻微晃动。 :param duration_seconds: 总运行时间秒默认1小时。 :param interval_seconds: 每次晃动的时间间隔秒。 :param move_pixels: 每次晃动的像素距离。 print(f鼠标模拟器启动。将运行 {duration_seconds} 秒每隔 {interval_seconds} 秒移动 {move_pixels} 像素。) print(按 CtrlC 终止程序。) start_time time.time() try: while time.time() - start_time duration_seconds: # 生成随机的X和Y方向移动-1, 0, 1增加随机性 dx random.choice([-move_pixels, 0, move_pixels]) dy random.choice([-move_pixels, 0, move_pixels]) # 如果dx和dy都是0就强制向一个方向移动1像素 if dx 0 and dy 0: dx move_pixels pyautogui.moveRel(dx, dy, duration0.1) # 用0.1秒完成移动更自然 time.sleep(interval_seconds) except KeyboardInterrupt: print(\n程序被用户中断。) finally: print(鼠标模拟器停止。) if __name__ __main__: # 默认运行1小时每10秒移动1像素。你可以修改这些参数。 jiggle_mouse(duration_seconds3600, interval_seconds10, move_pixels1)4.1 代码逐行解读导入库pyautogui用于控制鼠标time用于控制时间间隔random用于增加移动的随机性sys可能用于处理命令行参数在更复杂的版本中。jiggle_mouse函数这是核心逻辑。它接受三个参数总运行时长、移动间隔和每次移动的像素数。随机移动逻辑dx random.choice([-move_pixels, 0, move_pixels])这行代码是关键。它让鼠标每次移动的方向和幅度都是随机的可能向左、向右、向上、向下或者不移动0。这种随机性使得模拟行为更难以被简单的规律检测算法识别。防静止处理if dx 0 and dy 0:这个判断是为了防止随机结果恰好是(0, 0)导致本次循环没有移动。如果发生就强制让鼠标向右移动move_pixels像素确保每次间隔都有动作。执行移动pyautogui.moveRel(dx, dy, duration0.1)是执行动作的命令。moveRel表示相对当前位置移动。duration0.1参数让移动在0.1秒内完成而不是瞬间“跳”过去这模拟了人类操作鼠标时轻微的拖拽感更加自然。循环与休眠time.sleep(interval_seconds)让程序在每次移动后休眠指定的间隔时间然后进入下一次循环。优雅退出try...except KeyboardInterrupt结构允许用户通过按CtrlC来安全地终止程序而不是强制关闭命令行窗口。4.2 关键参数调优与自定义你可以通过修改函数参数或直接改动代码来让这个工具更符合你的需求move_pixels1这是移动幅度。我强烈建议保持为1。1个像素的移动在1080p或更高分辨率的屏幕上几乎不可见不会干扰你的正常工作鼠标指针不会乱跑但足以被系统检测为活动。如果设置得太大比如10鼠标指针就会在屏幕上“跳舞”非常恼人。interval_seconds10这是移动频率。10秒是一个比较平衡的值。太短如1秒会导致移动过于频繁可能增加CPU不必要的负担虽然极小且行为模式过于规律。太长如60秒则可能在两次移动之间系统已经判定你为“空闲”系统空闲时间阈值通常是几分钟。你可以根据自己系统的电源和屏幕保护设置来调整。例如如果你的系统设置是5分钟无操作后休眠你可以将间隔设置为4 * 60 240秒4分钟。duration_seconds3600总运行时间。默认1小时。你可以设置为一个很大的数如86400代表一天让它一直运行直到你手动停止。或者你可以修改代码去掉时间限制让while循环条件始终为True。注意事项如果你计划让脚本长时间比如整夜运行请确保你的电脑电源设置不会在长时间运行后进入休眠脚本本身可以防止因无操作休眠但无法阻止计划内的休眠或关机。同时建议将脚本窗口最小化或者将其运行为后台进程具体方法见下文。5. 高级用法与系统集成基础的脚本已经能用了但对于追求效率的我们来说还可以让它更好用。5.1 运行为后台进程无窗口模式在 Windows 上如果你不想保留一个命令行窗口可以将 Python 脚本保存为.pyw扩展名而不是.py然后双击运行。.pyw关联的程序是pythonw.exe它会在后台运行不显示命令行窗口。更通用的方法是创建一个批处理文件.batecho off start /B pythonw.exe mouse_jiggler.py exit将上述内容保存为start_jiggler.bat双击即可在后台静默启动脚本。要停止它你需要打开任务管理器找到pythonw.exe进程并结束它。在 macOS 或 Linux 上你可以使用nohup命令在后台运行nohup python3 mouse_jiggler.py /dev/null 21 停止时使用ps aux | grep mouse_jiggler找到进程ID然后用kill [进程ID]命令结束。5.2 创建系统快捷方式或开机启动为了进一步自动化你可以将脚本设置为开机启动。Windows将上一步创建的.bat文件快捷方式放入开始菜单 - 启动文件夹路径通常为C:\Users\[你的用户名]\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup。macOS创建一个.plist文件放入~/Library/LaunchAgents/目录或使用“系统偏好设置-用户与群组-登录项”添加。Linux将启动命令添加到~/.bashrc、~/.profile或使用 systemd 创建用户服务。5.3 增强功能模拟按键与复杂模式如果你需要模拟键盘活动防止某些软件同时检测鼠标和键盘可以很容易地扩展脚本。pyautogui也提供了press函数。import pyautogui import time import random def jiggle_with_keypress(interval30): 每隔一段时间模拟一次轻微的鼠标移动或一次无害的按键 actions [mouse, key] try: while True: action random.choice(actions) if action mouse: dx random.choice([-1, 0, 1]) dy random.choice([-1, 0, 1]) if dx 0 and dy 0: dx 1 pyautogui.moveRel(dx, dy, duration0.1) print(f[{time.strftime(%H:%M:%S)}] 移动鼠标: ({dx}, {dy})) else: # key press # 模拟按下再释放一个不常用的键例如 CAPSLOCK 或 SCROLLLOCK # 注意这可能会触发系统的相应功能请谨慎选择按键 # pyautogui.press(capslock) # 不推荐会改变大小写状态 pyautogui.press(scrolllock) # 许多键盘有这个键且通常无影响 print(f[{time.strftime(%H:%M:%S)}] 模拟按键: SCROLLLOCK) time.sleep(interval) except KeyboardInterrupt: print(程序退出。)重要警告模拟按键需要格外小心避免模拟Enter、Space、Ctrl、Alt等常用功能键否则可能会在你处理文档或聊天时造成意外输入。Scroll Lock或Pause/Break键通常是相对安全的选择因为它们在现代软件中很少被用到。务必先在测试环境中确认按键行为。6. 常见问题与排查技巧实录即使是一个简单的脚本在实际使用中也可能遇到各种小问题。下面是我在长期使用和帮助他人部署过程中总结的一些常见坑点和解决方案。6.1 脚本运行后鼠标指针“乱飞”或移动幅度过大问题现象启动脚本后鼠标指针不受控制地大幅移动无法进行正常操作。原因与排查move_pixels参数设置过大这是最常见的原因。请检查代码中move_pixels的值确保它是1。一个像素的移动在视觉和操作上都是无害的。pyautogui.moveRel的坐标计算错误确保你使用的是moveRel相对移动而不是moveTo绝对移动。moveTo需要屏幕坐标如果计算错误鼠标会直接跳到屏幕的某个角落。随机数生成逻辑有误检查dx和dy的生成逻辑。它们应该在[-move_pixels, 0, move_pixels]这个小范围内随机。如果错误地乘以了一个大系数就会导致大幅移动。解决方案将move_pixels固定为1并仔细检查移动相关的代码行。可以先在代码中加入打印语句输出每次移动的dx, dy值确认其范围是否正确。print(f即将移动: dx{dx}, dy{dy}) pyautogui.moveRel(dx, dy, duration0.1)6.2 程序无法阻止系统休眠或屏幕保护问题现象脚本在运行但电脑仍然按照电源计划进入了睡眠或启动了屏幕保护程序。原因与排查移动间隔过长系统检测“空闲”的阈值可能比你设置的移动间隔要短。例如系统设置为3分钟无操作后休眠而你的脚本每5分钟才动一次鼠标。中间有2分钟的空档期系统已经判定为空闲。移动幅度未被系统识别极少数情况下某些系统或电源管理软件可能忽略微小的像素级移动。可以尝试将move_pixels增加到2或3。脚本进程被挂起或休眠如果系统进入了一种深度节能状态如Windows的“连接待机”所有用户态进程都可能被暂停。外设活动不算“用户活动”这是一个更深层的原因。有些系统尤其是企业环境中通过组策略管理的电脑可能只将来自物理键盘和鼠标的输入计为用户活动而忽略软件模拟的输入。这通常是为了防止此类“欺骗”行为。解决方案调整间隔将interval_seconds设置为明显小于系统休眠阈值的时间。例如系统休眠阈值是5分钟300秒你可以设置间隔为240秒4分钟。组合模拟如上文所述加入模拟按键动作使用安全的按键因为有些系统检测逻辑是“键盘或鼠标活动”。检查电源设置确保你的电源计划设置正确。对于笔记本电脑检查“接通电源”和“使用电池”两种模式下的设置。对于企业环境如果是因为策略限制此类软件方法可能无效。你需要与IT部门沟通或寻找其他合规的保持系统活跃的方法如播放一段无声视频。6.3 在远程桌面RDP/VNC环境下无效问题现象通过远程桌面连接到电脑后运行脚本鼠标模拟只在远程会话中生效断开连接后主机电脑仍然进入休眠。原因分析这是远程桌面架构决定的。当你断开远程连接时远程会话通常会被锁定或挂起。在这个被挂起的会话中运行的脚本其生成的输入事件不会被传递到主机的用户输入栈因此无法阻止主机系统休眠。解决方案在主机上直接运行脚本这是最根本的解决方法。你需要通过计划任务或其他方式确保脚本在主机的控制台会话Session 0 或 Console Session中运行而不是在远程桌面会话中。这通常需要更高的权限并且设置起来更复杂。使用物理鼠标抖动器如果条件允许可以购买一个USB接口的物理鼠标模拟器常被称为“鼠标抖动器”或“防休眠器”。它是一个硬件插入USB口后会自动模拟鼠标微动不依赖于任何软件和会话状态效果最可靠。修改主机电源设置如果对主机的控制力有限可以尝试将主机的电源设置改为“永不睡眠”仅限接通电源时但这可能不符合节能或安全策略。6.4 安全软件误报或拦截问题现象脚本被杀毒软件或安全防护软件标记为病毒、恶意软件或潜在不受欢迎程序PUP并被隔离或删除。原因分析自动化脚本工具尤其是模拟用户输入的的行为特征如定时模拟鼠标移动、无界面运行与某些恶意软件或广告软件相似因此会触发安全软件的启发式检测。解决方案添加排除项在你使用的安全软件中将你的Python解释器python.exe或pythonw.exe和你的脚本文件目录添加到信任列表或排除列表。代码签名如果你需要分发此脚本可以考虑为你的可执行文件进行代码签名。但对于个人使用添加排除项更实际。使用解释型语言的优势正因为是Python脚本源代码是透明的。你可以向安全软件提交该文件进行误报分析或者向需要使用的同事解释其原理和代码这比一个来历不明的.exe文件更容易获得信任。6.5 资源占用与性能考量虽然这个脚本极其轻量但在极端情况下仍需注意CPU占用在默认参数每10秒移动一次下CPU占用率几乎为0%。但如果你将间隔设置得非常短比如0.01秒并且移除了time.sleep那么循环会疯狂运行可能导致一个CPU核心使用率达到100%。务必确保有合理的sleep间隔。对于游戏或高性能应用在运行全屏游戏或高性能图形应用时任何额外的后台进程理论上都可能带来细微影响。虽然pyautogui的影响微乎其微但对于追求极限帧率的电竞玩家在比赛时关闭所有不必要的后台程序是标准操作。7. 伦理、合规与最佳使用实践最后我们必须谈谈如何使用这个工具。技术本身是中立的但使用方式决定了它的性质。核心原则仅用于合法、合规的个人效率提升或系统维护目的。允许的场景防止个人电脑在长时间下载、渲染、编译时休眠。在远程办公时保持通讯软件如Teams、Slack的在线状态避免因短暂离开被误标记为“离开”。自动化测试中维持需要用户交互会话的旧版软件运行。禁止与不鼓励的场景欺骗工作时间追踪软件许多公司使用软件记录员工的活动时间。使用此类工具伪造活动时间是明确的欺骗行为违反职业道德和公司规定可能导致纪律处分甚至解雇。完成需要人工参与和思考的在线培训或考试这属于作弊。任何违反服务条款的行为例如在网游中挂机刷资源如果游戏规则禁止使用自动化工具就违反了用户协议。最佳实践建议知情与透明如果你在办公电脑上使用并且公司有相关IT政策最好事先了解或咨询。用于个人电脑则完全自主。最小干扰将移动幅度(move_pixels)设置为1间隔(interval)设置合理确保工具在完成任务的同时对你和他人的操作造成零干扰。按需启用不要让它7x24小时无意义地运行。在需要的时候启动它比如开始一个长达数小时的编译任务时任务完成后就关闭它。理解原理希望本文不仅让你会用一个脚本更能理解其背后的原理、局限和扩展可能性。这样当下次遇到类似但不同的需求时比如需要模拟键盘输入、点击特定位置你能够自己动手基于pyautogui这个强大的库打造出更贴合你需求的自动化小工具。工具的价值在于延伸人的能力而不是替代人的责任。trose/mouse-jiggler这样的开源小项目完美地体现了编程如何解决那些微小却真实存在的痛点。
Python鼠标模拟器：用pyautogui实现防休眠与状态保持
1. 项目概述一个“假装活跃”的鼠标模拟器如果你和我一样经常需要远程办公或者电脑上挂着一些需要保持“在线状态”才能运行的后台任务那你一定遇到过这个烦恼电脑明明在干活却因为长时间没有鼠标或键盘操作被系统判定为“空闲”然后自动锁屏、进入睡眠或者被某些监控软件标记为“离线”。这种时候一个能模拟鼠标微小移动的工具就成了刚需。trose/mouse-jiggler这个项目就是一个用 Python 写的、极其轻量级的鼠标模拟器。它的核心功能简单到极致让鼠标指针在屏幕上以肉眼几乎不可见的幅度和频率进行微小的、随机的移动从而欺骗操作系统让它认为用户一直在活动。你别小看这个功能在特定场景下它能解决大问题。比如远程会议时你需要暂时离开但又不想让状态显示为“离开”或者在进行一个漫长的数据下载或编译过程时你希望电脑保持唤醒避免因休眠中断任务。这个项目没有花里胡哨的界面就是一个命令行脚本但正是这种极简和高效让它成为了许多开发者和IT从业者工具箱里的“秘密武器”。我最初发现这个需求是在处理一些自动化测试脚本时。有些老旧的客户端软件会检测用户活动来维持会话脚本跑着跑着就因为“超时”被踢出来了。手动去晃鼠标显然不现实于是就开始寻找这类工具。市面上有很多选择有带GUI的独立软件也有浏览器插件但它们要么功能臃肿附带广告要么权限要求过高。trose/mouse-jiggler的 Python 实现吸引了我因为它开源、透明、可定制而且由于是脚本对系统资源的占用几乎可以忽略不计。2. 核心原理与方案选型为什么是Python和pyautogui2.1 功能本质与实现路径鼠标模拟器的技术本质是向操作系统发送模拟的输入事件。在 Windows 上这通常通过调用user32.dll中的SendInput或mouse_eventAPI 来实现在 macOS 上可以通过Quartz框架在 Linux 上则可以通过Xlib或uinput。直接调用这些系统 API 功能最强、效率最高但缺点也很明显代码与平台深度耦合需要为不同操作系统编写不同的实现并且可能涉及复杂的权限问题如在 Linux 上需要访问/dev/uinput。trose/mouse-jiggler项目选择了一条更优雅的路径使用 Python 的pyautogui库。这是一个跨平台的 GUI 自动化库它封装了底层不同操作系统的细节为开发者提供了统一的接口比如pyautogui.moveRel()用于相对移动鼠标。这样一来同一份 Python 代码就能在 Windows、macOS 和 Linux 上运行极大地提高了项目的可移植性和易用性。注意虽然pyautogui很方便但它并不是唯一选择。另一个常见的库是pynput它同样支持跨平台并且提供了更细粒度的事件监听和控制。trose/mouse-jiggler选择pyautogui我猜测主要是出于其 API 更加简洁直观对于实现“移动鼠标”这个单一功能来说pyautogui的moveRel或moveTo函数已经足够无需引入更复杂的事件管理机制。2.2 方案优势与潜在考量使用 Python pyautogui的方案带来了几个显著优势开发效率高几行核心代码就能实现功能快速验证想法。跨平台一份代码多处运行降低了使用门槛。依赖清晰主要依赖就是pyautogui安装简单pip install pyautogui。易于定制因为是脚本你可以轻松修改移动的幅度、频率、轨迹比如改成画小圆圈甚至加入随机性来让行为更“人类化”。当然这个方案也有其局限性主要是在需要后台隐藏运行或应对更严格的反自动化检测时。pyautogui的模拟是发生在用户输入层级一些安全软件可能会检测到连续的、有规律的模拟事件。但对于绝大多数用于防止系统休眠或状态检测的场景这已经完全够用且足够隐蔽。3. 环境准备与依赖安装要运行或基于trose/mouse-jiggler进行二次开发第一步就是搭建 Python 环境。这里我假设你使用的是 Windows 系统但步骤在 macOS 和 Linux 上也大同小异。3.1 Python 环境搭建首先确保你的系统安装了 Python。打开命令提示符CMD或 PowerShell输入python --version或者python3 --version如果显示了 Python 3.6 或更高的版本号如Python 3.9.13那么环境已经就绪。如果没有你需要去 Python 官网https://www.python.org/downloads/下载安装包。安装时务必勾选 “Add Python to PATH”这个选项这样系统才能在任何位置识别python命令。3.2 安装必要依赖项目核心依赖是pyautogui。使用 pip 安装非常简单pip install pyautogui在 Windows 上pyautogui可能还会依赖一些其他库来自动处理截图等功能但 pip 会自动处理这些依赖。安装过程通常很顺利。实操心得我强烈建议在安装这类工具依赖时使用虚拟环境Virtual Environment。这可以避免不同项目间的依赖冲突。创建和激活虚拟环境的命令如下# 创建名为 jiggler_env 的虚拟环境 python -m venv jiggler_env # 在 Windows 上激活 jiggler_env\Scripts\activate # 在 macOS/Linux 上激活 source jiggler_env/bin/activate激活后你的命令行提示符前会出现(jiggler_env)字样之后再用pip install pyautogui所有包都会安装在这个独立环境里。3.3 获取项目代码由于trose/mouse-jiggler是一个开源项目代码通常托管在 GitHub 上。你可以直接克隆仓库如果安装了 Gitgit clone https://github.com/trose/mouse-jiggler.git cd mouse-jiggler或者更简单的方式是直接查看项目主页将其核心的 Python 脚本内容复制下来保存为一个本地文件比如mouse_jiggler.py。对于这样一个功能集中的小工具核心代码往往就是一个单独的.py文件。4. 核心代码解析与自定义修改现在让我们深入看看这个鼠标模拟器的“心脏”是如何跳动的。一个基础版本的代码可能长这样import pyautogui import time import random import sys def jiggle_mouse(duration_seconds3600, interval_seconds10, move_pixels1): 让鼠标轻微晃动。 :param duration_seconds: 总运行时间秒默认1小时。 :param interval_seconds: 每次晃动的时间间隔秒。 :param move_pixels: 每次晃动的像素距离。 print(f鼠标模拟器启动。将运行 {duration_seconds} 秒每隔 {interval_seconds} 秒移动 {move_pixels} 像素。) print(按 CtrlC 终止程序。) start_time time.time() try: while time.time() - start_time duration_seconds: # 生成随机的X和Y方向移动-1, 0, 1增加随机性 dx random.choice([-move_pixels, 0, move_pixels]) dy random.choice([-move_pixels, 0, move_pixels]) # 如果dx和dy都是0就强制向一个方向移动1像素 if dx 0 and dy 0: dx move_pixels pyautogui.moveRel(dx, dy, duration0.1) # 用0.1秒完成移动更自然 time.sleep(interval_seconds) except KeyboardInterrupt: print(\n程序被用户中断。) finally: print(鼠标模拟器停止。) if __name__ __main__: # 默认运行1小时每10秒移动1像素。你可以修改这些参数。 jiggle_mouse(duration_seconds3600, interval_seconds10, move_pixels1)4.1 代码逐行解读导入库pyautogui用于控制鼠标time用于控制时间间隔random用于增加移动的随机性sys可能用于处理命令行参数在更复杂的版本中。jiggle_mouse函数这是核心逻辑。它接受三个参数总运行时长、移动间隔和每次移动的像素数。随机移动逻辑dx random.choice([-move_pixels, 0, move_pixels])这行代码是关键。它让鼠标每次移动的方向和幅度都是随机的可能向左、向右、向上、向下或者不移动0。这种随机性使得模拟行为更难以被简单的规律检测算法识别。防静止处理if dx 0 and dy 0:这个判断是为了防止随机结果恰好是(0, 0)导致本次循环没有移动。如果发生就强制让鼠标向右移动move_pixels像素确保每次间隔都有动作。执行移动pyautogui.moveRel(dx, dy, duration0.1)是执行动作的命令。moveRel表示相对当前位置移动。duration0.1参数让移动在0.1秒内完成而不是瞬间“跳”过去这模拟了人类操作鼠标时轻微的拖拽感更加自然。循环与休眠time.sleep(interval_seconds)让程序在每次移动后休眠指定的间隔时间然后进入下一次循环。优雅退出try...except KeyboardInterrupt结构允许用户通过按CtrlC来安全地终止程序而不是强制关闭命令行窗口。4.2 关键参数调优与自定义你可以通过修改函数参数或直接改动代码来让这个工具更符合你的需求move_pixels1这是移动幅度。我强烈建议保持为1。1个像素的移动在1080p或更高分辨率的屏幕上几乎不可见不会干扰你的正常工作鼠标指针不会乱跑但足以被系统检测为活动。如果设置得太大比如10鼠标指针就会在屏幕上“跳舞”非常恼人。interval_seconds10这是移动频率。10秒是一个比较平衡的值。太短如1秒会导致移动过于频繁可能增加CPU不必要的负担虽然极小且行为模式过于规律。太长如60秒则可能在两次移动之间系统已经判定你为“空闲”系统空闲时间阈值通常是几分钟。你可以根据自己系统的电源和屏幕保护设置来调整。例如如果你的系统设置是5分钟无操作后休眠你可以将间隔设置为4 * 60 240秒4分钟。duration_seconds3600总运行时间。默认1小时。你可以设置为一个很大的数如86400代表一天让它一直运行直到你手动停止。或者你可以修改代码去掉时间限制让while循环条件始终为True。注意事项如果你计划让脚本长时间比如整夜运行请确保你的电脑电源设置不会在长时间运行后进入休眠脚本本身可以防止因无操作休眠但无法阻止计划内的休眠或关机。同时建议将脚本窗口最小化或者将其运行为后台进程具体方法见下文。5. 高级用法与系统集成基础的脚本已经能用了但对于追求效率的我们来说还可以让它更好用。5.1 运行为后台进程无窗口模式在 Windows 上如果你不想保留一个命令行窗口可以将 Python 脚本保存为.pyw扩展名而不是.py然后双击运行。.pyw关联的程序是pythonw.exe它会在后台运行不显示命令行窗口。更通用的方法是创建一个批处理文件.batecho off start /B pythonw.exe mouse_jiggler.py exit将上述内容保存为start_jiggler.bat双击即可在后台静默启动脚本。要停止它你需要打开任务管理器找到pythonw.exe进程并结束它。在 macOS 或 Linux 上你可以使用nohup命令在后台运行nohup python3 mouse_jiggler.py /dev/null 21 停止时使用ps aux | grep mouse_jiggler找到进程ID然后用kill [进程ID]命令结束。5.2 创建系统快捷方式或开机启动为了进一步自动化你可以将脚本设置为开机启动。Windows将上一步创建的.bat文件快捷方式放入开始菜单 - 启动文件夹路径通常为C:\Users\[你的用户名]\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup。macOS创建一个.plist文件放入~/Library/LaunchAgents/目录或使用“系统偏好设置-用户与群组-登录项”添加。Linux将启动命令添加到~/.bashrc、~/.profile或使用 systemd 创建用户服务。5.3 增强功能模拟按键与复杂模式如果你需要模拟键盘活动防止某些软件同时检测鼠标和键盘可以很容易地扩展脚本。pyautogui也提供了press函数。import pyautogui import time import random def jiggle_with_keypress(interval30): 每隔一段时间模拟一次轻微的鼠标移动或一次无害的按键 actions [mouse, key] try: while True: action random.choice(actions) if action mouse: dx random.choice([-1, 0, 1]) dy random.choice([-1, 0, 1]) if dx 0 and dy 0: dx 1 pyautogui.moveRel(dx, dy, duration0.1) print(f[{time.strftime(%H:%M:%S)}] 移动鼠标: ({dx}, {dy})) else: # key press # 模拟按下再释放一个不常用的键例如 CAPSLOCK 或 SCROLLLOCK # 注意这可能会触发系统的相应功能请谨慎选择按键 # pyautogui.press(capslock) # 不推荐会改变大小写状态 pyautogui.press(scrolllock) # 许多键盘有这个键且通常无影响 print(f[{time.strftime(%H:%M:%S)}] 模拟按键: SCROLLLOCK) time.sleep(interval) except KeyboardInterrupt: print(程序退出。)重要警告模拟按键需要格外小心避免模拟Enter、Space、Ctrl、Alt等常用功能键否则可能会在你处理文档或聊天时造成意外输入。Scroll Lock或Pause/Break键通常是相对安全的选择因为它们在现代软件中很少被用到。务必先在测试环境中确认按键行为。6. 常见问题与排查技巧实录即使是一个简单的脚本在实际使用中也可能遇到各种小问题。下面是我在长期使用和帮助他人部署过程中总结的一些常见坑点和解决方案。6.1 脚本运行后鼠标指针“乱飞”或移动幅度过大问题现象启动脚本后鼠标指针不受控制地大幅移动无法进行正常操作。原因与排查move_pixels参数设置过大这是最常见的原因。请检查代码中move_pixels的值确保它是1。一个像素的移动在视觉和操作上都是无害的。pyautogui.moveRel的坐标计算错误确保你使用的是moveRel相对移动而不是moveTo绝对移动。moveTo需要屏幕坐标如果计算错误鼠标会直接跳到屏幕的某个角落。随机数生成逻辑有误检查dx和dy的生成逻辑。它们应该在[-move_pixels, 0, move_pixels]这个小范围内随机。如果错误地乘以了一个大系数就会导致大幅移动。解决方案将move_pixels固定为1并仔细检查移动相关的代码行。可以先在代码中加入打印语句输出每次移动的dx, dy值确认其范围是否正确。print(f即将移动: dx{dx}, dy{dy}) pyautogui.moveRel(dx, dy, duration0.1)6.2 程序无法阻止系统休眠或屏幕保护问题现象脚本在运行但电脑仍然按照电源计划进入了睡眠或启动了屏幕保护程序。原因与排查移动间隔过长系统检测“空闲”的阈值可能比你设置的移动间隔要短。例如系统设置为3分钟无操作后休眠而你的脚本每5分钟才动一次鼠标。中间有2分钟的空档期系统已经判定为空闲。移动幅度未被系统识别极少数情况下某些系统或电源管理软件可能忽略微小的像素级移动。可以尝试将move_pixels增加到2或3。脚本进程被挂起或休眠如果系统进入了一种深度节能状态如Windows的“连接待机”所有用户态进程都可能被暂停。外设活动不算“用户活动”这是一个更深层的原因。有些系统尤其是企业环境中通过组策略管理的电脑可能只将来自物理键盘和鼠标的输入计为用户活动而忽略软件模拟的输入。这通常是为了防止此类“欺骗”行为。解决方案调整间隔将interval_seconds设置为明显小于系统休眠阈值的时间。例如系统休眠阈值是5分钟300秒你可以设置间隔为240秒4分钟。组合模拟如上文所述加入模拟按键动作使用安全的按键因为有些系统检测逻辑是“键盘或鼠标活动”。检查电源设置确保你的电源计划设置正确。对于笔记本电脑检查“接通电源”和“使用电池”两种模式下的设置。对于企业环境如果是因为策略限制此类软件方法可能无效。你需要与IT部门沟通或寻找其他合规的保持系统活跃的方法如播放一段无声视频。6.3 在远程桌面RDP/VNC环境下无效问题现象通过远程桌面连接到电脑后运行脚本鼠标模拟只在远程会话中生效断开连接后主机电脑仍然进入休眠。原因分析这是远程桌面架构决定的。当你断开远程连接时远程会话通常会被锁定或挂起。在这个被挂起的会话中运行的脚本其生成的输入事件不会被传递到主机的用户输入栈因此无法阻止主机系统休眠。解决方案在主机上直接运行脚本这是最根本的解决方法。你需要通过计划任务或其他方式确保脚本在主机的控制台会话Session 0 或 Console Session中运行而不是在远程桌面会话中。这通常需要更高的权限并且设置起来更复杂。使用物理鼠标抖动器如果条件允许可以购买一个USB接口的物理鼠标模拟器常被称为“鼠标抖动器”或“防休眠器”。它是一个硬件插入USB口后会自动模拟鼠标微动不依赖于任何软件和会话状态效果最可靠。修改主机电源设置如果对主机的控制力有限可以尝试将主机的电源设置改为“永不睡眠”仅限接通电源时但这可能不符合节能或安全策略。6.4 安全软件误报或拦截问题现象脚本被杀毒软件或安全防护软件标记为病毒、恶意软件或潜在不受欢迎程序PUP并被隔离或删除。原因分析自动化脚本工具尤其是模拟用户输入的的行为特征如定时模拟鼠标移动、无界面运行与某些恶意软件或广告软件相似因此会触发安全软件的启发式检测。解决方案添加排除项在你使用的安全软件中将你的Python解释器python.exe或pythonw.exe和你的脚本文件目录添加到信任列表或排除列表。代码签名如果你需要分发此脚本可以考虑为你的可执行文件进行代码签名。但对于个人使用添加排除项更实际。使用解释型语言的优势正因为是Python脚本源代码是透明的。你可以向安全软件提交该文件进行误报分析或者向需要使用的同事解释其原理和代码这比一个来历不明的.exe文件更容易获得信任。6.5 资源占用与性能考量虽然这个脚本极其轻量但在极端情况下仍需注意CPU占用在默认参数每10秒移动一次下CPU占用率几乎为0%。但如果你将间隔设置得非常短比如0.01秒并且移除了time.sleep那么循环会疯狂运行可能导致一个CPU核心使用率达到100%。务必确保有合理的sleep间隔。对于游戏或高性能应用在运行全屏游戏或高性能图形应用时任何额外的后台进程理论上都可能带来细微影响。虽然pyautogui的影响微乎其微但对于追求极限帧率的电竞玩家在比赛时关闭所有不必要的后台程序是标准操作。7. 伦理、合规与最佳使用实践最后我们必须谈谈如何使用这个工具。技术本身是中立的但使用方式决定了它的性质。核心原则仅用于合法、合规的个人效率提升或系统维护目的。允许的场景防止个人电脑在长时间下载、渲染、编译时休眠。在远程办公时保持通讯软件如Teams、Slack的在线状态避免因短暂离开被误标记为“离开”。自动化测试中维持需要用户交互会话的旧版软件运行。禁止与不鼓励的场景欺骗工作时间追踪软件许多公司使用软件记录员工的活动时间。使用此类工具伪造活动时间是明确的欺骗行为违反职业道德和公司规定可能导致纪律处分甚至解雇。完成需要人工参与和思考的在线培训或考试这属于作弊。任何违反服务条款的行为例如在网游中挂机刷资源如果游戏规则禁止使用自动化工具就违反了用户协议。最佳实践建议知情与透明如果你在办公电脑上使用并且公司有相关IT政策最好事先了解或咨询。用于个人电脑则完全自主。最小干扰将移动幅度(move_pixels)设置为1间隔(interval)设置合理确保工具在完成任务的同时对你和他人的操作造成零干扰。按需启用不要让它7x24小时无意义地运行。在需要的时候启动它比如开始一个长达数小时的编译任务时任务完成后就关闭它。理解原理希望本文不仅让你会用一个脚本更能理解其背后的原理、局限和扩展可能性。这样当下次遇到类似但不同的需求时比如需要模拟键盘输入、点击特定位置你能够自己动手基于pyautogui这个强大的库打造出更贴合你需求的自动化小工具。工具的价值在于延伸人的能力而不是替代人的责任。trose/mouse-jiggler这样的开源小项目完美地体现了编程如何解决那些微小却真实存在的痛点。
