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

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

返回新手手册本文件可独立保存或发送给其他主播;外部链接需要联网。

主播端与服务器更新范围

1.13.1

游戏登录二维码分享(v1.13.0):需要同时更新主播端的 OBS 截图、识别及按钮,以及服务器的图片发送接口;早柚核心和 ZZZeroUID 无需为此更新。公共测试服务器已加载新接口,旧主播端的原有叫号接口保持可用。详见 配置与验收说明。

主播端版本 1.12.4

等待列表中点击「指定叫号」,可跳过排名直接叫指定观众。原当前观众回到等待队列,保留金额、首次入队时间和优先级,不记为完成;所选观众成为当前,触发语音及已绑定QQ群通知;其他人金额、等待时间和排序不变。支持限时撤销,但撤销不会撤回已经播放的语音或QQ消息。待核对红包占位记录必须先完成核对,不能直接叫号。悬浮窗按 Ctrl+Alt+Q 进入操作模式,再点击对应行的「叫号」。

指定叫号需要更新主播端。它沿用已有服务器叫号接口,服务器无需为此升级。

改动 是否必须更新主播端 服务器负责的部分
指定叫号、控制台按钮、悬浮窗布局 必须 沿用已有群通知接口
排序规则、礼物金额、抽奖、等待时间 必须 无权威队列逻辑
B站弹幕解析、验证弹幕规则、舰队同步 必须 可转发绑定口令、缓存验证结果
自定义叫号词、Windows TTS、OBS挂件 必须 将主播生成的文字发到QQ群
红包核对界面、实际金额入账规则 必须 接收金额申报并转发
主播群绑定界面与提示 必须 私聊授权及群绑定校验可独立更新
QQ口令前缀检查、错误提示 通常无需;控制台/指南提示变动仍需更新 可直接在公共机器人更新,例如强制 / 和取消昵称绑定入口
QQ消息发送、真实@格式、权限报错 无需,只要已有接口不变 服务器更新即可
绝区零查询修复、ZZZeroUID升级、美术资源 无需 服务器更新依赖并按需下载素材
QQ菜单新增已支持的ZZZ查询口令 无需 更新指令面板与查询处理
新排队口令但仍映射已有排队请求 通常无需 保持原有请求格式及本地排队规则
新排队功能、增加必需字段或改变接口 可能两端都需要 应保留旧协议或明确最低主播版本
HTTPS域名、隧道、部署及密钥 通常无需换包;地址变化需修改控制台设置 由运营者管理

服务器单独升级不能修改别人电脑上的本地队列逻辑、页面、TTS或UID验证规则。新增菜单项也不代表功能已实现。

实施与升级

  1. 服务器兼容原有 /client/* 接口时,可以独立更新,不要求主播换包;排队仍需要主播电脑在线。
  2. 主播端升级先退出旧版,解压新版到新目录,复制旧版 data,再启动;不要同时运行两份。
  3. 已验证身份及设置保存在 data,验证码仅在内存,重启后应重新申请。
  4. 本机源码运行服务已同步;GitHub下载包不会自动改变。v1.12.0发布包尚未含斜杠提示及指定叫号;1.12.1发布包已包含这些修复及指定叫号,旧包需升级才能获得本地功能。

1.12.3:无需UID的B站验证和短弹幕生成需要更新主播端;私聊 /解绑群 由服务器提供,旧主播端无需升级即可使用,但重新绑定时仍应按最新斜杠提示操作。

群内排队和红包申报必须先完成真实B站绑定。1.12.4及更早主播端需发送 /查看绑定 同步结果;1.12.5会自动同步并通知成功。未绑定时仅允许绑定及查询等非排队口令;服务器会阻止未绑定用户入队,包括旧主播端。新版主播端另作本地校验,服务器缓存无法替代本地验证。

1.12.4:服务器立即拦截未验证用户群排队,旧主播端也受限制;本地二次校验及红包核对卡显示修复需要更新主播包。OBS挂件不显示核对表单,控制台没有待核对申请时自动隐藏该卡。

1.12.5:自动恢复身份及自动验证成功通知需要更新主播端;身份独立保存到data/qq-identities.json。群绑定/解绑只走私聊及 /帮助 指引由服务器提供。旧主播端的群内绑定操作会被拒绝,请按私聊帮助处理。

取消排队、已有记录显示红包待核对及追加小额礼物累计需要更新主播端;QQ取消口令面板由服务器同步提供。

1.12.6:OBS 挂件只标注未绑定的观众,需更新主播端;公共 QQ 机器人服务器不需改版。保留完整 data 文件夹后,已验证身份会恢复,不需要群成员重新绑定。

1.12.7:主播控制台的当前位和等待队列也只提示未绑定观众,与 OBS 挂件保持一致;需更新主播端。