ZL-综合插件 v2.1.3 更新公告

发布日期:2026-10-08 版本类型:正式版


🚀 官机绑定流程规范化

  • 主人私聊官机发送“绑定官机”申请一次性验证码,再私聊普通机器人发送“确认官机 验证码”。

  • 确认身份后,在同一个目标群发送“@官机 绑定本群 真实群号”即可建立官机虚拟群与真实 QQ 群映射。

  • 不再使用容易误解的“官方机器人群”概念;控制台仍以普通机器人和真实群为主要管理对象。

  • 官机和普通机器人位于不同电脑或进程时,明确填写真实群号仍可完成映射。

📨 官机消息链路修复

  • 修复主人私聊官机发送“绑定官机”没有回复的问题。

  • 修复“官机帮助”“我的ID”“绑定状态”等私聊指令重复回复两遍的问题。

  • 官机私聊统一使用框架底层官方 API,绕过 UniQQ 2.0 日志包装的 DateTime → Int64 转换异常。

  • 已绑定群的普通消息可由普通机器人代收,并驱动官机主动发送 Markdown 回复。

🔁 全部指令统一防重

  • 修复同一条群消息同时从官机事件和普通机器人转发事件进入,造成执行或回复两次的问题。

  • 防重键包含真实群、真实发送者与规范化内容,窗口收紧为 2 秒;不同成员发送相同内容不会互相吞消息。

  • 同一来源按消息 ID 精确去重,官机/普通机器人双入口按消息次数成对抵消;连续发送相同内容仍会逐条处理。

  • 去重位于统一消息入口,对禁言、解除禁言、踢人、撤回、菜单、问答、AI 及其他全部指令生效。

🧱 官机协作结构加固

  • 官机投影事件同时保留虚拟群、虚拟成员和映射后的真实身份;业务识别使用真实 ID,官方 OpenAPI 操作使用虚拟 ID,不再混用。

  • 删除“复读官机回复即可被永久识别为官机”的内容学习逻辑;机器人保护只信任框架身份、官方虚拟 ID 或控制台白名单。

  • 删除消息入口固定 300ms 等待,改为消息到达信号与有界关联;多人同内容导致映射有歧义时安全拒绝猜测。

  • 框架原生官机在线时,插件内置官方网关与外部中转不再同时启动,避免多条链路抢事件和重复回复。

  • 官方回复序号增加 10 分钟清理及每条最多 5 次限制;超长回复会在发送前回退或截断,不再发送半截。

  • 官机回显窗口统一为 30 秒并持续清理,重复回包不会再次触发问答、AI 或群管。

🛡️ 机器人保护与离线接管

  • 官机与普通机器人统一列入受保护账号,违禁词、刷屏、内容审核、黑名单、新人禁言、批量踢人和手动撤回均不能处罚机器人。

  • 修复普通机器人可能警告、禁言、踢出或撤回官机消息的问题;主指令、自动流程与 Agent 工具均走统一安全入口,并在 API 前增加第二层硬拦截。

  • 官机掉线或发送失败时,当前消息立即回退普通机器人文本通道,后续消息由普通机器人接管;官机恢复后自动切回 Markdown。

  • 修复官机协作转发时丢失“明确艾特官机”状态导致 AI 不回复的问题,图片与引用内容继续沿用原 AI 解析链路。

🖥️ 控制台滚动与在线状态

  • 菜单指令、授权群列表、群选择下拉及其他长列表恢复独立滚动,支持鼠标滚轮与触摸板。

  • 下拉菜单会按屏幕剩余空间自动向上或向下展开,不再被窗口底部截断。

  • 菜单页 Markdown/预览按钮改为实时检测官机在线状态;官机掉线自动制灰并切回普通文本编辑,恢复在线后自动解锁。

🎬 官机富媒体能力(10-09 追加)

  • 官机支持直接发送视频:小姐姐视频 等指令经官方富媒体接口(file_type=2)出片,要求公网可访问的 mp4 直链(软限制 30MB);失败自动降级为文字链接。

  • 音乐卡片升级:官方平台限制官机不能发 ark/json 卡片,改为联动群普通机器人代发真音乐卡(带播放按钮),官机同步文字回执;普通号不在线时自动降级纯文字。

  • 修复官机在线判定:框架不给官机会话回填在线时间,导致官机上线后仍由普通机器人回复、控制台测试发送失败。改为官方事件新鲜度 + 映射探测双信号判活。

  • 修复 AI 回复末尾多余的 @官机别名号码。

  • 修复授权群组列表滚动问题:列表滚动框不再使用易被压缩裁剪的高度写法,窗口偏矮或展开授权编辑条时滚动条始终保持可见;菜单指令列表同步加固。

  • 修复等级审核拒绝理由残留旧占位文案:旧版前端曾把"后期需等官方SDK更新…"存进配置库,加载时自动迁移为"您的QQ等级过低,请升级后再申请"。

  • 入群审核「审核QQ等级」正式可用:SDK 1.1.0 的 GetStrangerInfoAsync 返回 Friend.Level(QQ 等级),申请人等级低于门槛即自动拒绝;查询失败放行,避免误拦。控制台对应卡片已解除禁用。

  • 修复官机音乐回执冗余问题:卡片已由普通号代发成功时,官机只发简短回执;此前把卡片失败兜底文案(含 dph 流式代理音频直链的 base64 长链接)原样发出,暴露音频源。

  • 修复官机别名号不受风控保护的问题:官机在真实群里表现为普通成员号(如 4019357913),此前其带链接的回复会被「按类型主动撤回」等硬规则误撤,表现为"发小姐姐没有回复";现按昵称自动识别官机别名号并豁免全部风控处罚,同时不再计入发言统计与 AI 上下文。

  • 控制台违禁词新增/删除即时保存,不再依赖手动点「保存全部」。

🛡️ 兼容性说明

  • 普通机器人原有群管执行能力保持不变。

  • 普通机器人继续发送普通文本模板,不会泄漏 Markdown 源码。

  • 官机继续发送 Markdown 卡片;官机不可用时自动回退原普通机器人流程。

  • 原有授权、分群配置、自定义菜单和问答数据无需迁移。

  • 更新前建议备份插件数据目录。


📦 发布文件校验

  • 文件:XiaoLin.ZLComprehensivePlugin.uniqq

  • 大小:6,858,895 字节

  • SHA256:30d5d7bd2e22da45bbbfdf4f500b59075518ce1bc64170a2e22f10e77beb96ea

共 27 篇 ZL-综合插件知识库 / 2.1.3 0 字 0 行 zhangxiaolin
创建 2026-10-08T20:12:51.815794812Z 更新 2026-10-11T14:41:55.835854226Z