wechat go

WECHAT-GO

Leia antes do uso:

• O WeChat, que logou na versão da Web da Web antes do final de junho de 2017, pode usar essa estrutura para verificar se o WeChat suporta a API da versão da Web. Clique em https://wx.qq.com/ e digitalize o código para verificar. Se você não puder fazer login, ele não será aplicável a essa estrutura.

introduzir

A implementação GO da API da versão da Web WeChat simula o login/contato/mensagem de envio e recebimento de funções da versão da Web WeChat. Ele pode assumir completamente as mensagens recebidas pelo WeChat e personalizar seu próprio conteúdo de envio.

• Suporta vários usuários (abertura múltipla)
• Não suporta nenhum código de varredura para fazer login novamente após a desconexão
• A função é fornecida na forma de um plug-in e você pode optar por carregar ou não carregar um plug-in de acordo com o usuário (como situações pagas).
• Simples de escrever plug-ins, altamente personalizável, sem necessidade de se preocupar com API e distribuição de mensagens, o desenvolvimento secundário é extremamente conveniente
• Para plug-ins carregados, os usuários finais que usam robôs podem ligar/desligar dinamicamente a interface do WeChat Chat.
• Atualmente, reconhecimento de avatar (gênero/idade), pesquisa de gif, coleta de piadas, "queima depois de ler", encaminhamento entre grupos de mensagens, tradução chinesa-inglês e outros plug-ins interessantes
• Você pode enviar várias mensagens, como imagens/texto/gif/vídeo/expressão
• Suportar Linux/Macosx/Windows, Raspberry Pi também pode ser :)

Obtenha o código -fonte

 mkdir -p $GOPATH/src/golang.org/x
cd $GOPATH/src/golang.org/x
git clone https://github.com/golang/net.git

go get -u -v github.com/songtianyi/wechat-go
cd $GOPATH/src/github.com/songtianyi/wechat-go
go get ./...

Compilar e correr

Linux/Mac

 go build examples/linux/terminal_bot.go
./terminal_bot

Windows

A versão do Windows precisa ser gerada usando a compilação cruzada em sistemas que não são de janelas e, em seguida, é executado no Windows após a geração.

 GOOS=windows GOARCH=amd64 go build examples/windows/windows_bot.go
./windows_bot.exe
扫码图片需要用软件打开，路径在输出日志内.

Projeto de amostra

Go-Aida

a diferença

• Go-Aida é um robô funcional com uma página de código de varredura
• O WeChat-Go implementa a WeChat API e fornece uma estrutura de mensagem fácil de usar, mas não é um programa executável
• Apenas uma pequena quantidade de código para criar seu próprio robô personalizado com base no WeChat-go. Para necessidades mais complexas (digitalize a página de código, etc.), o Go-Aida pode ser usado.
• WeChat-go concentra-se nos três aspectos da estabilidade da API, facilidade de uso da estrutura, plug-ins em geral, etc.
• Go-Aida concentra-se na personalização personalizada de robôs

Código de amostra

Crie robôs personalizados baseados em WeChat-go

 package main

import (
	"github.com/songtianyi/rrframework/logs"
	"github.com/songtianyi/wechat-go/plugins/wxweb/faceplusplus"
	"github.com/songtianyi/wechat-go/plugins/wxweb/gifer"
	"github.com/songtianyi/wechat-go/plugins/wxweb/replier"
	"github.com/songtianyi/wechat-go/plugins/wxweb/switcher"
	"github.com/songtianyi/wechat-go/wxweb"
)

func main () {
	// 创建session, 一个session对应一个机器人
	// 二维码显示在终端上
	session , err := wxweb . CreateSession ( nil , nil , wxweb . TERMINAL_MODE )
	if err != nil {
		logs . Error ( err )
		return
	}

	// 注册插件, 所有插件默认是开启的
	faceplusplus . Register ( session )
	replier . Register ( session )
	switcher . Register ( session )
	gifer . Register ( session )

	// 你也可以自己选择关闭插件里的handler(消息处理器)
	session . HandlerRegister . DisableByName ( "faceplusplus" )

	// 登录并接收消息
	if err := session . LoginAndServe ( false ); err != nil {
		logs . Error ( "session exit, %s" , err )
	}
}

Lista de plugins

Switcher

Um plugin para gerenciar plugins

 #关闭某个插件, 在微信聊天窗口输入
disable faceplusplus
#开启某个插件, 在微信聊天窗口输入
enable faceplusplus
#查看所有插件信息, 在微信聊天窗口输入
dump

faceplusplus

Faça reconhecimento facial por fotos recebidas, retornar sexo e idade

Gifer

Use as mensagens de texto recebidas como palavras -chave para pesquisar GIFs e retornar o gráfico GIF. Observe que o GIF retornado pode ter uma escala em larga, como as mensagens de texto contêm palavras -chave como "poluído".

replier

Responda automaticamente às mensagens de texto/imagem recebidas e responda às mensagens de texto corrigidas

Laosj

Obtenha uma foto linda e entre na janela de bate -papo

美女

Palhaço

Obtenha uma piada e entre na janela de bate -papo

笑话

Revener

O plug-in de retirada de mensagens e as mensagens de texto enviadas pelo telefone celular serão retiradas automaticamente após 3 segundos. As mensagens enviadas pelo robô precisam escrever a lógica de retirada no plug-in correspondente.

sistema

O sistema solicita o processamento de retirada de mensagens/envelopes vermelhos, etc.

Encaminhador

Para encaminhamento de mensagens entre grupos, basta modificar a ortografia completa do nome do grupo no plug-in.

youdao

Plug-in de tradução chinês-inglês, baseado na API de tradução YouDAO

verificar

Aceitar automaticamente solicitações de amizade e pode ser filtrado de acordo com as condições

compartilhar

Exemplo de distribuição automática de recursos (House of Cards)

Config

Configurações de plug-in de gerenciamento de configuração, digite na janela de bate-papo

 set config key value

Verifique a configuração e digite -a na janela de bate -papo

 get config key

Usando a configuração no código

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

Faça seu próprio plug-in

Dois princípios de plug-ins personalizados

• Um plug-in completa apenas uma função e não adiciona vários manipuladores a um plug-in
• O plug -in está ativado por padrão

Exemplo de plug -in

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

import (
	"github.com/songtianyi/rrframework/logs" // 导入日志包
	"github.com/songtianyi/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 . Error ( "ignore the messages from" , msg . FromUserName )
		return
	}

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

	// 可选: 根据wxweb.User数据结构中的数据来过滤
	if contact . PYQuanPin != "songtianyi" {
		// 比如根据用户昵称的拼音全拼来过滤
		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

}