QQ 聊天机器人小薇 2.0.0 发布！

本次发布主要加入了支持讨论组聊天，并增强了稳定性。另外，官方小薇 QQ 机器人已经下线，大家要体验的话请 自建私服~

简介

XiaoV（小薇）是一个用 Java 写的 QQ 聊天机器人 Web 服务，可以用于社群互动：

监听多个 QQ 群消息，发现有“感兴趣”的内容时通过图灵机器人或百度机器人进行智能回复
监听到的 QQ 群消息可以配置推送到论坛某个接口上，以实现论坛弹幕或者动态聚合效果，请看实例
在论坛代码中调用小薇进行 QQ 消息推送，比如论坛有新帖时自动推送到 QQ 群
加小薇为好友后可通过暗号（key）让她群推消息

总之，如果你需要一个连通 QQ 群和论坛的机器人，小薇是个不错的选择！

作者

小薇的爸爸叫 Daniel，妈妈叫 Vanessa，其他好心人可以在这里看到。

体验

体验之前一定要先仔细看完这个帖子：如何正确地使用小薇 QQ 机器人

加 QQ 群 13139268，然后发消息“小薇，你好！”
请自建私服进行体验
在论坛的社群动态页面可看到由 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 来解决。

发现问题该怎么反馈？

论坛发帖（推荐做法）
New Issue

启动

安装好 Java 1.7+、Maven 2+
Clone 本项目，并在项目根目录上执行 mvn jetty:run

这样小薇就启动了，然后根据输出提示进行扫码登录，一共需要扫两次：

第一次扫码是小薇登录
第二次扫码是小薇的守护登录

小薇的守护只需要和小薇在同一个群就行（但不要用自己的，需要用一个不发消息的 QQ，不然消息监听会有问题）。

配置

配置文件主要是 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.ack 定义了是否启用消息送达确认机制（小薇的守护），默认不启用
bot.follow.keywords 定义了监听群消息时的关键词，碰到这些词就做处理，比如对于群消息：“如何能在 3 天内精通 Java 呢？”包含了关键词 Java，机器人就对其进行处理
bot.follow.keywordAnswer 定义了监听群消息时出现了关键词后的回复模版
forum.api & forum.key 定义了论坛 API 地址和口令，小薇会将所有监听到的消息通过该 API 转发到论坛

API

论坛推送 QQ 群

功能：小薇提供给论坛调用的 HTTP 接口，用于将论坛的内容推送到 QQ 群
URL：/qq
Method：POST
Body：key={qq.bot.key}&msg={msgcontent}

QQ 群推送论坛

功能：由论坛提供给小薇调用的 HTTP 接口，用于将 QQ 群消息推送到论坛（这个接口是论坛实现的，这里是给出小薇的调用方式和参数）
URL：{forum.api}
Method：POST
Body：key={forum.key}&msg={msgcontent}&user={hexuserid}

鸣谢

小薇的诞生离不开以下开源项目/产品服务：

Smart QQ Java：封装了 SmartQQ（WebQQ）的 API，完成 QQ 通讯实现
图灵机器人：赋予了小薇抖机灵的能力..
百度机器人：再次赋予了小薇抖机灵的能力….
Latke：简洁高效的 Java Web 框架

PS：附送一批黑客派论坛注册邀请码：

XYAkBM4DweKCbvvg

xsFDlaomf2fJhaTA

spTg8t7EXn7IEar0

hmW0XO9NCQxbUV6x

sTg5mL765N0opuWj

OOKWTAve3cwQNt9k

YZOGMPp37Br57QBv

BhvUIQI3sBuwtdBV

YF6BTnVG6sELASl4

GI8xRXfksdijdNTq

pWfFuv5pMNNs8txj

YfRujj58780IefrV

Ia97uAHBLIRLjT5H

aKrjmKMy7KFI5ysg

eIfthzHMhrRdi2Lq

wDFgQoIzW3774dHH

SWFt3FoqxxXZ4RcD

mJ3zkdNyatnzqCaM

Dc3YxT7Cebqn3fBQ

ndlRQp9iAAUssKV0