wechat go

WeChat-Go

Baca sebelum digunakan:

• WeChat, yang masuk ke versi web web sebelum akhir Juni 2017, dapat menggunakan kerangka kerja ini untuk memverifikasi apakah WeChat mendukung API versi web. Silakan klik https://wx.qq.com/ dan pindai kode untuk memverifikasi. Jika Anda tidak dapat masuk, itu tidak akan berlaku untuk kerangka kerja ini.

memperkenalkan

Implementasi GO dari WeChat Web Version API mensimulasikan login/kontak/pesan pengiriman dan penerima fungsi WeChat Web Version. Ini sepenuhnya dapat mengambil alih pesan yang diterima oleh WeChat dan menyesuaikan konten pengiriman Anda sendiri.

• Mendukung banyak pengguna (pembukaan berganda)
• Tidak mendukung kode pemindaian untuk masuk lagi setelah pemutusan
• Fungsi disediakan dalam bentuk plug-in, dan Anda dapat memilih untuk memuat atau tidak memuat plug-in sesuai dengan pengguna (seperti situasi berbayar).
• Sederhana untuk menulis plug-in, sangat dapat disesuaikan, tidak perlu peduli tentang API dan distribusi pesan, pengembangan sekunder sangat nyaman
• Untuk plug-in yang dimuat, pengguna akhir yang menggunakan robot dapat dinyalakan secara dinamis melalui antarmuka obrolan WeChat.
• Saat ini, pengakuan avatar (jenis kelamin/usia), pencarian gif, koleksi lelucon, "bakar setelah membaca", penerusan silang pesan, terjemahan Cina-Inggris dan plug-in yang menarik lainnya
• Anda dapat mengirim berbagai pesan seperti gambar/teks/gif/video/ekspresi
• Dukungan Linux/Macosx/Windows, Raspberry Pi juga bisa :)

Dapatkan Kode Sumber

 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 ./...

Kompilasi dan jalankan

Linux/Mac

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

Windows

Versi Windows perlu dihasilkan menggunakan kompilasi silang pada sistem non-windows, dan kemudian dijalankan di bawah Windows setelah generasi.

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

Proyek Sampel

Go-Aida

perbedaannya

• Go-Aida adalah robot fungsional dengan halaman kode pemindaian
• WeChat-Go mengimplementasikan WeChat API dan menyediakan kerangka pesan yang mudah digunakan, tetapi ini bukan program yang dapat dijalankan
• Hanya sejumlah kecil kode untuk membuat robot pribadi Anda sendiri berdasarkan Wechat-Go. Untuk kebutuhan yang lebih kompleks (pindai halaman kode, dll.), Go-Aida dapat digunakan.
• Wechat-GO berfokus pada tiga aspek stabilitas API, kerangka kerja kemudahan penggunaan, plug-in umum, dll.
• Go-Aida berfokus pada penyesuaian robot yang dipersonalisasi

Kode sampel

Buat robot khusus berdasarkan 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 )
	}
}

Daftar Plugin

Switcher

Plugin untuk mengelola plugin

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

faceplusplus

Apakah pengakuan wajah untuk gambar yang diterima, kembali jenis kelamin dan usia

Gifer

Gunakan pesan teks yang diterima sebagai kata kunci untuk mencari GIF dan mengembalikan grafik GIF. Perhatikan bahwa GIF yang dikembalikan mungkin memiliki skala besar, seperti pesan teks berisi kata kunci seperti "tercemar".

Replier

Secara otomatis menanggapi pesan teks/gambar yang diterima dan membalas pesan teks yang diperbaiki

Laosj

Dapatkan gambar yang indah secara acak dan masukkan di jendela obrolan

美女

Pelawak

Dapatkan lelucon dan masukkan di jendela obrolan

笑话

Revoker

Plug-in penarikan pesan, dan pesan teks yang dikirim oleh ponsel akan ditarik secara otomatis setelah 3 detik. Pesan yang dikirim oleh robot perlu menulis logika penarikan di plug-in yang sesuai.

sistem

Sistem meminta untuk memproses penarikan pesan/amplop merah, dll.

Ekspeditur

Untuk meneruskan pesan di seluruh grup, cukup ubah ejaan penuh dari nama grup di plug-in.

yodao

Plug-in Terjemahan Cina-Inggris, Berdasarkan API Terjemahan YouDAO

memeriksa

Secara otomatis menerima permintaan pertemanan, dan dapat disaring sesuai dengan kondisi

membagikan

Contoh distribusi sumber daya otomatis (House of Cards)

konfigurasi

Pengaturan plug-in manajemen konfigurasi, masukkan di jendela obrolan

 set config key value

Periksa konfigurasi dan masukkan di jendela obrolan

 get config key

Menggunakan konfigurasi dalam kode

 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.
}

Buat plug-in Anda sendiri

Dua prinsip plug-in kustom

• Plug-in hanya menyelesaikan satu fungsi, dan tidak menambahkan beberapa penangan ke plug-in
• Plugin diaktifkan secara default

Contoh Plugin

 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

}