메뉴
Windows GUI automation toolkit for global hotkeys and window management. Use when users need to register global hotkeys, find/control windows, automate GUI operations, or perform Windows desktop automation. Requires Windows OS with pywin32, pyuserinput, and pyautogui dependencies.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Configure common development commands and local tool environments with pywayne's toolsetup CLI. Use whenever the user mentions toolsetup, cross-platform shell shortcuts, proxy_on/proxy_off, persistent goto aliases, the Linux gpu helper, nvm/npm bootstrap, Linux Tailscale installation, or MongoDB/PyMongo setup on macOS or Linux—even if they only ask for the right command or a dry-run plan.
Fetch and install C++ tools/libraries from cpp_tools repository. Use when users need to download or clone third-party C++ libraries such as eigen, opencv, pcl, fmt. Use for building tools from source using CMake, installing tools with installation scripts, listing available tools, or managing cpp_tools repository URL. Triggered by requests to fetch, get, download, clone, or install C++ tools or libraries.
Sensor calibration toolkit with magnetometer calibration using close-form method. Use when calibrating IMU sensors (accelerometer, gyroscope, magnetometer) to compute soft-iron matrix and hard-iron offset for magnetometer correction. Requires sensor fusion with VQF for orientation estimation.
Digital signal processing toolkit for filtering, peak detection, detrending, and curve similarity. Use when working with sensor data, signal preprocessing, feature extraction, noise suppression, or time-series analysis. Includes Butterworth filter, One-Euro filter, signal detrending, DTW curve similarity, Welford standard deviation, and sliding window extrema detection.
SE(3) rigid body transformation library for 3D rotation and translation operations. Use when working with robot poses, camera transformations, SLAM systems, or any 3D rigid body motion tasks. Supports SE(3) matrix operations, Lie group/algebra mappings (log/Log, exp/Exp), representation conversions (quaternion, axis-angle, Euler angles), and batch processing of trajectories.
VIO (Visual Inertial Odometry) data processing utilities for SE(3) pose conversion and 3D visualization. Use when working with SE(3) matrices and need pose representation conversion (tx,ty,tz,qw,qx,qy,qz), 3D visualization of pose trajectories with orientation arrows, or Visual Inertial Odometry data transformation and analysis
| name | pywayne-gui |
| description | Windows GUI automation toolkit for global hotkeys and window management. Use when users need to register global hotkeys, find/control windows, automate GUI operations, or perform Windows desktop automation. Requires Windows OS with pywin32, pyuserinput, and pyautogui dependencies. |
Windows 图形用户界面自动化工具，提供全局热键监听和窗口操作功能。
from pywayne.gui import GlobalHotKeys, GuiOperation
# 全局热键
g = GlobalHotKeys()
@g.register(GlobalHotKeys.VK_F1, GlobalHotKeys.MOD_SHIFT)
def shift_f1():
print('Shift+F1 被按下')
# 启动监听（按 Q 或 Ctrl+C 退出）
GlobalHotKeys.listen()
| 包 | 用途 | 安装命令 |
|---|---|---|
| pywin32 | Windows API 封装 | pip install pywin32 |
| pyuserinput | 键盘鼠标输入 | pip install pyuserinput |
| pyautogui | GUI 自动化 | pip install pyautogui |
注册全局热键，在全局范围内监听键盘事件。
from pywayne.gui import GlobalHotKeys
g = GlobalHotKeys()
# 装饰器方式注册
@g.register(GlobalHotKeys.VK_F1, GlobalHotKeys.MOD_SHIFT)
def shift_f1():
print('Shift+F1')
# 组合键修饰符（支持组合使用）
g.register(GlobalHotKeys.VK_F1, GlobalHotKeys.MOD_CTRL | GlobalHotKeys.MOD_SHIFT)
# 直接调用 register 方法
def handler():
print('Ctrl+A 被按下')
GlobalHotKeys.register(GlobalHotKeys.VK_A, GlobalHotKeys.MOD_CTRL, handler)
# 启动消息循环，开始监听热键
GlobalHotKeys.listen()
按以下任意组合键会停止监听循环：
Q 键Ctrl + C常用虚拟键码（VK_*）：
| 按键 | 键码 | 组合键 |
|---|---|---|
| A-Z | VK_A 到 VK_Z | ord('A') 到 ord('Z') |
| 0-9 | VK_0 到 VK_9 | ord('0') 到 ord('9') |
| F1-F12 | VK_F1 到 VK_F12 | - |
修饰键（MOD_*）：
| 修饰键 | 常量 |
|---|---|
| Alt | MOD_ALT |
| Ctrl | MOD_CTRL |
| Shift | MOD_SHIFT |
| Win | MOD_WIN |
修饰键可使用 | 组合，如 MOD_CTRL | MOD_SHIFT。
提供 Windows 窗口查找、控制和操作功能。
from pywayne.gui import GuiOperation
gui = GuiOperation()
查找包含指定关键字的窗口，返回窗口句柄列表。
# 查找包含"记事本"的窗口
notepad_handles = gui.find_window('记事本')
# 查找包含"微信"的窗口
wechat_handles = gui.find_window('微信')
# 多关键字匹配
handles = gui.find_window('Visual', 'Studio')
参数说明：
*keys: 按关键字匹配窗口标题返回值：
hwnd）获取指定窗口的属性信息。
hwnd = gui.find_window('记事本')[0]
title, class_name = gui.get_windows_attr(hwnd)
print(f"窗口标题: {title}")
print(f"窗口类名: {class_name}")
返回值：
(窗口标题, 窗口类名)('', '')将指定窗口最大化。
hwnd = gui.find_window('记事本')[0]
gui.maximize_window(hwnd)
将指定窗口置于顶层。
hwnd = gui.find_window('记事本')[0]
gui.bring_to_top(hwnd)
关闭指定窗口。
hwnd = gui.find_window('记事本')[0]
gui.close_window(hwnd)
修改指定窗口的标题。
hwnd = gui.find_window('记事本')[0]
gui.change_window_name(hwnd, '新标题')
获取窗口的矩形坐标。
hwnd = gui.find_window('记事本')[0]
rect = gui.get_window_rect(hwnd)
print(f"窗口位置: {rect}")
返回值：(left, top, right, bottom)
获取指定窗口的子窗口列表。
hwnd = gui.find_window('记事本')[0]
children = gui.get_child_windows(hwnd)
print(f"子窗口数量: {len(children)}")
from pywayne.gui import GlobalHotKeys
g = GlobalHotKeys()
@g.register(GlobalHotKeys.VK_F10, GlobalHotKeys.MOD_SHIFT)
def screenshot_hotkey():
print('截图热键被触发')
# 执行截图逻辑...
@g.register(GlobalHotKeys.VK_Q, GlobalHotKeys.MOD_CTRL)
def copy_hotkey():
print('复制热键被触发')
# 执行复制逻辑...
GlobalHotKeys.listen()
from pywayne.gui import GuiOperation
import time
gui = GuiOperation()
# 查找记事本窗口
notepad = gui.find_window('记事本')
if notepad:
print('未找到记事本')
exit()
# 置顶并最大化
gui.bring_to_top(notepad[0])
time.sleep(0.5)
gui.maximize_window(notepad[0])
# 修改窗口标题
gui.change_window_name(notepad[0], '自动化控制中...')
from pywayne.gui import GuiOperation, GlobalHotKeys
from pywayne.gui import PyMouse, PyKeyboard
gui = GuiOperation()
g = GlobalHotKeys()
@g.register(GlobalHotKeys.VK_F1, GlobalHotKeys.MOD_SHIFT)
def auto_test():
# 查找测试软件窗口
st_window = gui.find_window('ST测试软件')
if not st_window:
return
st_hwnd = st_window[0]
gui.bring_to_top(st_hwnd)
# 获取子窗口
for child in gui.get_child_windows(st_hwnd):
title, cls = gui.get_windows_attr(child)
print(f'子窗口: {title}')
# 操作完成后关闭
gui.close_window(st_hwnd)
GlobalHotKeys.listen()