KeymouseGo鼠标宏与键鼠录制工具：键盘录制回放下载使用教程

什么是KeymouseGo

KeymouseGo 是一款开源、免费、跨平台的鼠标宏、键鼠录制与回放工具，作者是陶佳元，在互联网上常用 ID 有 taojy123、tao.py。项目支持 Windows、Linux、macOS 系统。你可以把它理解为“精简绿色版”的按键精灵，也是一款轻量的鼠标键盘录制器：它能够记录用户的鼠标点击、键盘录制等操作，通过触发按钮自动执行之前记录的操作，并且可以设定执行次数，从而帮助用户完成操作简单、单调重复的工作。由于开源免费，它也适合寻找鼠标录制免费方案的用户。

  • 核心思路：自己先手动做一遍，然后让电脑按照记录自动重复执行；适合反复点击、反复输入、反复切换窗口、批量录入数据、执行固定测试流程等工作
  • 运行方式：软件下载后解压，点击 KeymouseGo 运行即可使用，无需复杂配置
  • 功能定位：不是复杂的自动化开发框架，而是偏向轻量、直接、易用的桌面操作录制工具
  • 热键与录制：默认启动热键为 F6（等同“启动”按钮），默认终止热键为 F9（停止正在运行的脚本）；录制时只记录鼠标点击动作和键盘动作，不记录鼠标移动轨迹
  • 脚本生成：每次录制结束后会在 scripts 目录下生成一个新的脚本文件，脚本使用 json5 格式，运行前可从列表中选择脚本，也可手动修改内容
  • 命令行模式：可直接运行指定脚本，也可指定运行次数，例如运行 scripts/0314_1452.txt，或使用 -rt 3、--runtimes 3 让脚本运行 3 次

总体而言，KeymouseGo 适合日常办公、数据录入、重复点击、简单测试、流程演示等场景，是一个轻量、开源、跨平台的鼠标宏、键鼠录制与键盘录制回放工具。

KeymouseGo的功能介绍

KeymouseGo 的功能围绕“录制、回放、编辑、执行”展开，主要面向需要重复执行鼠标键盘操作的用户：

  • 鼠标键盘录制与回放：点击“录制”按钮开始记录鼠标点击、键盘录制、键盘输入等操作，点击“结束”停止录制；之后点击“启动”按钮即可重复执行之前录制的动作，适合重复性高、操作步骤固定的任务
  • 执行次数控制：可设置脚本重复执行的次数，如果次数设置为 0 则表示无限循环；需要长时间重复执行可开启无限循环，只需执行固定次数可填写具体数字
  • 热键控制：默认启动热键为 F6（等同“启动”按钮），默认终止热键为 F9（停止正在运行的脚本）；即使软件窗口不在前台，也可通过快捷键快速启动或停止脚本
  • 脚本自动生成与管理：每次录制结束后会在 scripts 目录下生成一个新的脚本文件，运行前可在列表中选择需要执行的脚本；脚本内容可修改，修改时可参考脚本格式说明
  • 命令行模式：支持直接运行指定脚本（如 ./KeymouseGo scripts/0314_1452.txt），也可指定运行次数（如 ./KeymouseGo scripts/0314_1452.txt -rt 3 或 --runtimes 3），适合集成到批处理、计划任务或其他自动化流程中
  • 脚本语法灵活：脚本为 json5 格式，每个最内层 jsonobject 代表一个事件；事件类型包括 EM 鼠标事件、EK 键盘事件、EX 输入事件；动作类型包括 mouse left down、mouse right down、mouse left up、mouse right up、mouse move、key down、key up、input 等；坐标可使用相对坐标（如 0.05208 表示屏幕宽度的 5.208%），当横纵坐标为 [-1, -1] 时表示在鼠标当前所在位置执行操作
  • 支持鼠标与键盘多种按键：热键设置中的 Middle 指代鼠标中键，XButton 指代鼠标侧键；除了常规左右键，还可处理中键和侧键操作，覆盖更多使用场景
  • 跨平台支持：支持 Windows、Linux、macOS，可在不同系统的桌面环境中完成键鼠录制与回放任务
  • 开源与可扩展：项目在 GitHub 开源并提供 dev 分支，开发爱好者可查看进度并提交 Pull request 参与建设；项目也感谢 JetBrains 免费提供开发工具
  • 安装方式：点击页面下方下载按钮获取安装包，解压后运行即可，鼠标录制免费使用；高级功能可查看项目 wiki 中的脚本语法文档

如何使用KeymouseGo

