使用教程

KeymouseGo v5.2.1 完整使用指南

📌 目录

1. 安装与启动
2. 录制操作
3. 回放脚本
4. 编辑脚本
5. 高级设置
6. 快捷键说明
7. 常见问题

1. 安装与启动

Windows 用户

下载 Windows 便携版 ZIP 压缩包后，解压到任意目录，双击 KeymouseGo.exe 即可启动。

2. 录制操作

录制是 KeymouseGo 的核心功能，操作步骤如下：

1. 启动 KeymouseGo 程序
2. 点击界面上的 「录制」 按钮（或按下快捷键 F6）
3. 程序开始记录你的所有鼠标移动、点击和键盘输入
4. 完成操作后，再次按下 F6 停止录制
5. 录制的操作会自动保存为脚本文件

3. 回放脚本

录制完成后，可以回放脚本自动执行操作：

1. 在脚本列表中选择要回放的脚本
2. 设置回放参数：
   • 循环次数：设置脚本重复执行的次数，0 表示无限循环
   • 间隔时间：每条指令之间的等待时间（毫秒）
3. 点击 「回放」 按钮（或按下快捷键 F5）开始执行
4. 如需中途停止，按下 F8 即可中断回放

4. 编辑脚本

KeymouseGo 支持直接编辑脚本文件，脚本格式为 JSON：

[
  {"type": "mouse_move", "x": 500, "y": 300, "delay": 0.5},
  {"type": "mouse_click", "x": 500, "y": 300, "button": "left", "delay": 0.2},
  {"type": "key_press", "key": "enter", "delay": 1.0},
  {"type": "key_type", "text": "Hello World", "delay": 0.5}
]

支持的脚本指令类型：

• mouse_move - 移动鼠标到指定坐标
• mouse_click - 鼠标点击（左键/右键/中键）
• mouse_scroll - 鼠标滚轮滚动
• key_press - 按下并释放按键
• key_down - 按下按键（不释放）
• key_up - 释放按键
• key_type - 输入文本字符串
• delay - 延时等待

5. 高级设置

回放速度调节

通过调整「倍率」参数可以加快或减慢回放速度。倍率大于 1.0 时加速，小于 1.0 时减速。

鼠标坐标模式

支持两种坐标模式：

• 绝对坐标：使用屏幕像素坐标（默认）
• 相对坐标：相对于当前鼠标位置的偏移量

脚本扩展

KeymouseGo 支持 Python 脚本扩展，可以编写更复杂的自动化逻辑：

import keymousego as kmg

# 创建自定义脚本
script = kmg.Script()
script.add_mouse_click(800, 600)
script.add_delay(1.0)
script.add_key_type("Hello from Python!")
script.save("custom_script.json")

6. 快捷键说明

快捷键	功能
F5	开始回放
F6	开始/停止录制
F8	停止回放
Esc	退出程序

7. 常见问题

Q: 回放时鼠标位置不准确？

A: 请确保录制和回放时的屏幕分辨率一致。如果更换了显示器或调整了分辨率，需要重新录制脚本。

Q: 如何设置开机自动运行脚本？

A: 可以将 KeymouseGo 快捷方式添加到 Windows 系统启动目录：

• C:\Users\你的用户名\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

Q: 软件运行报错怎么办？

A: 请按以下步骤排查：

1. 确认已安装 Python 3.7+ 并正确配置环境变量
2. 尝试重新安装依赖库：pip install --upgrade pyautogui pynput
3. 以管理员身份运行程序（Windows 下部分操作需要权限）
4. 如果问题仍未解决，请前往 GitHub Issues 页面提交反馈