主播云服务：申请、备份和换电脑

云服务与备份自1.14.6提供；1.14.7增加连接自动修复及简化预审领取，请使用最新版。

主播申请

1. 控制台「连接与规则」填写自己的直播间号并保存。
2. 打开「QQ 机器人与云服务」，展开「账号申请与验证 / 换电脑」填写联系 QQ 号；在「云端存储授权」阅读并勾选存储范围。
3. 点击「获取私聊验证口令」，打开 然神🤖官方入口，用自己的 QQ 私聊发送 /云验证 Cxxxxxxxxxx，内容以控制台实际显示为准。口令5分钟有效。验证不会解除原有QQ群绑定。
4. QQ回复成功后，点击「QQ验证后提交申请」。把显示的验证码临时加到自己的直播间标题末尾，10分钟内点击「验证直播间」。验证成功后可把标题恢复原样。
5. 等待运营者在管理端批准。可点「刷新审核状态」。QQ号码由你填写，私聊验证确认的是平台身份；请填写真实联系号码，便于审核联系。
6. 通过官方入口把机器人加到自己的群，并在群设置里允许主动发言。审核通过后，展开同一卡片的「群绑定与排队」，保存QQ群号和排队开关，再按指引获取群接入码、私聊绑定并在控制台确认。

QQ机器人与云备份统一申请、统一审批。未申请或未经批准，均不能使用群排队、叫号、群内游戏查询或上传/下载备份；老设备与旧群绑定也不能绕过。审批通过且启用当前设备后两项服务同时开通。加机器人、查看接入帮助、身份验证与提交申请不受此限制。

云备份

审批通过后展开同一卡片的「云备份与恢复」，可点「立即备份」。「自动备份选项」与「历史备份与换机恢复」按需展开。自动备份默认关闭；勾选并保存后，每次启动主播端会在账号获批且当前设备已启用时备份一次，内容没变化也上传。首次开启选项会尝试一次。成功后本次运行不再定时上传；只是打开网页或手机控制台不会重复备份。失败会限频重试（至少间隔5分钟），错误显示在卡片中。需要随时保存时可点「立即备份」。

备份包括规则、显示偏好、当前及等待名单、金额、首次入队时间、红包待核对记录、已验证QQ/B站对应关系。最近完成记录需要单独勾选。不上传OBS密码、Cookie、登录二维码、连接令牌、局域网配对码、日志或安装包。默认保留最近10个版本，单版本上限2 MiB；超出时显示错误，不会悄悄截断队列。云端使用HTTPS及服务端加密，不是端到端加密。

换电脑与恢复

1. 在新电脑运行支持云服务的主播端，设置相同直播间。
2. 用原来的QQ完成私聊验证并提交申请。相同QQ私聊身份和房间会识别为同一个账号，通常不需重复标题验证或重新审批。
3. 在私聊验证后5分钟内，点击「启用此设备」。这会停用原设备的云备份和QQ群排队，并迁移原有群连接。超时可重新获取云验证口令；不需要解除原群绑定。
4. 选择云备份并点击「预览恢复」，核对时间、当前观众和等待人数。点击确认才会替换本机的队列及可迁移设置。
5. 恢复不自动叫号、不发QQ提醒、不重复入账；OBS密码、桥接令牌等本机设置保留。舰队身份会重新同步。预览后若收到新礼物或本机状态变化，需重新预览，避免覆盖刚收到的任务。

新电脑仍需完成自己的OBS捕获和LAPLACE接入设置。云备份不是把主播端队列搬到服务器持续运行；主播电脑离线时，本地队列和叫号仍不可用。

运营者管理

在运营者电脑双击 public_bot/open-cloud-admin.cmd，或运行 open-cloud-admin.ps1 -KeyFile 私钥路径。脚本通过现有SSH权限建立仅本机可访问的通道，打开 http://127.0.0.1:18788/。脚本会通过SSH读取独立管理口令并自动登录，本地网页收到后立即从地址栏移除口令；登录会话30分钟有效，过期后重新运行脚本。使用完成后在命令窗口按Enter关闭通道。私钥不传给网页，也不分发给主播。

