WeChatFerry

本工具仅供学习和技术研究使用，不得用于任何商业或非法行为，否则后果自负。

本工具的作者不对本工具的安全性、完整性、可靠性、有效性、正确性或适用性做任何明示或暗示的保证，也不对本工具的使用或滥用造成的任何直接或间接的损失、责任、索赔、要求或诉讼承担任何责任。

本工具的作者保留随时修改、更新、删除或终止本工具的权利，无需事先通知或承担任何义务。

本工具的使用者应遵守相关法律法规，尊重微信的版权和隐私，不得侵犯微信或其他第三方的合法权益，不得从事任何违法或不道德的行为。

本工具的使用者在下载、安装、运行或使用本工具时，即表示已阅读并同意本免责声明。如有异议，请立即停止使用本工具，并删除所有相关文件。

</details>

📖 Python 文档	📺 Python 视频教程	🙋 FAQ

👉 WeChatRobot🤖，一个基于 WeChatFerry 的 Python 机器人框架。


后台回复 `WCF` 加群交流	如果你觉得有用

<details><summary>点击查看功能清单</summary>

查询登录状态
获取登录账号信息
获取消息类型
获取联系人
获取可查询数据库
获取数据库所有表
获取语音消息
发送文本消息（可 @）
发送图片消息
发送文件消息
发送卡片消息
发送 GIF 消息
拍一拍群友
转发消息
开启接收消息
关闭接收消息
查询数据库
获取朋友圈消息
下载图片、视频、文件
解密图片
添加群成员
删除群成员
邀请群成员

</details> <details><summary>点击查看支持的客户端</summary>

Python
HTTP
NodeJS

</details>

快速开始

Python

安装

pip install --upgrade wcferry

参考框架：🤖WeChatRobot

HTTP

wcfrust（基于 Rust）

go_wcf_http（基于 Go）

NodeJS

一起开发

🚫 非开发用户不需要往下看。 开发用户：可以根据文档和错误提示，自行解决编译错误的人员。

安装开发环境

安装 vcpkg

安装，参考Vcpkg: 总览。

cd C:\Tools
git clone https://github.com/microsoft/vcpkg
.\vcpkg\bootstrap-vcpkg.bat

添加全局配置：环境变量增加 vcpkg 所在路径（本项目为：C:\Tools\vcpkg）。

安装相关组件

vcpkg install protobuf[zlib]:x64-windows-static
vcpkg install spdlog:x64-windows-static
vcpkg install nng:x64-windows-static
vcpkg install magic-enum:x64-windows-static
vcpkg install minhook:x64-windows-static
vcpkg integrate install

安装完毕后，需要配置 protoc 的环境变量，并确保在命令行下可用，protoc 的路径在 <vcpkg_install_path>\installed\x86-windows-static\tools\protobuf

安装 VS2019

安装 Python3

可以通过微软商店或 python.org 自行下载，注意配置好环境变量，确保在命令行下可以使用 python3。

安装依赖：

pip install grpcio-tools==1.48.2

编译

使用 VS2019 打开工程并进行编译。编译成功后，在 WeChatFerry\WeChatFerry\Out 目录中可以看到相应的 DLL 文件。

注意：如果在执行 protoc 时遇到 9009 错误，请检查 python3 环境是否有问题，或者 protoc 命令的环境变量配置是否正确。

运行

import ctypes
# 加载 sdk.dll （需要使用绝对路径）
sdk = ctypes.cdll.LoadLibrary("C:/Projs/WeChatFerry/WeChatFerry/Out/sdk.dll")

# 初始化
sdk.WxInitSDK(False, 10086)

# 退出 SDK
sdk.WxDestroySDK()

# 注意关闭 Python 进程

调试日志

    DbgMsg("ListenMessage"); // 封装的 OutputDebugString
    OutputDebugString(L"ListenMessage\n");
    MessageBox(NULL, L"ListenMessage", L"ListenMessage", 0);

项目结构

WeChatFerry
├── LICENSE                 # 许可证
├── README.MD               # 说明文档
├── WeChatFerry
│   ├── WeChatFerry.sln     # VS2019 工程文件
│   ├── com                 # 公共模块
│   ├── rpc                 # RPC 模块
│   ├── sdk                 # 注入及启动模块
│   ├── smc                 # Silk-Mp3 转换模块
│   └── spy                 # 核心功能实现模块
├── assets
│   ├── QR.jpeg             # 二维码，测试用图
│   ├── TEQuant.jpg         # 二维码，测试用图
│   └── demo.gif            # 示例动图
├── clients
│   ├── go                  # Go 客户端
│   ├── gohttp              # HTTP 客户端
│   ├── http                # HTTP 客户端
│   ├── java                # Java 客户端
│   ├── node                # Node.js 客户端
│   ├── pyauto              # 群友封装的客户端
│   ├── python              # Python 客户端
│   └── rust                # Rust 客户端
└── docs                    # 文档