微信自动化操作 Skill

⚠️ 使用前必读：安装检查

在执行任何操作前，必须先确认 wx4py 库已安装。

步骤1：检查是否已安装

try:
    from wx4py import WeChatClient
    print("✅ wx4py 已安装")
except ImportError:
    print("❌ 未安装 wx4py")

步骤2：如果未安装，执行安装

# 方法1：从 PyPI 安装（推荐）
pip install wx4py

# 方法2：从 GitHub 安装（最新版）
pip install git+https://github.com/claw-codes/wx4py.git

# 方法3：从本地安装
cd /path/to/wx4py
pip install .

步骤3：验证安装成功

from wx4py import WeChatClient

# 测试导入
print("✅ 安装成功！")

# 检查版本（可选）
import wx4py
print(f"版本: {wx4py.__version__}")

重要提示：

• 如果用户提示 ModuleNotFoundError: No module named 'wx4py'，说明未安装
• 必须先安装库再执行后续操作
• 安装只需要一次，后续无需重复

---

概述

本 skill 基于 wx4py 库，帮助用户通过 Python 代码自动化控制 Windows 微信客户端，完成重复性的消息发送、群管理等任务。

适用场景：

• 批量群发通知到多个群或联系人
• 定时发送文件、图片、消息
• 获取和分析聊天记录
• 管理群公告、群昵称、免打扰等设置
• 监听多个群聊消息，并在被 @ 时自动回复
• 接入 OpenAI 兼容接口或自定义 AI 回调，构建群聊机器人
• 自动化日常微信操作

前置要求：

• Windows 系统
• 微信 PC 客户端已安装并登录（Qt 版本，已测试 4.1.7.59、4.1.8.29）
• Python >=3.9
• 终端、编辑器、脚本文件统一使用 UTF-8 编码环境，避免中文消息、群名、文件名出现乱码

编码环境建议：

• Python 源码文件保存为 UTF-8
• PowerShell / 终端优先使用 UTF-8 编码
• 读写文本、JSON、Markdown 文件时显式指定 encoding='utf-8'
• 如果要输出中文日志或生成中文文件内容，优先验证终端和编辑器都已切换到 UTF-8

核心功能

1. 消息发送

发送单条消息到联系人或群

from wx4py import WeChatClient

wx = WeChatClient()
wx.connect()

# 发送给联系人
wx.chat_window.send_to("文件传输助手", "测试消息")

# 发送到群
wx.chat_window.send_to("工作群", "下午3点开会", target_type='group')

wx.disconnect()

批量群发消息

wx = WeChatClient()
wx.connect()

# 批量发送到多个群
groups = ["群1", "群2", "群3"]
message = "重要通知：明天放假"
wx.chat_window.batch_send(groups, message)

# 批量发送到多个联系人
contacts = ["张三", "李四", "王五"]
wx.chat_window.batch_send(contacts, "周末聚餐通知", target_type='contact')

wx.disconnect()

2. 文件发送

发送单个文件

wx = WeChatClient()
wx.connect()

# 发送文件给联系人
wx.chat_window.send_file_to("文件传输助手", r"C:\reports\weekly.pdf")

# 发送文件到群
wx.chat_window.send_file_to("工作群", r"C:\data.xlsx", target_type='group', message='可以携带消息')

wx.disconnect()