KeymouseGo

中文

KeymouseGo 是开源鼠标键盘录制工具，可保存点击与按键操作，并按指定次数重放，适合处理重复桌面任务。本文整理 KeymouseGo 下载与免安装步骤、5.2.1 更新日志、脚本与插件兼容区别，以及录制失败和点击位置偏移的排查方法，帮助你先确认终止热键、选择 Windows 发行文件，再在相同窗口布局中检查脚本。

KeymouseGo 下载前了解录制、重放与脚本

KeymouseGo 是陶佳元（taojy123）发起的开源工具，项目说明其用途是记录鼠标键盘操作，并在触发后自动重放。它适合输入内容、点击位置和窗口顺序相对固定的重复工作。录制一次并不意味着脚本能理解页面；窗口移动、显示缩放、弹窗或任务执行时间变化，都可能让后续点击落到不同位置。建议先在空白文档或可撤销的操作中录制短片段，并把执行次数设为 1，确认终止热键后再扩展流程。

官方示例明确写着 v5.1。5.2 的说明已移除原有“执行速度”控件，因此不要按旧图寻找该选项，也不要把图中的示例次数当作默认值。

KeymouseGo 安装步骤：Windows 发行文件直接运行

1. 打开 KeymouseGo 5.2.1 官方发行页，确认仓库为 taojy123/KeymouseGo。
2. 在发行附件中选择 Windows 的 KeymouseGo_v5_2_1-win.exe；Linux、Linux ARM64 和 macOS 文件属于其他平台，GitHub 自动生成的 Source code 归档是源码。
3. 将程序保存到有写入权限的独立文件夹，再按项目说明启动。项目已打包 Python 依赖，普通用户无需另装 Python；发行说明提示该构建使用 Python 3.10，不能据此宣称支持 Windows 7 或现成 32 位系统包。
4. 在界面确认热键，点击录制，完成一段简单操作后结束录制。选中生成的脚本，设置执行次数为 1，再启动检查；运行前保持窗口位置和缩放一致。

项目说明每次录制会在 scripts 目录生成新脚本。若程序或安全软件提示异常，应核对来源和检测详情；本页没有下载、扫描或执行发行程序，不能将告警直接判定为误报。

KeymouseGo 5.2.1 更新日志：热键字符串与录制修复

官方将 5.2.1 标为当前 Latest，发布日期为 2025 年 4 月 19 日。该补丁修复了一个具体问题：当按键字符是热键字符串的一部分时，该按键可能无法被录制。它不是对所有快捷键冲突或录制失败的通用修复。后续源代码提交的时间也不等于新的安装版发布日期。

从旧版升级还应查看 5.2 的变化：界面升级到 PySide6，支持高 DPI；脚本改用 JSON5 并说明兼容旧脚本，插件系统则不兼容旧插件；原“执行速度”选项被移除，可按项目 Wiki 使用插件实现相应工作流。请分别检查脚本、插件和界面，不要把“旧脚本兼容”扩大为所有旧扩展都能使用。

KeymouseGo 常见问题 FAQ：停止运行、偏移与兼容

不小心一直循环怎么办？ README 说明次数为 0 表示无限循环，并给出默认终止热键 F9。实际运行前应以当前界面配置为准，先熟悉终止方式，再使用有限次数；不要在尚未检查的脚本上设置 0。

脚本点击位置偏了怎么办？ 先恢复录制时的窗口位置、显示缩放和目标界面，再检查脚本坐标及等待时间。动态弹窗或页面加载状态变化时，需要重新录制或调整脚本；坐标重放不能自动确认目标按钮是否还在原位。

Windows 7 或 32 位系统能直接用当前文件吗？ 5.2.1 发布说明指出构建使用 Python 3.10，并把旧系统与 32 位版本列为需要自行调整构建的情况；不要把源码可修改当作现成附件兼容性。

旧插件为什么不能用了？ 5.2 引入新的插件系统，官方明确不兼容旧插件；它与兼容旧脚本是两件事，应依据 Wiki 更新插件。

选择 KeymouseGo 下载文件后，先完成一次可撤销的录制与重放检查，再增加执行次数。保留原始脚本和已知可用配置，有助于区分安装问题、坐标偏移和升级兼容问题。

English

KeymouseGo download and setup guide: record and replay desktop input, review v5.2.1 fixes, check Windows package limits, and troubleshoot misplaced clicks.

Before downloading KeymouseGo: recordings and replay scripts

KeymouseGo is an open-source project started by Tao Jiayuan (taojy123) for recording mouse and keyboard actions and replaying them on demand. It suits repetitive desktop work with a stable sequence, text input, and window layout. A recording does not understand the page: moving a window, changing display scaling, opening a dialog, or changing task timing can move the target of later clicks. Start with a short sequence in a blank document or another reversible workflow, set the repeat count to 1, and confirm the stop shortcut before extending it.

The example is visibly labeled v5.1. The 5.2 notes removed the old execution-speed control, so do not use this picture to locate that control in a current build or treat the illustrated repeat count as a default.

How to install and start the KeymouseGo Windows release

1. Open the official KeymouseGo 5.2.1 release page and confirm the repository is taojy123/KeymouseGo.
2. Select the Windows asset KeymouseGo_v5_2_1-win.exe. The Linux, Linux ARM64, and macOS files target other platforms; GitHub Source code archives contain source rather than a packaged application.
3. Save the application in a separate writable folder and start it as described by the project. The packaged release does not require a separate Python installation. Its notes say the build uses Python 3.10; that does not establish Windows 7 compatibility or a ready-made 32-bit package.
4. Check the hotkeys in the current interface, start recording, perform a short task, and end recording. Select the generated script, set the repeat count to 1, and start a replay with the same window position and display scaling.

The project says recordings create scripts in the scripts folder. If the program or security software raises a warning, check the source and detection details. No release executable was downloaded, scanned, or run for this guide, so a warning cannot be classified here as a false positive.

KeymouseGo 5.2.1 release notes: a hotkey recording fix

The project marks 5.2.1 as Latest, released April 19, 2025. It fixes a specific problem: a key could fail to be recorded when its character was part of the hotkey string. This is not a universal fix for every shortcut conflict or recording failure. A later source commit date is also not a new packaged-release date.

When upgrading from an older release, also review 5.2: it moved to PySide6, enabled high-DPI scaling, changed scripts to JSON5 while retaining old-script compatibility, and introduced a plugin system incompatible with old plugins. The old execution-speed control was removed; the Wiki describes a plugin approach for related workflows. Check scripts, plugins, and controls separately instead of assuming every old extension remains compatible.

KeymouseGo FAQ: stopping, misplaced clicks, and compatibility

What if a script keeps repeating? The README says a repeat count of 0 means an infinite loop and lists F9 as the default stop shortcut. Confirm the actual current setting before running a script and begin with a finite repeat count.

Why are replayed clicks in the wrong place? Restore the recorded window position, display scaling, and target view, then review coordinates and delays. Dynamic dialogs and loading states may require a new recording or script edits. Coordinate replay does not verify that a button is still at its previous location.

Can the current Windows asset run directly on Windows 7 or a 32-bit system? The 5.2.1 notes identify Python 3.10 and describe older systems and 32-bit builds as cases requiring adjusted builds. Editable source does not establish compatibility of the supplied executable.

Why does an old plugin fail? Version 5.2 introduced a new plugin system explicitly incompatible with old plugins. This differs from old-script compatibility; follow the current Wiki for plugin changes.

After choosing a KeymouseGo download, check one reversible recording and replay before raising the repeat count. Keep the original script and a working configuration to distinguish setup problems, coordinate drift, and upgrade compatibility issues.