使用Python做一个微信机器人

时间：2024-11-14 07:18:29

介绍

实现代码和pip安装: /Qwertyuiop2016/article/details/135076957

简介

该程序将微信的内部功能提取出来，然后在程序里加载Python，接着将这些功能导出成库函数，就可以在Python里使用这些函数

程序启动的时候会执行py_code目录下的，类似于你在命令行使用python 。

现在会以插件的形式加载py脚本，将脚本放到plugins目录下，忽略掉以_开头的脚本，然后加载所有其他的py脚本

插件脚本分为两类，以msg开头的py文件会在deal_msg.py【处理消息】里加载，其他脚本在里加载。如果需要收到消息做什么事的话就以msg开头命名，不然就随便命名

加载的所有脚本都在同一个线程内运行，如果需要多线程，请在脚本里继承一下, 参考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是不是你要回复的那个人，然后调用给他发消息即可

所有功能

接收消息
  • 好友消息
  • 群消息
  • 通知类消息(成员进群通知等)
  • 公众号推送(可以用来监控公众号的发文)
  • 公众号消息(公众号发送的消息)
  • 好友请求
  • 撤回提示消息
  • 群公告
  • 转账消息
  • 收款消息(可以写一个自动发卡的)
  • 关注的公众号直播提醒
  • 大文件上传完成提示(别人发文件时)
  • 更多消息自己发现
  • 有遗漏的消息类型也可以提出来
发消息
  • 发送文本
  • 发送图片
  • 发送文件
  • 发送表情
  • 发送名片
  • 发送xml消息
  • 发送拍一拍
  • 发送小程序
  • 转发消息
防撤回
  • 已内置(打开软件，默认开启，无法关闭)
群相关
  • 获取群成员
  • 获取群成员昵称
  • 删除群成员
  • 设置群公告
  • 修改群名称
  • 修改自己的群昵称
  • 邀请好友进群
加好友
  • 同意好友请求(案例Python代码可配置自动同意)
  • 检测好友状态(该功能用法参考插件check_friend.py)
  • 搜索好友(可通过手机号或微信号搜索)
  • 添加好友
转账收款
  • 接收转账和退还转账（案例Python代码可配置自动接收）
其他
  • 修改好友备注
  • 获取好友详细信息
  • 获取好友列表
  • 获取wxid的相关信息
CDN下载
  • 下载图片
  • 下载视频
  • 下载文件
  • 下载语音
  • 下载表情包
待更新
  • 发送引用消息
  • 发送@消息
  • 语音转文字
  • 获取朋友圈
  • 消息标记已读

操作步骤

准备工作
  1. 安装给定版本(3.9.6.32)的微信到任意目录
  2. 安装给定的python-3.8.到任意目录, 不懂的话，安装选项可以一直默认
  3. 编辑配置文件，主要修改微信安装目录和Python安装目录
  4. 打开软件，点击软件界面的-》帮助-》启动微信，登录即可(如果出现监听不到消息的情况，需要以管理员权限运行微信，在运行软件)

提示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: ...
功能: 发送文本消息
参数：

  1. wxid: 对方的wxid
  2. text: 发送的文本内容
SendXmlMsg

函数原型: def SendXmlMsg(wxid:str, xml:str, dtype:int) -> int: ...
功能: 发送xml消息，接受消息类型为49，应该都可以把xml拿下来重新发出去。只测试了发送公众号文章
参数：

  1. wxid: 对方的wxid
  2. xml: 发送的xml内容
  3. dtype: xml里面的类型，可以从xml里解析出来
SendEmotionMsg

函数原型: def SendEmotionMsg(wxid:str, path:str) -> int: ...
功能: 发送表情包
参数：

  1. wxid: 对方的wxid
  2. path: 表情包的绝对路径，可以是未加密的表情包、也可以是 FileStorage\CustomEmotion下的加密表情
SendCardMsg

函数原型: def SendCardMsg(wxid:str, xml:str) -> int: ...
功能: 发送某个好友的名片， 也可以使用下面那个函数，可以直接通过好友wxid发送
参数：

  1. wxid: 对方的wxid
  2. xml: 名片的xml数据，可以先发送一个出去，然后在接受消息里打印出来就能看到
SendCardMsgByWxid

函数原型: def SendCardMsg(wxid:str, cardWxid:str) -> int: ...
功能: 发送某个好友的名片
参数：

  1. wxid: 对方的wxid
  2. cardWxid: 需要发送的好友wxid
SendPatMsg

函数原型: def SendPatMsg(roomid:str, wxid:str) -> int: ...
功能: 发送拍一拍消息
参数：

  1. roomid: 群id
  2. wxid: 拍的人的wxid
SendImageMsg

函数原型: def SendImageMsg(wxid:str, path:str) -> int: ...
功能: 发送图片
参数：

  1. wxid: …
  2. path: 发送的图片绝对路径
SendFileMsg

函数原型: def SendFileMsg(wxid:str, path:str) -> int: ...
功能: 发送文件
参数：

  1. wxid: …
  2. path: 发送的文件绝对路径
SendAppMsg

函数原型: def SendAppMsg(wxid:str, gappid:str) -> int: ...
功能: 发送小程序消息
参数：

  1. wxid: …
  2. gappid: 类似gh_xxxxxxxx@app这样的id, 可以转发一个小程序，里面的xml就有
