wechat-go

微信web版API的go实现，模拟微信网页版的登录／联系人／消息收发等功能，可以完全接管微信收到的消息, 并定制自己的发送内容

支持多用户(多开)
支持掉线后免扫码重登
功能以插件的形式提供，可以根据用户(比如付费情况）选择加载或者不加载某插件
插件编写简单, 可定制性强, 无需关心API和消息分发，二次开发极为方便
对于加载的插件, 使用机器人的终端用户可以通过微信聊天界面动态开启/关闭.
目前已提供头像(性别／年龄)识别, gif搜索, 笑话大全, "阅后即焚", 消息跨群转发, 中英互译等多个有趣插件
可以发送图片/文字/gif/视频/表情等多种消息
支持Linux/MacOSX/Windows, 树莓派也可以:)

获取源码

git clone github.com/oldthreefeng/wechat-go.git
go mod download

编译并运行

linux/mac

cd wechat-go
go build .

插件

插件列表

switcher

一个管理插件的插件

#关闭某个插件, 在微信聊天窗口输入
disable faceplusplus

#开启某个插件, 在微信聊天窗口输入
enable faceplusplus

#查看所有插件信息, 在微信聊天窗口输入
dump

faceplusplus

对收到的图片做面部识别，返回性别和年龄

gifer

以收到的文字消息为关键字做gif搜索，返回gif图, 注意返回的gif可能尺度较大，比如文字消息中包含“污”等关键词。

replier

对收到的文字/图片消息，做自动应答，回复固定文字消息

laosj

随机获取一张美女图片, 在聊天窗口输入美女

joker

获取一则笑话, 在聊天窗口输入笑话

revoker

消息撤回插件, 3s后自动撤回手机端所发的文本消息. 机器人发出的消息需要自己在对应插件里写撤回逻辑.

system

处理消息撤回/红包等系统提示

forwarder

消息跨群转发, 在插件里修改群名的全拼即可.

youdao

中英互译插件, 基于有道翻译API

verify

自动接受好友请求, 可以按条件过滤

资源(纸牌屋)自动分发示例

config

配置管理插件设置配置, 在聊天窗口输入

set config key value

查看配置，在聊天窗口输入

get config key

在代码中使用配置

import "github.com/oldthreefeng/wechat-go/kv"
func demo() {
	kv.KVStorageInstance.Set("key", "value")
	v := kv.KVStorageInstance.Get("key")
	if v == nil {
		return
	}
	// v.(string) etc.
}

制作自己的插件

自定义插件的两个原则

一个插件只完成一个功能，不在一个插件里加入多个handler
插件默认开启

插件示例

package demo // 以插件名命令包名

import (
	"github.com/oldthreefeng/wechat-go/logs" // 导入日志包
	"github.com/oldthreefeng/wechat-go/wxweb"  // 导入协议包
)

// 必须有的插件注册函数
// 指定session, 可以对不同用户注册不同插件
func Register(session *wxweb.Session) {
	// 将插件注册到session
	// 第一个参数: 指定消息类型, 所有该类型的消息都会被转发到此插件
	// 第二个参数: 指定消息处理函数, 消息会进入此函数
	// 第三个参数: 自定义插件名，不能重名，switcher插件会用到此名称
	session.HandlerRegister.Add(wxweb.MSG_TEXT, wxweb.Handler(demo), "textdemo")

	// 开启插件
	if err := session.HandlerRegister.EnableByName("textdemo"); err != nil {
		logs.Error(err)
	}
}

// 消息处理函数
func demo(session *wxweb.Session, msg *wxweb.ReceivedMessage) {

	// 可选: 可以用contact manager来过滤, 比如过滤掉没有保存到通讯录的群
	// 注意，contact manager只存储了已保存到通讯录的群组
	contact := session.Cm.GetContactByUserName(msg.FromUserName)
	if contact == nil {
		logs.Warn("ignore the messages from %v, cause you don't save the contact", msg.FromUserName)
		return
	}

	// 可选: 根据消息类型来过滤
	if msg.MsgType == wxweb.MSG_IMG {
		return
	}

	// 可选: 根据wxweb.User数据结构中的数据来过滤
	if contact.PYQuanPin != "oldthreefeng" {
		// 比如根据用户昵称的拼音全拼来过滤
		return
	}

	// 可选: 过滤和自己无关的群组消息
	if msg.IsGroup && msg.Who != session.Bot.UserName {
		return
	}

	// 取出收到的内容
	// 取text
	logs.Info(msg.Content)
	//// 取img
	//if b, err := session.GetImg(msg.MsgId); err == nil {
	//	logs.Debug(string(b))
	//}

	// anything

	// 回复消息
	// 第一个参数: 回复的内容
	// 第二个参数: 机器人ID
	// 第三个参数: 联系人/群组/特殊账号ID
	session.SendText("plugin demo", session.Bot.UserName, wxweb.RealTargetUserName(session, msg))
	// 回复图片和gif 参见wxweb/session.go

}

oldthreefeng/wechat-go