RECOMMENDED / 推荐
Windows 安装版
无需另装 Python、Node.js 或 Docker。安装向导只需选择安装目录，数据保存在其中的 data 文件夹；控制台支持一键更新。
下载安装包 · v1.14.7ZZZ QUEUE OBS / WINDOWS
队列交给助手。
叫号由你决定。
为 Bilibili 游戏直播制作的排队助手。弹幕、礼物和 QQ 群排队汇入同一个队列，在 OBS 中展示，轮到时语音提醒。
安装版与更新 · 本页直接下载
无需 Docker · EXE 版无需安装 Python · 中文 / English
HOW IT WORKS01 / 02 / 03
01观众发送排队或礼物进入接下来
02主播手动叫下一位转为当前
03语音与群内提醒准备开始
QQ 群功能可选，使用前需连接机器人并验证观众身份。
下载 v1.14.7。
普通主播选择 Windows 安装版即可。
FOR CUSTOMIZATION
Python 启动器版
适合已有 Python、希望修改启动器的用户。安装 Python 3.10+，完整解压后运行 start-python.cmd。
下载 Python ZIP · v1.14.7v1.14.7 更新：修复领取服务后 QQ 群设置不匹配的问题，启动时安全同步群标识与缺失的观众身份。预审邀请一码领取；现有队列和金额保留。公共 QQ 排队和云备份需要申请获批，本地排队可独立使用。
已有用户可从控制台一键更新，无需重新下载。直播中不会未经点击自动安装；请勿删除或分享 data 文件夹。不要把 Source code ZIP 当作安装包。
01 / START
先让助手运行起来。
- 从官方下载站获取安装包，只需选择安装目录，数据自动保存在其中的 data 文件夹。
- 双击
ZZZ Queue.exe或start.cmd。等待控制台打开，确认右下角出现托盘图标。 - 在“连接与规则”填写自己的 Bilibili 直播间 ID，保存设置。这里填直播间数字，不是账号 UID。
关掉浏览器标签不会退出助手。可从托盘重新打开控制台、启动悬浮窗、重启或退出。
02 / LAPLACE
两种接收方式，都先了解这一步。
先在 LAPLACE Chat 首页选择连接方式。选择“开放平台 / 幻星”时，按页面要求填写主播身份码：从 Bilibili 幻星获取。其他连接方式按提示填写房间信息。
身份码填在 LAPLACE；排队助手始终填写直播间 ID。不要把身份码、同步链接或令牌展示给观众。
先确认 LAPLACE 能收到真实测试弹幕，再在 Dashboard 右上角齿轮中启用 Event Bridge。地址与助手保持一致，默认：
ws://127.0.0.1:9696
令牌两边一致，未设置时都留空。网页端口与桥接端口不同，不要混用。
03 / CHOOSE YOUR SETUP
有没有副屏，设置方式不一样。
无副屏时不要依赖后台普通浏览器：页面可能被挂起，造成弹幕和礼物漏收。手机只负责遥控，不能替代电脑接收端。
OBS 内设置时先保持 Dashboard 来源可见。设置完成后，将接收源放在游戏捕获与不透明底板下面，保持来源运行，并取消勾选“不可见时关闭源”。普通浏览器与 OBS 的本地设置不自动共享。
需要弹幕朗读时使用 Dashboard，不要用 LAPLACE 的 /obs/ 展示链接代替。OBS 的“通过 OBS 控制音频”不等于开启 TTS，还需开启 Dashboard 自己的朗读，并设置音频监听。
04 / OBS WIDGET
把队列放进直播画面。
- 从助手控制台复制“OBS 排队挂件”的实际地址。
- OBS 来源 → ＋ → 浏览器，粘贴地址。建议从 360 × 400 开始，也支持更长的列表尺寸。
- 在助手里选择自动滚动或自动翻页，调整字号和显示速度。
当前观众固定显示，等待队列同时显示金额和等待时间。弹幕挂件可选，需先在设置中开启“在 OBS 弹幕源中展示聊天”。
想让手机遥控：电脑与手机连接同一局域网，从控制台读取手机地址，输入配对码。想在游戏上方操作：从托盘打开桌面悬浮窗，Ctrl+Alt+Q 切换穿透／操作。
05 / DAILY USE
进队和叫号，是两个动作。
观众发送配置的排队口令（默认 /排队）或有效礼物后，进入“接下来”。点击 完成当前叫号并继续，才会推进队列、设置当前观众并播报。
- 排序：抽奖中奖者固定在等待队列前方；其他观众按总督、提督、舰长、礼物金额、先到先得排序。
- 追加礼物：金额相加，排序重新计算，首次入队时间保留。同额先到先得。
- 免费排队：主播可以关闭。舰队成员在有效身份期间仍可免费排队；其他观众需满足付费礼物门槛。
- 抽奖：主播开启倒计时，按口令或礼物名称识别参与者。中奖者加入“接下来”，不会立即叫号。
- 指定叫号：可直接叫等待中的某位观众；原当前观众回到等待队列，保留金额、首次入队时间和优先级，不记为完成。待核对红包记录需先处理。
- 取消排队：等待观众可在直播间发送取消口令，或在群内真正 @ 发送 /取消排队；当前任务由主播处理。
- 语音：开启“电脑后台 TTS”。重播当前只重复播报，不推进队列；LAPLACE 的弹幕 TTS 独立设置。
06 / QQ GROUP
让观众从群里排队。
公共机器人由服务器保持在线。主播无需安装机器人服务、Docker 或早柚核心，本机只运行排队助手。
主播先连接自己的群
- 打开 然神🤖官方入口，由群主或有权限的管理员加入自己的群，并允许主动发言。新主播须使用带云服务申请界面的版本完成QQ及直播间验证，等待管理员批准后绑定群；旧版没有云服务界面时请等待新版安装包。
- 在助手控制台打开公共 QQ 机器人设置，使用服务地址
https://qq.zenlesszonezero.fans，生成一次性绑定码。 - 先私聊发送 /绑定 绑定码；在目标群真正 @ 机器人发送 /帮助 获取群接入码；再私聊 /绑定群 群接入码 绑定码，最后回控制台确认目标群。绑定码过期后重新生成。
观众自己验证 B 站身份
- 在已绑定群真正 @ 机器人，发送
/绑定B站。 - 将机器人回复的短验证码，用自己的 B 站账号发到主播直播间。助手需保持运行并接收弹幕。
- 收到验证成功通知后，真正 @ 机器人发送
/排队。轮到时机器人在本群 @ 提醒。
群内真正 @ 发送 /排队列表，可查看当前位、等待人数和前20位名单，含金额及红包待核对状态。查询无需绑定 B 站，但入队仍需验证；主播端必须升级到1.13.1并保持在线。
专属红包不能自动读取到账金额。观众先验证身份，再发送 /红包排队 金额；主播在控制台核对真实领取记录后确认，金额才会累加。自报金额不会自动提高名次。
查询帮助：真正 @ 机器人发送 /zzz帮助。部分查询需要绑定游戏 UID；涉及账号登录时请先阅读机器人提示。不要在群里发送账号密码或 Cookie。
07 / GAME LOGIN QR
叫号时，分享游戏登录码。
- 先连接公共机器人并绑定群，让观众完成 B 站验证。
- 在游戏客户端打开扫码登录页，确保 OBS 捕获来源能看到二维码。启用 OBS WebSocket，保留身份验证。
- 在控制台「游戏登录二维码」填写 OBS 连接信息，选择来源、获取画面、框选完整二维码并保存。先测试识别，这一步不叫号、不发群消息。
- 每次刷新游戏码，再点击「完成当前 · 叫号并发送登录码」。图片过期或发送失败时，刷新后使用「重发当前登录码」，不会重复推进队列或播报。
群内所有成员都能看到游戏登录码，只有图片注明的本人应扫码。它与获取查询授权的 /zzz扫码登录 是两个独立流程。识别失败不推进；已叫号但图片发送失败时，请使用重发。
08 / HELP
遇到问题，先检查这里。
显示“已连接”，为什么还没入队？
先发普通测试弹幕，核对 LAPLACE 与助手事件列表都收到；再检查直播间 ID、排队口令和免费排队开关。桥接连接成功本身不代表正在接收真实事件。
OBS 中有弹幕，但是听不到朗读？
使用 Dashboard 来源，通过“交互”打开设置并启用 TTS。再检查 OBS 高级音频属性的监听方式和监听设备。排队叫号需另行开启助手的“电脑后台 TTS”。
升级会丢失队列或 QQ 绑定吗？
新版在控制台最下方“软件更新”点击“一键更新”，会自动校验、备份、安装和重启，数据统一保存在安装目录内的 data。1.14.4 使用外部目录的用户会自动备份并迁移，原副本保留，无需重新绑定。
主播关机后，机器人还在线吗？
机器人和 ZZZ 查询在服务器运行；主播本机关闭后，不能即时处理本地排队、OBS 显示或叫号。正式直播前确认助手已连接。