QQ 聊天机器人小薇 2.1.0 发布!
本次发布加入了支持茉莉机器人,并且更容易搭建开发环境,在线显示登录二维码~
简介
XiaoV(小薇)是一个用 Java 写的 QQ 聊天机器人 Web 服务,可以用于社群互动:
- 监听多个 QQ 群消息,发现有“感兴趣”的内容时通过图灵机器人或百度机器人进行智能回复
- 监听到的 QQ 群消息可以配置推送到论坛某个接口上,以实现论坛弹幕或者动态聚合效果,请看实例
- 在论坛代码中调用小薇进行 QQ 消息推送,比如论坛有新帖时自动推送到 QQ 群
- 加小薇为好友后可通过暗号(key)让她群推消息
总之,如果你需要一个连通 QQ 群和论坛的机器人,小薇是个不错的选择!
作者
小薇的爸爸叫 Daniel,妈妈叫 Vanessa,其他好心人可以在这里看到。
体验
体验之前一定要先仔细看完这个帖子:如何正确地使用小薇 QQ 机器人
- 加 QQ 群 13139268,然后发消息“小薇,你好!”
加小薇(Q3082959578)和小薇的守护(Q316281008)为好友,然后将他们都邀请进你所在的群就可以开始调戏了请自建私服- 在论坛的社群动态页面可看到由 QQ 群同步过来的消息
FAQ
如何正确地使用小薇 QQ 机器人?
论坛帖子传送门。
为什么要单独做成一个 Web 服务,而不是一个依赖 jar?
做成依赖库的话会随应用部署,从开发的角度是比较方便,但有个致命的问题是应用一般是部署在云端,而登录扫码是在本地,这样会造成 QQ 的异地登录,导致很多问题。
所以需要将小薇部署在本地,保证用手机和小薇启动后 QQ 不出现异地登录。但是这也需要解决一个问题,即需要为小薇提供“内网穿透”的能力,比如使用 ngrok,具体可参考这里。
为什么会出现“发送失败,Api返回码[1202]”?
这个问题是因为 QQ 服务器判断消息有问题时的返回,具体可关注这个 issue。
目前已经使用“小薇的守护”进行了改进,大幅度提升了消息发送的成功率。
出现“Api返回码[103]”怎么破?
先关闭小薇,然后将小薇、小薇的守护两个账号依次分别登录 w.qq.com 后在设置中退出登录,最后再次启动小薇,这时扫码后应该就不会 103 了。
报错 Group list error [groupId=xxxx], please report this bug to developer… 怎么破?
同 103 错误处理步骤。
为什么输出日志是乱码?
是由于控制台编码造成,可以在将 src/main/resources/log4j.properties 中加入 log4j.appender.stdout.Encoding=UTF-8 来解决。
发现问题该怎么反馈?
启动
- 安装好 Java 1.7+、Maven 2+
- Clone 本项目,并在项目根目录上执行
mvn jetty:run
这样小薇就启动了,然后根据输出提示进行扫码登录:
- 第一次扫码是小薇登录
- 第二次扫码是小薇的守护登录(如果启用了守护才会需要扫第二次码)
小薇的守护只需要和小薇在同一个群就行(守护不要用自己的,需要用一个不发消息的 QQ,不然消息监听会有问题)。
另外,如果你一定要在服务器上启动小薇(但真心不建议,请参考 FAQ 第二条):
- 打 war 包部署自己的容器,需要修改 latke.props 中的
serverHost
为你服务器的公网 IP、serverPort
为你容器监听的端口,如果你用了反向代理,那么serverHost
可能就是你绑定的域名、serverPort
是 80。简而言之,这两个值是你最终访问接口时候的值 - 登录的扫码可能有点麻烦,这时可以通过 /login 地址来访问二维码,哥考虑得周到吧 :smirk: (其实得感谢 @abinnz 和 @red3 在这个改进上面所提出的建议)
配置
配置文件主要是 src/main/resources/xiaov.properties:
- turing.api & turing.key 定义了图灵机器人的 API 地址和口令
- baidu.cookie 定义了百度机器人访问需要的 Cookie(登录百度,然后抓包)
- qq.bot.type 定义了机器人类型,1 是使用图灵机器人,2 则使用百度机器人
- qq.bot.name 定义了机器人的名字,这个主要是用于识别群消息是否“感兴趣”,比如对于群消息:“小薇,你吃过饭了吗?”包含了机器人的名字,机器人就对其进行处理
- qq.bot.key 定义了管理 QQ 或论坛发过来的消息群推的口令,需要消息开头是这个口令,验证过后才会群推后面的消息内容
- qq.bot.pushGroups 定义了群推的群名,用
,
分隔多个群;也可以配置成*
推送所有群 - qq.bot.pushGroupUserCnt 定义了群推时群人数的下限,只有大于等于这个人数的群才推送
- qq.bot.ack 定义了是否启用消息送达确认机制(小薇的守护),默认不启用
- bot.follow.keywords 定义了监听群消息时的关键词,碰到这些词就做处理,比如对于群消息:“如何能在 3 天内精通 Java 呢?”包含了关键词 Java,机器人就对其进行处理
- bot.follow.keywordAnswer 定义了监听群消息时出现了关键词后的回复模版
- forum.api & forum.key 定义了论坛 API 地址和口令,小薇会将所有监听到的消息通过该 API 转发到论坛
API
论坛推送 QQ 群
- 功能:小薇提供给论坛调用的 HTTP 接口,用于将论坛的内容推送到 QQ 群
- URL:/qq
- Method:POST
- QueryStr:key={qq.bot.key}&msg={msgcontent}(也可以放到 Body 里面)
- 例如:/qq?key=123456&msg=Hello
QQ 群推送论坛
- 功能:由论坛提供给小薇调用的 HTTP 接口,用于将 QQ 群消息推送到论坛(这个接口是论坛实现的,这里是给出小薇的调用方式和参数)
- URL:{forum.api}
- Method:POST
- QueryStr:key={forum.key}&msg={msgcontent}&user={hexuserid}
- 例如:/xiaov?key=123456&msg=Hello&user=0a
鸣谢
小薇的诞生离不开以下开源项目/产品服务:
- Smart QQ Java:封装了 SmartQQ(WebQQ)的 API,完成 QQ 通讯实现
- 图灵机器人:赋予了小薇抖机灵的能力
- 百度机器人:再次赋予了小薇抖机灵的能力
- 茉莉机器人:再再次赋予了小薇抖机灵的能力
- Latke:简洁高效的 Java Web 框架
其他教程
如果上面的文档看得一头雾水(作者语文高考差点不及格,见谅),请看下面由热心开发者提供的图文并茂、绘声绘色的、认真的教程:
PS:附送一批黑客派论坛注册邀请码:
wgXvmqHEZ119YoiE
FmQBnsAirHKFmdIU
rVXqTa27xnhl2vF8
CMQvkzQGQhKILw0A
aPBE2B3nEnFuA6xD
5kwXwkYDEMPF9jpt
LeAVaxR5L0HhkKYJ
3oNgY58dpDU3s7dT
HX21YNhK0Goz64S8
bHAnNbsJTIy0MlIx
如果邀请码都被使用了,请加 QQ 群 13139268 后找管理要吧 :-p
QQ 聊天机器人小薇 2.1.0 发布!的更多相关文章
- QQ 聊天机器人小薇 2.0.0 发布!
本次发布主要加入了支持讨论组聊天,并增强了稳定性.另外,官方小薇 QQ 机器人已经下线,大家要体验的话请 自建私服~ 简介 XiaoV(小薇)是一个用 Java 写的 QQ 聊天机器人 Web 服务, ...
- QQ 聊天机器人小薇 1.0.1 发布!
本次发布主要解决了消息丢失(Api返回码[1202])问题,并改进了改进了一些细节. 简介 XiaoV(小薇)是一个用 Java 写的 QQ 聊天机器人 Web 服务,可以用于社群互动: 监听多个 Q ...
- QQ 聊天机器人小薇发布!
简介 XiaoV(小薇)是一个用 Java 写的 QQ 聊天机器人 Web 服务,可以用于社群互动: 监听多个 QQ 群消息,发现有"感兴趣"的内容时通过图灵机器人进行智能回复 监 ...
- QQ 聊天机器人API
QQ机器人是腾讯陆续推出的的人工智能聊天机器人的总称. 都说小Q妹妹聪明好学,我们能够教她说话.也能够请他帮忙查询邮编.手机号,或者解释成语.翻译成语,据说她还会查询手机号码归属地.应用科学计算器. ...
- QQ聊天机器人 Delphi代码
QQ聊天机器人 前几日,看到杂志上有一篇关于开发QQ聊天机器人的文章.谈到了对QQ循环发送消息内容,感觉倒也很好玩,于是拿起Delphi开始了我的QQ聊天机器人之路. 首先要明白自己要做什么, ...
- python3+qqBot+图灵机器人实现qq聊天机器人
原理: 通过Python3的qqBot开源库,基于腾讯的smartQQ协议登录个人QQ,实现监控.收集QQ消息,进而通过图灵机器人API接入方式实现自动聊天. 零.前期准备: 1.Python3 2. ...
- QQ聊天机器人for PHP版 (登录,收、发消息)
<?php include "http_no_cookie.class.php"; class qq { public $sid; public $http; public ...
- PIGCMS 关闭聊天机器人(小黄鸡)
无脑操作举例 1.找到 WeixinAction.class.php 文件,路径: 你的版本\PigCms\Lib\Action\Home 2.查询 function chat ,在 chat() 函 ...
- 调用聊天机器人 -小I机器人
public static string sendMsg2(string msg) { try { msg = Uri.EscapeDataString( msg); string sUrl = &q ...
随机推荐
- CountDownLatch、CyclicBarrier和 Semaphore
在java 1.5中,提供了一些非常有用的辅助类来帮助我们进行并发编程,比如CountDownLatch,CyclicBarrier和Semaphore,今天我们就来学习一下这三个辅助类的用法. 以下 ...
- jinja url_for js 参数
在JavaScript中,也就是客户端,向flask路由服务器端使用post请求并在url_for中传递参数,服务器端获取不到该参数, Jinja不能使用Javascript变量,如下所示: var ...
- 南昌网络赛 I. Max answer (单调栈 + 线段树)
https://nanti.jisuanke.com/t/38228 题意给你一个序列,对于每个连续子区间,有一个价值,等与这个区间和×区间最小值,求所有子区间的最大价值是多少. 分析:我们先用单调栈 ...
- 让 Linux grep 的输出不换行
在Redhat中亲测. 本来ps -ef的输出是不会换行的,但是 ps -ef | grep java 就换行了. 如果想让grep完的结果不要换行,找到两种方法. 1. 在后面拼接 less -S: ...
- javascript语言使用技巧及注意事项总结
1.首次为变量赋值时务必使用var关键字 变量没有声明而直接赋值得话,默认会作为一个新的全局变量,要尽量避免使用全局变量. var a=b=10;//其中a是局部变量,b是全局变量 2.使用===比= ...
- Oracle练习笔记
1 基本查询 SQL> --当前用户 SQL> show user USER 为 "SCOTT" SQL> --当前用户下的表 SQL> select * ...
- 公司Git实用记录
一.git命令名词解释 1.添加/跟踪/暂存:添加到本地索引 git add 文件名 2.提交:提交到本地仓库 git commit -m '注释' 3.推送:将提交到本地仓库的所有更新提交到服务器 ...
- memcached 学习笔记 3
适合什么场合 memcached不是万能的,它也不是适用在所有场合. Memcached是“分布式”的内存对象缓存系统,那么就是说,那些不需要“分布”的,不需要共享的,或者干脆规模小到只有一台服务器的 ...
- HDU 1102 Constructing Roads(kruskal)
Constructing Roads There are N villages, which are numbered from 1 to N, and you should build some r ...
- ExcelHelper----根据指定样式的数据,生成excel(一个sheet1页)文件流
/// <summary> /// Excel导出类 /// </summary> public class ExcelHelper { /// <summary> ...