KeymouseGo 鼠标键盘自动化录制回放
【免费下载链接】KeymouseGo类似按键精灵的鼠标键盘录制和自动化操作 模拟点击和键入 | automate mouse clicks and keyboard input项目地址: https://gitcode.com/gh_mirrors/ke/KeymouseGo
KeymouseGo 是一款免费开源的鼠标键盘自动化工具：把一遍鼠标点击与键盘输入录下来，存成可编辑的 JSON5 脚本，之后按热键或用命令行让电脑自动重放。它支持 Windows、Linux 与 macOS，图形界面基于 PySide6 开发，同时提供无需界面的命令行模式。
KeymouseGo 是什么，不是什么
它不是编程框架，不需要写代码，也不做屏幕内容识别。它做的事比较单一：忠实记录鼠标点过哪里、按过哪些键，再按原样回放。项目对自己的定位是“精简绿色版”的按键精灵——自己把操作做一遍，接下来让电脑照着做。
相比同类工具，KeymouseGo 有两个方便之处：脚本是纯文本文件，直接用编辑器就能改；程序用 Python 编写，源码结构不复杂，录制监听在 Recorder/ 目录，事件回放在 Event/ 目录，界面逻辑集中在 UIFunc.py，想改哪里基本一眼能找到。v5.2 还引入了插件系统（不兼容旧版插件），脚本格式也改为 json5 并保持对旧脚本的兼容。
界面支持简体中文、英文、繁体中文，热键、执行次数等设置会保存在本地配置文件中，下次启动自动恢复。
🖱 安装 KeymouseGo：直接运行或源码运行
直接运行可执行文件
项目提供打包好的可执行文件（由 pyinstaller 生成）。机器上没有 Python 环境时，下载后直接运行 KeymouseGo 程序即可打开界面，属于开箱即用。
从源码运行
希望修改代码或了解内部机制时，克隆源码并安装对应平台的依赖：
git clone https://gitcode.com/gh_mirrors/ke/KeymouseGo cd KeymouseGo pip install -r requirements-windows.txt # Linux/MacOS 改用 pip3 install -r requirements-universal.txt python KeymouseGo.py🎬 KeymouseGo 怎么录制、怎么回放
开始与结束一次录制
点“录制”按钮或按默认热键 F10，然后像平时一样操作电脑。录制只记鼠标点击和键盘事件，不记录连续的鼠标移动轨迹；拖动产生的移动事件会按界面上 Precision 参数（1–1000 毫秒）设定的间隔采样。完成后点“结束”，F9 热键同样可以结束录制。每次录制结束都会在 scripts 目录下生成一个以时间命名的新脚本文件，例如 0314_1452.json5。
设置执行次数并启动回放
运行前在脚本下拉列表里选一个文件，设置执行次数——填 0 表示无限循环，其余数值即循环轮数。点“启动”或按默认热键 F6 开始执行；执行中再按 F6 会暂停，再按一次恢复；按 F9 立即停止。旧版本曾提供 50%–200% 的执行速度滑杆，v5.2 起移除了这个内置选项，项目以插件样例作为替代。这种“录一次、跑很多遍”的方式，适合数据录入、批量文档处理、界面回归测试等重复性工作。
自定义启动、停止与录制热键
三个热键都能在界面里改。除了功能键，还可以用鼠标中键（Middle）和侧键（XButton）当热键，方便双手不离键盘的操作。
📄 KeymouseGo 脚本的保存位置与格式
脚本文件在哪里
所有脚本都在项目目录的 scripts 文件夹下，录制一次生成一个文件，界面列表会列出全部已有脚本供选择。
如何阅读和修改脚本
脚本为 JSON5 格式，包含事件类型、延迟毫秒数、坐标或按键码，支持用//写注释。鼠标坐标以相对屏幕的百分比表示，换分辨率时一般不用重录；坐标写成[-1, -1]表示在鼠标当前所在位置执行动作。用任意文本编辑器打开即可调整延迟、坐标和按键，保存后在列表选中运行。解析细节可参考 脚本解析逻辑。
⌨ 用命令行直接执行脚本
不打开图形界面时，可以把脚本路径直接传给程序（支持一次传多个脚本），-rt（或--runtimes）指定执行次数，缺省为 1 次；命令行下按 F9 可停止正在执行的脚本：
./KeymouseGo scripts/0314_1452.txt ./KeymouseGo scripts/0314_1452.txt -rt 3 ./KeymouseGo scripts/0314_1452.txt -rt 0-rt 0即无限循环。命令行模式省去了开窗口这一步，适合挂在服务器上批量跑同一份脚本。
🛠 坐标偏移、录不到事件等常见问题的处理
屏幕缩放导致的位置偏差
系统显示缩放不是 100% 时，回放坐标容易偏。建议把缩放调到 100%，并保证录制与回放时的缩放设置一致。
权限不足导致录不到鼠标事件
部分系统环境下会录不全鼠标事件。Windows 上以管理员身份运行；Linux 和 Mac 以 root 身份运行；Mac 还要把程序加入辅助功能白名单，用打包的可执行文件时终端也要一并加入。若应用闪退，可给 ~/.qt_material 目录下文件加写权限：chmod -R 770 ~/.qt_material。Linux/Mac 以管理员运行后仍有问题的，可参考 pynput 文档中的权限说明。
回放速度达不到预期
程序执行速度有限制，录制的操作速度超过一定阈值时，回放无法达到录制的速度，关键步骤之间多留一点延迟会更稳。
【免费下载链接】KeymouseGo类似按键精灵的鼠标键盘录制和自动化操作 模拟点击和键入 | automate mouse clicks and keyboard input项目地址: https://gitcode.com/gh_mirrors/ke/KeymouseGo
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
