先说结论：插件批量分发，卡住的从来不是按钮，是目录规范和预览。文件夹名和配置名必须一致，差一个大小写就识别不到；分发前一定点预览，冲突项会标红；出错用批量回滚，别挨个房间改。同一个插件一天上限三次，别拿它试错。
一、插件目录：三个文件，名字要对上
在插件目录下新建文件夹，里面放三个文件：主逻辑、配置、描述。配置里写清插件名、版本号、触发关键词，描述里说明用途。文件夹名必须和配置里写的小名完全一致，大小写也一样。
这一步错了后面全白费。目录名别带空格，路径里有空格同样会报错。系统靠名字匹配，名字对不上就不会出现在分发列表里，你还以为是自己漏了哪步。写完先在本地跑一遍，确认功能能触发再往下走。
图：单号跑通再加台
二、分发流程，四步走完
登录管理后台，左侧菜单找「插件分发」，这是新版才有的入口，旧版没有。顶部下拉框选要发的插件，下面房间列表默认列出所有已绑定的房间，可以手勾也可以全选。房间多的时候用搜索框输名字，比翻列表快。
| 步骤 | 做什么 | 注意 |
|---|---|---|
| 选插件 | 下拉框选择 | 确认版本号 |
| 勾房间 | 手动或全选 | 别漏掉主推房间 |
| 预览 | 看冲突标记 | 标红的先处理 |
| 开始分发 | 等进度条走完 | 中途别关页面 |
三、失败和回滚
分发失败八成是两类原因：网络抖了一下，或者目标房间的版本太旧。后台日志会写清是哪一类，照着改就行，不用猜。日志里带房间号和原因码，照着原因码查比逐条翻快。同一批里个别房间失败，重跑那一批即可。
分错版本不用慌，同一个面板里有「批量回滚」，选上一个版本，一键还原所有房间，不用挨个改。回滚比重发安全，出问题时先回滚再排查。回滚成功后等一分钟再验证，别立刻重发，两次操作叠在一起容易判断失误。
四、频率上限和验收
同一个插件一天上限三次，超了要等第二天。所以每次分发之前把插件测透，别把机会浪费在试错上。测试窗口建议留出半小时，覆盖触发、超时、异常三种情况。
分发完别急着走，抽两个房间现场验证触发是否正常。有问题立刻回滚，别等观众反馈才发现。分发只是两下点击，真正决定效果的是插件本身稳不稳，本地测试做扎实比什么都强。多房间管理的方法见多开账号托管，客户端在客户端下载页更新。
Q：旧版本没有这个入口怎么办？
更新到新版。旧版只有单个房间的设置，没有批量分发，版本对照见四项对比怎么挑。
Q：预览里标红一定要处理吗？
要。标红说明目标房间已有版本冲突，跳过或者先在本地升级，硬发会导致两个版本打架。
Q：回滚会掉数据吗？
只回滚插件版本，房间数据不动。回滚后重新测一遍触发再决定要不要重发。
补一条验收标准：分发完先看三台日志的末尾时间戳，彼此差在 2 分钟以内算通过；差太多说明有一台没执行，回滚重来比逐台补更省事。
图：扫码、客户端、手机
