The iotqq from killeder

IOTQQ --为跨平台而生

运行在Mac平台

运行在树莓派3B+ 1G RAM

运行在电视盒子 N1

运行在路由器HIWI-FI

⚠️使用协议⚠️

IOTQQ 不得用于包括且不限于~~赌博、色情、云盘、政治~~ 等网络违法违规服务，违者必究
用户不得使用 IOTQQ 来进行批量业务，如：批量加群，加好友等。
用户在使用本软件过程中，应遵守当地法律法规与深圳市腾讯计算机系统有限公司用户协议中相关行为规范，且用户不能使用本软件进行以下行为，包括但不限于：广告传播、黑产、黄、赌、毒、PC蛋蛋、北京赛车、黑色产业、灰色产业、算账下注、群发、批量加群等任何违法犯罪或与犯罪相关，用户使用本软件进行相关违法犯罪的行为，均应由用户自行承担，IOTQQ不对用户的任何言行与行为承担任何责任
免责声明：IOTQQ软件是一款基于QQ协议的AI机器人软件，主要用于活跃QQ群气氛、管理群、群内娱乐活动等，协议版权归属于深圳市腾讯计算机系统有限公司所有，如有侵权请联系邮箱([email protected])，将会对软件下架并删除相关内容。

🆕树莓派运行展示🆕

芝麻开门 VNC 密码12345678

IOTQQ功能	Free ⬆️
`好友消息收发语音文字图文XML/JSON`	✅
`群组消息收发语音文字图文XML/JSON`	✅
`私聊消息收发语音文字图文XML/JSON`	✅
`Open RedBag`	✅
`Send RedBag`	❌
`QQ空间发图文`	❌
`群邀请/踢人/加群`	✅
`好友通过/拒绝/加人`	✅
`账号登陆`	❌
`多账号登陆`	❌

项目介绍

⚠️运行项目的必要条件需要外网IP用来接收GitHub的WebHook通知非外网用户可以借助转发工具来解决如

frp

ngrok

🆓
🌞采用独特的插件机制 --Lua
🌞提供WebSocket （SocketIO）
🌞提供Web API
🌞内置协程池高效稳定迸发
🌞完成了大部分核心接口其他必要接口将后续更新可在issues中提出 bug or todo
不断电稳定运行 0 崩错误日志将会在log中体现

💗开启运行之旅

fmt.Println("Github Token 会用来创建通知仓库 如果不放心使用 请建立小号 初始化所有操作记得清空Bot-Notify 仓库")

1⃣️下载对应平台版本的二进制包传送门

2⃣️申请GitHub Token 用于GitHubApi访问默认限制每小时60次请求有了Token可以5000/h 申请流程登陆GitHub后->settings-> Developer settings->Developer settings->Generate New Token 开启全部Token权限!全部☑️

3⃣️填写配置文件CoreConf.conf 首先配置Token 后启动程序

  #默认使用本地配置文件 暂时不支持集群模式
  EnabledEtcd = false
  #自定义监听服务端口
  Port = "0.0.0.0:8888"
    [Etcd]
      Nodes = ["", "", ""]
    [GithubConf]
      #必填 GitHub申请回来的Token
      Token = ""
      #初始化软件自动生成 请勿填写
      FullName = ""
      #初始化软件自动生成 请勿填写
      IssuesNum = 1
      #必填域名端口替换成外网的http://IP:PORT/v1/Github/WebHook
      WebHookUrl = ""
      #初始化软件自动生成 请勿填写
      BitFlag = 0
      #初始化软件自动生成 请勿填写
      BitCtrl = 0
      #初始化软件自动生成 请勿填写
      CommentID = 0 
      #初始化软件自动生成 请勿填写
      WebHookId = 0

4⃣️运行程序执行命令 ./IOTQQ 默认开启8888端口作为WebSokcet/WebApi的服务端口

服务器用户如:服务器外网IP 为123.123.123.123 且防火墙允许8888端口这时访问一下URL http://123.123.123.123:8888/v1/Github/WebHook 如果返回为OK 则此时的URL 为WebHookUrl 将其填写到 CoreConf.conf 的字段WebHookUrl后保存

转发用户公益的FRP有很多配置好转发规则将本地的服务端口8888映射出去如映射到外网的9909端口这时访问一下 http://公益FRP域名:9909/v1/Github/WebHook 如果返回为OK 则此时的URL 为WebHookUrl 将其填写到 CoreConf.conf 的字段WebHookUrl后保存

您的服务器信息均会不暴露 No DDos,No Attack 仅作为GitHub WebHook通知

UsersConf目录为本地用户缓存数据登录设备信息等便于复用切勿随意创建默认启动程序会自动登录

仓库中Plugins与二进制压缩包里Plugins 文件不同可手动合并

5⃣️一切准备就绪当你外网服务器IP:PORT 或(内网用户)经过转发OK时在打开浏览器访问WebHookUrl 浏览器返回OK则可以进行下一步不通请检查防火墙 or 转发配置

