WeChatFerry

一个玩微信的工具。更多介绍见：WeChatFerry: 一个玩微信的工具。

👉 WeChatRobot🤖，一个基于 WeChatFerry 的 Python 机器人示例。

感谢大佬们贡献代码

快速开始

Python

• 安装

pip install --upgrade wcferry

• 参考示例：🤖WeChatRobot

HTTP

• wcfrust（基于 Rust）
• go_wcf_http（基于 Go）
• wrest-chat（基于 Go）
• wcf-http（基于 Python）

Java

• java

NodeJS

• wcferry-node
• node-wcferry
• wechatferry

C#

• WeChatFerry.Net 使用 Nuget 安装
• WeChatFerry-CSharp

Rust

• wechat-bot

Docker

• docker_wechat
• wechatbot-provider-windows

一起开发

🚫 非开发用户不需要往下看。

开发用户：可以根据文档和错误提示，自行解决编译错误的人员。

安装开发环境

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

setx VCPKG_ROOT "C:/Tools/vcpkg" /M

vcpkg integrate install # 失败则说明未正确安装或者未正确配置环境变量

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 进程

调试日志

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

项目结构

WeChatFerry
├── LICENSE                 # 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                    # 文档

版本更新

v39.5.2

• 没有新功能

WeChatFerry 快速上手指南

⚠️ 免责声明

使用前请务必阅读完整免责声明：点击查看

1. 环境准备

• 操作系统: Windows
• 微信客户端: 需已登录微信 PC 端
• Python 环境: 建议使用 Python 3.10（版本过高可能需要自行编译依赖）
• 网络: 确保能访问 PyPI 及 GitHub

2. 安装步骤

通过 pip 安装核心 Python 包：

pip install --upgrade wcferry

3. 基本使用

以下为基础 SDK 加载与初始化的示例代码（需根据实际路径调整）：

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

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

# 退出 SDK
sdk.WxDestroySDK()

# 注意关闭 Python 进程

4. 资源与扩展

• Python 文档: 📖 Python 文档
• 参考示例: 🤖WeChatRobot
• 多语言支持: 支持 HTTP、Java、NodeJS、C#、Rust 等客户端，详见项目 clients 目录。
• Docker 部署: 可参考 docker_wechat。