KeymouseGo for UOS 20 (ARM64/Kirin 9000C/X11)

项目概述

KeymouseGo 是一款开源的键盘鼠标录制与回放工具，基于 Python 开发，采用 GPL-2.0 协议。原项目在 GitHub 上拥有 10.3k Star，支持 Windows、macOS 和 GNU/Linux 平台。

本版本为 ARM64 架构的 UOS 20 适配编译版，由 longzheng268 基于 v5.2.1 源码编译发布，解决了国产化终端环境下 KeymouseGo 的兼容性问题。

适配环境

项目	详情
操作系统	UOS 20 (UnionTech OS)
架构	ARM64 (AArch64)
处理器	HUAWEI Kirin 9000C @ 2.188GHz
显示协议	X11
基于版本	KeymouseGo v5.2.1
发布日期	2026-01-24

核心功能

录制模式

点击 录制 按钮，开始录制
在计算机上进行操作（鼠标点击、键盘输入），这些动作会被录制下来
点击 结束 按钮，停止录制
点击 启动 按钮，即可重复执行步骤 2 中录制的操作

录制结束后，脚本文件自动保存至 scripts 目录。

回放模式

直接指定脚本运行：

./KeymouseGo scripts/0314_1452.txt

指定重复次数（如 3 次）：

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

快捷键

快捷键	功能
`F6`	启动脚本（等同 `启动` 按钮）
`F9`	终止运行中的脚本

脚本语法

脚本采用 JSON5 格式，每个事件为一个 JSON 对象。屏幕分辨率基于 1920 x 1080：

{
  "scripts": [
    // 延迟 3000ms，在屏幕坐标 (0.05208, 0.1852) 即 (100,200) 处 按下鼠标右键
    {
      "type": "event",
      "event_type": "EM",
      "delay": 3000,
      "action_type": "mouse right down",
      "action": ["0.05208%", "0.1852%"]
    },
    // 等待 50ms，在同位置 抬起鼠标右键
    // 当坐标为 [-1, -1] 时，表示在鼠标当前位置执行操作
    {
      "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) 即 (500, 500) 处 按下鼠标左键
    {
      "type": "event",
      "event_type": "EM",
      "delay": 100,
      "action_type": "mouse left down",
      "action": ["0.2604%", "0.4630%"]
    },
    // 等待 100ms，将鼠标移动到坐标 (0.2604, 0.5556) 即 (500, 600) 位置
    {
      "type": "event",
      "event_type": "EM",
      "delay": 100,
      "action_type": "mouse move",
      "action": ["0.2604%", "0.5556%"]
    },
    // 等待 100ms，在屏幕坐标 (0.3125, 0.5556) 即 (600, 600) 处 抬起鼠标左键
    {
      "type": "event",
      "event_type": "EM",
      "delay": 100,
      "action_type": "mouse left up",
      "action": ["0.3125%", "0.5556%"]
    },
    // 等待 100ms，在当前位置输入 "hello world" 文字
    {
      "type": "event",
      "event_type": "EX",
      "delay": 100,
      "action_type": "input",
      "action": "hello world"
    }
  ]
}

事件类型说明：

event_type	含义	action 字段
`EM`	鼠标事件 (Mouse)	`[x, y]` 坐标，支持百分比或像素值
`EK`	键盘事件 (Keyboard)	`[键码, 键名, 修饰符]`
`EX`	文本输入事件 (eXtend)	输入的字符串内容