先驱框架Dice!骰娘搭建手册

本文为搭建Dice!适配先驱机器人的教程。本教程只对手册内提供的文件负责，如果您希望使用本教程搭建骰娘，除了旧存档目录DiceData外请全部使用给定文件，否则出现问题我们无法答疑。

框架毕竟不是正版QQ程序，存在固有缺陷，我们无法排除所有问题，请做好心理准备；

新人请从炼骰手册了解骰娘，再开始尝试搭建；

作为Dice!开发者，先驱和Mirai框架均系我们为骰主提供的备选方案，框架适配均较为稳定，可关注更新，保证资讯的及时性；本手册更新时间为2020/10/18，你可以关注以下任一渠道

Shiki序列官群（群内提问骰娘相关可加此群）:754494359 1029435374

私骰分流群（分享自己骰娘可加此群）:863062599 192499947

Kokona四号姬的B站动态（本教程作者）

爱发电:https://afdian.net/@dice_shiki

QQ机器人通过使用QQ协议，实现收发聊天消息、获取列表等QQ功能，相当于非官方QQ程序。框架监听QQ消息，再将事件交由插件处理，并为插件提供操作接口。由于腾讯没有公开QQ协议，机器人属于腾讯的打击对象。因此，永远不要被QQ识别为机器人！

先驱是一款QQ机器人框架。2020年8月初酷Q机器人框架开发者跑路，而先驱属于未跑路的一员，且至今仍在更新和运营。同酷Q类似，先驱框架在使用时需要连接先驱后台服务器，同理无法排除跑路风险。

CQXQ是溯洄开发的一款先驱插件，用于转接原CQ插件（如Dice!）。由于并非真正的QQ程序，机器人存在一些固有缺陷，例如：获取群成员权限失败，退群失败，等等。

骰娘功能没有实质变化，存档文件相对路径不变，均为[根目录]/[DiceData]

Mirai完全去中心化，不会因作者跑路无法运行；先驱启动必须连接到先驱后台服务端，存在跑路风险，但是现阶段免费；酷Q框架相对稳定，但是部分功能（登录协议、图片、语音等）收费，现已跑路

部分功能因接口缺陷无法实现或可能失灵，如酷Q监听群管理同意入群事件；Mirai接收讨论组消息，群成员最后发言时间，监听群员退出；先驱发送讨论组消息，获取群成员权限，退群……

Mirai/先驱的图片缓存目录和主动放置图片目录是分离的，所以不推荐用指令设置图片回复

不同框架对富文本信息（图片、语音）的标记方式不同，转接酷Q插件需要先转义为酷Q码格式，部分消息类型无法转换

酷Q无法正常单文件夹多开，一个文件夹只能对应一枚骰娘；Mirai和先驱虽然理论上支持多开，但由于CQP.dll框架限制，酷Q插件在任何框架下都不适合多开

框架本体大小相当(先驱≈45MB，其余20+MB)，但Mirai额外需要java环境(近90MB)

先驱仅支持PC协议登录，Mirai默认平板协议登录，酷Q默认手机协议登录，付费版可使用其余协议

Mirai的登录设备非常耿直，腾讯会发现你用一个名为Mirai的Pad机型登录了QQ；如果是先驱，登录设备叫XQPC

Windows系统或Linux下wine环境（注意中文字符支持）或安卓下Windows模拟器

一个XQ_with_Dice整合包包含先驱本体、先驱插件CQXQ、Dice!2.4.1插件

下载链接:https://shiki.stringempty.xyz/pkg

一个有一定等级QQ号，尽量不要刚注册的小号，最好最近活跃且异常登录较少，有设备锁

(可选) 原Dice2.3.8exp10以上版本的酷Q骰娘根目录下的DiceData文件夹

Dice2.3.8exp9及以前版本酷Q骰娘data/app/com.w4123.dice文件夹

Dice2.3.8exp10的开发版(554/555)骰娘请两个都带上

