ZZZ Queue OBS 新手使用手册
适用版本:v1.14.7 · 更新日期:2026 年 10 月 22 日
这份手册面向不懂编程的主播。先完成第 1–3 节,再根据设备选择一种接收方案:没有副屏必须先看第 4 节;有副屏且能让浏览器持续显示时,才可选择第 5 节;接通后继续第 6 节,把队列放进直播画面。手机、抽奖、桌面悬浮窗等功能可以之后再设置。
最重要的一句话:观众加入的是“接下来”;主播点击“完成当前叫号并继续”,才会把第一位观众变成“当前”,并进行语音叫号。
1. 先认识这几个窗口
| 名称 | 用来做什么 | 观众是否需要看到 |
|---|---|---|
| ZZZ Queue 主程序 | 保持排队服务运行,右下角有角色图标 | 不需要 |
| 排队控制台 | 设置房间、排队规则、抽奖、语音和手机连接 | 不要作为直播内容 |
| 直播面板 | 简化的日常操作页面,适合手机 | 不需要 |
| LAPLACE Chat 控制台 | 接收 B 站弹幕和礼物,再交给排队插件 | 不要直接展示设置页 |
| OBS 排队挂件 | 只显示当前观众和等待队列 | 按需展示 |
| OBS 弹幕挂件 | 把收到的聊天显示在直播中 | 可选,默认关闭 |
| 桌面悬浮窗 | 让主播在游戏上方看队列、弹幕并操作 | 取决于 OBS 的捕获方式 |
LAPLACE Chat → 本机桥接 → 排队插件 → OBS 挂件 / 桌面窗 / 手机。
你不需要理解“桥接”的技术原理。把它理解为两边传递弹幕的小通道即可。本插件的完整安装包已经带了桥接程序,不需要安装 Docker。
本工具不是放进 OBS 插件目录的 DLL。它是独立运行的 Windows 程序,OBS 通过“浏览器”来源显示它的挂件。普通使用不需要开启 OBS WebSocket,也不需要填写 OBS 密码。
2. 下载、安装和第一次启动
2.1 推荐使用 Windows 安装版
- 打开 官方下载站,点击 下载安装包 · 推荐。无需访问 GitHub。
- 双击下载的
ZZZ-Queue-版本号-install.exe,选择中文或 English。 - 选择程序目录,例如
D:\Apps\ZZZQueue,用于保存软件文件;也可以直接使用默认目录。 - 数据自动保存在安装目录内的 data 文件夹,用于保存队列、设置、QQ 身份绑定和日志,无需再选择位置。旧版独立数据目录会自动备份并迁移到这里,原目录保留副本。
- 完成安装后,从桌面或开始菜单打开 ZZZ Queue。
- 以后在控制台页面最下方的“软件更新”点击“一键更新”,软件会自动下载、校验、备份、安装并重启。直播中不会未经点击自动安装。
下载站也保留便携 EXE ZIP:完整解压后运行 ZZZ Queue.exe,不能直接在压缩包内启动,也不要只复制 EXE。便携版默认把数据放在同目录的 data 中。新安装版默认也使用程序旁的 data;安装版统一使用安装目录内的 data,可从托盘“打开数据目录”查找。
EXE 版无需另外安装 Python、Node.js 或 Docker。若 Windows 提示未识别的应用,请先核对下载来源为上述官方站点。
2.2 启动成功是什么样
正常情况下,浏览器会打开排队控制台,Windows 右下角出现你熟悉的角色图标。找不到图标时,点击时钟附近的 向上箭头 / 隐藏的图标。
第一次启动请耐心等候;慢电脑最多会等待约 90 秒。不要连续解压多个副本、反复启动不同目录里的程序。
主程序 ZZZ Queue.exe 的文件图标与控制台主托盘使用同一张角色图标;桌面悬浮窗使用另一张独立图标。
点击托盘图标可重新打开控制台。关掉排队控制台的浏览器标签页,不等于关闭主程序。
控制台顶部会显示本副本的版本、地址和运行目录(目录仅在电脑本机显示)。打开页面时会检查常用端口 3667–3766;发现其他副本会列出它们的地址和版本。核对 OBS 来源所用地址,退出不用的旧副本。检查不会擅自停止其他程序,自定义范围外端口不在此检查范围内。
2.3 Python 版给谁用
如果你只想直播,选 EXE 版即可。Python 版适合已有 Python、想修改启动源码的用户:下载 windows-x64-python.zip,完整解压,安装 Python 3.10 或更新版本,再运行 start-python.cmd。首次运行需要联网安装依赖。两版功能一致,不需要同时运行。
3. 在排队插件里填写基本设置
打开排队控制台,找到 连接与规则。如果手机样式的页面里找不到设置,先点顶部的 设置控制台。
第一次建议这样填:
| 项目 | 建议填写 | 说明 |
|---|---|---|
| 直播间 ID | 你自己的 B 站直播间数字 | 不是 B 站账号 UID,也不是个人空间地址 |
| 桥接地址 | ws://127.0.0.1:9696 |
新安装使用这个默认值 |
| 桥接令牌 | 留空 | 两边都没设密码时都留空 |
| 排队口令 | /排队 |
观众需要完整发送这个口令 |
| 最低礼物金额(元) | 0.1 |
不能低于 0.1 元 |
| 抽奖口令 | 抽奖 |
建议与“排队”不同 |
| 抽奖时长(秒) | 60 |
倒计时一分钟 |
| 开放排队 | 勾选 | 允许正常入队 |
| 在 OBS 弹幕源中展示聊天 | 先不勾选 | 后面需要展示弹幕时再开 |
填完点击 保存设置。然后在“接下来”卡片勾选 开启免费排队,方便第一次测试。
例如你的直播间网页是 https://live.bilibili.com/446277,通常填写 446277。这里是演示号码,其他主播要换成自己的房间。少数房间有短号和真实房间号之分;如果 LAPLACE 有弹幕、插件始终不认房间,请核对 LAPLACE 实际连接的房间数字是否与插件一致。
3.1 三种地址不要混用
| 地址示例 | 填在哪里 |
|---|---|
http://127.0.0.1:3667 |
电脑浏览器打开排队控制台 |
ws://127.0.0.1:9696 |
LAPLACE 和排队插件各自的“桥接地址” |
http://192.168.1.20:3667/live |
手机浏览器;实际地址从电脑控制台读取 |
3667 是默认的网页端口;被占用时程序会换一个数字。后续请使用实际控制台地址。9696 是桥接端口,与网页端口不是同一个东西。不要因为网页是 3667,就把桥接地址也改成 3667。
旧配置可能使用 9698,本插件也支持自动启动它;已有连接正常就不必更改。9697 不是本插件默认自动启动的桥接端口。
3.2 两种方案都先读:LAPLACE Chat 的房间与身份码设置
无论有无副屏,都先了解本节,再选第 4 节或第 5 节。 有副屏时在普通浏览器填写;无副屏时在第 4 节创建来源后,通过 OBS 的“交互”窗口填写。普通浏览器的设置不会自动变成 OBS 的设置。
- 打开 LAPLACE Chat 首页,先选择连接方式。
- 选择“开放平台 / 幻星”时,需要填写主播身份码,而不是直播间号。 打开 哔哩哔哩幻星,登录自己的主播账号,在首页右下角找到并复制身份码。回到 LAPLACE,将它粘贴到该连接方式的身份码输入位置。具体位置以当前页面为准。官方设置说明
- 选择其他要求房间号或房间链接的连接方式时,按页面提示填写自己的直播间号或链接,不能用身份码代替。不同方式需要的内容不同。
- 排队插件里的“直播间 ID”始终填写房间数字,不要填身份码、自己的账号 UID、桥接令牌或手机配对码。确认 LAPLACE 实际连接的房间与这里一致。
- 配好后使用首页的“打开控制台”。如果当前连接方式提供专用链接,请使用页面实际生成的地址,不要把身份码拼进示例房间地址。身份码和含配置凭据的链接不要展示在直播画面中。
- 用手机发送普通测试弹幕,确认 LAPLACE 自己先收到,再按后续章节开启 Event Bridge。
身份识别也要验收: 官方说明幻星方式不提供真实观众 UID。因此能显示昵称不等于跨连接方式的观众身份一定一致。正式开播前,用同一账号先发送“排队”,再追加礼物,确认插件合并到同一条记录;不要在已有队列时随意切换连接方式。官方身份限制说明
| 内容 | 填在哪里 |
|---|---|
| 主播身份码 | LAPLACE 的开放平台 / 幻星连接配置 |
| 直播间数字 ID | 排队插件“直播间 ID”;LAPLACE 房间号连接方式 |
| Event Bridge 地址、令牌 | LAPLACE 与插件两边的桥接设置 |
| 手机配对码 | 手机打开插件时的配对页面 |
3.3 根据显示器选择一种接收方案
先看第 4 节:没有副屏请选择 OBS 接收方案。第 5 节仅供有副屏、能让浏览器持续显示的用户选择,两套不用同时做。
普通浏览器方案不适合无副屏用户。 玩游戏时切换标签、最小化或让游戏完全遮住 LAPLACE,都可能让浏览器挂起页面,导致无法持续接收弹幕、漏识别礼物。仅把浏览器开着或加入休眠例外,并不能保证正常接收。手机可控制队列,但不能替代电脑上的接收端。
| 你的设备 | 接下来怎么做 |
|---|---|
| 没有副屏,只有一个显示器或笔记本屏幕 | 跳过第 5 节,直接按第 4 节在 OBS 内设置,完成后继续第 6 节 |
| 有副屏,能在副屏一直显示 LAPLACE | 按第 5 节设置,完成后跳过第 4 节,继续第 6 节 |
两种方案都需要运行排队主程序。手机是可选的遥控器,不负责接收弹幕。
4. 推荐方案:没有副屏,在 OBS 内运行 LAPLACE Chat
适合只有一个显示器或笔记本屏幕的用户。 直接按本节操作,不需要先做第 5 节。OBS 保持 LAPLACE 来源运行;主播用桌面悬浮窗或手机控制排队。
4.1 建立一个专用的接收来源
- 打开 OBS,选择平时直播游戏用的场景。
- 在 来源 区域点击 + → 浏览器。
- 新建来源,命名为 LAPLACE 接收端—不要展示。
- 不勾选“本地文件”。先在普通浏览器的 LAPLACE 首页按第 3.2 节确认连接方式、房间号或身份码,再把实际使用的 Dashboard 控制台地址填入 OBS 来源,例如
https://chat.laplace.live/dashboard/446277(换成自己的房间)。/obs/是观众看到的展示页,不能用它代替需要设置 Event Bridge 和 TTS 的 Dashboard。 - 宽度可先填
1280,高度900,便于设置时操作。这是本手册的起始尺寸,可自行调整。 - 取消勾选“不可见时关闭源 / Shutdown source when not visible”。
- 建议也取消“场景激活时刷新浏览器”,避免切场景时反复重新加载。
- 确定后,右键这个来源 → 交互。
- 在交互窗口确认 Dashboard 显示自己的直播间。用手机发一条
连接测试01,先确认 LAPLACE 自己能收到。OBS 内的 Dashboard 可以直接使用右上角齿轮设置,不必通过交互窗口跳转到新标签页;交互窗口不能正常打开新页时,回到来源“属性”修改 URL。 - 在交互窗口内点击 LAPLACE 右上角的 设置 / 齿轮,向下找到 Event Bridge 并开启。
- 桥接地址填
ws://127.0.0.1:9696;如果排队插件使用 9698,这里也用 9698。令牌与排队插件一致,没设令牌时两边留空。 - 按页面的连接按钮或等待自动连接。回到排队插件,必要时点击 重新连接 / 启动桥接。
- 从手机发送
连接测试02,确认它同时出现在 LAPLACE 和排队插件的“弹幕与礼物”区域。仅看到“已连接”不算验证完成。
也可以使用控制台页面底部的 一键添加 LAPLACE Dashboard 到 OBS:先在 OBS 工具 → WebSocket 服务器设置启用 WebSocket(默认端口 4455),再粘贴完整 Dashboard 地址并输入 WebSocket 密码。添加前先停止直播和录制,以免 Dashboard 在设置时出现在节目画面中。插件会把 Dashboard 添加到 OBS 当前场景,保持来源可见并打开“交互”窗口,方便直接设置。设置完成后,在来源列表点击 Dashboard 的眼睛图标将它隐藏;浏览器来源会继续在后台运行并接收弹幕。WebSocket 密码仅用于本次连接,不会保存在插件设置中。若 OBS 版本不支持自动音频监听,按 9.3 节手动设置监听设备。
OBS 的浏览器环境与 Chrome / Edge 不是同一份本地存储。请在 OBS 交互窗口内检查房间、Event Bridge 和 TTS 设置;即使普通浏览器已配置过,这里仍需确认。不要在 OBS 交互窗口中依赖打开全局配置器的新标签页。修改 LAPLACE 首页配置时,在普通浏览器完成后,将实际需要的 Dashboard 地址复制到 OBS 来源“属性 → URL”。
如果选择使用 LAPLACE 首页生成的带配置控制台链接,请使用页面实际提供的链接;不要手工拼接同步密钥参数。含同步密钥的链接请保密。LAPLACE 配置链接说明
4.2 让它运行,但不把后台设置播出去
在 OBS 来源列表中,越靠上的来源,画面越在前面。建议按下面顺序排列:
- OBS 排队挂件 / 可选的弹幕挂件。
- 游戏捕获。
- 一张铺满画布的不透明“颜色源”,例如黑色,作为遮挡底板。
- LAPLACE 接收端—不要展示。
颜色源可以通过“来源 → + → 颜色源”创建。它应放在游戏下方、LAPLACE 上方;这样游戏没打开时,LAPLACE 控制台也不会从后面露出来。确认预览后锁定这些来源,减少误拖动。
保持 LAPLACE 接收端的眼睛图标开启,并保留在当前活动场景中。 不要用关闭眼睛作为本流程的遮挡方式;使用上面的不透明来源遮挡。OBS 官方说明:启用“不可见时关闭源”会卸载页面,场景激活刷新也会重新加载。OBS 浏览器来源说明
有多个直播场景时,使用“添加现有来源”复用这个接收端,并在每个相关场景放好遮挡底板。不要新建多个不同的 LAPLACE 接收端,让它们同时重复转发同一房间。
4.3 做一次后台测试
- 用 OBS 的“交互”确认 LAPLACE 桥接已连接。
- 从手机发送
后台测试01,确认排队插件收到。 - 关闭交互窗口,切回游戏。不要关闭 OBS。
- 从手机发送
后台测试02,在手机排队面板或桌面悬浮窗中确认出现。 - 切换到平时会用的另一个 OBS 场景,再发送
后台测试03。
这套流程已有短时测试依据;不同 OBS 版本、显卡和场景设置仍需在自己的电脑上验证。准备长时间直播前,按平时的游戏方式运行一段时间,期间发送几条编号消息检查是否持续收到。
4.4 每次直播保持这套方案运行
- 启动排队主程序,再打开 OBS。
- 确认当前场景包含配置好的 LAPLACE 接收端,来源没有关闭。
- 发一条真实弹幕,确认手机面板或桌面悬浮窗收到。
- 保持 OBS 运行,就可以切回游戏;不需要另开第 5 节的副屏浏览器接收方案。
接下来前往第 6 节,添加观众看到的排队挂件。这里的 LAPLACE 接收端负责收消息,第 6 节的挂件负责展示队列,用途不同。
5. 可选方案:仅有副屏时,在浏览器运行 LAPLACE Chat
仅适合有副屏且能持续显示 LAPLACE 的用户。没有副屏请返回第 4 节,不要使用本节浏览器方案:页面被后台挂起时会漏收弹幕和礼物,影响入队与金额统计。 将 LAPLACE 控制台放在副屏,主屏用来玩游戏。本节完成后直接前往第 6 节,不需要再配置第 4 节的 OBS 接收端。
5.1 先让 LAPLACE 本身收到弹幕
- 在直播电脑打开 LAPLACE Chat。
- 按第 3.2 节选择连接方式:幻星填主播身份码,要求房间号的方式填房间号或链接。
- 对于排队这种要区分“是谁”的功能,优先使用能提供可靠观众身份的连接方式。幻星连接不能提供真实 UID,不能只凭“能看到昵称”就认定排队身份一定正确。LAPLACE 控制台说明
- 在首页底部点击 打开控制台。
- 用手机进入 B 站直播间,发送一条容易辨认的普通弹幕,例如
连接测试01。 - 先确认这条弹幕出现在 LAPLACE 控制台,再进行下一步。
如果 LAPLACE 本身没有收到,先处理它的房间号、登录或网络问题。此时修改排队插件的规则不会解决问题。
5.2 开启 Event Bridge
确认排队主程序已经启动,再在 LAPLACE 控制台 操作:
- 点击右上角的 设置 / 齿轮。
- 在设置面板内向下滚动,找到 Event Bridge。不同 LAPLACE 版本可能把它放在高级或实验功能相关区域;要找的是这个名称,不是 Event Fetcher。
- 开启 Event Bridge。
- 地址填入
ws://127.0.0.1:9696。如果插件已经使用 9698,两边都使用 9698。 - Token / 令牌与排队插件完全一致;新安装没设令牌时,两边都留空。
- 按页面提供的连接按钮连接,或等待开启后自动连接。
- 回到排队插件,查看 LAPLACE Event Bridge 卡片。如有需要,点 重新连接 / 启动桥接。
默认桥接由本工具启动。普通用户不用另下一个桥接程序,也不需要安装 Event Fetcher。官方桥接的默认端口和可选认证机制见 Event Bridge 说明。
5.3 完整验收:一定要再发一条真实消息
- 在手机的 B 站直播间发送
连接测试02。 - 确认 LAPLACE 收到了。
- 确认排队插件的 弹幕与礼物 区域也出现了它。
- 查看插件的“已收到……条事件 / 最近……”是否更新。
- 再发送
/排队,确认自己进入 接下来,而“当前”仍为空。
完成这些才算接通。两边显示“已连接”但没有新消息,只能说明连接存在,不能说明弹幕正在传过来。
如果免费排队关闭,普通 /排队 弹幕不入队是正常规则,不代表桥接坏了。
5.4 直播时保持副屏浏览器活跃
把 chat.laplace.live 加入 Chrome / Edge 的“始终保持活跃”列表,并让 LAPLACE 保持为独立窗口中的当前标签页。官方说明指出:休眠例外不能完全消除后台计时器限制,切标签、最小化或被完全遮住仍可能影响接收。直播时让这个窗口持续显示在副屏,不要切走它的标签页。浏览器后台限制说明
配置完成后发一条真实弹幕确认插件收到,再直接前往第 6 节。
6. 把排队和弹幕放进直播画面
6.1 添加排队挂件
- 在排队控制台找到 OBS 排队挂件 链接,打开它并复制浏览器地址栏中的完整地址。
- 回到 OBS 的游戏场景,在“来源”点 + → 浏览器。
- 新建来源,命名为 ZZZ 排队。
- 把刚复制的地址粘贴到 URL,不勾选“本地文件”。
- 宽度先设
360,高度先设400,之后根据自己的直播布局调整。 - 确定,将它拖到画面合适位置,并放在来源列表的游戏捕获上方。
- 用 OBS 预览检查名字、金额和“当前 / 接下来”是否清楚,再锁定来源。
默认端口时,中文挂件地址示例为 http://127.0.0.1:3667/overlay?lang=zh。英文用 lang=en。优先复制插件实际提供的链接,不要照抄端口示例。 OBS 挂件顶部固定显示当前观众,下方展示全部等待名单。控制台“连接与规则”中的 OBS 排队显示模式(自适应尺寸) 可选择“自动翻页”或“自动滚动”,点击保存后挂件会同步更新。
- 自动翻页(默认):根据来源高度自动计算每页人数,默认每 6 秒换一页(可调 3–30 秒),末页后回到第一页。360×400 通常每页约 4 人;加高来源可以显示更多人。
- 自动滚动:名单缓慢向上滚动,顶部和底部各停留 2 秒,滚到底后回到顶部。
- 等待名单在当前高度下能够全部容纳时,两种模式都保持静止。
- 手动叫下一位时回到开头;普通新增、礼物重排尽量保留正在观看的位置,例行状态同步不会重置进度。调整字体、速度或来源尺寸时会重新开始。
- 在 OBS 浏览器来源的“属性”中修改宽度和高度,挂件会自动重新排版。只在画布上拖动缩放不会改变每页人数。当前观众保持固定,等待区域利用剩余高度。
- 显示真实名次、昵称、金额和中奖星标,隐藏 UID。长昵称会省略,主播可在控制台查看。
如果看到的是一整页设置按钮,说明填成了控制台地址;请改用上面带 /overlay 的挂件链接。
“连接与规则”还可设置 翻页间隔(3–30秒)、滚动速度(5–60像素/秒)、名单字号(12–24) 和 挂件显示金额。保存后同步到挂件。字体越大,每页可容纳人数越少;隐藏金额可以给昵称更多空间。
6.2 选择是否让观众看到弹幕
不想把弹幕播出去:不添加 OBS 弹幕来源,并保持 在 OBS 弹幕源中展示聊天 关闭。桌面窗和手机仍可用于自己看消息。
想把弹幕播出去:
- 在排队控制台“连接与规则”勾选 在 OBS 弹幕源中展示聊天。
- 点击 保存设置。
- 打开控制台中的 OBS 弹幕挂件 链接,复制完整地址。
- OBS 新建“浏览器”来源,命名为 ZZZ 弹幕,粘贴这个地址。
- 可先用
500 × 700的尺寸,按预览调整。 - 发送新弹幕检查。没有消息,或者开关没开时,空白是正常现象。
本插件的弹幕来源是简化显示,不等于 LAPLACE 官方所有模板、动效和礼物展示功能。如果你另外使用 LAPLACE 官方 OBS 链接,就在 LAPLACE 首页配置并复制它;建议只选择一种观众弹幕显示方式,避免同一条消息出现两份。
关闭本插件的聊天开关,只会关闭本插件 /chat-overlay 的输出,不会关闭你另外添加的 LAPLACE 官方弹幕来源。
7. 排队规则与日常叫号
7.1 免费排队
在“接下来”区域打开 开启免费排队。观众发送完整的排队口令,例如 /排队,就会加入等待队列。重复发送不会增加同一 UID 的队列名额。
我要排队 和 排队呀 不等于 /排队。如果你修改了口令,记得把新口令告诉观众。
关闭免费排队后,普通口令不再让观众加入;之前已经在队列里的人不会因此自动移除。
7.2 礼物排队与累计排序
符合最低金额的付费礼物可直接入队,不需要再发送排队口令。金额在等待期间按观众累计;累计越高,排得越前。同额时先入队的人优先。免费礼物和银瓜子不计入付费金额。
| 发生的事 | 等待队列 |
|---|---|
| A 送 1 元 | A:1 元 |
| B 送 2 元 | B:2 元,A:1 元 |
| A 再送 2 元 | A:3 元,B:2 元 |
| 主播点击继续 | A 进入“当前”,B 留在等待队列 |
| B 再送礼 | B 的等待金额继续累计,不会挤掉当前 A |
最低金额按每次收到的有效礼物事件金额判断。比如最低设成 1 元,多次单独发送、每次只有 0.1 元的事件不会自动凑到 1 元入队;有效事件入队后才参与累计。
7.3 正确使用“当前”与“接下来”
- 第一次开始服务观众时,点击 完成当前叫号并继续。
- 等待第一位进入“当前”;开启电脑 TTS 时会叫号一次。
- 为当前观众完成游戏、组队或其他约定操作。
- 完成后再点击同一个按钮,上一位进入完成历史,下一位变成当前。
等待队列为空时,点击继续只会完成当前,不会再叫一个不存在的人。
重播当前叫号:再叫一次当前观众,不推进队列。
等待行的 移除:把该观众直接移出等待队列,不会先叫到当前。误点后可在控制台“当前”卡片点击 撤销上次操作(20秒内)。同样可撤销“完成当前叫号并继续”。只支持最近一次操作;过期、重启或状态冲突后不能撤销。撤销不会重新播报,但不能收回已经听到的叫号;之后的新入队和有效礼物会保留。
当前观众的再次排队或送礼不会让其同时出现在等待队列;完成后可重新参加,新一轮重新计金额。队列显示的金额不是该观众终身消费总额。
7.4 暂停入队、暂停聊天有什么区别
| 操作 | 实际作用 |
|---|---|
| 取消“开放排队”并保存 | 暂停正常的口令与礼物入队;保留已有队列,仍可叫号 |
| 关闭“开启免费排队” | 禁止免费口令入队,仍允许符合门槛的礼物 |
| “暂停滚动” | 暂停本页面消息区的显示更新,不停止接收,不停止排队 |
| “取消”抽奖 | 停止当前抽奖;不是清空普通队列 |
“开放排队”开关不取消已开启的抽奖。需要两者都暂停时,分别暂停排队并取消抽奖。
8. 抽奖:口令或礼物报名
8.1 先设规则,再开抽奖
在“连接与规则”设置并保存:
- 抽奖口令:例如
抽奖。不想与普通排队一起触发,就不要与排队口令设成一样。 - 抽奖时长:例如
60秒;可设置 5–86400 秒。 - 允许礼物参加抽奖:不想让礼物报名就取消勾选。
- 抽奖礼物名称:填写实际礼物的完整名字,不填写 ID;同名不同 ID 的礼物都可匹配。留空表示任意达到金额门槛的有效礼物。
- 礼物报名使用同一“最低礼物金额”门槛。
礼物名可从收到的礼物记录确认。当前控制台不提供房间礼物图鉴。礼物报名和口令报名是“任选一种”,不是“必须送礼后再发口令”。
8.2 开始与结束
- 在 幸运观众 区域点击 开启抽奖。
- 把报名口令、礼物规则和剩余时间告诉观众。
- 开启之后,观众发口令或送符合规则的礼物才能报名。
- 每位观众在同一轮只有一份报名资格;重复发送不会增加抽中权重。
- 倒计时结束后自动开奖;也可以点 立即开奖 提前结束。
- 想中止这一轮就点 取消。
抽奖开启时会记住这一轮的规则;中途改设置不改变正在进行的一轮。想用新规则,请取消后重新开启。没有报名者时会结束,不产生中奖者。
8.3 中奖后会怎样
中奖者进入 接下来第一位,不会自动打断当前观众,也不会自动叫号。主播点击“完成当前叫号并继续”时才轮到中奖者。
中奖者优先于普通礼物排序;后续新的中奖者会排在之前中奖者前面。已经在普通等待队列里的中奖者会在原条目上置顶,不额外复制一行。当前观众不会再次被抽中进入等待队列。
符合普通礼物排队规则的礼物,也可能同时让观众进入普通队列和本轮抽奖报名。未中奖并不等于从普通队列移除。免费排队关闭时,抽奖口令报名仍然有效。
9. 设置叫号语音,并确认观众听得见
TTS 就是“让电脑把文字读出来”。这里有两套独立语音:
| 语音 | 在哪里设置 | 什么时候说话 |
|---|---|---|
| 排队叫号 | 本插件“语音播报” | 主播手动继续或重播当前 |
| LAPLACE 弹幕播报 | LAPLACE 自己的设置 | 按 LAPLACE 规则读弹幕与礼物 |
9.1 开启电脑叫号
- 在排队控制台的“连接与规则”选择 叫号语音语言:中文 / English,保存。
- 在“语音播报”勾选 电脑后台 TTS。
- 等状态显示语音就绪。
- 点击 测试电脑语音。
- 确认耳机或扬声器里听到了测试句。
电脑后台 TTS 使用 Windows 安装的语音,不依赖排队控制台标签页一直显示。切换界面语言不会自动改变叫号语言;两者分别设置。
启用此设备 TTS 是浏览器播报的备用方式,不是必点按钮。电脑后台 TTS 开启时,不要再让手机也播一份。浏览器方式还可能受标签页休眠或自动播放限制影响。
9.2 检查 OBS 是否录到了声音
- OBS 的混音器里,确认用于采集电脑声音的音频来源没有静音。
- 点击“测试电脑语音”,观察对应音量条是否跳动。
- 做一段十几秒的 本地录制,不用正式开播。
- 停止录制并播放文件,确认里面能听到叫号。
如果你平时只捕获游戏应用的声音,叫号可能不会被游戏音轨收进去。请让 OBS 采集 TTS 实际输出的电脑音频设备。避免同时用两条来源重复捕获同一份电脑声音,否则可能有回声。
9.3 如果还想让 LAPLACE 读弹幕
无副屏时,右键 OBS 中的 LAPLACE 接收端 → 交互,打开 Dashboard 右上角的齿轮,在其中开启 TTS / 自动朗读,并配置语音服务。发送一条新弹幕测试。我们已在 OBS 32.2.2 中实测:Dashboard 来源开启 TTS 后能听到播报;同一个房间的 /obs/ 展示链接能显示弹幕,但不会因此自动启用 Dashboard 的 TTS。LAPLACE TTS 官方说明
若 OBS 来源显示弹幕但主播听不到:在该浏览器来源“属性”中开启 通过 OBS 控制音频;到 OBS 设置 → 音频 → 高级,把监听设备设为主播耳机;在混音器的 高级音频属性中将该来源设为 监听并输出(主播和观众都听)或 仅监听(只让主播听)。观察来源音量条:不动时先检查 Dashboard 内 TTS 是否真正开启,跳动但耳机无声时检查监听设备。若同时捕获耳机的桌面音频,可能重复收音,开播前做一段本地录制确认。OBS 浏览器来源说明
有副屏时,则在副屏的 LAPLACE Dashboard 设置面板开启 TTS。首次建议先验证本插件叫号,再添加弹幕播报,容易判断声音来自哪里。
手动叫号能避免“刚入队就自动说话”,但不会自动暂停 LAPLACE 正在读的弹幕。希望完全避开重叠时,可关闭 LAPLACE 弹幕 TTS,或等它读完再手动叫号。
10. 用桌面悬浮窗边玩边操作
- 右键主托盘图标,选择 打开桌面悬浮窗。
- 屏幕上会出现队列与聊天窗口。默认是鼠标穿透:点击会落到后面的游戏,不会点中悬浮窗。
- 需要操作时,同时按 Ctrl + Alt + Q。
- 进入操作模式后,可点 完成当前并继续、重播、抽奖、开奖、语音测试、控制台,也可移除等待观众。
- 在操作模式拖动顶部标题,把窗口移到合适的位置。
- 操作完,再按 Ctrl + Alt + Q 返回穿透模式。
- Ctrl + Alt + H 隐藏或重新显示悬浮窗。
快捷键被其他程序占用时,可通过悬浮窗自己的托盘菜单切换模式。主程序和悬浮窗各有托盘入口:悬浮窗菜单“退出悬浮窗”只关它;主程序菜单“退出并停止服务”才是完整退出。
游戏建议使用 无边框窗口 / 窗口化。独占全屏模式可能把悬浮窗挡住。
如果不想让观众看到悬浮窗,优先用 OBS 的 游戏捕获 并实际检查录制。显示器捕获 会录整块屏幕,通常也会把悬浮窗录进去。关闭“OBS 弹幕输出”不能隐藏已经被显示器捕获拍到的窗口。
11. 用手机或平板管理排队
手机只负责遥控,不需要安装本插件,也不需要在手机上设置桥接。
- 保持直播电脑上的主程序运行。
- 电脑和手机连接同一个家庭 / 工作室局域网。电脑用网线、手机用同一路由器 Wi-Fi 也可以。
- 在插件文件夹里运行 enable-lan.cmd。Windows 询问管理员授权时允许它为本插件添加局域网访问规则。
- 在电脑排队控制台找到 手机 / 平板控制。
- 将显示的完整地址输入手机浏览器,例如
http://192.168.1.20:3667/live。 - 按提示输入电脑上显示的 八位配对码。
- 手机出现队列与控制按钮后,就可以操作叫号、抽奖等功能。
手机不能填写 127.0.0.1 或 localhost:在手机上,它们表示手机自己,不是直播电脑。也不要在手机地址栏里输入 ws://…:9696。
配对会话约 12 小时有效;重启服务后可能需要重新配对。换 Wi-Fi、路由器重启、电脑地址改变后,重新查看电脑控制台的地址,不要一直使用旧收藏。
如果有多个地址,先试与你手机处于同一家庭 Wi-Fi 网段的地址;不要优先选 VPN 或虚拟网卡地址。访客 Wi-Fi 可能禁止设备互相访问,需要换普通 Wi-Fi。
手机去刷视频、切到其他应用,不会停止电脑后台排队和叫号。回来后刷新页面即可查看最新状态;不要依赖手机浏览器后台 TTS 来承担电脑叫号。
12. 不花钱演练一次完整流程
请在没有真实观众排队时进行。模拟功能会写入正在使用的真实队列,不是隔离练习场。
- 打开免费排队,确认当前和等待队列都没有要保留的人。
- 找到 模拟弹幕 / 礼物。
- UID 填
900001,昵称填测试A,弹幕填实际排队口令,点击 发送弹幕。 - 确认 A 出现在“接下来”,当前仍为空,电脑不会自动叫号。
- 改 UID 为
900002、昵称测试B,金额填2,点击 赠送礼物。 - 确认 B 因有效礼物金额排在免费 A 前面。
- 点击 完成当前叫号并继续:B 进入当前;电脑 TTS 开启时应播报 B。
- 开启抽奖,换第三个测试 UID,发送实际抽奖口令,点击 立即开奖。
- 确认中奖者在等待第一位,当前 B 没有被挤掉,也没有自动叫号。
- 完成后移除剩余测试等待条目;当前若仍是测试用户且等待队列已空,再点一次“完成当前叫号并继续”结束它。
模拟测试通过,只能证明本插件规则和播报正常;它不验证 LAPLACE 是否真正接通。开播前仍需发送一条真实 B 站弹幕。
13. 每次开播与下播怎么做
开播前
- 启动
ZZZ Queue.exe,确认托盘存在。 - 有副屏:保持副屏 LAPLACE 控制台运行;无副屏:打开 OBS,让第 4 节的 LAPLACE 接收端运行。
- 检查插件的房间号、排队开关和最低金额。
- 从手机发一条编号测试弹幕,确认插件收到。
- 点击“测试电脑语音”,观察 OBS 音量条;第一次使用或换设备后做一次本地录制。
- 检查 OBS 预览:只有打算播出的挂件,没有配对码、同步密钥或后台设置页。
- 打开桌面悬浮窗或手机面板,再正式开播。
直播中出现异常
先看本手册第 15 节。需要重启时,在主托盘右键选 重启服务。它会先停止旧服务,再启动;不要立即又启动另一个版本。慢机器等待就绪后再测试新弹幕。
重启会短暂断开控制台、手机和桥接。重新配对或重新连接后发送新弹幕验证;断开期间错过的事件不能假定会自动补回。
下播后
- 结束直播。
- 在主托盘选择 退出并停止服务。
- 确认主托盘图标消失。
- 再按需关闭 OBS 与 LAPLACE 页面。
仅关闭悬浮窗或排队网页不会停止主服务。反过来,承担接收任务的 LAPLACE 页面若关闭,真实弹幕来源就可能中断。
14. 升级、换文件夹与保留数据
日常升级:打开控制台,滑到整页最下方的 软件更新;发现新版本时点击 一键更新。软件会自动下载、校验、备份、停止旧版、安装并重启,保留程序目录;旧版外部数据会迁入安装目录内的 data。队列、群绑定和观众验证记录会保留。请在方便短暂中断服务时再点击,不会未经点击自动安装。
查找数据:从主托盘选择“打开数据目录”。新安装版和便携版默认使用程序旁的 data,已升级安装版统一使用安装目录内的 data。备份在数据目录的 backups 内;卸载安装版会保留数据。
换盘或搬迁数据:先退出软件,再备份并复制完整数据目录;保留备份并按安装与升级指南恢复到实际数据目录。详细步骤见 安装与升级指南。数据可能包含令牌和观众记录,请勿公开上传。重启不会清空队列。
15. 常见问题:按症状排查
A. 双击 EXE 没看到控制台
先展开 Windows 右下角隐藏图标,看看主程序是否已在运行。点击图标打开控制台;没有图标则检查是否完整解压、有无被移动的配套文件。启动失败提示出现后,不要只留 EXE 再试。可查看 data/tray-error.log 和 data/server-error.log 的最近错误。
B. LAPLACE 连接 9697 一直失败
新安装两边改成 ws://127.0.0.1:9696,保存后在插件点击“重新连接 / 启动桥接”,再回 LAPLACE 连接。已有 9698 配置可以两边统一为 9698。确认输入的是 ws://,不是网页的 http://,也不是手机局域网地址。
C. 两边都显示已连接,但排队插件没消息
先发新消息,看 LAPLACE 自己是否收到。收到了,再检查它的 Event Bridge 开关、地址、令牌和插件房间号。普通浏览器设置好,不代表 OBS 交互窗口也设置好了。只保留一个选定的接收端转发该房间。
D. 插件能显示弹幕,但发送“排队”不入队
检查“开放排队”是否开启、免费排队是否开启、口令是否完全相同、该观众是否已经在等待或当前。免费排队关闭时,需有效付费礼物或符合抽奖流程。
E. 礼物不计入 / 名次不对
检查是否付费礼物、是否达到单次事件的金额门槛、是否来自正确房间。当前观众不会因再次送礼挤入等待队列;中奖置顶也会优先于普通金额排序。排除规则原因后,记录发生时间、礼物名和数量,以便反馈。
F. 中奖后没叫号
这是设计行为。中奖者先进入“接下来”,主播点击“完成当前叫号并继续”才会叫号。
G. 电脑听不到叫号
先打开“电脑后台 TTS”,等待就绪并点测试;检查 Windows 输出设备和音量。只有手动继续 / 重播才叫号,普通进队不叫号。语音不可用时,在 Windows 设置中搜索“语音”,检查相应语言语音是否安装,再重启插件。
H. 电脑能听到,观众听不到
看 OBS 音量条并本地录制。仅采集游戏音频时可能漏掉 Windows 叫号;确认捕获的是实际播放 TTS 的音频设备,且对应输出音轨用于直播。
I. 两个声音同时读、或者有回声
区分电脑后台 TTS、手机 / 浏览器 TTS、LAPLACE 弹幕 TTS。叫号优先只保留电脑后台 TTS。回声还应检查 OBS 是否重复捕获同一音源。手动叫号不会自动暂停独立的弹幕播报。
J. 悬浮窗点不动 / 游戏挡住它
点不动先按 Ctrl+Alt+Q 切操作模式。看不到先按 Ctrl+Alt+H,再检查游戏是否为独占全屏;切无边框窗口后测试。快捷键冲突时使用悬浮窗托盘菜单。
K. 手机打不开、一直连接失败
确认主服务运行、手机使用控制台显示的局域网 http:// 地址、连接同一路由器、已执行 enable-lan.cmd,并排除访客 Wi-Fi 隔离。重启或换网络后重新查看地址和配对码。不要输入 127.0.0.1。
L. OBS 弹幕来源一片空白
先展开控制台“弹幕与礼物”下面的 弹幕诊断预览(仅主播)。它会区分输出开关关闭、桥接未连接、尚无事件、收到事件但本房间没有聊天等状态,并预览最近消息。该区域只在已授权控制台显示,不会添加到 OBS 挂件,也不会注入模拟消息。
先在插件开启“在 OBS 弹幕源中展示聊天”并保存,再发新消息。确认 URL 是 /chat-overlay,且端口与控制台一致。默认关闭或暂时没有消息时,空白正常。
M. 一切正常,切标签 / 切场景后就断了
检查真正负责接收的 LAPLACE 页面是否被后台挂起或卸载。副屏浏览器按第 5.4 节处理;OBS 按第 4 节检查来源存活设置和各场景配置。排队网页关掉与 LAPLACE 接收页面关掉不是一回事。
N. 问题仍未解决,怎样反馈
到 GitHub Issues 说明:插件版本、EXE 还是 Python 版、Windows / OBS 版本、在哪一步失败、LAPLACE 是否能收到新消息、插件是否有新事件,以及完整错误文字。截图前遮住同步密钥、桥接令牌和配对码;不要直接上传整个 data 文件夹。
16. 最后留一张日常速查卡
| 我想…… | 应该做什么 |
|---|---|
| 开始运行 | 双击 ZZZ Queue.exe |
| 找回控制台 | 点击主托盘角色图标 |
| 让下一位上场 | 完成当前叫号并继续 |
| 再叫一次当前 | 重播当前叫号 |
| 暂时不收新人 | 关闭“开放排队”并保存;需要时另行取消抽奖 |
| 禁止免费排队 | 关闭“开启免费排队” |
| 开一次抽奖 | 先保存规则,再点“开启抽奖” |
| 操作悬浮窗 | Ctrl+Alt+Q |
| 隐藏悬浮窗 | Ctrl+Alt+H |
| 手机遥控 | 同一局域网 → 电脑显示的地址 → 八位配对码 |
| 重新启动 | 主托盘 → 重启服务 |
| 完全退出 | 主托盘 → 退出并停止服务 |
本手册按 v1.14.7 的控制台与安装流程更新;LAPLACE、浏览器和 OBS 的菜单可能随版本调整。外部设置以文中链接的官方说明为准,遇到改版请按功能名称查找,不要照搬不同软件的端口或密码。
等待时间与图标
控制台和 OBS 排队挂件同时展示累计金额与等待时间。累计金额越高排名越前;相同金额按本次首次入队先后排序,抽奖中奖者仍优先置顶。追加礼物、重复发送排队口令不会重置等待时间。主播移除后重新入队才开始新的计时;撤销移除会恢复原时间。叫号后显示该观众叫号前的总等待时长。
旧版本的已有名单没有记录入队时间,会显示“等待时间未知”,直到该观众重新入队。刷新控制台或 OBS 浏览器源即可加载新布局。悬浮窗使用独立托盘图标;控制台图标保持不变,重新打开悬浮窗即可生效。
大航海优先与手动记录合并
等待队列按“抽奖置顶 → 总督 → 提督 → 舰长 → 普通观众”排列;同身份比较累计礼物金额,金额相同则先入队者优先。大航海身份来自收到的事件,控制台及挂件会显示标签。
免费排队关闭时,总督、提督、舰长仍可发送排队口令入队,有效付费礼物低至 0.01 元也可入队;主播暂停整个队列时仍暂停接收。身份按最新事件更新;明确收到普通观众身份后取消优先权。主播端会定期同步直播间舰队名单,更新身份及过期状态;网络同步失败时请查看控制台状态。
所有昵称完全相同的等待记录都会自动合并,包括旧名单,无需手动标记。金额相加(例如站外收款 20 元加 B 站礼物 10 元,累计为 30 元),保留较高排名记录的入队时间和置顶状态,再按合计金额排序。收到真实弹幕或礼物时改用该事件的 UID;之后手动补录不会覆盖已确认的真实 UID。合并会取消此前的撤销,避免恢复出重复记录。昵称是合并依据,因此不同真实账号同名也会合并。
服务启动时也会整理旧名单的重复记录;没有新事件时不会猜测哪个旧 UID 是真实 UID,后续收到观众事件再更新。
盲盒按每条事件当次开出的单价 × 数量计算金额、入队门槛和抽奖礼物门槛;同名礼物不同次开出可以有不同价值,不缓存固定单价。缺少开出价值时使用该次盲盒购买价,并在弹幕区标注“按盲盒购买价”。优先使用实际支付总价,否则使用盲盒单价 × 数量;两种价格均缺失时才不计金额。
17. 可选:公共 QQ 机器人排队与绝区零查询
主播安装包只包含本地控制台、队列和挂件。机器人及绝区零查询在公共服务器运行,主播无需申请机器人、填写 AppSecret、安装 Docker 或下载查询贴图。
公共服务地址为 https://qq.zenlesszonezero.fans,已迁移至云服务器,不依赖作者电脑在线。主播自己的助手仍需保持运行;主播电脑关机或休眠时无法从群里操作该队列。
- 通过然神🤖官方入口,由群主或有权限的管理员邀请机器人加入目标群,并允许主动发言。
- 打开本机控制台「QQ机器人与云服务」,展开「账号申请与验证 / 换电脑」。普通申请先在「连接与规则」保存自己的直播间,再填写联系QQ,确认「云端存储授权」,完成本人QQ私聊验证、提交申请、直播间标题验证,等待管理员批准。一项审核同时开通QQ机器人和云备份;未获批的旧群绑定也不能绕过。
- 如果管理员已给你一次性领取口令:展开「管理员已给你领取口令?」,填入I开头口令,确认存储范围后直接点击领取,无需额外QQ私聊验证。领取会设置指定的直播间和群号,无需再改标题或等待审核。口令7天有效,只发给指定主播,不要放在群里。管理员已预选实际群时,直接到「群绑定与排队」核对并确认目标群。
- 未预选群时,获批后展开「群绑定与排队」,填写自己的数字群号,开启QQ群文字排队并保存,再生成群绑定码。服务地址默认官方地址,无需更改。
- 用主播自己的QQ私聊机器人发送
/绑定 XXXXXXXXXX;在目标群真正 @机器人发送/帮助取得群接入码,再私聊发送/绑定群 群接入码 XXXXXXXXXX。回本机控制台核对并确认群。绑定码5分钟有效,群接入码10分钟有效。 - 观众先真正 @机器人发送
/绑定B站,按提示到直播间发送短码并等待自动成功通知,再发/排队。发/zzz帮助可查询帮助。手打昵称不等于真正 @。群内业务需要该群主播的服务账号已获批;群排队还需本机助手在线。
详细申请、邀请领取、云备份与换电脑步骤见云服务与备份指南。
主播点击「完成当前叫号并继续」时才会把下一位升到当前,触发语音和群通知;排队成功不代表已经叫号。「你正在当前位」表示这位观众已被叫号,尚未由主播完成。
需要米游社登录才能使用的绝区零查询:观众先在群内真正 @机器人发送 /zzz绑定UID自己的绝区零游戏UID,然后由同一个 QQ 账号在群内发送 /zzz扫码登录。机器人会 @发起人提示并发二维码;只由本人用米游社 App 扫描并确认。群内二维码所有成员都看得见,不能把 @ 当成二维码的访问限制。服务器会在保存凭据前核对扫码账号确实拥有该 QQ 账号事先绑定的绝区零 UID;不匹配则拒绝保存。登录后再试 /zzz刷新面板。这只影响公共机器人,主播端无需重装。
多人同时扫码时,先看二维码消息所回复的成员昵称,确认是自己发起的那张;登录完成或二维码过期的提示也会 @对应发起人。不要扫描别人的二维码。
18. QQ 身份绑定、红包和自定义叫号
18.1 观众验证 B 站 UID
在已绑定的群真正 @机器人发送 /绑定B站,无需填写UID。机器人回复短码,例如 绑定123456。在5分钟内,用要绑定的B站账号在主播直播间发送这条8字符弹幕,助手会自动读取真实发送者的UID和昵称。助手会自动在QQ群通知绑定成功,不需要再发送 /查看绑定;可用 /解绑B站 解除。不要把验证码转给别人。详细步骤见 QQ UID 绑定指南。
主播端会定期同步该直播间的大航海名单,不需要观众先发弹幕才能更新。等待队列按抽奖置顶、总督、提督、舰长、普通观众排序;同身份比较金额,再比较首次入队时间。同步长期失败时不会一直保留过期优先权,控制台会显示同步状态。
18.2 红包排队:先申报,再核对
观众发送专属红包后,在群里真正 @机器人发送 /红包排队 1.23,表示申报人民币 1.23 元。机器人无法直接读取 QQ 红包到账金额:新观众先在队尾待核对,已有观众保持原名次,申报金额不立即入账。
主播打开控制台「红包待核对」,核对真实领取记录;可将金额改为实际收到的金额,再确认入账。确认后金额才累加并按身份、金额、等待时间重新排名。错误或重复申报应驳回;不要凭申报文字直接确认。详情见 红包排队指南。
18.3 设置语音和 QQ 群叫号词
语音叫号词在「连接与规则 → 叫号语音」中保存;QQ叫号词在「QQ机器人与云服务 → 群绑定与排队」中保存。{name} 会自动换成当前观众昵称,{uid} 会自动换成队列中的用户码。花括号和里面的英文必须保留,不用每次换成观众的名字。留空使用默认词。
| 设置项 | 可直接复制的内容 | 假设昵称是小明、用户码是 12345678,实际效果 |
|---|---|---|
| 语音叫号词 | 轮到 {name} 了,请加入游戏。 |
电脑播报「轮到 小明 了,请加入游戏。」 |
| QQ 群叫号词 | {name},轮到你了,请查看直播。 |
机器人真正 @小明,再发送「小明,轮到你了,请查看直播。」 |
| 带用户码的语音词 | 轮到 {name},用户码 {uid},请做好准备。 |
电脑播报「轮到 小明,用户码 12345678,请做好准备。」 |
QQ 叫号词里不用写 @小明 或任何 @标签;机器人会根据已记录的 QQ 身份自动提及。观众完成 UID 绑定最可靠;仅按昵称匹配时,需要 QQ 群昵称与 B 站昵称相同并曾 @过机器人,同名或无法确定身份时只发送文字。
两项分别控制电脑语音和 QQ 消息,可以填不同内容。点「测试语音」检查电脑播报;「重播当前叫号」会给真实当前观众重播并发送群通知,请在合适的时候使用。
指定叫号与更新范围
点击等待列表的「指定叫号」会将原当前观众放回等待队列,再叫所选观众,不会完成原任务。悬浮窗在操作模式可点击「叫号」。待核对红包记录不能直接叫号。详见 主播端与服务器更新范围。
主播需解除QQ群连接时,请用原绑定QQ私聊机器人发送 /解绑群。只解除自己的群连接,不删除主播端任务。
1.12.4 的 QQ 排队与红包显示
群成员必须先 /绑定B站,完成短弹幕验证,收到自动验证成功通知后,才能 /排队 或 /红包排队 金额。未绑定不会进入队列;绝区零查询仍可使用。红包待核对卡只在主播控制台有待处理申请时出现,全部确认或驳回后自动隐藏;OBS挂件不显示核对说明或操作表单。
身份保存与私聊帮助(1.12.5)
主播私聊机器人发送 /帮助 获取完整接入步骤。绑定和解绑群只能私聊操作,群里仅可通过 /帮助 获取接入码。身份在 data/qq-identities.json 持久保存,升级迁移完整data后自动恢复。短弹幕验证成功会自动回复,不需要额外 /查看绑定。
等待中的观众可在直播间发送 取消排队,或在QQ群真正 @机器人发送 /取消排队。QQ用户需先完成B站验证,只能取消自己的等待记录及待核对红包申请;当前位任务请联系主播处理。已入队者追加礼物继续累计,最低金额只用于新观众入队。已有队列或当前位再次申报红包时,金额旁保留已入账金额,并显示“待核对”标记。
控制台和 OBS 排队挂件在公共 QQ 机器人已连接并绑定群时,只为尚未通过 QQ↔B站 UID 验证的观众标记“未绑定”;当前位和等待队列均适用,已验证者不显示徽标。
游戏登录二维码(v1.13.0)
主播可配置 OBS 游戏来源和二维码区域,点击「完成当前 · 叫号并发送登录码」将游戏客户端显示的登录码发到绑定群;过期或发送失败时使用「重发当前登录码」。第一次使用先测试识别,详见 设置及验收步骤。这与查询 Cookie 的 /zzz扫码登录 是两个独立流程。
19. 群内查看实时排队列表(v1.13.1)
真正 @机器人发送 /排队列表,例如 @然神🤖 /排队列表。机器人显示当前位、等待人数及前20位等待观众,含金额和红包待核对标记。查询不会叫号、退出或改变名次;后续送礼及主播操作可能改变顺序。
查看名单不需要绑定 B站账号;入队和红包申报仍必须验证绑定。主播必须升级到1.13.1并保持助手在线,群仍使用原绑定,不用再次绑定。超过20人时显示剩余人数,完整名单可看直播排队挂件。详细说明见 QQ排队列表。
20. Windows安装版与保留数据升级
首次安装只选程序目录,数据默认放在其中的 data;旧版独立目录会自动备份并迁移到安装目录内,卸载保留数据。托盘提供打开数据目录及检查更新入口。完整步骤见 安装与升级指南。
21. 自动检查与一键更新
下载地址为 https://download.zenlesszonezero.fans ,无需GitHub。启动或打开控制台时自动检查版本,发现新版本后点击更新卡片中的“一键更新”,即可自动下载、校验、备份、升级并重启。队列与身份绑定保留,安装版统一使用安装目录内的 data。不会在直播期间未经点击后台自动安装。1.14.4 及以后用户可直接一键更新。
22. 在软件内阅读本手册
控制台顶部点击 使用指南,会打开随软件安装的本地手册,无需联网。也可以从程序目录的 docs 文件夹打开 USER-GUIDE.zh-CN.html;相关专题也已附为可直接阅读的 HTML 文件。外部网站和在线服务仍需网络。
在线使用指南 与软件内手册来自同一份内容。更新软件会更新附带手册;查看在线版可了解最新说明。
控制台的 软件更新 位于整页最下方,不占用当前位和队列的顶部空间。也可以通过托盘“检查更新 / 下载新版”直接跳到该卡片。
19. 云备份、换电脑与丢失 data
在「QQ机器人与云服务 → 云备份与恢复」点击「立即备份」。自动备份选项默认关闭,勾选并保存后,每次启动主播端备份一次;成功后本次运行不再定时上传,打开网页不会重复备份。网络失败会限频重试。最近完成记录可单独选择是否包含。
换电脑时用原QQ验证并提交同一直播间,再明确启用新设备;选择备份并预览、确认恢复。恢复会替换本机队列和可迁移设置,不自动叫号;OBS密码、Cookie和连接令牌不随云备份上传。
没有云备份就不能完整找回丢失的data。 服务器可能仍有群连接与观众身份记录,但不会因此保存原等待名单、金额和本机设置。旧群仍被占用时不要先解绑:解绑会清除服务器成员身份记录。先用原QQ私聊 /查看群,联系管理员核对恢复;1.14.7尚未提供一键恢复旧绑定的入口。
联系与反馈
需要管理员协助时,可通过B站私聊或邮件 contact@zenlesszonezero.fans 联系。请提供版本号、状态文字与操作步骤,不要发送完整data、Cookie或连接令牌。
1.14.7 群连接自动修复
修复领取成功却提示“本地QQ群绑定或排队设置不匹配”的问题。已批准且已绑定的客户端会在启动、领取或切换设备后,先同步服务器确认的群标识及现存观众身份,再启动群消息与身份同步。若发现本机与服务器的群或UID冲突,会保留记录并提示核对,不盲目覆盖。没有原客户端凭据、又没有云备份时,仍需管理员处理旧设备迁移。