文档

快速开始

四步跑通：装依赖、体检控件树、连上窗口、发一条消息。

1. 装依赖

建议用独立虚拟环境，避免污染系统 Python。

python -m venv .venv
.venv\Scripts\activate
pip install -e .

依赖：uiautomation、comtypes、pywin32、pillow、psutil、tenacity、pyperclip、colorama、requests。

2. 先体检，别急着写代码

这一步能省掉后面大量排查时间。它只读，不发任何消息。

python -m wx4auto.selftest

如果卡在「定位微信主窗口」，说明控件树没暴露 —— 那是环境问题不是代码问题， 先读 环境与版本。

3. 连上窗口

from wx4auto import WeChat

wx = WeChat()          # 连上已登录的微信主窗口
print(wx.IsOnline())

WeChat() 首次连接约 5~8 秒（comtypes 缓存 + UIA 找窗），且是同步阻塞的。 高频调用的接口不要每次新建实例。

4. 发一条消息

wx.SendMsg("你好", who="文件传输助手")

SendMsg 内部自带三道闸：切换会话 → 发送前读回校验 → 达标才回车。 所以不会把消息发到上一个打开的会话里。

命令行入口

不想写代码时可以直接用：

python -m wx4auto.selftest                  # 只读自检（18 项）
python -m wx4auto probe --out dump.txt      # 导出控件树
python -m wx4auto sessions                  # 列会话
python -m wx4auto info                      # 我的昵称 / 微信号
python -m wx4auto send --to 张三 --msg 你好
python -m wx4auto listen --chat 客服群 --echo
python -m wx4auto moment --text "今天天气不错"

下一步