ForwardMessage

函数原型: def ForwardMessage(wxid:str, localid:int) -> int: ...
功能: 转发消息
参数：

  1. wxid: …
  2. localid: 消息里面的localid字段
EditRemark

函数原型: def EditRemark(wxid:str, remark:str) -> int: ...
功能: 编辑好友备注
参数：

  1. wxid: …
  2. remark: 备注内容
RecvTransfer

函数原型: def RecvTransfer(wxid:str, transferid:str, transcationid:str) -> int: ...
功能: 接收转账
参数：

  1. wxid: …
  2. transferid: 转账消息的xml里可以提取到
  3. transcationid: 转账消息的xml里可以提取到
RefundTransfer

函数原型: def RefundTransfer(wxid:str, transferid:str, transcationid:str) -> int: ...
功能: 退还转账
参数：

  1. wxid: …
  2. transferid: 转账消息的xml里可以提取到
  3. transcationid: 转账消息的xml里可以提取到
GetChatRoomMembers

函数原型: def GetChatRoomMembers(roomid:str) -> str: ...
功能: 获取某个群的所有群成员
参数：

  1. roomid: 群id
GetChatRoomMemberNickname

函数原型: def GetChatRoomMemberNickname(roomid:str, wxid:str) -> str: ...
功能: 获取群成员昵称
参数：

  1. roomid: 群id
  2. wxid: 要获取昵称的wxid
GetUserInfoJsonByCache

函数原型: def GetUserInfoJsonByCache(wxid:str) -> str: ...
功能: 获取某个用户的昵称, 可以是好友或者群成员
参数：

  1. wxid: 要获取昵称的wxid
DelChatRoomMembers

函数原型: def DelChatRoomMembers(roomid:str, wxid:str) -> int: ...
功能: 删除群成员
参数：

  1. roomid: 群id
  2. wxid: 要删除的那个人的wxid
SetChatRoomAnnouncement

函数原型: def SetChatRoomAnnouncement(roomid:str, content:str) -> int: ...
功能: 设置群公告
参数：

  1. roomid: 群id
  2. content: 公告内容，仅支持文本内容
SetChatRoomName

函数原型: def SetChatRoomName(roomid:str, name:str) -> int: ...
功能: 修改群名称
参数：

  1. roomid: 群id
  2. name: 名称
SetChatRoomMyNickname

函数原型: def SetChatRoomMyNickname(roomid:str, name:str) -> int: ...
功能: 修改自己的群昵称
参数：

  1. roomid: 群id
  2. name: 名称
AddChatRoomMembers

函数原型: def AddChatRoomMembers(roomid:str, wxid:str) -> int: ...
功能: 邀请好友进程，该接口仅支持40人以下的群
参数：

  1. roomid: 群id
  2. wxid: 好友的wxid
DownloadImageFromCdnByLocalid

函数原型: def DownloadImageFromCdnByLocalid(localid:int, file_path:str) -> int: ...
功能: 下载某个图片消息的图片到指定路径下
参数：

  1. localid: 消息的localid
  2. file_path: 路径一般是微信的目录，然后解密拷贝出来。具体见Python示例
DownloadFileFromCdnByLocalid

函数原型: def DownloadFileFromCdnByLocalid(localid:int, file_path:str) -> int: ...
功能: 下载某个文件消息到指定路径下
参数：

  1. localid: 消息的localid
  2. file_path: 路径一般是微信的目录，然后拷贝出来。具体见Python示例
DownloadVideoFromCdnByLocalid

函数原型: def DownloadVideoFromCdnByLocalid(localid:int, file_path:str) -> int: ...
功能: 下载某个视频消息到指定路径下
参数：

  1. localid: 消息的localid
  2. file_path: 路径一般是微信的目录，然后拷贝出来。具体见Python示例
AddFriendByWxidOrV3

函数原型: def AddFriendByV3V4(v3:str, v4:str, addType:int) -> int: ...
功能: 同意还有请求，v3、v4和addType都在好友请求的消息xml里，具体字段见Python示例
参数：

  1. v3: …
  2. v4: …
  3. addType: 添加的类型，比如通过wxid添加就是6，通过名片添加的就是17，
getVoiceByMsgid

函数原型: def getVoiceByMsgid(msgid:str) -> str: ...
功能: 通过msgid获取语音文件，获取的格式是slik，需要转常见的音频格式比如mp3才能播放
参数：

  1. msgid: 音频消息中的msgid
CheckFriendStatus

函数原型: def CheckFriendStatus(wxid:str) -> dict: ...
功能: 检测好友状态，拉黑、删除等，可以用来做僵尸粉检测，建议调用增加间隔时间。可能会出现添加好友的提示，属于正常现象，对方看不到
参数：

  1. wxid: …
SearchFriend

函数原型: def SearchFriend(phone:str) -> dict: ...
功能: 通过微信号或者手机号搜索用户
参数：

  1. phone: 要搜索的微信号或手机号

获取我的wxid

函数原型: def GetMyWxid() -> dict: ...
功能: 获取开发者的wxid
返回值：kanadeblisst

相关文章