ZL-综合插件 2.2.1 正式版更新

发布日期:2026-10-13 构建标记:官方消息投影[构建2201] 文件大小:7,274,714 字节 SHA256:d05cf3d7b12f22aca62d928fc9c4c8aeab3699ba9bab4477b277298e4940598f


本次更新一句话

两个全新互动系统 + 两个全新管群工具 + 一批实打实的修复:投票系统让群友用「投票1」一键参与活动表决;留言反馈让群友的意见安静地私聊到主人手里;成员比对一眼找出两个群的共同成员并批量清人;针对系统实现「他一发消息就撤回 / 艾特指定人」的整活管群效果;同期修复群总开关失灵、插件启用失败、控制台整页点不动等五项问题。


🗳️ 投票系统(2199 新增,纯指令版)

群友互动投票,管理员发起、全员参与、匿名统计:

  • 发起(管理员,多行发送):第一行是标题,之后每行一个选项,选项行的序号前缀(1、 2. 3) 等写法)自动剥掉只留选项文字:

发起投票 周末去哪玩
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 字节
SHA256d05cf3d7b12f22aca62d928fc9c4c8aeab3699ba9bab4477b277298e4940598f
发布时间2026-10-13 02:05

自测覆盖

  • 0 警告 0 错误编译;AgentFeatureSmoke 全量断言 PASS,本轮新增:投票持久化与编号计数回归、官机 Markdown 主卡片自动升级(2198 版裸卡片 → 新模板)、留言反馈页面存在性与保存按钮撞名防再犯、菜单种子补全断言。

  • 前端改动经浏览器实测:全页面导航切换正常、留言反馈页渲染与保存校验正常、无任何 JS 运行时错误。

  • 打包部署 SHA256 与发布包一致,plugin.json 版本号 2.2.1 已验证进入包内。

共 27 篇 ZL-综合插件知识库 / 2.2.1 0 字 0 行 zhangxiaolin
创建 2026-10-12T18:20:43.673593970Z 更新 2026-10-12T18:22:08.537439159Z