winautox

WinAuto 方法手册（总览）

WinAuto 是 winautox 的推荐入口：窗口绑定、控件定位、点击、输入、滚动、剪贴板、列表、消息、视觉与调试。

桌面软件仅用于试跑 / 生成代码，见 软件附录。正式脚本以本手册方法为准。

第一次看手册怎么用

  1. 还没装环境？先去 安装 → 快速开始。
  2. 需要抄现成脚本？去 示例代码。
  3. 已经会绑定窗口：在下方「章节导航」点进某一领域；每页开头都有 方法一览表，再往下是参数与例子。
  4. 报错了：常见问题。

记忆口诀：先 find_hwnd 绑定 → 再 dump 看控件 → 再 click / input。不要跳过 dump。

学习路径

  1. 环境配置和安装
  2. 快速开始
  3. 示例代码
  4. 下方按领域查方法
  5. 常见问题

导入

from winautox import (
    WinAuto, MODE_AUTO, MODE_UIA, MODE_POST, MODE_SEND, MODE_MOUSE, MODE_HUMAN,
    findpic, ocr, authenticate,
)

操作模式

能力autouiapost / sendmousehuman
点击 / 输入自动降级需控件消息路径物理拟人轨迹
组合键hotkey 优先用 keys见 input 章物理—

不会选就用 mode='uia'。 拟人见 拟人操作。

章节导航

章节内容
构造与绑定HWND、from_*、bind、set_mode、im_client
控件获取控件树、find、wait_ctrl、批量查找
查找与点击click / 坐标 / 气泡 / 长按 / click_named
拟人操作human_click*、human_move、MODE_HUMAN
输入与键盘input、keys、hotkey、send_msg、clear_input
剪贴板copy*、inspect、set_clip*、媒体保存
滚动与窗口翻页、滚轮、激活关闭、弹窗、scroll_into_view
列表与会话会话列表、未读
消息列表bind_msg_list、视口、消息点击、im_client
控件别名register / *_cfg / use
找图找色采样findpic / OCR / 伪树
辅助与许可笔记弹窗、authenticate、perf_status
调试与示例dump、完整示例

全量方法索引（按领域）

绑定 / 窗口查找

方法说明文档
WinAuto(hwnd, mode=...)直接绑定 HWNDbind
from_find_hwnd / from_main_hwnd按标题/类名构造bind
find_hwnd / find_main_hwnd / find_wechat_main_hwnd静态查找 HWNDbind
bind / set_mode / activate / close_window重绑、模式、激活关闭bind · window
im_client / create_im_client / resolve_im_client_class注入 IM 客户端messages

控件定位

方法说明文档
find / wait_ctrl按属性查找 / 等待controls
find_controls_by_names / click_named批量名称controls · click
find_descendant_hwnd / focus_descendant子 HWNDcontrols
dump_windows_controls / print_windows_dump导出控件树controls · debug
get_ctrl_value / set_ctrl_valueValue 读写input

点击

方法说明文档
click / double_click / right_click / click_bubble控件点击click
click_xy / double_click_xy / right_click_xy屏幕坐标click
long_press长按click
human_click / human_click_xy / human_right_click_xy / human_move拟人human

输入 / 键盘

方法说明文档
input / send_msg / type_and_send / clear_input文本输入发送input
keys / hotkey / enter / select_all按键input
page_up / page_down翻页window

剪贴板

方法说明文档
copy / copy_content / copy_rich / copy_and_parse从控件复制clipboard
paste / get_clip / set_clip / set_clip_files读写粘贴clipboard
inspect_clipboard / read_clipboard / read_clipboard_all / parse_clipboard解析clipboard
empty_clipboard / wait_clipboard / save_clipboard_media / show_content工具clipboard

滚动 / 窗口 / 弹窗

方法说明文档
scroll / wheel_hwnd / scroll_into_view滚轮与滚入视口window
set_window_rect / sleep尺寸与等待window
snapshot_popups / wait_popup / wait_chrome_popup弹窗window · helpers
find_chatrecord聊天记录窗window

列表 / 会话

方法说明文档
get_list_items / get_sessions / find_session / click_session会话列表list
get_unread_* / click_unread_* / click_all_unread / get_unread_count未读list
click_list_item点列表项list
register / get_list_cfg / click_list_cfg / get_unread_cfg / click_unread_cfg别名列表alias

消息列表

方法说明文档
bind_msg_list / chat_message_list / list_viewport_messages绑定与视口messages
find_in_list / find_msg_in_list视口内查找messages
click_msg / click_message / double_click_msg / right_click_msg点消息messages
get_new_messages / get_all_messages / get_latest_messages读消息messages
MakeMessageAnchor / ResolveMessageByAnchor / scroll_msg_into_view锚点messages
chat_with / get_chat_info / GetNextUnreadBarMessages会话辅助messages

别名

方法说明文档
register / cfg / find_cfg / click_cfg / input_cfg / send_msg_cfg控件别名alias
use链式代理alias

视觉（类方法 / 包导出）

方法说明文档
findpic / findcolor / sample / capture / get_color找图找色vision
click_pic / click_color找到并点vision
ocr / ocr_tree / ocr_tree2 / pseudo_treeOCR 与伪树vision
vision_status / perf_status环境探测vision · helpers

辅助 / 许可（包级）

符号说明文档
NoteContentParser / read_note_window笔记窗helpers
snapshot_hwnds / wait_new_toplevel顶层窗快照helpers
authenticate / check_license / device_id / require_*许可helpers

统一调试模板

from winautox import WinAuto
import time

WIN_CLASS = 'YourMainWndClass'
WIN_TITLE_KEY = '目标应用'
hwnd = WinAuto.find_hwnd(WIN_CLASS, WIN_TITLE_KEY)
auto = WinAuto(hwnd, mode='uia')
auto.activate()
time.sleep(0.3)