应用图标
绳匠委托终端 · 新手手册

无需编程知识 · 适用 v1.14.7 · 离线可读

返回下载与指南本文件可独立保存或发送给其他主播;外部链接需要联网。

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 安装版

  1. 打开 官方下载站,点击 下载安装包 · 推荐。无需访问 GitHub。
  2. 双击下载的 ZZZ-Queue-版本号-install.exe,选择中文或 English。
  3. 选择程序目录,例如 D:\Apps\ZZZQueue,用于保存软件文件;也可以直接使用默认目录。
  4. 数据自动保存在安装目录内的 data 文件夹,用于保存队列、设置、QQ 身份绑定和日志,无需再选择位置。旧版独立数据目录会自动备份并迁移到这里,原目录保留副本。
  5. 完成安装后,从桌面或开始菜单打开 ZZZ Queue。
  6. 以后在控制台页面最下方的“软件更新”点击“一键更新”,软件会自动下载、校验、备份、安装并重启。直播中不会未经点击自动安装。

下载站也保留便携 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 的设置。

  1. 打开 LAPLACE Chat 首页,先选择连接方式。
  2. 选择“开放平台 / 幻星”时,需要填写主播身份码,而不是直播间号。 打开 哔哩哔哩幻星,登录自己的主播账号,在首页右下角找到并复制身份码。回到 LAPLACE,将它粘贴到该连接方式的身份码输入位置。具体位置以当前页面为准。官方设置说明
  3. 选择其他要求房间号或房间链接的连接方式时,按页面提示填写自己的直播间号或链接,不能用身份码代替。不同方式需要的内容不同。
  4. 排队插件里的“直播间 ID”始终填写房间数字,不要填身份码、自己的账号 UID、桥接令牌或手机配对码。确认 LAPLACE 实际连接的房间与这里一致。
  5. 配好后使用首页的“打开控制台”。如果当前连接方式提供专用链接,请使用页面实际生成的地址,不要把身份码拼进示例房间地址。身份码和含配置凭据的链接不要展示在直播画面中。
  6. 用手机发送普通测试弹幕,确认 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 建立一个专用的接收来源

  1. 打开 OBS,选择平时直播游戏用的场景。
  2. 在 来源 区域点击 + → 浏览器。
  3. 新建来源,命名为 LAPLACE 接收端—不要展示。
  4. 不勾选“本地文件”。先在普通浏览器的 LAPLACE 首页按第 3.2 节确认连接方式、房间号或身份码,再把实际使用的 Dashboard 控制台地址填入 OBS 来源,例如 https://chat.laplace.live/dashboard/446277(换成自己的房间)。/obs/ 是观众看到的展示页,不能用它代替需要设置 Event Bridge 和 TTS 的 Dashboard。
  5. 宽度可先填 1280,高度 900,便于设置时操作。这是本手册的起始尺寸,可自行调整。
  6. 取消勾选“不可见时关闭源 / Shutdown source when not visible”。
  7. 建议也取消“场景激活时刷新浏览器”,避免切场景时反复重新加载。
  8. 确定后,右键这个来源 → 交互。
  9. 在交互窗口确认 Dashboard 显示自己的直播间。用手机发一条 连接测试01,先确认 LAPLACE 自己能收到。OBS 内的 Dashboard 可以直接使用右上角齿轮设置,不必通过交互窗口跳转到新标签页;交互窗口不能正常打开新页时,回到来源“属性”修改 URL。
  10. 在交互窗口内点击 LAPLACE 右上角的 设置 / 齿轮,向下找到 Event Bridge 并开启。
  11. 桥接地址填 ws://127.0.0.1:9696;如果排队插件使用 9698,这里也用 9698。令牌与排队插件一致,没设令牌时两边留空。
  12. 按页面的连接按钮或等待自动连接。回到排队插件,必要时点击 重新连接 / 启动桥接。
  13. 从手机发送 连接测试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 来源列表中,越靠上的来源,画面越在前面。建议按下面顺序排列:

  1. OBS 排队挂件 / 可选的弹幕挂件。
  2. 游戏捕获。
  3. 一张铺满画布的不透明“颜色源”,例如黑色,作为遮挡底板。
  4. LAPLACE 接收端—不要展示。

