ZL-综合插件 2.2.1 正式版更新
发布日期:2026-10-13
构建标记:官方消息投影[构建2201]
文件大小:7,274,714 字节
SHA256:d05cf3d7b12f22aca62d928fc9c4c8aeab3699ba9bab4477b277298e4940598f
本次更新一句话
两个全新互动系统 + 两个全新管群工具 + 一批实打实的修复:投票系统让群友用「投票1」一键参与活动表决;留言反馈让群友的意见安静地私聊到主人手里;成员比对一眼找出两个群的共同成员并批量清人;针对系统实现「他一发消息就撤回 / 艾特指定人」的整活管群效果;同期修复群总开关失灵、插件启用失败、控制台整页点不动等五项问题。
🗳️ 投票系统(2199 新增,纯指令版)
群友互动投票,管理员发起、全员参与、匿名统计:
发起(管理员,多行发送):第一行是标题,之后每行一个选项,选项行的序号前缀(
1、2.3)等写法)自动剥掉只留选项文字:
参与(全员):发
投票1给当前投票的 1 号选项投票;标题末尾带「多选」即多选投票,投票1,3一次投多个选项(逗号分隔,投票+1+3写法同样支持)。同群多投票:
投票+2+1表示投给 2 号投票的选项 1,不用等前一个结束。查看:
投票结果1输出 ▓░ 条形图 + 票数占比(省略编号 = 本群最新一个);投票列表列出本群进行中的投票。结束:发起人或管理员发
结束投票1提前收摊。规则:一人一票(多选票可投多个选项)、匿名统计(只看票数看不到谁投的)、默认 24 小时自动截止、每群同时最多 3 个进行中、2-8 个选项。
可靠性:投票数据随全局配置持久化,机器人重启不丢;编号跨重启递增不重复(冒烟测试覆盖持久化与计数器回归)。
📮 留言反馈(2199 新增)
群友给主人提意见的官方通道,避免刷屏私聊轰炸:
群友发
反馈 内容或留言 内容(5-300 字),机器人回执「已提交」,内容按渠道转达。送达渠道(控制台「提醒服务 → 留言反馈」配置):
私聊主人:默认开启,把反馈私聊发给所有主人;
私聊指定QQ:默认开启但列表为空,填了 QQ 就额外私聊;
Webhook 推送:默认关闭,开启后 POST JSON 到你自己的接口,方便接自建系统;
邮件送达:默认关闭,复用「邮件提醒」页已配好的 SMTP,发到收件邮箱。
防骚扰:每人每天最多 3 条,超出直接拒绝;内容长度不足 5 字或超过 300 字不收。
四个渠道至少开启一个才能保存,URL / 邮箱格式不合法会标红提示。
🖥️ 控制台「留言反馈」设置页(2199 新增)
位于「提醒服务」分组:私聊主人 指定QQ Webhook / 邮件四渠道开关、收件邮箱列表、每日限频一体管理,保存前做格式校验(至少一个渠道、邮箱与 URL 格式合法)。
🎛️ 菜单与官机卡片更新(2198 2199 2201)
主菜单新增「✨投票系统✨✦留言反馈✨」行,官机 Markdown 卡片同步加入新入口。
新增四个内置子菜单关键词:投票系统 投票菜单 留言反馈 / 反馈菜单(带表情与指令示例,风格与其他子菜单一致)。
升级机制(2198 建立,2201 完善):老用户重启后自动补种缺失关键词、升级未自定义的旧主菜单;自己改过内容的菜单绝不覆盖。
官机主卡片自动重建(2201):2198 起自动生成的裸 Markdown 主卡片没有旧特征句,曾被升级逻辑误判为"用户手写"而永不更新;现按历史全文精确比对自动重建,内置卡片模板更新后重启即生效,用户手改过的卡片依然不动。
👥 成员比对(2188-2190 新增,控制台)
控制台「安全防护 → 成员比对」子页面:
选定 A / B 两个群,列出两个群同时存在的成员。
按两群最高角色筛选(群主 > 管理员 > 成员)。
支持单人移出(选 A 群 / B 群)与勾选批量移出,可勾选「同时拉黑」防止再进。
群内发
成员比对/比对菜单查看功能说明;指令版的跨群去重(成员去重+群号A+群号B)继续可用。
🎯 针对系统(2191-2194 新增,页面 + 指令双通道)
被「针对」的成员每发一条消息,机器人自动执行联动动作:
动作:撤回他的消息 / 艾特指定的人,可组合启用、可自定义提示文案。
页面:控制台「安全防护 → 针对系统」,中间固定高度规则表格、使用说明沉底,按群管理。
群内指令:
添加针对@某人 撤回、添加针对@某人 艾特@某人、删除针对@某人、针对列表。序列化兼容(2194):TargetUin 采用 String/Int64 双向兼容序列化,老用户升级不再报
$.FocusRules[0] 无法从 String 转 Int64而启用失败。列表即时刷新(2200):删除/保存规则后后端立即回推最新列表,前端表格同步更新,删除后自动收起编辑卡。
🔇 踢出 / 禁言支持连带撤回(2198 新增)
踢出 @成员 撤回20:先撤回他最近的 20 条消息,再踢出。禁言 @成员5 撤回10:禁言 5 分钟并撤回他最近的 10 条消息。不带「撤回N」参数时行为与旧版完全一致。
N 范围 1-50,逐条间隔 250~450ms 防风控。
🐛 修复汇总
群总开关失灵(2187):控制台群总开关关掉后机器人彻底静默,不再回复任何消息;开关立即落库并弹回提示,不再被 5 秒防抖吞掉。
插件启用失败(2194):针对系统引入的
WriteAsString未配AllowReadingFromString,老配置反序列化直接炸掉启用;已双向兼容。针对系统页列表不刷新(2200):删除/保存规则后即时回推最新规则。
控制台整页点不动(2200):留言反馈保存按钮与违禁词功能按钮 ID 撞名(
fbSave重复声明),整个 app.js 语法失效、全部事件绑定中断;已改名fbSettingsSave,并新增冒烟断言防止再次撞名。官机主菜单卡片不更新(2201):历史自动生成的裸 Markdown 卡片按全文精确比对自动重建。
升级方式
控制台检查更新
校验信息
| 项 | 值 |
|---|---|
| 版本 | 2.2.1(构建 2201) |
| 文件 | XiaoLin.ZLComprehensivePlugin.uniqq |
| 大小 | 7,274,714 字节 |
| SHA256 | d05cf3d7b12f22aca62d928fc9c4c8aeab3699ba9bab4477b277298e4940598f |
| 发布时间 | 2026-10-13 02:05 |
自测覆盖
0 警告 0 错误编译;AgentFeatureSmoke 全量断言 PASS,本轮新增:投票持久化与编号计数回归、官机 Markdown 主卡片自动升级(2198 版裸卡片 → 新模板)、留言反馈页面存在性与保存按钮撞名防再犯、菜单种子补全断言。
前端改动经浏览器实测:全页面导航切换正常、留言反馈页渲染与保存校验正常、无任何 JS 运行时错误。
打包部署 SHA256 与发布包一致,
plugin.json版本号 2.2.1 已验证进入包内。