先驱框架下常见问题合集（持续更新）

Hikari Sakurai

先驱框架下常见问题合集

由于近日众多骰主转向先驱框架后由于对新框架不熟悉等原因，论坛关于先驱框架及CQXQ插件的问题增加。考虑到很多骰主的问题十分相似，故撰写本贴以供参考。

本贴在时间允许的条件下将持续更新，如你的问题没有在本贴列出，并且你认为你的问题属于常发且对其他骰主同样有效，请发送邮件至 AzusaHikari@arcaea.moe。在邮件内附上 先驱主程序版本号 CQXQ版本号 Dice! 版本号 及问题描述，出现该问题时后台截图（注意将你的公网 IP 打码）。

请注意，由于时间原因，邮件不一定回复。且由于本贴仅列出常见问题，因此你的问题不一定会被列举在本贴。

Hikari Sakurai

#1 先驱框架下出现黑名单清查全部非免清/免黑群聊问题

请更新你的 Dice! 版本，目前最新版本已经部分修复（仅仅列出所有群但不会退群）。

如果你使用了第三方修改版插件，请联系你使用的版本的开发者。

Hikari Sakurai

#2 先驱框架下拓展文件的存放地址

溯洄开发的 CQXQ 插件力求兼容 CoolQ 的插件，因此你的拓展文件仍然位于与 CoolQ 的等效目录下，即：

牌堆文件：CoolQ\DiceData\PublicDeck\ -> XQ\Dice[QQ]\PublicDeck

Mod文件：CoolQ\DiceData\Mod\ -> XQ\Dice[QQ]\Mod

其余文件位置类似处理。

Hikari Sakurai

#3 先驱框架下图片、音频等文件存放位置

如果你使用的原生插件，请咨询你的插件的开发者。

如果你的插件是 CoolQ 的 .dll 和 .json 原始插件且使用 CQXQ 兼容层，你的文件应在下列路径：

图片： XQ\data\image\

音频： XQ\data\record\

Hikari Sakurai

#4 先驱框架下无法使用部分指令

先驱框架使用了 PC 版 QQ 协议，因此一些基于 AndroidQQ 的功能无法使用，如设置专属头衔等。

该问题很难解决，请亲自手动操作。

Hikari Sakurai

#5 先驱框架下出现 `获取群成员信息失败，正在采用更慢的方式` 信息

短时间大量获取群成员信息将被 QQ 认定为垃圾请求，QQ 的服务器将拦截此次请求。因此出现上述问题。

理论上等待即可。

另：CQXQ 为了解决本问题采取了缓存机制，这一机制可能导致 #6 中出现的问题（见下）

Hikari Sakurai

#6 先驱框架下无法令已获得群管理权限 bot 禁言或踢出群员问题

本问题一般发生于被制裁的群员失去管理员权限后一段时间。这是由于 CQXQ 为避免拉取群成员请求被 QQ 拦截使用了缓存机制。

你可以等待缓存刷新（不超过1h）或手动重启 bot 清除缓存。

Hikari Sakurai

#7 先驱框架下 bot 所在群全员禁言后 bot 无法使用问题

在 CQXQ 1.1.0beta 版本开始，由于需要实现消息撤回，插件由此前的异步处理变为同步处理。这可能导致了 CQXQ 线程堵塞从而无法发送信息。

如你的插件不需要依赖原 CoolQ 的 MessageID，请使用最新 CQXQ 插件的异步版本（在溯洄发布的插件压缩包内已经写明）或暂时不要更新 CQXQ。

Hikari Sakurai

#8 先驱框架下无法使用网络图片的问题

由于发送网络图片（CQ码 类似于 [CQ:image,url=...] ）需要从图片源下载后再发送。因此任何网络问题均有可能导致无法发送，包括但不限于：

- 图片源本身在国内无法访问（如 Pixiv 等网站）
- 无法上传服务器（此时你可以在后台的日志中看到 4个地址上传失败 等字样）
- 获取图片失败，可能原始网页并非纯图片（判断方法为 Google Chrome 可以查看网页源代码，该情况说明网页并非纯图片）
- 图片文件过大，从图片源下载超时或上传超时
- 可能你请求的资源已经不存在，请检查你的地址是否正确

Hikari Sakurai

#9 先驱框架下其他插件的可用问题

如果你使用的 CoolQ 的原始 dll 和 json 文件，理论上可以很方便移植。

如果你使用的先驱原生插件，一般不会出现与 CQXQ 的兼容性问题。

本论坛不负责解答其他插件问题，请咨询你的插件开发者。

Hikari Sakurai

#10 先驱框架下的 TRPGlogger 可用性问题

在新版本 Dice! 插件中，已经内置 TRPGlogger，原有独立的 TRPGlogger 不一定可用（笔者未测试旧版本插件可用性，但由于要读取 CoolQ 的日志，理论上不可用）

Hikari Sakurai

#11 先驱框架下多账号登陆问题

尽管先驱主程序提供了多账号登陆，但为防止出现各种预料之外的问题，请保持使用 CoolQ 时多个账号使用多个程序并拆分文件夹的方法。

另外，由于先驱未来可能对多账号登录收费，使用先驱框架自带的多账号登陆请考虑该问题。

Hikari Sakurai

#12 先驱框架下提示 `加载菜单失败，请检查 json 文件是否正确`

CQXQ 下插件菜单保持 CoolQ 的插件菜单读取方法，即在对应的插件 json 文件中注明菜单对应的函数。因此出现该问题意味着你可能并没有使用插件对应的 json 文件，从而导致 CQXQ 无法找到菜单对应的函数。

请检查你的原始 CoolQ 插件版本和 json 中标注版本一致。

Hikari Sakurai

#13 先驱框架下插件优先度问题

你可以通过修改 CoolQ 插件对应的 json 文件中有关事件的优先级。其逻辑保持与 CoolQ 的优先级逻辑不变。