颜色源可以通过“来源 → + → 颜色源”创建。它应放在游戏下方、LAPLACE 上方;这样游戏没打开时,LAPLACE 控制台也不会从后面露出来。确认预览后锁定这些来源,减少误拖动。

保持 LAPLACE 接收端的眼睛图标开启,并保留在当前活动场景中。 不要用关闭眼睛作为本流程的遮挡方式;使用上面的不透明来源遮挡。OBS 官方说明:启用“不可见时关闭源”会卸载页面,场景激活刷新也会重新加载。OBS 浏览器来源说明

有多个直播场景时,使用“添加现有来源”复用这个接收端,并在每个相关场景放好遮挡底板。不要新建多个不同的 LAPLACE 接收端,让它们同时重复转发同一房间。

4.3 做一次后台测试

  1. 用 OBS 的“交互”确认 LAPLACE 桥接已连接。
  2. 从手机发送 后台测试01,确认排队插件收到。
  3. 关闭交互窗口,切回游戏。不要关闭 OBS。
  4. 从手机发送 后台测试02,在手机排队面板或桌面悬浮窗中确认出现。
  5. 切换到平时会用的另一个 OBS 场景,再发送 后台测试03。

这套流程已有短时测试依据;不同 OBS 版本、显卡和场景设置仍需在自己的电脑上验证。准备长时间直播前,按平时的游戏方式运行一段时间,期间发送几条编号消息检查是否持续收到。

4.4 每次直播保持这套方案运行

  1. 启动排队主程序,再打开 OBS。
  2. 确认当前场景包含配置好的 LAPLACE 接收端,来源没有关闭。
  3. 发一条真实弹幕,确认手机面板或桌面悬浮窗收到。
  4. 保持 OBS 运行,就可以切回游戏;不需要另开第 5 节的副屏浏览器接收方案。

接下来前往第 6 节,添加观众看到的排队挂件。这里的 LAPLACE 接收端负责收消息,第 6 节的挂件负责展示队列,用途不同。

5. 可选方案:仅有副屏时,在浏览器运行 LAPLACE Chat

仅适合有副屏且能持续显示 LAPLACE 的用户。没有副屏请返回第 4 节,不要使用本节浏览器方案:页面被后台挂起时会漏收弹幕和礼物,影响入队与金额统计。 将 LAPLACE 控制台放在副屏,主屏用来玩游戏。本节完成后直接前往第 6 节,不需要再配置第 4 节的 OBS 接收端。

5.1 先让 LAPLACE 本身收到弹幕

  1. 在直播电脑打开 LAPLACE Chat。
  2. 按第 3.2 节选择连接方式:幻星填主播身份码,要求房间号的方式填房间号或链接。
  3. 对于排队这种要区分“是谁”的功能,优先使用能提供可靠观众身份的连接方式。幻星连接不能提供真实 UID,不能只凭“能看到昵称”就认定排队身份一定正确。LAPLACE 控制台说明
  4. 在首页底部点击 打开控制台。
  5. 用手机进入 B 站直播间,发送一条容易辨认的普通弹幕,例如 连接测试01。
  6. 先确认这条弹幕出现在 LAPLACE 控制台,再进行下一步。

如果 LAPLACE 本身没有收到,先处理它的房间号、登录或网络问题。此时修改排队插件的规则不会解决问题。

5.2 开启 Event Bridge

