JokyMouse 开发者文档

小丑鼠 Latest

键名列表

jm.key_press(key)、jm.key_release(key) 和 jm.key_click(key) 共享同一套键名解析规则。推荐统一使用小写字符串。

local jm = require("jokymouse")

jm.key_click("enter")
jm.key_press("cmd")
jm.key_release("cmd")
jm.key_click("a")
jm.key_click("/")

通用规则

所有键名都大小写不敏感，例如 Enter、ENTER、enter 等价。
单字符键可以直接写字符本身，例如 "a"、"1"、"/"、"="。
修饰键和方向键建议始终使用语义化名字，而不是依赖字符。

常用键名

类别	支持的键名
控制键	`ctrl` / `lctrl` / `rctrl`
Shift	`shift` / `lshift` / `rshift`
Alt	`alt`
Meta	`cmd`
常用编辑键	`enter` / `tab` / `backspace` / `space` / `delete` / `esc` / `capslock`
方向键	`up` / `down` / `left` / `right`
导航键	`home` / `end` / `pageup` / `pagedown`
功能键	`f1` 到 `f20`
数字小键盘	`numpad0` 到 `numpad9` / `kpenter` / `decimal`
小键盘运算	`add` / `sub` / `mul` / `div`
音量与媒体	`volumeup` / `volumedown` / `volumemute` / `medianext` / `mediaprev` / `mediaplaypause`

平台差异

macOS

推荐继续写 alt 与 cmd，运行时会兼容 option、command 等别名。
额外支持：
- fn / function
- eject
功能键只公开到 f20。
单字符符号键会优先按 ANSI 键位映射处理，所以像 "!"、"@"、"["、"/" 这类字符可以直接传。

Windows

推荐继续写 cmd，运行时会兼容 win、windows 等别名。
额外支持：
- insert
- printscreen / print_screen / prtsc / prtscr
- pause / break
- numlock / num_lock
- scrolllock / scroll_lock
额外支持 f21 到 f24。

Linux

推荐继续写 cmd，运行时会兼容 super 等别名。
额外支持：
- insert
- printscreen / print_screen / prtsc / prtscr
- pause / break
- numlock / num_lock
- scrolllock / scroll_lock
额外支持 f21 到 f24。

推荐写法

local jm = require("jokymouse")

jm.key_press("cmd")
jm.key_click("a")
jm.key_release("cmd")

jm.key_click("enter")
jm.key_click("tab")
jm.key_click("esc")