wechat go

wechat-go

사용하기 전에 읽기 :

• 2017 년 6 월 말 이전에 웹 버전의 웹 버전에 로그인 한 WeChat 은이 프레임 워크를 사용하여 WeChat이 웹 버전 API를 지원하는지 여부를 확인할 수 있습니다. https://wx.qq.com/을 클릭하고 코드를 스캔하여 확인하십시오. 로그인 할 수없는 경우이 프레임 워크에 적용되지 않습니다.

소개하다

WeChat 웹 버전 API의 GO 구현은 WeChat 웹 버전의 로그인/연락처/메시지 전송 및 수신 기능을 시뮬레이션합니다. WeChat에서받은 메시지를 완전히 인수하고 자신의 전송 내용을 사용자 정의 할 수 있습니다.

• 여러 사용자를 지원합니다 (다중 개방)
• 연결을 끊은 후 다시 로그인 할 스캔 코드가 없습니다.
• 이 기능은 플러그인 형식으로 제공되며 사용자 (예 : 유료 상황)에 따라 플러그인을로드하거나로드하지 않도록 선택할 수 있습니다.
• 글을 쓰기 쉬운 플러그인, 고도로 사용자 정의 가능하며 API 및 메시지 배포에 관심이 없으며 2 차 개발이 매우 편리합니다.
• 로드 된 플러그인의 경우 로봇을 사용하는 최종 사용자는 WeChat 채팅 인터페이스를 통해 동적으로 켜지거나 꺼질 수 있습니다.
• 현재 Avatar (Gender/Age) 인식, GIF 검색, 농담 컬렉션, "Burn After Reading", Message Cross-Group 전달, 중국어-영어 번역 및 기타 흥미로운 플러그인
• 사진/텍스트/gif/비디오/표현과 같은 다양한 메시지를 보낼 수 있습니다
• Linux/MacOSX/Windows 지원, Raspberry Pi도 가능합니다 :)

소스 코드를 얻으십시오

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

컴파일하고 실행하십시오

리눅스/맥

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

창

Windows 버전은 비 원도 시스템에서 교차 컴파일을 사용하여 생성 한 다음 세대 후 Windows에서 실행해야합니다.

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

샘플 프로젝트

고-에다

차이

• Go-Aida는 스캔 코드 페이지가있는 기능적인 로봇입니다.
• WeChat-Go는 WeChat API를 구현하고 사용하기 쉬운 메시지 프레임 워크를 제공하지만 실행 가능한 프로그램은 아닙니다.
• wechat-go를 기반으로 자신만의 개인화 된 로봇을 만들기위한 소량의 코드 만. 보다 복잡한 요구 (코드 페이지 스캔 등)를 위해 Go-Aida를 사용할 수 있습니다.
• Wechat-Go는 API 안정성의 세 가지 측면, 프레임 워크 사용 편의성, 일반 플러그인 등에 중점을 둡니다.
• Go-Aida는 로봇의 개인화 된 사용자 정의에 중점을 둡니다

샘플 코드

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

플러그인 목록

스위처

플러그인 관리를위한 플러그인

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

faceplusplus

받은 사진, 성별 및 나이에 대한 얼굴 인정

선물

수신 된 문자 메시지를 키워드로 사용하여 GIF를 검색하고 GIF 그래프를 반환하십시오. 반환 된 GIF는 문자 메시지에 "오염 된"과 같은 키워드가 포함 된 대규모가있을 수 있습니다.

대답

수신 된 텍스트/사진 메시지에 자동으로 응답하고 고정 문자 메시지에 응답

laosj

무작위로 아름다운 사진을 얻고 채팅 창에 입력하십시오.

美女

조커

농담을 받고 채팅 창에 입력하십시오.

笑话

수요

메시지 인출 플러그인 및 휴대폰에서 전송 된 문자 메시지는 3 초 후에 자동으로 철회됩니다. 로봇이 보낸 메시지는 해당 플러그인에 인출 로직을 작성해야합니다.

체계

메시지 철수/빨간 봉투 등을 처리하기위한 시스템 프롬프트 등

전환기

그룹 간 메시지를 전달하려면 플러그인에서 그룹 이름의 전체 철자를 수정하십시오.

Youdao

YouDAO Translation API를 기반으로 한 중국어 영어 번역 플러그인

확인하다

친구 요청을 자동으로 수락하고 조건에 따라 필터링 할 수 있습니다.

공유하다

자원의 자동 분포 예 (집)

구성

구성 관리 플러그인 설정, 채팅 창을 입력하십시오

 set config key value

구성을 확인하고 채팅 창에 입력하십시오.

 get config key

코드에서 구성 사용

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

나만의 플러그인을 만드십시오

맞춤형 플러그인의 두 가지 원칙

• 플러그인은 하나의 기능 만 완료하고 플러그인에 여러 핸들러를 추가하지 않습니다.
• 플러그인은 기본적으로 활성화됩니다

플러그인 예제

 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

}