chatautox

WinAuto 总览

WinAuto 是 chatautox.auto 的推荐入口，封装了窗口查找、UIA 控件定位、点击、输入、滚动、剪贴板、会话/消息列表遍历等能力，适用于任意 Windows 程序。

✨ chatautox.auto 子包（含 WinAuto 及全部扩展模块）为会员版功能。

导入

from chatautox import WinAuto, MODE_AUTO, MODE_UIA, MODE_POST, MODE_MOUSE
# 或
from chatautox.auto import WinAuto

操作模式与 API 兼容性

能力autouiapostmouse
click / input自动降级需控件需坐标/控件定位物理
hotkey(0x11, 0x41)PostMessage 优先不支持，用 keys需绑定 hwnd物理按键
keys('{Enter}') 等单键支持需 ctrl仅 _VK_MAP 单键仅 _VK_MAP 单键
keys('{Ctrl}a', ctrl)优先 UIA SendKeys需 ctrl不支持组合串不支持组合串
input 中文剪贴板粘贴剪贴板/InputWM_CHAR 逐字剪贴板粘贴

实用建议：

  • 后台组合键（Ctrl+A/C/V）→ hotkey(0x11, 0x41)，并确保 WinAuto 已绑定 hwnd
  • 复杂 SendKeys 字符串（{Ctrl}a{Delete}）→ mode='uia' 且传入 ctrl，或拆成 hotkey + keys('{Delete}', ctrl)
  • post 模式下 keys('{Ctrl}s') 会报错，应改用 hotkey(0x11, 0x53)

文档导航

主题说明
控件获取导出控件树、find 定位、control_browser
构造与绑定HWND、类名查找、bind / set_mode
查找与点击find、wait_ctrl、各类点击
输入与键盘input、keys、hotkey、send_msg
剪贴板读写剪贴板、copy_content、inspect_clipboard
滚动与窗口翻页、滚轮、activate、弹窗
列表与会话左侧会话列表 UIA 操作
消息列表im_client、GetNewMessage 等
控件别名register、use、*_cfg 系列
调试与示例控件树导出、完整示例
找图找色采样findpic / findcolor / sample / ocr / pseudo_tree

uibase / BoundWindow / macro_helper 等 auto 扩展模块文档为会员专属，公开站暂不展示；源码在 web/vitepress/members-docs/。

统一调试模板

各子页示例均可复制后改 WIN_CLASS / aid / 会话名再运行：

from chatautox import WinAuto
import time

WIN_CLASS = 'YourMainWndClass'     # 改为你的窗口 ClassName
WIN_TITLE_KEY = '目标应用'          # 标题包含即可（弹窗/动态标题更准）
hwnd = WinAuto.find_hwnd(WIN_CLASS, WIN_TITLE_KEY)
auto = WinAuto(hwnd, mode='uia')
auto.activate()
time.sleep(0.3)

标题必须全等时可用 find_main_hwnd：

hwnd = WinAuto.find_main_hwnd(WIN_CLASS, ('目标应用',), find_window_name='目标应用')

上一页开发文档总览下一页控件获取