❤️初始化服务

服务运行成功后访问URL http://IP:PORT/v1/Github/InstallService 初始化成功后控制台会提示 Auth初始化完成 若未提示重复上述操作初始化完成后就可以 🌊了

若没有提示Auth初始化完成请检查你的防火墙或GitHub账号是否禁用(需解封) 也可以联系我排除问题
获取登陆二维码访问Url http://IP:PORT/v1/Login/GetQRcode 扫码登陆即可

🆒Lua相关API

WebPlugin APi

请勿修改 WebPlugins目录下的任意文件名以及文件内容的函数名否则部分WebAP接口会失效

详细介绍请移步

Plugin APi

插件命名不受限制 xxx.lua 但是必须实现以下函数

--收到好友/私聊消息触发该函数
--CurrentQQ 响应消息的QQ
--data 消息数据 
function ReceiveFriendMsg(CurrentQQ, data)
    return 1 --1 继续处理后续插件 2 不在处理后续插件
end
--收到群消息触发该函数
function ReceiveGroupMsg(CurrentQQ, data)
    return 1
end
--收到所有相关事件的集合 如群成员进群退群管理升降消息撤回、好友撤回删除等事件
function ReceiveEvents(CurrentQQ, data, extData)
    return 1
end

详细介绍请移步

相关APi用法请查阅Plugins目录下的相关文件调用例程这里不再赘述

WebSocket APi

实现的功能比较少只做了几个配合WebAPI 实现 webQQ 易如反掌
** 给出部分js代码**

<script>
    var User = localStorage.getItem('User');
     var socket = io("127.0.0.1:8888", {
      transports: ['websocket']
    });

    socket.on('connect',
    function() {
        //从缓存或从cookies 读取历史登陆的QQ号
        //链接成功后获取用户缓存 获取成功后直接同步消息 失败直接获取二维码
        //同一浏览器会置换当前的websocket id
    
      if (User == null){

      //获取二维码
      socket.emit('GetQrcode', '1234', (data) =>{
      console.log(data); // data will be 'woot'
      var JsonPkg = JSON.parse(data);
      $('#qrcode').attr("src", 'data:image/png;base64,' + JsonPkg.Data.BQrpic);

       });

      }else{

        socket.emit('GetWebConn', User, (data) =>{
        console.log(data);

        $('#qrcode').attr("src", 'http://q1.qlogo.cn/g?b=qq&nk=' + User + '&s=640');
      });

      }
     
    })
    socket.on('OnCheckLoginQrcode',
    function(data) {
      //48未扫描 53已扫码 17 49 过期了
      // if (data.Data.ScanStatus ==17 || data.Data.ScanStatus == 49){
      // }
        console.log(data);
    });

    socket.on('OnLoginSuccess',
    function(data) {

      // 移除所有
      localStorage.clear();
      console.log(data);

      $('#qrcode').attr("src", 'http://q1.qlogo.cn/g?b=qq&nk=' + data.Uin + '&s=640');
      localStorage.setItem('User', data.Uin);
      localStorage.setItem('Nick', data.Nick);
    });
    //统一事件管理如好友进群事件 好友请求事件 退群等事件集合
    socket.on('OnEvents', function (data) {
      console.log("收到相关事件");
      console.log(JSON.stringify(data));

    });
    //收到好友消息的回调事件
    socket.on('OnFriendMsgs', function (data) {
      console.log("收到好友消息");
      console.log(data);
      console.log(JSON.stringify(data))
    });
    //收到群消息的回调事件
    socket.on('OnGroupMsgs', function (data) {
      console.log("收到群消息");
      console.log(data);
      console.log(JSON.stringify(data))
    });
</script>

Web APi

请导入仓库中的WebAPI.json到Chrome的Restlet Client - REST API Testing插件中
插件下载地址Restlet Client

Tips

😄登陆成功后在手机端回复电脑 systeminfo可查看相关收发包等信息
😄访问URL :http://IP:PORT/v1/ClusterInfo 可以查询相关信息
😄集群模式暂未开放
😄多账号登陆需授权

❤️以下文章或项目排名不分先后 🙏感谢贡献 ❤️

感谢

gopher-lua https://github.com/yuin/gopher-lua
gluahttp https://github.com/cjoudrey/gluahttp
TarsGo https://github.com/TarsCloud/TarsGo
BeegoLog https://github.com/beego

killeder / iotqq Goto Github PK

iotqq's Introduction

⚠️使用协议⚠️

🆕树莓派运行展示🆕

💗开启运行之旅

❤️初始化服务

🆒Lua相关API

WebPlugin APi

Plugin APi

WebSocket APi

Web APi

Tips

❤️以下文章或项目排名不分先后 🙏感谢贡献 ❤️

相关文章

相关项目

感谢

交流裙

iotqq's People

Contributors

Watchers

Recommend Projects

Recommend Topics

Recommend Org