Awesome

新的开始

这边已经不再维护，但可继续使用。

可以关注新坑：ComWeChatBotClient ，使用onebot12协议，更方便做一些操作。

介绍

• ntchat的封装无头客户端，配合 ntchat-adapter 实现和Nonebot2通信
• 微信pc hook，需求在windows端或者wine环境

上游依赖

• ntchat：基于pc微信的api接口, 类似itchat项目

支持的微信版本

• WeChat3.6.0.18：安装后请更改配置，修改hosts等操作关闭自动更新。
• hosts文件添加：127.0.0.1 dldir1.qq.com

配置项

.env文件是项目配置文件

# 是否注入已开启微信进程
smart = True

# http api 地址
host = 127.0.0.1

# http api 端口
port = 8000

# http post上报地址，不填不会进行上报
http_post_url = ""

# ws主动连接地址，不填不会主动连接ws
ws_address = ""

# access_token验证密钥
access_token = ""

# 日志显示等级
log_level = "DEBUG"

# 日志保存天数
log_days = 10

# 事件过滤列表，列表填tpye的数字
msg_filter = []

# 是否上报自身消息
report_self = False

# 文件缓存地址
cache_path = "./file_cache"

# 文件缓存天数，为0则不清理缓存
cache_days = 3

# 聊天图片解密地址
image_path = "./image_decode"

# 聊天解密图片保存天数，为0则不清理缓存
image_days = 0

# 下载pc图片超时时间(s)，超时的图片不会解密
image_timeout = 30

# 超时的图片消息是否继续发送
timeout_image_send = False

与Nonebot2通信

目前支持反向websocket通信和http post通信

使用反向websocket

需要修改配置项：

# ws主动连接地址，不填不会主动连接ws
ws_address = "ws://127.0.0.1:8080/ntchat/ws"

• 这里127.0.0.1与nb2的host配置对应
• 这里8080与nb2的port配置对应

使用http post

需要修改配置项：

# http post上报地址，不填不会进行上报
http_post_url = "http://127.0.0.1:8080/ntchat/http"

• 这里127.0.0.1与nb2的host配置对应
• 这里8080与nb2的port配置对应

Http api

在连接到wechat后，会自动开启http api，访问http api需要注意：

• 当前api只支持post方法，get无法访问
• post访问请将参数放入body，编码规则使用JSON， Content-Type设置为application/json

响应数据模型

下面是api列表：

获取登录信息

api地址：/get_login_info

参数： 无

响应数据类型：dict

获取自己个人信息

api地址：/get_self_info

参数：无

响应数据类型：dict

获取联系人列表

api地址：/get_contacts

参数：无

响应数据类型：list[dict]

获取关注公众号列表

api地址：/get_publics

参数：无

响应数据类型：list[dict]

获取联系人详细信息

api地址：/get_contact_detail

参数：

响应数据类型：dict

根据wxid、微信号、昵称和备注模糊搜索联系人

api地址：/search_contacts

参数：

响应数据类型：list

获取群列表

api地址：/get_rooms

参数：无

响应数据类型：list[dict]

获取指定群详细信息

api地址：/get_room_detail

参数：

响应数据类型：dict

获取群名

api地址：/get_room_name

参数：

响应数据类型：str

获取群成员列表

api地址：/get_room_members

参数：

响应数据类型：list[dict]

发送文本消息

api地址：/send_text

参数：

响应数据类型：None

发送群@消息

api地址：/send_room_at_msg

参数：

响应数据类型：None

注意：

• 假如文本为："test,你好{$@},你好{$@}.早上好"
• 文本消息的content的内容中设置占位字符串 {$@},这些字符的位置就是最终的@符号所在的位置
• 假设这两个被@的微信号的群昵称分别为aa,bb
• 则实际发送的内容为 "test,你好@ aa,你好@ bb.早上好"(占位符被替换了)
• 占位字符串的数量必须和at_list中的微信数量相等.

发送名片

api地址：/send_card

参数：

响应数据类型：None

发送链接卡片

api地址：/send_link_card

参数：

响应数据类型：None

发送图片

api地址：/send_image

参数：

响应数据类型：None

注意：

图片地址目前支持：

• 绝对路径，采用file_uri，格式为file:///path
• 网络路径，支持http和https，格式：http://或https://
• base64，格式为：base64://values

发送文件

api地址：/send_file

参数：

响应数据类型：None

注意：

文件地址目前支持：

• 绝对路径，采用file_uri，格式为file:///path
• 网络路径，支持http和https，格式：http://或https://
• base64，格式为：base64://values

发送视频

api地址：/send_video

参数：

响应数据类型：None

注意：

视频地址目前支持：

• 绝对路径，采用file_uri，格式为file:///path
• 网络路径，支持http和https，格式：http://或https://
• base64，格式为：base64://values

发送gif

api地址：/send_gif

参数：

响应数据类型：None

注意：

gif地址目前支持：

• 绝对路径，采用file_uri，格式为file:///path
• 网络路径，支持http和https，格式：http://或https://
• base64，格式为：base64://values

发送xml消息

api地址：/send_xml

参数：

响应数据类型：None

发送拍一拍

api地址：/send_pat

参数：

响应数据类型：None

同意加好友请求

api地址：/accept_friend_request

参数：

响应数据类型：None

创建群

api地址：/create_room

参数：

响应数据类型：None

邀请好友入群

api地址：/invite_room_member

参数：

响应数据类型：None

删除群成员

api地址：/del_room_member

参数：

响应数据类型：None

注意：需要有相应权限

修改群名

api地址：/modify_room_name

参数：

响应数据类型：None

注意：需要有相应权限

修改群公告

api地址：/modify_room_notice

参数：

响应数据类型：None

注意：需要有相应权限

添加群成员为好友

api地址：/add_room_friend

参数：

响应数据类型：None

退出群

api地址：/quit_room

参数：

响应数据类型：None

修改好友备注

api地址：/modify_friend_remark

参数：

响应数据类型：None

获取群名

api地址：/get_room_name

参数:

响应数据类型：str