确认排队主程序已经启动,再在 LAPLACE 控制台 操作:

  1. 点击右上角的 设置 / 齿轮。
  2. 在设置面板内向下滚动,找到 Event Bridge。不同 LAPLACE 版本可能把它放在高级或实验功能相关区域;要找的是这个名称,不是 Event Fetcher。
  3. 开启 Event Bridge。
  4. 地址填入 ws://127.0.0.1:9696。如果插件已经使用 9698,两边都使用 9698。
  5. Token / 令牌与排队插件完全一致;新安装没设令牌时,两边都留空。
  6. 按页面提供的连接按钮连接,或等待开启后自动连接。
  7. 回到排队插件,查看 LAPLACE Event Bridge 卡片。如有需要,点 重新连接 / 启动桥接。

默认桥接由本工具启动。普通用户不用另下一个桥接程序,也不需要安装 Event Fetcher。官方桥接的默认端口和可选认证机制见 Event Bridge 说明。

5.3 完整验收:一定要再发一条真实消息

  1. 在手机的 B 站直播间发送 连接测试02。
  2. 确认 LAPLACE 收到了。
  3. 确认排队插件的 弹幕与礼物 区域也出现了它。
  4. 查看插件的“已收到……条事件 / 最近……”是否更新。
  5. 再发送 /排队,确认自己进入 接下来,而“当前”仍为空。

完成这些才算接通。两边显示“已连接”但没有新消息,只能说明连接存在,不能说明弹幕正在传过来。

如果免费排队关闭,普通 /排队 弹幕不入队是正常规则,不代表桥接坏了。

5.4 直播时保持副屏浏览器活跃

把 chat.laplace.live 加入 Chrome / Edge 的“始终保持活跃”列表,并让 LAPLACE 保持为独立窗口中的当前标签页。官方说明指出:休眠例外不能完全消除后台计时器限制,切标签、最小化或被完全遮住仍可能影响接收。直播时让这个窗口持续显示在副屏,不要切走它的标签页。浏览器后台限制说明

配置完成后发一条真实弹幕确认插件收到,再直接前往第 6 节。

6. 把排队和弹幕放进直播画面

6.1 添加排队挂件

  1. 在排队控制台找到 OBS 排队挂件 链接,打开它并复制浏览器地址栏中的完整地址。
  2. 回到 OBS 的游戏场景,在“来源”点 + → 浏览器。
  3. 新建来源,命名为 ZZZ 排队。
  4. 把刚复制的地址粘贴到 URL,不勾选“本地文件”。
  5. 宽度先设 360,高度先设 400,之后根据自己的直播布局调整。
  6. 确定,将它拖到画面合适位置,并放在来源列表的游戏捕获上方。
  7. 用 OBS 预览检查名字、金额和“当前 / 接下来”是否清楚,再锁定来源。

默认端口时,中文挂件地址示例为 http://127.0.0.1:3667/overlay?lang=zh。英文用 lang=en。优先复制插件实际提供的链接,不要照抄端口示例。 OBS 挂件顶部固定显示当前观众,下方展示全部等待名单。控制台“连接与规则”中的 OBS 排队显示模式(自适应尺寸) 可选择“自动翻页”或“自动滚动”,点击保存后挂件会同步更新。

如果看到的是一整页设置按钮,说明填成了控制台地址;请改用上面带 /overlay 的挂件链接。

“连接与规则”还可设置 翻页间隔(3–30秒)、滚动速度(5–60像素/秒)、名单字号(12–24) 和 挂件显示金额。保存后同步到挂件。字体越大,每页可容纳人数越少;隐藏金额可以给昵称更多空间。

6.2 选择是否让观众看到弹幕

不想把弹幕播出去:不添加 OBS 弹幕来源,并保持 在 OBS 弹幕源中展示聊天 关闭。桌面窗和手机仍可用于自己看消息。

想把弹幕播出去:

  1. 在排队控制台“连接与规则”勾选 在 OBS 弹幕源中展示聊天。
  2. 点击 保存设置。
  3. 打开控制台中的 OBS 弹幕挂件 链接,复制完整地址。
  4. OBS 新建“浏览器”来源,命名为 ZZZ 弹幕,粘贴这个地址。
  5. 可先用 500 × 700 的尺寸,按预览调整。
  6. 发送新弹幕检查。没有消息,或者开关没开时,空白是正常现象。

