介绍
简介
该程序将微信的内部功能提取出来,然后在程序里加载Python,接着将这些功能导出成库函数,就可以在Python里使用这些函数
程序启动的时候会执行py_code目录下的main.py,类似于你在命令行使用python main.py
。
现在会以插件的形式加载py脚本,将脚本放到plugins目录下,忽略掉以_开头的脚本,然后加载所有其他的py脚本
插件脚本分为两类,以msg开头的py文件会在deal_msg.py【处理消息】里加载,其他脚本在main.py里加载。如果需要收到消息做什么事的话就以msg开头命名,不然就随便命名
main.py加载的所有脚本都在同一个线程内运行,如果需要多线程,请在脚本里继承一下threading.Thread, 参考check_friend.py
程序导出了一个函数库可以在Python里使用,库名是wxfunction,具体函数看下面的功能介绍。该库为其他语言编写,只是导出接口给Python使用
已有插件
- 检测所有好友状态(拉黑、删除等): check_friend.py
- 监控群消息,触发关键词预警(后续增加关键词规则): msg_monitor_keyword.py
- 每隔一段时间发一次消息: _send_msg_timing.py
- 给指定好友自动回复消息: msg_auto_reply.py
- 保存聊天记录到postgre数据库: msg_postgre.py
- 自动收款
- 自动接收好友请求
- 自动保存聊天文件、图片等
- 更多插件待开发
内置功能
- 保存所有文件、图片、视频、语音和表情包
- 如果想修改保存路径,可以参考保存的代码文件
发消息例子
举个例子,如果想每隔五分钟发一次消息,Python代码如下(修改完Python代码,需要关闭软件重新打开才能生效,微信不需要重新登录)
from threading import Timer
def sendmsg(interval):
'''每隔interval秒给文件传输助手发一次消息, filehelper是文件传输助手的wxid'''
wxfunction.SendTextMsg("filehelper", "测试消息!")
timer = Timer(interval, sendmsg, args=(interval,))
timer.start()
sendmsg(5*60)
SendTextMsg就是程序导出的发送文本消息的函数,第一个参数是wxid,这是微信内部使用的唯一id,每个微信号都有对应的wxid,可以通过获取好友列表来获取,第二个参数是发送的消息内容
接收消息例子
收到的消息处理,比如你想收到某人的回复,然后给他发一个消息,就像对接机器人一样的操作方式, 代码主要看deal_msg.py,其中的启动函数如下
def run(self):
while self.event.is_set():
msg = self.wxfunction.popFromMsgQueue()
if not msg:
time.sleep(0.5)
continue
msg_data = json.loads(msg)
msg_struct = ChatMsgStruct(**msg_data)
self._deal_msg(msg_struct)
代码很简单,从程序的消息队列里弹出一条json格式的消息,然后转成类,在_deal_msg方法里处理它。转成类的好处是我在类里定义了消息的相应字段, 在写代码时可以使用msg_struct.content来获取,编辑器会自动补全
你只需要在_deal_msg方法里判断发送人的wxid是不是你要回复的那个人,然后调用wxfunction.SendTextMsg给他发消息即可
所有功能
接收消息
- 好友消息
- 群消息
- 通知类消息(成员进群通知等)
- 公众号推送(可以用来监控公众号的发文)
- 公众号消息(公众号发送的消息)
- 好友请求
- 撤回提示消息
- 群公告
- 转账消息
- 收款消息(可以写一个自动发卡的)
- 关注的公众号直播提醒
- 大文件上传完成提示(别人发文件时)
- 更多消息自己发现
- 有遗漏的消息类型也可以提出来
发消息
- 发送文本
- 发送图片
- 发送文件
- 发送表情
- 发送名片
- 发送xml消息
- 发送拍一拍
- 发送小程序
- 转发消息
防撤回
- 已内置(打开软件,默认开启,无法关闭)
群相关
- 获取群成员
- 获取群成员昵称
- 删除群成员
- 设置群公告
- 修改群名称
- 修改自己的群昵称
- 邀请好友进群
加好友
- 同意好友请求(案例Python代码可配置自动同意)
- 检测好友状态(该功能用法参考插件check_friend.py)
- 搜索好友(可通过手机号或微信号搜索)
- 添加好友
转账收款
- 接收转账和退还转账(案例Python代码可配置自动接收)
其他
- 修改好友备注
- 获取好友详细信息
- 获取好友列表
- 获取wxid的相关信息
CDN下载
- 下载图片
- 下载视频
- 下载文件
- 下载语音
- 下载表情包
待更新
- 发送引用消息
- 发送@消息
- 语音转文字
- 获取朋友圈
- 消息标记已读
操作步骤
准备工作
- 安装给定版本(3.9.6.32)的微信到任意目录
- 安装给定的python-3.8.10.exe到任意目录, 不懂的话,安装选项可以一直默认
- 编辑配置文件,主要修改微信安装目录和Python安装目录
- 打开wxrobot.exe软件,点击软件界面的-》帮助-》启动微信,登录即可(如果出现监听不到消息的情况,需要以管理员权限运行微信,在运行软件)
提示1: Python版本并不需要是给定的3.8.10,更新的版本应该都能用,但必须是32位的Python
提示2: 不一定要使用软件启动微信,也可以自己点击快捷方式启动,但是软件和微信都需要以管理员方式运行,如果不是的话,软件是控制不了其他用户的程序的
所有功能介绍
getSelfWxid
函数原型: def getSelfWxid() -> str: ...
功能: 获取自己登录的微信的wxid
getWeChatFilePath
函数原型: def getWeChatFilePath() -> str: ...
功能: 获取微信文件的保存路径(微信设置文件管理里的微信文件的默认保存路径)
GetUsers
函数原型: def GetUsers() -> List[dict]: ...
功能: 获取当前已登录的wxid、微信号和昵称
GetContactList
函数原型: def GetContactList() -> List[list]: ...
功能: 获取好友和群列表
popFromMsgQueue
函数原型: def popFromMsgQueue() -> Union[str, None]: ...
功能: 从已接收到的消息队列里弹出一条消息,消息类型为json字符串
SendTextMsg
函数原型: def SendTextMsg(wxid:str, text:str) -> int: ...
功能: 发送文本消息
参数:
- wxid: 对方的wxid
- text: 发送的文本内容
SendXmlMsg
函数原型: def SendXmlMsg(wxid:str, xml:str, dtype:int) -> int: ...
功能: 发送xml消息,接受消息类型为49,应该都可以把xml拿下来重新发出去。只测试了发送公众号文章
参数:
- wxid: 对方的wxid
- xml: 发送的xml内容
- dtype: xml里面的类型,可以从xml里解析出来
SendEmotionMsg
函数原型: def SendEmotionMsg(wxid:str, path:str) -> int: ...
功能: 发送表情包
参数:
- wxid: 对方的wxid
- path: 表情包的绝对路径,可以是未加密的表情包、也可以是 FileStorage\CustomEmotion下的加密表情
SendCardMsg
函数原型: def SendCardMsg(wxid:str, xml:str) -> int: ...
功能: 发送某个好友的名片, 也可以使用下面那个函数,可以直接通过好友wxid发送
参数:
- wxid: 对方的wxid
- xml: 名片的xml数据,可以先发送一个出去,然后在接受消息里打印出来就能看到
SendCardMsgByWxid
函数原型: def SendCardMsg(wxid:str, cardWxid:str) -> int: ...
功能: 发送某个好友的名片
参数:
- wxid: 对方的wxid
- cardWxid: 需要发送的好友wxid
SendPatMsg
函数原型: def SendPatMsg(roomid:str, wxid:str) -> int: ...
功能: 发送拍一拍消息
参数:
- roomid: 群id
- wxid: 拍的人的wxid
SendImageMsg
函数原型: def SendImageMsg(wxid:str, path:str) -> int: ...
功能: 发送图片
参数:
- wxid: …
- path: 发送的图片绝对路径
SendFileMsg
函数原型: def SendFileMsg(wxid:str, path:str) -> int: ...
功能: 发送文件
参数:
- wxid: …
- path: 发送的文件绝对路径
SendAppMsg
函数原型: def SendAppMsg(wxid:str, gappid:str) -> int: ...
功能: 发送小程序消息
参数:
- wxid: …
- gappid: 类似gh_xxxxxxxx@app这样的id, 可以转发一个小程序,里面的xml就有
ForwardMessage
函数原型: def ForwardMessage(wxid:str, localid:int) -> int: ...
功能: 转发消息
参数:
- wxid: …
- localid: 消息里面的localid字段
EditRemark
函数原型: def EditRemark(wxid:str, remark:str) -> int: ...
功能: 编辑好友备注
参数:
- wxid: …
- remark: 备注内容
RecvTransfer
函数原型: def RecvTransfer(wxid:str, transferid:str, transcationid:str) -> int: ...
功能: 接收转账
参数:
- wxid: …
- transferid: 转账消息的xml里可以提取到
- transcationid: 转账消息的xml里可以提取到
RefundTransfer
函数原型: def RefundTransfer(wxid:str, transferid:str, transcationid:str) -> int: ...
功能: 退还转账
参数:
- wxid: …
- transferid: 转账消息的xml里可以提取到
- transcationid: 转账消息的xml里可以提取到
GetChatRoomMembers
函数原型: def GetChatRoomMembers(roomid:str) -> str: ...
功能: 获取某个群的所有群成员
参数:
- roomid: 群id
GetChatRoomMemberNickname
函数原型: def GetChatRoomMemberNickname(roomid:str, wxid:str) -> str: ...
功能: 获取群成员昵称
参数:
- roomid: 群id
- wxid: 要获取昵称的wxid
GetUserInfoJsonByCache
函数原型: def GetUserInfoJsonByCache(wxid:str) -> str: ...
功能: 获取某个用户的昵称, 可以是好友或者群成员
参数:
- wxid: 要获取昵称的wxid
DelChatRoomMembers
函数原型: def DelChatRoomMembers(roomid:str, wxid:str) -> int: ...
功能: 删除群成员
参数:
- roomid: 群id
- wxid: 要删除的那个人的wxid
SetChatRoomAnnouncement
函数原型: def SetChatRoomAnnouncement(roomid:str, content:str) -> int: ...
功能: 设置群公告
参数:
- roomid: 群id
- content: 公告内容,仅支持文本内容
SetChatRoomName
函数原型: def SetChatRoomName(roomid:str, name:str) -> int: ...
功能: 修改群名称
参数:
- roomid: 群id
- name: 名称
SetChatRoomMyNickname
函数原型: def SetChatRoomMyNickname(roomid:str, name:str) -> int: ...
功能: 修改自己的群昵称
参数:
- roomid: 群id
- name: 名称
AddChatRoomMembers
函数原型: def AddChatRoomMembers(roomid:str, wxid:str) -> int: ...
功能: 邀请好友进程,该接口仅支持40人以下的群
参数:
- roomid: 群id
- wxid: 好友的wxid
DownloadImageFromCdnByLocalid
函数原型: def DownloadImageFromCdnByLocalid(localid:int, file_path:str) -> int: ...
功能: 下载某个图片消息的图片到指定路径下
参数:
- localid: 消息的localid
- file_path: 路径一般是微信的目录,然后解密拷贝出来。具体见Python示例
DownloadFileFromCdnByLocalid
函数原型: def DownloadFileFromCdnByLocalid(localid:int, file_path:str) -> int: ...
功能: 下载某个文件消息到指定路径下
参数:
- localid: 消息的localid
- file_path: 路径一般是微信的目录,然后拷贝出来。具体见Python示例
DownloadVideoFromCdnByLocalid
函数原型: def DownloadVideoFromCdnByLocalid(localid:int, file_path:str) -> int: ...
功能: 下载某个视频消息到指定路径下
参数:
- localid: 消息的localid
- file_path: 路径一般是微信的目录,然后拷贝出来。具体见Python示例
AddFriendByWxidOrV3
函数原型: def AddFriendByV3V4(v3:str, v4:str, addType:int) -> int: ...
功能: 同意还有请求,v3、v4和addType都在好友请求的消息xml里,具体字段见Python示例
参数:
- v3: …
- v4: …
- addType: 添加的类型,比如通过wxid添加就是6,通过名片添加的就是17,
getVoiceByMsgid
函数原型: def getVoiceByMsgid(msgid:str) -> str: ...
功能: 通过msgid获取语音文件,获取的格式是slik,需要转常见的音频格式比如mp3才能播放
参数:
- msgid: 音频消息中的msgid
CheckFriendStatus
函数原型: def CheckFriendStatus(wxid:str) -> dict: ...
功能: 检测好友状态,拉黑、删除等,可以用来做僵尸粉检测,建议调用增加间隔时间。可能会出现添加好友的提示,属于正常现象,对方看不到
参数:
- wxid: …
SearchFriend
函数原型: def SearchFriend(phone:str) -> dict: ...
功能: 通过微信号或者手机号搜索用户
参数:
- phone: 要搜索的微信号或手机号
获取我的wxid
函数原型: def GetMyWxid() -> dict: ...
功能: 获取开发者的wxid
返回值:kanadeblisst