告别重复操作：KeymouseGo让电脑自动完成你的工作流
项目地址: https://gitcode.com/gh_mirrors/ke/KeymouseGo 你是否每天都在重复这些动作：填写相同的表单、点击固定的按钮、输入重复的文字？据统计，普通办公族每天有30%时间都在做机械性操作。现在，有了KeymouseGo.py这款开源自动化工具，你只需演示一次操作流程，电脑就能精准复现所有步骤，从此告别枯燥重复的工作。
什么是KeymouseGo？
KeymouseGo是一款轻量级的鼠标键盘录制工具，被开发者称为"精简绿色版的按键精灵"。它能记录你的鼠标点击、键盘输入等操作，生成可编辑的脚本文件，并按设定次数自动执行。与传统自动化工具不同，它无需复杂编程知识，普通用户也能在3分钟内快速上手。
项目核心模块采用分层设计：
- 录制模块：Recorder/WindowsRecorder.py负责捕获鼠标键盘事件
- 事件处理：Event/WindowsEvents.py实现操作的精准回放
- 脚本系统：支持JSON5格式的脚本文件，可手动编辑优化操作流程
3步实现自动化：从录制到执行
基本操作流程
- 录制动作：点击主界面"录制"按钮，正常完成需要自动化的操作流程，结束后点击"停止"
- 调整参数：在脚本列表选择刚生成的记录，设置执行次数（0表示无限循环）
- 自动执行：点击"启动"按钮或按F6热键，电脑将精确复现你的操作
提示：默认使用F9热键可随时终止正在执行的脚本，避免误操作时无法停止
命令行高级用法
对于进阶用户，可直接通过命令行运行脚本：
# 直接运行指定脚本
./KeymouseGo scripts/0314_1452.txt
# 设置执行3次
./KeymouseGo scripts/0314_1452.txt -rt 3
脚本文件深度解析
每次录制的操作都会保存在scripts目录下，生成类似0314_1452.txt的脚本文件。这些文件采用JSON5格式，可手动编辑优化，实现更复杂的自动化逻辑。
脚本基本结构
{
scripts: [
// 3秒后在(100,200)位置按下鼠标右键
{type: "event", event_type: "EM", delay: 3000, action_type: "mouse right down", action: ["0.05208%", "0.1852%"]},
// 50毫秒后抬起鼠标右键
{type: "event", event_type: "EM", delay: 50, action_type: "mouse right up", action: [-1, -1]},
// 输入文本"你好 world"
{type: "event", event_type: "EX", delay: 100, action_type: "input", action: "你好 world"}
]
}
坐标系统说明
KeymouseGo采用相对坐标系统，确保脚本在不同分辨率屏幕上都能正常工作：
["0.05208%", "0.1852%"]表示相对于屏幕宽度的0.05208%和高度的0.1852%位置[-1, -1]是特殊标记，表示保持当前鼠标位置不变
这种设计使得录制的脚本可以在不同分辨率的显示器之间移植使用，大大提高了脚本的通用性。
安装与配置指南
直接使用（推荐）
无需安装Python环境，直接从项目发布页下载对应系统的可执行文件，解压后双击KeymouseGo.py即可运行。
源码运行方式
如果你需要自定义功能或参与开发，可以通过源码运行：
# 安装依赖
pip install -r requirements-windows.txt # Windows系统
# 或
pip3 install -r requirements-universal.txt # Linux/MacOS系统
# 直接运行
python KeymouseGo.py
打包可执行文件
开发者可以将修改后的代码打包为独立可执行文件：
# 安装打包工具
pip install pyinstaller
# Windows打包命令
pyinstaller -F -w --add-data "./assets;assets" KeymouseGo.py
实用场景与案例
日常办公自动化
- 表单填写：自动填写各类报表中固定不变的信息
- 文件重命名：按规则批量重命名照片或文档
- 数据录入：从Excel批量导入数据到业务系统
软件测试辅助
开发人员可录制测试用例，快速复现操作步骤，验证软件功能稳定性。特别是在进行回归测试时，能大幅减少重复劳动。
游戏辅助操作
对于需要重复操作的游戏任务，可录制脚本自动执行，解放双手（请遵守游戏规则，勿用于违规用途）。
扩展与定制
KeymouseGo支持通过插件系统扩展功能，插件开发可参考Plugin/Interface.py定义的接口规范。目前项目已实现基础的插件管理框架，可扩展图像识别、OCR文字识别等高级功能。
常见问题解决
权限问题
在部分系统环境中，可能出现无法录制完整事件的情况，解决方案：
- 尝试以管理员/root身份运行程序
- 检查系统安全软件是否阻止了事件捕获
Mac系统特殊配置
Mac用户需要：
- 在"系统偏好设置-安全性与隐私"中允许辅助功能访问
- 给予终端或应用文件完整的磁盘访问权限
- 如遇闪退，执行权限修复命令：
chmod -R 770 ~/.qt_material
多显示器支持
程序默认支持多显示器环境，会自动识别当前活动窗口所在屏幕，确保坐标定位准确。
总结与展望
KeymouseGo通过简洁的设计实现了强大的自动化功能，既满足普通用户的快速操作需求，又为高级用户提供了脚本编辑和插件扩展的可能性。相比商业软件，它体积小巧（不到10MB）、完全开源免费，且没有任何广告和后门。
项目持续维护中，未来计划加入更多高级功能：
- 图像识别触发条件
- 更丰富的脚本控制语句
- 跨平台统一体验优化
如果你觉得这个工具对你有帮助，欢迎给项目点星支持，或通过README.md中提供的方式联系作者交流反馈。
提示：使用自动化工具时，请遵守相关软件的使用条款，尊重知识产权和数据安全。
觉得有用？收藏本文，关注项目更新，获取更多自动化技巧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