本插件的弹幕来源是简化显示,不等于 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 正确使用“当前”与“接下来”

  1. 第一次开始服务观众时,点击 完成当前叫号并继续。
  2. 等待第一位进入“当前”;开启电脑 TTS 时会叫号一次。
  3. 为当前观众完成游戏、组队或其他约定操作。
  4. 完成后再点击同一个按钮,上一位进入完成历史,下一位变成当前。

等待队列为空时,点击继续只会完成当前,不会再叫一个不存在的人。

重播当前叫号:再叫一次当前观众,不推进队列。

等待行的 移除:把该观众直接移出等待队列,不会先叫到当前。误点后可在控制台“当前”卡片点击 撤销上次操作(20秒内)。同样可撤销“完成当前叫号并继续”。只支持最近一次操作;过期、重启或状态冲突后不能撤销。撤销不会重新播报,但不能收回已经听到的叫号;之后的新入队和有效礼物会保留。

当前观众的再次排队或送礼不会让其同时出现在等待队列;完成后可重新参加,新一轮重新计金额。队列显示的金额不是该观众终身消费总额。

7.4 暂停入队、暂停聊天有什么区别

操作 实际作用
取消“开放排队”并保存 暂停正常的口令与礼物入队;保留已有队列,仍可叫号
关闭“开启免费排队” 禁止免费口令入队,仍允许符合门槛的礼物
“暂停滚动” 暂停本页面消息区的显示更新,不停止接收,不停止排队
“取消”抽奖 停止当前抽奖;不是清空普通队列

“开放排队”开关不取消已开启的抽奖。需要两者都暂停时,分别暂停排队并取消抽奖。

8. 抽奖:口令或礼物报名

8.1 先设规则,再开抽奖

在“连接与规则”设置并保存:

礼物名可从收到的礼物记录确认。当前控制台不提供房间礼物图鉴。礼物报名和口令报名是“任选一种”,不是“必须送礼后再发口令”。

8.2 开始与结束

  1. 在 幸运观众 区域点击 开启抽奖。
  2. 把报名口令、礼物规则和剩余时间告诉观众。
  3. 开启之后,观众发口令或送符合规则的礼物才能报名。
  4. 每位观众在同一轮只有一份报名资格;重复发送不会增加抽中权重。
  5. 倒计时结束后自动开奖;也可以点 立即开奖 提前结束。
  6. 想中止这一轮就点 取消。

抽奖开启时会记住这一轮的规则;中途改设置不改变正在进行的一轮。想用新规则,请取消后重新开启。没有报名者时会结束,不产生中奖者。

8.3 中奖后会怎样

中奖者进入 接下来第一位,不会自动打断当前观众,也不会自动叫号。主播点击“完成当前叫号并继续”时才轮到中奖者。

中奖者优先于普通礼物排序;后续新的中奖者会排在之前中奖者前面。已经在普通等待队列里的中奖者会在原条目上置顶,不额外复制一行。当前观众不会再次被抽中进入等待队列。

符合普通礼物排队规则的礼物,也可能同时让观众进入普通队列和本轮抽奖报名。未中奖并不等于从普通队列移除。免费排队关闭时,抽奖口令报名仍然有效。

9. 设置叫号语音,并确认观众听得见

TTS 就是“让电脑把文字读出来”。这里有两套独立语音:

语音 在哪里设置 什么时候说话
排队叫号 本插件“语音播报” 主播手动继续或重播当前
LAPLACE 弹幕播报 LAPLACE 自己的设置 按 LAPLACE 规则读弹幕与礼物

9.1 开启电脑叫号

  1. 在排队控制台的“连接与规则”选择 叫号语音语言:中文 / English,保存。
  2. 在“语音播报”勾选 电脑后台 TTS。
  3. 等状态显示语音就绪。
  4. 点击 测试电脑语音。
  5. 确认耳机或扬声器里听到了测试句。