面板支持：

• 查看待审核申请、联系QQ、直播间验证状态、设备及备份元数据。
• 批准、拒绝和停用。房间未验证不能批准。
• 撤销设备，阻止其再次使用旧设备凭据。设备被撤销后需要运营者处理；不能仅重新提交原设备申请绕过。
• 调整保留版本数（1–30，下次上传清理超额版本），删除指定备份。
• 查看近期审批、设备切换和备份访问记录。管理端不提供直接读取主播备份内容的入口。

管理服务只监听服务器127.0.0.1:8788，不加入Cloudflare公网隧道，不需要开放OCI防火墙端口。不要把8788代理到公网。数据目录为中转数据目录下的 cloud；加密密钥使用服务器受保护环境文件中的 PUBLIC_CLOUD_BACKUP_KEY，不可公开或随意轮换，丢失后无法解密已有备份。

2026-10-21 实测：真实QQ私聊验证及直播间446277标题验证成功，申请进入待审核。管理API已验证匿名访问返回401、登录后可读取；运营者已批准并完成首次备份（6人等待、16.5 KiB）。

控制台整理：账号申请、群排队、云备份合并为「QQ 机器人与云服务」。已批准账号默认收起申请步骤，自建机器人位于高级折叠区。连接与规则按直播间、桥接、抽奖、挂件和语音分组；游戏二维码、历史记录、手机控制及模拟工具按需展开。

管理员预先开通（你负责邀请机器人进群时）

1. 你先用QQ官方入口邀请机器人进目标群；在目标群真正 @机器人 发送 /帮助，复制G开头的群接入码（10分钟有效）。
2. 打开云服务管理端，在「管理员预先开通主播」填写主播联系QQ、QQ群号、B站直播间号。群接入码为可选，建议填入，确保预选到实际群。数字群号由你核对，QQ平台事件中的标识未必是数字群号。
3. 点击「批准并生成一次性领取口令」。此操作代表你已经人工核验并批准指定主播，无需主播再改标题或等待二次审批。口令仅本次显示，7天有效；仅私发指定主播，不放群里或截图公开。未领取前可以在管理端撤销，丢失后撤销并重新生成。
4. 主播打开控制台「QQ机器人与云服务 → 账号申请与验证 / 换电脑 → 管理员已给你领取口令？」，输入I开头的领取口令，确认云端存储范围。
5. 主播点击「获取私聊验证口令」，用本人QQ私聊机器人发送显示的 /云验证 C...，5分钟内回控制台点击「领取已批准的服务」。不需要先手动填写直播间；领取后直播间、群号和公共QQ模式会自动设置。
6. 如你填写了群接入码，主播展开「群绑定与排队」，核对并点击「确认绑定刚才的群」。未填写时，主播继续普通群绑定步骤。管理员指定的群不能在确认时替换为其他群。

预审邀请用于新主播，不能覆盖已有账号、跨直播间备份或恢复被撤销的设备。QQ数字只作联系记录，领取权限由随机口令及实际QQ私聊身份共同确定；官方机器人不会提供私聊身份对应的数字QQ号，因此请把口令发给正确的主播。

2026-10-22 简化预审领取：新建预审邀请只需一次性口令和存储范围确认，不再要求额外QQ私聊验证码。普通自助申请仍需本人QQ验证。旧群邀请可由管理员将已发口令切换为简化模式；只开通账号，旧群连接和成员记录不自动移动。首次使用旧1.14.6时，若提示尚未连接公共机器人，可先点击一次“获取私聊验证口令”初始化连接，但不需要发送C口令。源码已支持领取时自动初始化，公开安装包暂未包含这项初始化改动。

1.14.7：领取预审服务时自动初始化连接；已绑定客户端在消息循环启动前，安全同步群标识和缺失身份记录。不同群或UID冲突会阻止同步，不覆盖原记录。新建预审邀请无需额外QQ私聊验证；普通自助申请仍需验证。