注意：如果你在搭建到一半时看本手册，我唯一的建议是从新文件夹从头开始做起，因为我无法确认你的意外状况。如果情况顺利，你将很快完成一次搭建。

将压缩包解压到一个新文件夹

2. (可选)将DiceData目录复制到根目录(Dice!在启动找不到目录时，会自动重命名DiceData)

或 将com.w4123.dice目录复制到CQPlugins/config/data/com.w4123.dice.dll（556后不再向此目录保存数据，但仍可读取此处文件初始化）

3. (如果未使用整合包)将CQXQ.XQ.dll放入Plugin文件夹；启动先驱，加载插件后会自动新建CQPlugins文件夹；将com.w4123.dice.dll和com.w4123.dice.json放入CQPlugins文件夹。 以上文件在整合包中均已在既定位置，本教程对其他来源文件概不负责

4. 双击【先驱.exe】进入程序

5. 等待先驱加载CQXQ完成，切到【账号管理】页，输入账号密码登录（初次登录时大概率要完成完全验证，否则大概率被腾讯甄别）。

6. 切到【插件扩展】页，手动【启用插件】。CQXQ默认启用CQPlugins文件夹内的插件。

7. 等待日志窗口显示加载成功

8.（可选）右键菜单内单击【设置插件】，根据自己需要选择【开始接收来自自己的事件】。开启后会响应本机QQ从任何设备发送的群消息

9. (无存档新骰娘)插件列表选中【Dice!】->【菜单】->【综合管理】，在Master设置页，上方正中栏内输入MasterQQ，点击【设置Master】

发送预存图片，可将文件放置在\data\image下(例:.\data\image\demo.png),然后在文本中使用酷Q码[CQ:image,file=demo.png]，填入图片目录的相对路径或绝对路径

CQXQ尚不能使用.system reload重载，可使用.cloud update更新，如不能手动重载插件，可使用.system remake重启先驱。

安卓系统上的Windows模拟器(如ExaGear)可以运行先驱框架，因此可以在手机上挂载骰娘。

ExaGear的搭建步骤：

在安卓系统上安装Exagear ED301 溯洄超级无敌可以后台运行为酷Q修改版V2.apk(https://drive.kokona.tech/s/MrPyz7J2cMz7Xnb)

将整合包文件夹放入根目录的ExaGear文件夹

打开ExaGear，新建容器并启动

在容器内执行搭建步骤

切换应用时将容器留在后台

如CQXQ在模拟器中无法正常使用文件流写出CQP.dll，更新时需提前手动复制

小号登录就冻结怎么办？ 作为骰主需要学会“养号”，降低被QQ识别为机器人的概率，多干点阳间的事，例如水群活跃，减少异常登录，等等。尽量避免使用新注册的号。

讨论组消息没发出来/group title没给到头衔怎么办？ 先驱接口缺陷，部分功能无法保证使用

其他酷Q插件可以迁移吗？

不一定，请咨询开发者。基础要求是有插件的dll和json，cpk或epk是无法使用的。

为什么DiceData放着没用？

目录内已经有新目录了，Dice!不会自动重命名；或者使用的Dice!插件未更新。

为什么启动后数据初始化，根目录生成文件夹Dice0？

CQXQ适配缺陷，请确保先登录QQ后启用插件。一般重启即可。

为什么先驱显示UDP服务器连接失败或拒绝连接？

网络原因，先驱不会主动ban，等待恢复连接。

加载其他先驱插件返回【载入失败】怎么办？

一般考虑插件dll的依赖缺失，给系统安装vs环境。

在其他设备登录账号，接收私聊消息慢一拍怎么办？

框架固有缺陷

带图指令设置的reply/msg发出来为什么图是裂的？

请避免直接在指令内带图发送，而是手动将图片存入指定位置后使用酷Q码设置

为什么重启后CQXQ报错，tmp文件夹访问冲突？

上次关闭时线程退出得不干净，稍等或手动删除tmp文件夹

对于先驱不明原因报错，可以保存日志记录，在先驱群或论坛询问先驱开发者