电脑后台 TTS 使用 Windows 安装的语音,不依赖排队控制台标签页一直显示。切换界面语言不会自动改变叫号语言;两者分别设置。

启用此设备 TTS 是浏览器播报的备用方式,不是必点按钮。电脑后台 TTS 开启时,不要再让手机也播一份。浏览器方式还可能受标签页休眠或自动播放限制影响。

9.2 检查 OBS 是否录到了声音

  1. OBS 的混音器里,确认用于采集电脑声音的音频来源没有静音。
  2. 点击“测试电脑语音”,观察对应音量条是否跳动。
  3. 做一段十几秒的 本地录制,不用正式开播。
  4. 停止录制并播放文件,确认里面能听到叫号。

如果你平时只捕获游戏应用的声音,叫号可能不会被游戏音轨收进去。请让 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. 用桌面悬浮窗边玩边操作

  1. 右键主托盘图标,选择 打开桌面悬浮窗。
  2. 屏幕上会出现队列与聊天窗口。默认是鼠标穿透:点击会落到后面的游戏,不会点中悬浮窗。
  3. 需要操作时,同时按 Ctrl + Alt + Q。
  4. 进入操作模式后,可点 完成当前并继续、重播、抽奖、开奖、语音测试、控制台,也可移除等待观众。
  5. 在操作模式拖动顶部标题,把窗口移到合适的位置。
  6. 操作完,再按 Ctrl + Alt + Q 返回穿透模式。
  7. Ctrl + Alt + H 隐藏或重新显示悬浮窗。

快捷键被其他程序占用时,可通过悬浮窗自己的托盘菜单切换模式。主程序和悬浮窗各有托盘入口:悬浮窗菜单“退出悬浮窗”只关它;主程序菜单“退出并停止服务”才是完整退出。

游戏建议使用 无边框窗口 / 窗口化。独占全屏模式可能把悬浮窗挡住。

如果不想让观众看到悬浮窗,优先用 OBS 的 游戏捕获 并实际检查录制。显示器捕获 会录整块屏幕,通常也会把悬浮窗录进去。关闭“OBS 弹幕输出”不能隐藏已经被显示器捕获拍到的窗口。

11. 用手机或平板管理排队

手机只负责遥控,不需要安装本插件,也不需要在手机上设置桥接。

  1. 保持直播电脑上的主程序运行。
  2. 电脑和手机连接同一个家庭 / 工作室局域网。电脑用网线、手机用同一路由器 Wi-Fi 也可以。
  3. 在插件文件夹里运行 enable-lan.cmd。Windows 询问管理员授权时允许它为本插件添加局域网访问规则。
  4. 在电脑排队控制台找到 手机 / 平板控制。
  5. 将显示的完整地址输入手机浏览器,例如 http://192.168.1.20:3667/live。
  6. 按提示输入电脑上显示的 八位配对码。
  7. 手机出现队列与控制按钮后,就可以操作叫号、抽奖等功能。

手机不能填写 127.0.0.1 或 localhost:在手机上,它们表示手机自己,不是直播电脑。也不要在手机地址栏里输入 ws://…:9696。

配对会话约 12 小时有效;重启服务后可能需要重新配对。换 Wi-Fi、路由器重启、电脑地址改变后,重新查看电脑控制台的地址,不要一直使用旧收藏。

如果有多个地址,先试与你手机处于同一家庭 Wi-Fi 网段的地址;不要优先选 VPN 或虚拟网卡地址。访客 Wi-Fi 可能禁止设备互相访问,需要换普通 Wi-Fi。

手机去刷视频、切到其他应用,不会停止电脑后台排队和叫号。回来后刷新页面即可查看最新状态;不要依赖手机浏览器后台 TTS 来承担电脑叫号。

12. 不花钱演练一次完整流程

