本文为尚在测试中的Dice!gocq的搭建教程。如需反馈交流可加官群:928626681/1029435374

速通版说明(Windows)

操作以包内最新说明为准

  1. 解压压缩包到合适文件夹,(如有旧数据)迁移Dice目录至根目录下;
  2. 启动本地签名服务,至命令行显示【Responding at http://127.0.0.1:*】即启动成功
  3. 编辑【config样例.yml】,将开头uin项和password项替换为骰子QQ和密码,重命名为【config.yml】如果本台电脑开启多个gocq,则编辑最下方的【address: 127.0.0.1:15800】,将15800修改为未使用的端口(如127.0.0.1:15800、127.0.0.1:15801、127.0.0.1:15802……)
  4. 启动gocq,登录QQ,至命令行显示【CQ WebSocket 服务器已启动: 127.0.0.1:*】;
  5. 启动DiceDriver.Gocq.Lite.exeDice!

维护说明

  • DiceDriver默认正向ws连接gocq,断连后不会自动重连,因此如果go-cqhttp遭遇掉线、重启等情况,需要重启DiceDriver(反向ws的情况下不需要重启);
  • 反之,DiceDriver闪退或重启时不需要重启go-cqhttp;
  • go-cqhttp在登录时会在根目录生成device.json文件,即QQ->设置->账号安全->登录设备管理中显示的设备信息,每次重新生成相当于更换一台新设备,当使用原device登录遭遇登录设备异常等状况时,考虑重新生成;
  • go-cqhttp在登录成功后会在根目录生成session.token文件,只要不遇到冻结、修改密码、登录状态失效等情况,不改动device.json,文件还在就能保持登录,因此可以用手机QQ在与之相同wifi的设备上扫码登录,再将session.token迁移至服务器上,保证登录成功率;

对有余力的骰主的说明

  • DiceDriver与gocq可以分离。DiceDriver优先读取同目录下config.yaml中的servers[1].ws.address项,如果读取不到,则会读取Diceki/driver.yaml(需自建)中的server项(同address);
  • 不支持gocq的access-token验证,问就是没写;

反向ws连接

打开config.yml,删除或注释掉最底端ws配置,替换为如下ws-reverse项,重启gocq。

  - ws:   # 正向 Websocket
      # 正向WS服务器监听地址
      address: 127.0.0.1:15800
      middlewares:
        <<: *default # 引用默认中间件

  - ws-reverse:
      # 反向WS Universal 地址
      # 注意 设置了此项地址后下面两项将会被忽略
      universal: ws://127.0.0.1:15800
      # 反向WS API 地址
      # api: ws://your_websocket_api.server
      # 反向WS Event 地址
      # event: ws://your_websocket_event.server
      # 重连间隔 单位毫秒
      reconnect-interval: 10000
      middlewares:
        <<: *default # 引用默认中间件

下载链接

FAQ

为什么私聊回复反应慢/新加好友不回复?

Dice!与go-cqhttp会双重验证私聊对象是否为好友,即Dice!Master配置中的DisableStrangeChat=1与go-cqhttp的config.yaml中的allow-temp-session: false 可修改以上两处配置。

connect error:HS: ws upgrade response not 101(协议升级失败)

尝试将gocq连接方式改为反向ws(见上)

1 个月 后
2 个月 后

[WARNING]: 登录失败: 你的用户身份已失效,为保证帐号安全,请你重新登录。
在扫码之后得到了这样的提示……

    更换新账号登录,扫码显示密码错误或账号被冻结。

      12 天 后

      根据之前的回复更改为"protocol":2后还是扫码无法登上,显示网络不稳定或处于复杂网络环境。

        097 尝试在本地电脑上同wifi扫码,登录成功后再打包至服务器。


        求助请教!前面都成功了,到启动DiceDriver的时候弹出了这样的文字,有和我一样情况的吗?这种情况应该怎么办呢?

          在mirai上可以直接使用的lua脚本到了go cq上面就报错是不是这个CQ image这个有改动啊?

            Evylenn 形如CQ:image,file=调用本地图片的不会有区别,除非本地图库没有被跟着迁移

            安研色Shiki 将标题更改为 「【框架指南】Dice!gocq版搭建说明」。

            地窖上的松 大佬,为啥我输进入跟我说账号密码错误呢,我试过电脑上可以登的呀,文件里前前后后的空格我都试着删过,都说配置不对,应该不是这个问题