使用 KeymouseGo 可以分为下载运行、桌面录制、启动回放、命令行执行和脚本修改几个步骤：

  • 下载与安装：点击页面下方下载按钮获取安装包，解压后点击 KeymouseGo 运行即可使用，无需复杂配置
  • 桌面模式录制：打开 KeymouseGo 后点击“录制”按钮开始键鼠录制，此时在计算机上进行任意操作（点击鼠标、键盘录制、键盘输入）都会被记录；注意录制时只记录鼠标点击动作和键盘动作，不记录鼠标移动轨迹，若操作依赖鼠标移动路径需在脚本中手动添加 mouse move 事件；操作完成后点击“结束”按钮，每次录制结束后都会在 scripts 目录下生成一个新的脚本文件
  • 启动回放：录制完成后点击“启动”按钮，计算机会重复执行刚才录制的动作；可设置脚本重复执行的次数，设置为 0 即为无限循环；默认启动热键 F6 等同“启动”按钮，默认终止热键 F9 停止正在运行的脚本；运行前可在列表中选择需要执行的脚本，避免执行错误的脚本
  • 命令行模式：不想打开图形界面时可直接运行指定脚本，例如 ./KeymouseGo scripts/0314_1452.txt；若希望运行指定脚本 3 次，可使用 ./KeymouseGo scripts/0314_1452.txt -rt 3 或 ./KeymouseGo scripts/0314_1452.txt --runtimes 3；命令行模式适合批处理、计划任务和自动化脚本调用
  • 修改脚本：scripts 下的脚本文件内容可修改，修改时参考脚本格式说明；脚本为 json5 格式，每个最内层 jsonobject 代表一个事件，例如 {type: "event", event_type: "EM", delay: 3000, action_type: "mouse right down", action: ["0.05208%", "0.1852%"]} 表示开始运行 3000ms 后在屏幕相对坐标 (0.05208, 0.1852) 即 (100,200) 处按下鼠标右键；{type: "event", event_type: "EM", delay: 50, action_type: "mouse right up", action: [-1, -1]} 表示等待 50ms 后在相同位置抬起鼠标右键，横纵坐标为 [-1,-1] 时表示在鼠标当前所在位置执行操作；键盘事件使用 event_type: "EK"（如按下 f 键和抬起 f 键），输入事件使用 event_type: "EX"（如 action_type: "input"、action: "你好 world"），鼠标移动使用 action_type: "mouse move"，鼠标左键、右键、中键、侧键等都可以通过 action_type 表达
  • 高级使用：运行前可在列表中选择脚本，也可手动编辑脚本中的 delay、action_type、action 等字段；对于复杂任务，可把多个事件组合起来形成一套完整的操作录制流程；高级功能可查看项目 wiki 中的脚本语法文档；若发现程序速度受限，当输入的鼠标速度大于一定值时脚本将无法以预期的输入速度执行，因此需要合理设置 delay

KeymouseGo使用的注意事项

使用 KeymouseGo 时，需要注意权限、平台差异、脚本格式、热键、执行速度和合规使用等问题：

  • 默认热键：默认启动热键为 F6（等同“启动”按钮），默认终止热键为 F9（停止正在运行的脚本）；运行脚本前应确认热键是否与其他软件冲突
  • 录制范围：录制时只记录鼠标点击动作和键盘动作，不记录鼠标移动轨迹；若脚本需要移动鼠标，需参考脚本语法手动添加 mouse move 事件；坐标可使用相对坐标，也可使用 [-1, -1] 表示当前鼠标位置
  • 执行速度限制：由于程序速度受限，当输入的鼠标速度大于一定值时，脚本将无法以预期的输入速度执行；录制或修改脚本时应合理设置 delay，避免动作过快导致目标程序响应不及时
  • 权限问题：部分系统环境中可能出现无法录制完整的鼠标事件的情况，请以管理员身份或 root 身份运行此工具；Linux 和 macOS 用户如以管理员身份运行后仍无法录制或执行，可参考 pynput 的文档 limitations 部分
  • macOS 辅助功能白名单：Mac 用户需要确保程序在辅助功能白名单中；如使用打包的 exec 文件，还需确保终端也在辅助功能白名单；如果 app 程序闪退，请尝试给予 ~/.qt_material 目录下文件的写权限，例如执行 chmod -R 770 ~/.qt_material
  • 脚本格式：脚本为 json5 格式，每个最内层 jsonobject 代表一个事件；修改脚本时需注意括号、逗号、引号和字段名；演示屏幕分辨率为 1920 * 1080，相对坐标 0.05208 对应 100、0.1852 对应 200；坐标含义与屏幕分辨率相关，换到不同分辨率设备上执行时可能需要调整
  • 鼠标按键说明：热键设置中的 Middle 指代鼠标中键，XButton 指代鼠标侧键；如需使用中键或侧键，应在脚本中使用对应的 action_type
  • 重复次数：可设置脚本重复执行的次数，如果为 0 即为无限循环；无限循环时务必记住 F9 终止热键，避免脚本无法停止；运行前应选择正确的脚本，避免误执行
  • 脚本管理：每次录制结束后都会在 scripts 目录下生成一个新的脚本文件，运行前可在列表中选择需要执行的脚本；建议对重要脚本进行备份，避免误删或误改
  • 命令行参数：命令行模式可直接运行指定脚本，例如 ./KeymouseGo scripts/0314_1452.txt；运行指定脚本 3 次可使用 -rt 3 或 --runtimes 3；使用命令行时要注意当前工作目录和脚本路径是否正确
  • 合规与隐私：KeymouseGo 是开源自动化工具，适合用于简单、单调、重复的合法工作；不要将本工具用于违反法律法规、平台规则、游戏规则或侵犯他人隐私的用途；录制键盘输入时可能包含账号、密码、聊天内容等敏感信息，应妥善保管脚本文件

资源出处

  • 资源名称KeymouseGo
  • 资源协议GPL2.0
  • 资源版本5.2.1
  • 资源来源