连接事件

WECHAT_CONNECT_MESSAGE

微信客户端连接成功（接口就绪通知）。

• 类型码：11024
• 触发时机：微信客户端被成功接管后

@wechat.handle(events.WECHAT_CONNECT_MESSAGE)
def on_connect(bot: WeChat, event: dict):
    print(f"微信已连接：PID={event['data']['pid']}")

USER_LOGIN_MESSAGE

用户登录成功。

• 类型码：11025
• 触发时机：微信账号登录完成

@wechat.handle(events.USER_LOGIN_MESSAGE)
def on_login(bot: WeChat, event: dict):
    print(f"用户已登录：{event['data']['nickname']} ({event['data']['wxid']})")

事件数据包含：

• wxid：微信ID
• account：微信号
• nickname：昵称
• pid：进程PID

USER_LOGOUT_MESSAGE

用户注销通知。

• 类型码：11026
• 触发时机：微信账号退出登录

@wechat.handle(events.USER_LOGOUT_MESSAGE)
def on_logout(bot: WeChat, event: dict):
    print(f"用户已退出登录")

LOGIN_QR_CODE_MESSAGE

登录二维码事件。

• 类型码：11087
• 触发时机：生成登录二维码时

@wechat.handle(events.LOGIN_QR_CODE_MESSAGE)
def on_qrcode(bot: WeChat, event: dict):
    print(f"请扫描二维码登录")

WINDOW_HANDLE_CHANGE_MESSAGE

窗口句柄变化。

• 类型码：11088
• 触发时机：微信窗口状态发生变化

@wechat.handle(events.WINDOW_HANDLE_CHANGE_MESSAGE)
def on_window_change(bot: WeChat, event: dict):
    print(f"窗口变化：{event['data']}")

CHAT_CHANGE_MESSAGE

聊天对象变化。

• 类型码：11091
• 触发时机：当前会话窗口切换

@wechat.handle(events.CHAT_CHANGE_MESSAGE)
def on_chat_change(bot: WeChat, event: dict):
    print(f"切换到聊天：{event['data']}")

WECHAT_DISCONNECT_MESSAGE

微信断开连接。

• 类型码：11023
• 触发时机：微信客户端关闭或断开

@wechat.handle(events.WECHAT_DISCONNECT_MESSAGE)
def on_disconnect(bot: WeChat, event: dict):
    print(f"微信已断开连接")