KeymouseGo完全指南：从零基础到自动化操作大师
项目地址: https://gitcode.com/gh_mirrors/ke/KeymouseGo 1. 为什么选择KeymouseGo？自动化操作的革命
你是否还在重复这些枯燥工作？
- 电商客服重复回复相同问题
- 游戏玩家机械执行日常任务
- 数据录入员反复填写表单
- 软件测试工程师重复操作流程
KeymouseGo（按键精灵的开源替代方案）通过录制和回放鼠标键盘操作，让电脑自动完成这些重复性工作。本文将带你从安装到高级脚本编写，彻底释放双手，成为自动化操作大师。
读完本文你将掌握：
- 3分钟快速上手的安装与基础操作
- 5种实用场景的自动化脚本编写
- 脚本高级语法与自定义扩展技巧
- 跨平台兼容性配置与常见问题解决
2. 快速入门：安装与基础操作
2.1 环境准备与安装
| 系统类型 | 安装方法 | 依赖要求 |
|---|---|---|
| Windows | 直接下载发布版 | 无需Python环境 |
| Linux | 源码安装 | Python ≥ 3.7 + pynput |
| macOS | 源码安装 | Python ≥ 3.7 + 辅助功能权限 |
源码安装步骤：
# 克隆仓库
git clone https://gitcode.com/gh_mirrors/ke/KeymouseGo
cd KeymouseGo
# 安装依赖
# Windows
pip install -r requirements-windows.txt
# Linux/macOS
pip3 install -r requirements-universal.txt
# 运行程序
python KeymouseGo.py
打包可执行文件（开发人员）：
# 安装打包工具
pip install pyinstaller
# Windows打包
pyinstaller -F -w --add-data "./assets;assets" KeymouseGo.py
# Linux X11打包
pyinstaller -F -w --add-data "./assets:assets" --hidden-import "pynput.keyboard._xorg" --hidden-import "pynput.mouse._xorg" KeymouseGo.py
2.2 界面介绍与基础操作
KeymouseGo现代化操作界面展示
KeymouseGo采用深色主题设计，界面分为三大功能区：
- 配置区域：设置脚本文件、执行次数、鼠标精度、执行速度和主题
- 热键区域：配置暂停执行、开始/暂停录制、终止录制/执行等快捷键
- 操作区域：包含开始录制、启动、暂停录制等核心功能按钮
3. 核心功能：录制与执行自动化操作
3.1 桌面模式操作流程
- 开始录制：点击"开始录制"按钮，软件开始记录你的操作
- 执行操作：在计算机上进行任意鼠标点击、键盘输入等操作
- 结束录制：点击"结束"按钮，录制完成并生成脚本文件
- 执行脚本：点击"启动"按钮，计算机自动重复执行录制的操作
3.2 命令行模式操作
直接运行指定脚本：
./KeymouseGo scripts/0314_1452.txt
运行指定脚本3次：
./KeymouseGo scripts/0314_1452.txt -rt 3
./KeymouseGo scripts/0314_1452.txt --runtimes 3
4. 脚本语法详解：掌握自动化核心
4.1 脚本格式基础
KeymouseGo脚本采用JSON5格式，每个事件对象代表一个具体的操作：
{
scripts: [
// 开始运行3000ms后，在屏幕相对坐标(0.05208, 0.1852)处按下鼠标右键
{type: "event", event_type: "EM", delay: 3000, action_type: "mouse right down", action: ["0.05208%", "0.1852%"]},
// 等待50ms后在相同位置抬起鼠标右键
{type: "event", event_type: "EM", delay: 50, action_type: "mouse right up", action: [-1, -1]},
// 等待1000ms后按下F键
{type: "event", event_type: "EK", delay: 1000, action_type: "key down", action: [70, 'F', 0]},
// 等待50ms后抬起F键
{type: "event", event_type: "EK", delay: 50, action_type: "key up", action: [70, 'F', 0]},
// 等待100ms后，在屏幕相对坐标(0.2604, 0.4630)处按下鼠标左键
{type: "event", event_type: "EM", delay: 100, action_type: "mouse left down", action: ["0.2604%", "0.4630%"]},
// 等待100ms后，鼠标移动至相对坐标(0.2604, 0.5556)位置
{type: "event", event_type: "EM", delay: 100, action_type: "mouse move", action: ["0.2604%", "0.5556%"]},
// 等待100ms后，在屏幕相对坐标(0.3125, 0.5556)处抬起鼠标左键
{type: "event", event_type: "EM", delay: 100, action_type: "mouse left up", action: ["0.3125%", "0.5556%"]},
// 等待100ms后，在当前位置输入"你好 world"文字
{type: "event", event_type: "EX", delay: 100, action_type: "input", action: "你好 world"}
]
}
4.2 关键参数说明
- delay：延迟时间（毫秒），控制每个操作之间的间隔
- action_type：操作类型，包括鼠标按下/抬起、移动、键盘按下/抬起、输入文本等
- action：具体操作参数，使用相对坐标或绝对坐标
5. 实用技巧与注意事项
5.1 配置优化建议
- 执行次数设置：设置为0即为无限循环，适合长期监控任务
- 热键配置：默认启动热键为F6，终止热键为F9
- 鼠标精度调整：根据具体应用场景调整鼠标精度参数
5.2 跨平台兼容性
Windows系统：
- 直接运行可执行文件，无需特殊配置
Linux系统：
- 可能需要以管理员身份运行
- 确保系统支持X11或Wayland显示协议
macOS系统：
- 需要在系统偏好设置中授予辅助功能权限
- 如果使用打包的可执行文件，还需确保终端也在辅助功能白名单中
5.3 常见问题解决
无法录制完整事件：
- 以管理员身份或root身份运行程序
- 检查系统权限设置
Mac应用闪退：
- 给予~/.qt_material目录写权限：
chmod -R 770 ~/.qt_material
执行速度受限：
- 调整鼠标速度参数，避免设置过高值
6. 高级功能与扩展应用
KeymouseGo提供了丰富的插件系统和扩展功能，支持自定义脚本编辑和高级自动化场景：
- 条件触发机制：根据特定条件执行不同的操作序列
- 循环控制逻辑：实现复杂的循环和分支结构
- 多脚本协作：多个脚本文件可以协同工作
7. 实战应用场景
7.1 办公自动化
- 批量处理邮件
- 自动填写表格
- 数据整理与导出
7.2 游戏辅助
- 自动执行日常任务
- 重复性操作自动化
- 定时触发特定动作
7.3 软件测试
- 自动化功能测试
- 回归测试脚本
- 性能测试自动化
通过掌握KeymouseGo的核心功能和脚本语法，你可以轻松实现各种重复性工作的自动化，大幅提升工作效率。无论是简单的鼠标点击操作，还是复杂的键盘输入序列，KeymouseGo都能为你提供稳定可靠的自动化解决方案。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
