Wingman

Appearance

API: wingman.input ​

输入模拟模块，提供鼠标和键盘输入的模拟功能。

提示：查看 数据类型参考 了解 API 中使用的各种对象和数据结构。

模块概述 ​

input 模块用于模拟用户的鼠标和键盘操作，主要功能包括：

  • 鼠标操作：点击、移动、滚轮滚动
  • 键盘操作：按键输入、文本输入
  • 延迟控制：固定延迟、随机延迟

坐标系统 ​

使用屏幕坐标系统，左上角为原点 (0, 0)：

  • click(x, y, button) - 点击指定坐标
  • 坐标单位为像素

鼠标点击 ​

click(x, y, button) ​

说明：在指定位置执行鼠标点击。

函数签名：

python
click(x: int, y: int, button: int) -> None
lua
click(x: number, y: number, button: number) -> nil

参数：

  • x, y - 点击位置坐标
  • button - 鼠标按键（整数）：
    • 0 - 左键
    • 1 - 中键
    • 2 - 右键
python
from wingman import input

# 左键点击
input.click(100, 100, 0)

# 中键点击
input.click(100, 100, 1)

# 右键点击
input.click(100, 100, 2)

鼠标移动 ​

move(x, y, duration) ​

说明：移动鼠标到指定位置。

函数签名：

python
move(x: int, y: int, duration: int) -> None
lua
move(x: number, y: number, duration: number) -> nil

参数：

  • x, y - 目标位置坐标
  • duration - 移动完成后等待的毫秒数（移动本身是瞬时跳转，不是平滑轨迹）

使用场景：

  • duration 较小：移动后立即继续
  • duration 较大：给应用留出响应时间

需要平滑/拟人轨迹时请使用 human.moveMouse()（贝塞尔平滑移动）。

python
from wingman import input

# 移动到 (500, 300) 后等待 0ms
input.move(500, 300, 0)

# 移动到 (500, 300) 后等待 300ms
input.move(500, 300, 300)

滚轮滚动 ​

scroll(x, y, delta) ​

说明：在指定位置执行滚轮滚动。

函数签名：

python
scroll(x: int, y: int, delta: int) -> None
lua
scroll(x: number, y: number, delta: number) -> nil

参数：

  • x, y - 滚动位置坐标
  • delta - 滚动量（正数向上，负数向下；三平台一致）

滚动量参考（仅 Windows）：

  • 120 - 通常为一行（WHEEL_DELTA）
  • 360 - 通常为一页
  • -120 / -360 - 向下滚动

Linux/macOS 的 delta 单位不同（Linux 上按 abs(delta) 次滚轮格计、macOS 按行数直接传递），上述 120/360 参考值不适用。

python
from wingman import input

# 向上滚动一行
input.scroll(500, 300, 120)

# 向下滚动一页
input.scroll(500, 300, -360)

键盘按键 ​

key(vkCode) ​

说明：模拟一次完整的按键（按下并抬起）。

函数签名：

python
key(vkCode: int) -> None
lua
key(vkCode: number) -> nil

参数：

  • vkCode - 虚拟键码（Windows 虚拟键码，整数）
python
from wingman import input

# 按下回车键（VK_RETURN = 0x0D = 13）
input.key(0x0D)

# 按下空格键（VK_SPACE = 0x20 = 32）
input.key(0x20)

按键按下 / 抬起 ​

keyDown(vkCode) / keyUp(vkCode) ​

说明：模拟按键按下或抬起，配合使用可实现组合键。

函数签名：

python
keyDown(vkCode: int) -> None
keyUp(vkCode: int) -> None
lua
keyDown(vkCode: number) -> nil
keyUp(vkCode: number) -> nil

参数：

  • vkCode - 虚拟键码（Windows 虚拟键码，整数）
python
from wingman import input

# 组合键 Ctrl+C（VK_CONTROL = 0x11，'C' = 0x43）
input.keyDown(0x11)  # 按下 Ctrl
input.keyDown(0x43)  # 按下 C
input.keyUp(0x43)    # 抬起 C
input.keyUp(0x11)    # 抬起 Ctrl

文本输入 ​

type(text, delay?) ​

说明：输入一段文本（整段一次性输入，非逐字符延时模拟）。

函数签名：

python
type(text: str, delay: int = 10) -> None
lua
type(text: string, delay: number = 10) -> nil

参数：

  • text - 要输入的文本
  • delay - 可选，整段输入完成后等待的毫秒数，默认 10（不是字符间间隔）
python
from wingman import input

# 输入文本
input.type("hello world")

# 输入完成后等待 50ms
input.type("hello world", 50)

延迟 ​

delay(ms) ​

说明：让脚本暂停指定的毫秒数。

函数签名：

python
delay(ms: int) -> None
lua
delay(ms: number) -> nil

参数：

  • ms - 暂停时长（毫秒）
python
from wingman import input

# 暂停 1000ms（1 秒）
input.delay(1000)

随机延迟 ​

randomDelay(min, max) ​

说明：在 [min, max] 范围内随机暂停一段时间，使自动化更像真人操作。

函数签名：

python
randomDelay(min: int, max: int) -> None
lua
randomDelay(min: number, max: number) -> nil

参数：

  • min - 最小暂停时长（毫秒）
  • max - 最大暂停时长（毫秒）
python
from wingman import input

# 随机暂停 500ms 到 1500ms
input.randomDelay(500, 1500)

可用接口 ​

鼠标操作 ​

Python 函数Lua 函数说明参数
click(x, y, button)click(x, y, button)鼠标点击x,y: 坐标
button: 0=左/1=中/2=右
move(x, y, duration)move(x, y, duration)移动鼠标x,y: 目标坐标
duration: 移动完成后等待(ms)，非平滑轨迹
scroll(x, y, delta)scroll(x, y, delta)滚轮滚动x,y: 位置
delta: 滚动量

键盘操作 ​

Python 函数Lua 函数说明参数
key(vkCode)key(vkCode)按键（按下并抬起）vkCode: 虚拟键码
keyDown(vkCode)keyDown(vkCode)按键按下vkCode: 虚拟键码
keyUp(vkCode)keyUp(vkCode)按键抬起vkCode: 虚拟键码
type(text, delay?)type(text, delay?)输入文本text: 文本
delay: 输入完成后等待(ms)，默认 10

延迟 ​

Python 函数Lua 函数说明参数
delay(ms)delay(ms)固定延迟ms: 毫秒
randomDelay(min, max)randomDelay(min, max)随机延迟min,max: 毫秒范围