KeymouseGo 免费鼠标键盘录制工具：如何快速安装并上手自动化回放

KeymouseGo 免费鼠标键盘录制工具：如何快速安装并上手自动化回放

【免费下载链接】KeymouseGo类似按键精灵的鼠标键盘录制和自动化操作 模拟点击和键入 | automate mouse clicks and keyboard input项目地址: https://gitcode.com/gh_mirrors/ke/KeymouseGo

KeymouseGo 是一款免费开源的鼠标键盘录制工具，它能记录你的鼠标点击和键盘输入，再按你设定的次数自动回放。适合经常做重复性电脑操作、希望省去手动重复劳动的办公、测试和日常用户。

它解决什么问题：KeymouseGo 项目定位

KeymouseGo 做的事情很直接：你亲自把一套鼠标键盘操作做一遍，它把过程存成脚本，之后按次数替你重复执行。官方将其定位为"精简绿色版"的按键精灵，专注于单调、重复的简单操作场景。

核心优势：

• 免费开源，代码可查，无功能限制
• 跨平台，支持 Windows、Linux、macOS
• 只需点击"录制—启动"，不需要编程基础
• 脚本以文本形式保存，可随时查看和手动修改

安装步骤：两种系统的最小依赖安装

前置条件：Python 3（依赖清单基于 Python 3.10 编写）。如果你不打算装 Python，也可以直接从 release 版本下载打包好的可执行文件，双击运行即可，见 README.md 的安装说明。

源码方式运行只需两条命令：

git clone https://gitcode.com/gh_mirrors/ke/KeymouseGo pip install -r requirements-windows.txt # Windows pip3 install -r requirements-universal.txt # Linux / macOS

首次运行：从录制到回放的 4 步操作

1. 运行KeymouseGo.py（或直接双击打包好的可执行文件），界面默认选中简体中文主题。
2. 点击"开始录制"（或按默认热键 F10），然后正常操作鼠标和键盘，这一遍动作会被记录下来。
3. 点击"结束"（或再按 F10），脚本自动保存到scripts目录，并出现在界面左侧的脚本列表中。
4. 在"执行次数"中填想要重复的轮数，点击"启动"（或按 F6），电脑开始回放；过程中随时可按 F9 终止。

如果你习惯命令行，也可以不打开界面直接跑脚本，回放 3 次即：

./KeymouseGo scripts/0314_1452.txt --runtimes 3

🖱️ 功能要点一览

功能	说明	适用场景
录制与回放	记录鼠标点击与键盘动作（默认不含鼠标移动轨迹），按设定次数重复执行	重复录入、批量点击
执行次数	可设具体轮数，填 0 表示无限循环	长时间批量任务
自定义热键	默认 F10 开始/暂停录制、F6 启动、F9 终止；可改为任意功能键，还支持鼠标中键、侧键	免手离开键盘的快速操控
脚本管理	每次录制在scripts目录生成独立文件，界面列表中可选、重命名、编辑	管理多个自动化任务
手动编辑脚本	脚本为 json5 格式，支持注释，可改延迟、坐标、按键	微调回放细节
命令行模式	指定脚本路径与--runtimes次数直接运行，F9 可中止	集成到定时或批处理任务
插件扩展	v5.2 引入插件系统，向plugins目录放入插件即可注册自定义功能	进阶定制

两点值得留意。其一，脚本中的坐标以屏幕百分比（相对坐标）保存，例如0.2604%表示屏幕宽度的 26.04%，所以在不同分辨率的机器上回放，落点依然对应同一相对位置，脚本具备跨设备迁移能力。其二，脚本事件模型定义在 Event/ 目录中，包含鼠标按下/抬起、按键、文本输入等事件类型，配合 Plugin/ 的插件接口，可以扩展出自定义动作，供想深入的用户参考。

使用案例：三个真实场景

场景一：重复填写表单——每天要把相同内容填入一个在线表单 50 次。

1. 录制一次完整填写过程并保存为脚本。
2. 执行次数填 50，点击启动。
3. 期间可以去做别的事，按 F9 可随时叫停。

场景二：软件测试回归验证——同一条测试路径需要反复点一遍。

1. 把标准操作路径录制为脚本。
2. 修改脚本中个别按键与延迟，得到不同测试分支。
3. 用--runtimes批量回放，观察结果是否一致。

场景三：批量处理文件——对 20 个文件做相同的"打开、改参数、保存"操作。

1. 对第一个文件录制完整流程。
2. 执行次数设为 20（或 0 循环，手动停止）。
3. 启动后按文件名顺序逐个处理。

⚠️ 避坑指南：常见问题一次看懂

遇到的问题	处理建议
部分系统录不全鼠标事件	以管理员身份（Linux 用 root）运行即可
macOS 无法模拟按键	在系统"辅助功能"白名单中允许本程序（用打包版还需同时放行终端）；若 app 闪退，为~/.qt_material目录添加写权限
Linux/macOS 加权限后仍异常	检查所在桌面环境对输入钩子的限制，X11 与 Wayland 行为不同，Wayland 下打包时需额外指定 uinput 隐藏导入
回放速度跟不上录制时手速	程序有速度上限，操作过快会失真，建议录制时放慢节奏
高分屏上落点偏移	检查系统缩放与布局设置是否异常，可参考下图位置将其调整为 100% 后再试
多显示器下坐标异常	多屏支持目前仅限 Windows
默认热键与其他软件冲突	在热键区自行改键，鼠标中键、侧键（XButton）也可用作热键

小结与延伸阅读

KeymouseGo 把"做一遍、存成脚本、按次数回放"这条最实用的自动化路径做到了开箱即用，新手五分钟可上手，进阶用户再碰脚本与插件。

• 使用说明与脚本语法：README.md
• 各版本功能变化：Changelog.md
• 插件系统接口与实现：Plugin/

【免费下载链接】KeymouseGo类似按键精灵的鼠标键盘录制和自动化操作 模拟点击和键入 | automate mouse clicks and keyboard input项目地址: https://gitcode.com/gh_mirrors/ke/KeymouseGo