ZL-综合插件 v2.1.2 更新公告
发布日期:2026-10-08 版本类型:正式版
🤖 官方机器人协作模式
官方机器人负责菜单、问答、AI、提示等所有可见消息回复。
普通机器人在后台执行禁言、解除禁言、踢人、撤回、管理员、群名片等框架群管动作,不额外发送重复话术。
未配置官方机器人、绑定缺失或官机发送失败时,自动回退原普通机器人发送流程,不影响原有功能。
🔗 群组绑定与身份同步
新增官机快速接入:主人私信官机发送“绑定官机”,再私信普通机器人确认一次性验证码,最后在目标官方群发送“绑定本群”。
“绑定本群”自动匹配真实群与普通执行机器人;存在多个候选时返回真实群列表供主人选择,不再要求复制19位虚拟群 ID。
新增官方虚拟群 ID / openid 与真实 QQ 群号绑定。
自动采集官机事件中的虚拟成员身份;昵称匹配只作为待确认候选,未经验证码或人工确认不会取得真实 QQ 权限。
授权、分群配置、权限判断和群管执行统一使用绑定后的真实群数据。
修复官机成员虚拟 ID 无法用于禁言、踢人、管理员、群名片等操作的问题。
官机私聊直达框架底层腾讯官方 API,绕过 UniQQ 2.0 公开插件接口写日志时的
DateTime → Int64转换异常;禁止错误回退普通 QQ 私聊接口。新增跨插件实例的消息 ID 与内容双层防重,修复同一官机私聊事件重复投递导致所有指令回复两遍。
“绑定官机”只是申请一次性验证码,任何用户都可申请,但只有插件主人能在普通机器人侧确认并完成接入;同一身份仅保留最后一枚验证码。
在群聊发送“绑定官机”不再静默或公开验证码,机器人会明确引导用户进入一对一私聊。
普通执行机器人位于其他电脑、本机无法发现执行号时,官机仍使用真实群配置回复菜单、问答和 AI;不会再因绑定成功反而整体静默。
统一为同一个 QQ 群内绑定:不存在另一个“官方机器人群”;普通机器人先回显真实群号,主人继续在同群发送“绑定本群 真实群号”,官机即可与其看到的虚拟群 ID 建立映射。
官机和普通机器人位于不同进程或电脑时,明确携带真实群号仍允许建立映射,不再强制要求官机本机枚举到普通执行机器人。
兼容腾讯官机默认只接收艾特事件:绑定第二步明确使用“@官机 绑定本群 真实群号”,解析器会自动清除前置艾特后识别指令。
绑定完成后,普通机器人收到未艾特官机的群消息时可代收并驱动官机主动发送 Markdown;若官机也收到原生事件则通过跨入口门禁只处理一次。
🎯 艾特、引用和消息路由修复
修复艾特官方机器人不回复、普通消息反而触发的问题。
修复引用消息中的艾特无法识别,以及官机成员显示名与真实 QQ 映射失败的问题。
群成员仅艾特其他人时不再误触发 AI 搜索。
官机发送的消息不会被插件再次消费,避免重复回复、两边同时发送和消息序号冲突。
🖼️ 引用消息与图片识别
AI 可读取当前消息和引用消息中的文字内容。
AI 可接收当前消息及引用消息中的图片,交给支持视觉的多模态模型识别。
问答、进群欢迎语等图片回复场景适配官机发送,不再只显示
[图片]占位文字。
🪪 官机 Markdown 菜单
官机内置主菜单和全部子菜单默认使用 Markdown 卡片发送。
菜单包含分级标题、说明、引用、图标和可点击指令,保留完整的功能入口。
主菜单替换为新版「🔥 ZL 菜单列表 🔥」模板及指定横幅图片。
没有官机时仍发送原普通消息菜单。
🧩 官机问答卡片修复
修复官机直接触发问答时忽略该问答
OfficialMarkdown、误发普通答案的问题。官机 Markdown 含未放行图片或链接导致发送失败时,会先移除外链资源并重试 Markdown,尽量保留标题、加粗、列表和引用排版。
Markdown 最终不可用时转换成可读纯文本,不再把
#、**、图片语法等源码直接发到群里。卡片编辑器增加提示:公网图片域名必须加入 QQ 开放平台「消息 URL 白名单」,右侧预览不等于平台权限校验。
🔒 消息通道隔离加固
官机回复统一走 Markdown 通道;普通纯文本回复也按官机 Markdown 消息提交。
普通机器人只读取菜单
Content、问答Answer等普通模板,不再接收OfficialMarkdown卡片源码。官机 Markdown 失败时,普通机器人使用对应普通模板兜底,不会把
#、**、图片语法等源码发到群里。原生官机、官机投影和旧外部协作三条链路采用一致的模板选择规则。
日志会明确记录官机、执行机器人和真实群号,方便确认实际发送通道。
🖥️ 控制台修复
修复「菜单指令」页面列表被通用表格样式覆盖、无法纵向滚动的问题。
菜单工具栏和底部数量保持固定,只有中间指令列表滚动,表头继续吸顶显示。
官机协作页新增三步接入向导、真实群/执行机器人状态、身份搜索、状态筛选、群筛选和每页20条分页。
官机不再参与默认执行机器人和真实群归属选择;普通配置页只显示真实群,虚拟群集中在官机协作页管理。
🛡️ 兼容性说明
原普通机器人功能、指令、授权和分群配置保持兼容。
官机负责插件消息接收和全部可支持的对外回复;普通机器人仍是群管动作和定时任务的实际执行端。
更新前建议备份插件数据目录;覆盖插件包后重启框架即可。
🔁 联动群重复回复修复
修复同一条群消息同时从官机事件与普通机器人转发事件进入,造成群管、菜单、问答、AI 等功能执行或回复两次的问题。
官机虚拟成员 ID 与普通机器人真实 QQ 的艾特片段现在统一生成同一消息指纹;任一入口成功领取后,另一入口自动忽略。
去重位于统一消息入口,对全部指令生效,不再逐个功能打补丁。
📦 发布文件校验
文件:
XiaoLin.ZLComprehensivePlugin.uniqq大小:
6,841,464字节SHA256:
cdd067af8b784f4e7653aeb6e6862d34fc933860a42274a3a712cdb143d07e03