请在没有真实观众排队时进行。模拟功能会写入正在使用的真实队列,不是隔离练习场。

  1. 打开免费排队,确认当前和等待队列都没有要保留的人。
  2. 找到 模拟弹幕 / 礼物。
  3. UID 填 900001,昵称填 测试A,弹幕填实际排队口令,点击 发送弹幕。
  4. 确认 A 出现在“接下来”,当前仍为空,电脑不会自动叫号。
  5. 改 UID 为 900002、昵称 测试B,金额填 2,点击 赠送礼物。
  6. 确认 B 因有效礼物金额排在免费 A 前面。
  7. 点击 完成当前叫号并继续:B 进入当前;电脑 TTS 开启时应播报 B。
  8. 开启抽奖,换第三个测试 UID,发送实际抽奖口令,点击 立即开奖。
  9. 确认中奖者在等待第一位,当前 B 没有被挤掉,也没有自动叫号。
  10. 完成后移除剩余测试等待条目;当前若仍是测试用户且等待队列已空,再点一次“完成当前叫号并继续”结束它。

模拟测试通过,只能证明本插件规则和播报正常;它不验证 LAPLACE 是否真正接通。开播前仍需发送一条真实 B 站弹幕。

13. 每次开播与下播怎么做

开播前

  1. 启动 ZZZ Queue.exe,确认托盘存在。
  2. 有副屏:保持副屏 LAPLACE 控制台运行;无副屏:打开 OBS,让第 4 节的 LAPLACE 接收端运行。
  3. 检查插件的房间号、排队开关和最低金额。
  4. 从手机发一条编号测试弹幕,确认插件收到。
  5. 点击“测试电脑语音”,观察 OBS 音量条;第一次使用或换设备后做一次本地录制。
  6. 检查 OBS 预览:只有打算播出的挂件,没有配对码、同步密钥或后台设置页。
  7. 打开桌面悬浮窗或手机面板,再正式开播。

直播中出现异常

先看本手册第 15 节。需要重启时,在主托盘右键选 重启服务。它会先停止旧服务,再启动;不要立即又启动另一个版本。慢机器等待就绪后再测试新弹幕。

重启会短暂断开控制台、手机和桥接。重新配对或重新连接后发送新弹幕验证;断开期间错过的事件不能假定会自动补回。

下播后

  1. 结束直播。
  2. 在主托盘选择 退出并停止服务。
  3. 确认主托盘图标消失。
  4. 再按需关闭 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,已迁移至云服务器,不依赖作者电脑在线。主播自己的助手仍需保持运行;主播电脑关机或休眠时无法从群里操作该队列。

  1. 通过然神🤖官方入口,由群主或有权限的管理员邀请机器人加入目标群,并允许主动发言。
  2. 打开本机控制台「QQ机器人与云服务」,展开「账号申请与验证 / 换电脑」。普通申请先在「连接与规则」保存自己的直播间,再填写联系QQ,确认「云端存储授权」,完成本人QQ私聊验证、提交申请、直播间标题验证,等待管理员批准。一项审核同时开通QQ机器人和云备份;未获批的旧群绑定也不能绕过。
  3. 如果管理员已给你一次性领取口令:展开「管理员已给你领取口令?」,填入I开头口令,确认存储范围后直接点击领取,无需额外QQ私聊验证。领取会设置指定的直播间和群号,无需再改标题或等待审核。口令7天有效,只发给指定主播,不要放在群里。管理员已预选实际群时,直接到「群绑定与排队」核对并确认目标群。
  4. 未预选群时,获批后展开「群绑定与排队」,填写自己的数字群号,开启QQ群文字排队并保存,再生成群绑定码。服务地址默认官方地址,无需更改。
  5. 用主播自己的QQ私聊机器人发送 /绑定 XXXXXXXXXX;在目标群真正 @机器人发送 /帮助 取得群接入码,再私聊发送 /绑定群 群接入码 XXXXXXXXXX。回本机控制台核对并确认群。绑定码5分钟有效,群接入码10分钟有效。
  6. 观众先真正 @机器人发送 /绑定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冲突,会保留记录并提示核对,不盲目覆盖。没有原客户端凭据、又没有云备份时,仍需管理员处理旧设备迁移。