WeChatFerry/clients/wcfautopy

WeChatFerry wcfautopy 客户端(基于python客户端进行修改)

📖 文档	📺 视频教程	🙋 FAQ

🤖示例机器人框架：WeChatRobot。

快速开始

pip install --upgrade wcferry

Demo：

#! /usr/bin/env python3
# -*- coding: utf-8 -*-

import logging
from time import sleep
from wcferry import Wcf, WxMsg, Register

logging.basicConfig(level='DEBUG', format="%(asctime)s %(message)s")
LOG = logging.getLogger("Demo")



def main():
    receiver = Register()
    
    @receiver.message_register(isDivision=True, isGroup=True, isPyq=False)
    def process_msg(bot: Wcf, msg: WxMsg):
        """
        同步消息函数装饰器
        """
        LOG.info(f"收到消息: {msg}")
        
        sleep(5)  # 等微信加载好，以免信息显示异常
        LOG.info(f"已经登录: {True if bot.is_login() else False}")
        LOG.info(f"wxid: {bot.get_self_wxid()}")
    
        # bot.disable_recv_msg() # 当需要停止接收消息时调用
        sleep(5)
        ret = bot.send_text("Hello world.", "filehelper")
        LOG.info(f"send_text: {ret}")
    
        sleep(5)
        # 需要确保图片路径正确，建议使用绝对路径（使用双斜杠\\）
        ret = bot.send_image("https://raw.githubusercontent.com/lich0821/WeChatFerry/master/assets/QR.jpeg", "filehelper")
        LOG.info(f"send_image: {ret}")
    
        sleep(5)
        # 需要确保文件路径正确，建议使用绝对路径（使用双斜杠\\）
        ret = bot.send_file("https://raw.githubusercontent.com/lich0821/WeChatFerry/master/README.MD", "filehelper")
        LOG.info(f"send_file: {ret}")
    
        sleep(5)
        LOG.info(f"Message types:\n{bot.get_msg_types()}")
        LOG.info(f"Contacts:\n{bot.get_contacts()}")
    
        sleep(5)
        LOG.info(f"DBs:\n{bot.get_dbs()}")
        LOG.info(f"Tables:\n{bot.get_tables('db')}")
        LOG.info(f"Results:\n{bot.query_sql('MicroMsg.db', 'SELECT * FROM Contact LIMIT 1;')}")
    
        # 需要真正的 V3、V4 信息
        # bot.accept_new_friend("v3", "v4")
    
        # 添加群成员，填写正确的群 ID 和成员 wxid
        # ret = bot.add_chatroom_members("chatroom id", "wxid1,wxid2,wxid3,...")
        # LOG.info(f"add_chatroom_members: {ret}")
    
        # 删除群成员，填写正确的群 ID 和成员 wxid
        # ret = bot.del_chatroom_members("chatroom id", "wxid1,wxid2,wxid3,...")
        # LOG.info(f"add_chatroom_members: {ret}")
    
        sleep(5)
        bot.refresh_pyq(0)  # 刷新朋友圈第一页
        # bot.refresh_pyq(id)  # 从 id 开始刷新朋友圈

    @receiver.async_message_register()
    async def async_process_msg(bot: Wcf, msg: WxMsg):
        """
        异步消息函数装饰器
        """
        print(msg)

    # 开始接受消息
    receiver.run()


if __name__ == "__main__":
    main()

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

一起开发

配置环境

# 创建虚拟环境
python -m venv .env
# 激活虚拟环境
source .env/Scripts/activate
# 升级 pip
pip install --upgrade pip
# 安装依赖包
pip install grpcio-tools pynng

重新生成 PB 文件

# CMD
cd clients\wcfautopy\wcferry
python -m grpc_tools.protoc --python_out=. --proto_path=..\..\..\WeChatFerry\rpc\proto\ wcf.proto

# GitBash
cd clients/wcfautopy/wcferry
python -m grpc_tools.protoc --python_out=. --proto_path=../../../WeChatFerry/rpc/proto/ wcf.proto

版本更新

39.0.3.0 (2023.09.28)

• 修复登录账号昵称超长报错问题

点击查看更多

版本号：w.x.y.z。

其中：

• w 是微信的大版本号，如 37 (3.7.a.a), 38 (3.8.a.a), 39 (3.9.a.a)
• x 是适配的微信的小版本号，从 0 开始
• y 是 WeChatFerry 的版本，从 0 开始
• z 是各客户端的版本，从 0 开始

功能：

• 检查登录状态
• 获取登录账号的 wxid
• 获取消息类型
• 获取所有联系人
• 获取所有好友
• 获取数据库
• 获取某数据库下的表
• 获取用户信息
• 发送文本消息（可 @）
• 发送图片（wcfautopy 客户端支持网络路径）
• 发送文件（wcfautopy 客户端支持网络路径）
• 允许接收消息
• 停止接收消息
• 执行 SQL 查询
• 接受好友申请
• 添加群成员
• 删除群成员
• 解密图片
• 获取朋友圈消息
• 某功能（Breaking Change）