简介

Python的微信机器人，内核由C++编写，并使用aardio加载Python提供脚本扩展功能。C++内核不开源，只提供exe和Python写的扩展插件。

hook实现

hook使用的是windows的VEH异常处理机制(和安卓的硬件断点hook类似)，不会修改内存字节码，所以会无痕一点，可以减小封号的风险。

当然，封号并非只靠客户端来判断，还有服务端的异常行为判断(比如频繁加好友)，所以无法保证百分百不封号。

功能列表

发送消息：

• 文本消息
• 图片消息
• AT消息
• xml消息
• 表情消息
• 名片消息
• 拍一拍消息
• 文件消息
• 小程序消息
• 引用消息
• 转发消息
• 撤回消息

CDN下载:

• 下载视频
• 下载图片
• 下载文件

其他功能：

• 获取微信文件路径
• 获取自己的登录信息
• 获取语音文本内容
• 获取语音内容
• 接收转账
• 退还转账

好友相关:

• 网络获取好友信息
• 编辑好友备注
• 内存获取好友信息
• 获取好友列表
• 网络搜索用户
• 检测好友状态
• 添加好友
• 同意好友请求

群相关：

• 获取群列表
• 邀请好友进群
• 修改自己的群昵称
• 修改群名称
• 设置群公告
• 发送群邀请
• 删除群成员
• 获取群成员昵称
• 获取群成员列表

使用步骤

依赖环境

微信(版本3.9.6.32)

下载地址: https://www.123pan.com/s/ihEKVv-u4Ox.html 提取码:yw41

里面有两个文件，zip是从exe用7zip解压得到的，可以作为绿色版直接使用。

登录版本低

如果登录该版本显示登录版本低，建议先去官网下载最新版本登录几天，在切换到这个版本使用。

如果你就想现在测试，可以使用过低版本软件来强制登录：https://wwm.lanzoue.com/iPpJZ24eouej

原理只是修改内存版本号，所以登上去会显示其他版本，而不是3.9.6.32。过低版本会一个群显示bug，就是群会显示已退出，但手机看是正常的，解决方法是用新版本登录几天再切换。这个bug不会影响机器人的功能，依旧可以正常收发群消息。

配置文件

将config_bak.ini重命名位config.ini，然后在config.ini里填写相应的配置：

• 授权码(license)

授权码请联系微信kanadeblisst获取，有两个月的试用期，后面会按月付费。好不好用封不封号试用期两个月肯定能感觉出来，后面如果觉得不好用不续费即可。

启动

先以管理员权限启动微信并登录, 打开pywxrobot.exe就会加载pyrobot目录下的main.py，相对于运行python main.py，只不过是从aardio层提供了一些内置函数给python使用。

main.py里的代码只是用于初始化插件，也就是plugins目录里的代码。

pyrobot目录结构

• .vscode: vscode的配置，用于配置语法提示
• packages: 依赖的一些其他包可以放在这个目录，这个目录默认已经加到sys.path
• plugins: 由pywxrobot的插件目录，可以是py文件或者文件夹(需包含__init__.py)。
• other_plugins: 不依赖消息机制的插件
• settings: 配置文件目录，文件名需和插件名一样
• test: 没什么用，我写的一些测试脚本
• .env: 可以设置packages的路径，这样引用packages里的包在vscode里就有语法提示了
• main.py: 启动文件
• requirements.txt: 依赖包，编写版Python已经携带。如果想用安装版Python需要自己安装这些依赖

已有的插件列表

消息插件:

• auto_accept_friend.py: 自动接受好友请求
• auto_download_file.py: 自动下载聊天文件
• auto_download_img.py: 自动下载聊天图片，可以配置auto_download_img.json里的save_path来解密保存到其他目录
• auto_download_video.py: 自动下载聊天视频
• auto_recv_transfer.py: 自动接收转账
• auto_save_emotion.py: 将接收到的表情包保存到指定路径，
• auto_save_voice.py: 将收到的语音保存到指定路径(格式silk)
• debug.py: 控制台和日志打印所有消息，可通过配置文件关闭
• echo_revoke_msg.py: 打印撤回的消息
• enter_room_tip.py: 设置进群提示语，例子请看配置文件
• interactive_console.py: 如果启用，会在控制台开启一个python的交互式终端
• keyword_invite_to_room.py: 根据关键词邀请进群，会判断两个内容，聊天消息和加好友的验证消息
• sysmsg_manager.py: 内置插件，不需要管
• xml_manager.py: 内置插件，不需要管

