企业官网建设流程全解析

还在手动重复点鼠标？KeymouseGo 跨平台录制回放工具完整上手指南

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

每天要重复几百次"点这个按钮、填那栏数据、按一次回车"，重复到后半程手都是木的。KeymouseGo是一个类似按键精灵的跨平台鼠标键盘录制回放工具：把操作录一遍，它就能按你设定的次数自动复刻，Windows、Linux、macOS 三大系统通用，无需安装任何运行环境，下载即用。先带你在终端跑通第一个脚本，再拆解坐标换算与插件机制，文末附一份排障清单。

不用写代码也能自动化：它和脚本党、按键精灵的区别

你见过的大部分自动化方案分两类：一类是"脚本党"，要手写坐标和延时，还没开始就劝退；另一类只支持 Windows，换台 Mac 直接作废。KeymouseGo 的差别在于，它记录的是"操作流"而不是代码——底层用哪个 API，你完全不用知道，在屏幕前把动作做一遍就行。

一句话概括：不写代码、不装驱动、录完即用，相当于"精简绿色版"的按键精灵。对"今天就想把活干完"的人来说，这个差别决定了你会不会真的打开它。

上图是主界面：左侧为脚本选择、执行次数与坐标精度，右侧是热键映射，中间为"开始录制 / 启动"按钮

⚡️ 三步快速上手：从安装到第一次自动回放

第1步：把程序跑起来

不熟悉 Python 的用户直接下载打包好的可执行文件，双击KeymouseGo就能打开。走源码路线的话，按系统装依赖再运行主入口：

pip3 install -r requirements-universal.txt # Linux / macOS python3 KeymouseGo.py

Windows 用户把依赖文件换成requirements-windows.txt。验收标准：主界面弹出、底部状态栏显示Ready...，说明环境就绪。

第2步：录一段操作，看它回放

1. 点录制按钮开始
2. 在电脑上正常操作：点按钮、打字（只记录点击和按键，不记录鼠标移动轨迹）
3. 点结束完成录制
4. 点启动，看电脑自动复刻一遍

验收标准：鼠标自动重放刚才的动作，且scripts/目录下多了一个带时间戳的json5脚本文件。

第3步：用命令行跑批量任务

不想开界面时，直接传脚本路径：

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

-rt（或--runtimes）指定执行次数，0表示无限循环。验收标准：程序无界面运行、鼠标开始动作，按F9随时中止，按F6等效于点"启动"。

原理拆解：操作是怎么被"录成乐谱"再回放的

把整段操作想象成一段演奏：它不关心你点了什么软件、开了什么窗口，只把每个动作翻译成"延迟多久、什么类型、什么参数"，像乐谱一样按顺序记下来。每个事件只有四要素：

class Event(metaclass=ABCMeta): def __init__(self, content: Dict[str, Any]): # 每个事件只记录四要素：delay 间隔 / event_type 类型 / action_type 动作 / action 参数 for key in ['delay', 'event_type', 'action_type', 'action']: setattr(self, key, content[key])

这段代码在做什么：录制时"翻译"出这样一串事件，回放时按顺序逐个执行，两边彻底解耦——所以你可以直接改文件里的数字来调坐标和延迟。

坐标换算是跨屏适配的关键。录制时像素会被换算成相对坐标（逻辑在 Recorder/）：

tx = x / SW # 横坐标像素 ÷ 屏幕宽度 → 百分比 ty = y / SH # 纵坐标像素 ÷ 屏幕高度

回放时再乘回当前屏幕宽高，分辨率变了点击位置也不变。Windows 端还调用SetProcessDPIAware()声明 DPI 感知，用mouse_event的归一化坐标规避显示缩放偏移。平台实现走策略模式，互不干扰：

上图的"缩放与布局"比例直接决定逻辑坐标与物理坐标的换算关系，跨机器跑脚本前先核对两台是否一致

实战配方：三个直接能抄的使用场景

场景一：表单数据循环录入

1. 打开网页表单，先手动完整走一遍"填写 → 保存"流程
2. 点"录制"，把同一套流程再做一遍
3. 把"执行次数"设为0（无限循环），点"启动"
4. 走开干别的活，F9一键叫停

预期结果：表单一条接一条自动提交，不用盯着屏幕。

场景二：换台机器继续跑

1. 在第一台机器上录好"登录 → 执行 → 退出"全流程
2. 把scripts/里生成的脚本复制到第二台机器（建议两台分辨率、缩放比例一致）
3. 第二台机器直接./KeymouseGo 脚本路径 -rt 5

预期结果：脚本照跑不误；新机器节奏不同，改文件里的delay数字即可。

场景三：放慢动作节奏（进阶）

1. 录一套游戏里的"打怪 → 拾取 → 回城"动作
2. 打开脚本文件，找到目标事件那一行
3. 把delay从50改大到800，整体节奏放慢
4. 用-rt 0启动，F6开始执行

预期结果：循环节奏变慢，客户端跟得上、不超时。

🔧 进阶定制：改热键、调脚本、挂插件

• 热键映射：主界面右侧可改启动/暂停/终止键；Middle指鼠标中键、XButton指侧键，改之前先确认没和系统快捷键撞车。
• 脚本文件：scripts/下每个对象就是一个事件，改坐标、改延迟都很直观，语法细节见 README.md 的"脚本语法说明"一节。
• 插件机制：核心是微内核，只负责录制回放，其余能力全靠插件挂。在plugins/下放一个带manifest.json5清单的文件夹，启动时会被自动扫描加载；写插件只需继承 Plugin/Interface.py 里的接口，在register_functions里登记函数，脚本里就能直接调用。想加 OCR 识别、网络请求、条件判断，都从这个入口进。

排障手册：七个高频问题的快速解法

1. 录制不完整，鼠标事件丢失：权限不足。用管理员身份（Windows）或 root 身份（sudo）运行即可。
2. 换台机器回放，点错了位置：两台机器显示缩放比例不一致。打开"设置 > 显示 > 缩放与布局"，把两边比例调成一样再跑脚本。
3. macOS 打开就闪退：程序不在辅助功能白名单。到"系统设置 > 隐私与安全性 > 辅助功能"把程序（打包版还要加上终端）加进去；仍闪退就执行chmod -R 770 ~/.qt_material。
4. Linux X11 录不了：缺对应驱动导入。X11 环境打包时加--hidden-import pynput.keyboard._xorg --hidden-import pynput.mouse._xorg，Wayland 换成_uinput后缀。
5. 回放时鼠标飞太快、跟不上：录制时手速过快，而程序回放速度有上限。放慢录制节奏，或把"执行速度"调到 100% 以下。
6. 脚本跑一半想停：按F9立即中止，不用重启程序。
7. 热键没反应：先确认Middle/XButton的实际含义，再在热键设置里换一个没被系统占用的键。

现在就动手：录下你的第一个脚本

从"手动重复"到"录一遍、跑 N 遍"，KeymouseGo 把全部成本压缩到"自己做一遍"。现在打开软件 → 点"录制" → 录一段 30 秒的重复操作 → 点"启动"，这个循环的爽感跑一遍就懂。它是开源项目，bug 修复和功能建议都欢迎提交到 dev 分支。

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