消息插件需定义在pyrobot\plugins目录，由pywxrobot.exe来加载并传递消息给这些插件。

其他插件:

• foreach_check_friends_status.py: 检测所有好友状态(删除、拉黑和好友)
• export_friends.py: 导出好友列表
• export_rooms.py: 导出群列表
• export_bizs.py: 导出公众号列表

其他插件是指不依赖消息机制的插件，可以通过pywxrobot 脚本路径直接运行这个脚本。

如何开发

编写插件

首先需要知道两个点：

• 如何获取到聊天消息
• 如何主动调用函数

编写好的插件放到pyrobot/plugins目录,然后关闭重新打开pywxrobot.exe就会生效

如何获取到聊天消息

broadcast_service.listen(消息类型, 处理函数)

当收到这个类型的消息，就会调用处理函数，具体可以参考其他插件的写法。每个处理函数是一个单独的线程，使用公共资源时需要加锁。

所有消息的类型定义在wxstruct.py里的MsgType、XmlMsgType和SysMsgType

MsgType有以下属性:

• TEXT: 文本消息
• IMAGE: 图片消息
• VIDEO: 视频消息
• VOICE: 语音消息
• ADDFRIEND: 好友请求
• CARD: 名片消息
• EMOTION: 表情消息
• LOCATION: 位置消息
• XML: XML消息，可能是文件、转账、文章、小程序、聊天记录等
• VOIP : 语音、视频通话
• NOTICE: 通知消息，可能是进群提示、红包、拍一拍等
• SYSMSG: 系统消息, 很多我也不知道是什么

xml_manager插件会进一步处理XML类型消息，生成以下类型消息:

• BIZMSG: 分享的文章
• FILE: 文件
• SHARE_LOCATION: 位置共享
• MULTI_MSG: 合并发送的多条消息
• STEP_RANK_MSG: 微信运行发送的步数消息
• APPMSG: 分享的小程序
• FEED: 视频号
• REFERENCE_MSG: 引用回复
• ROOM_ANNOUNCEMENT: 群公告
• TRANSFER: 转账

如果有些消息没有定义，你可以在wxstruct.py里定义一个名称，值是消息里msg_type的值。定义完成后，broadcast_service.listen就可以监听该类型的消息。

如何导入外部依赖

如果是安装版，用pip安装即可。如果是便携版，你需要从安装版里复制出来放到packages下。有些库这么操作可能会报错，这个自行解决或者直接使用安装版。

默认是使用便携版，虽然便携版Python也能通过下载pip来安装模块，但使用外部模块还是建议使用安装版Python好管理，切换到安装版Python可以看切换Python.md

如何主动调用函数

导出微信函数的模块名是wxfunc，所有函数列表可以看wxfunc.pyi，使用案例请看docs目录下的文档

例如你想在插件里发送文本消息:

import wxfunc

wxfunc.SendTextMsg("filehelper", "测试消息")

待补充

详细版的文档后面补充，后面的更新插件会在: https://github.com/kanadeblisst00/pywxrobot

特殊功能

还有一些隐藏功能后面在发布，现在还不稳定。

• pywxrobot.exe a.py 直接执行Python脚本，方便测试一些函数。而且有些功能并不依赖消息机制，比如检测好友状态
• 插件界面，我一直在想用户能不能给自己的Python插件写一个界面操作，或者是能用aardio做插件的界面。这个暂时没有什么好的想法，后面在考虑实现

功能exe

后面还会用aardio开发一些单独的exe使用，方便在界面上操作一些功能。

多开实现

多开功能其实已经兼容，但是我并没有去测试，这个还是先等功能稳定后再去测试

http接口调用

开放http接口来调用功能，而不是通过Python插件。不过收消息这个不好处理，只能通过post提交消息，这样就需要用户开一个server端接收。