客户端操作指南
桌面客户端是云云AI直播助手的主要操作界面，所有自动化规则都在这里配置和执行。
登录方式
客户端支持两种登录方式：
微信扫码登录（推荐）
- 打开客户端，在登录页点击 「微信扫码」。
- 用微信扫描二维码。
- 在手机上确认登录。
- 首次使用微信登录的用户，可能需要补充用户名和密码。
扫码后无需额外操作，等待系统自动验证完成，网页窗口会在验证成功后自动关闭。
微信扫码登录的后台记录渠道为
desktop，与网页端扫码（web）区分。
账号密码登录
如果 /api/common/init 返回 site.username_login_switch=1，登录页会显示账号密码入口：
- 输入注册时的用户名和密码。
- 点击 「登录」。
界面概览
客户端主要分为两个界面：
直播间列表
登录后默认进入直播间列表，展示已添加的所有直播间。
- 顶部：搜索框、刷新按钮、「+ 添加直播间」、「转入直播间」。
- 每个直播间卡片显示：平台图标、直播间名称、启用/禁用状态。
- 操作按钮：进入、启用/禁用、转出。
添加直播间
客户端添加直播间与网页端流程不同，建议优先使用客户端：
- 点击直播间列表顶部 「+ 添加直播间」。
- 选择 抖音 平台卡片，客户端会打开抖音后台扫码窗口。
- 使用主播账号完成扫码登录，客户端自动读取直播间名称和账号资料。
- 确认资料后客户端自动提交新增并刷新列表，不需要粘贴直播间链接或手动填写直播间 ID。
监控窗
选中直播间后进入监控窗，这是主操作界面。
| 区域 | 内容 |
|---|---|
| 顶部 | 直播间名称、平台、监控状态、功能开关 |
| 左侧 | 直播间信息、弹幕消息面板 |
| 右侧 | 各功能设置卡片（自动回复、自动发言等） |
常用操作
启停监控
- 开启监控：点击顶部 「开启监控」，客户端开始接收弹幕并执行自动化规则。
- 关闭监控：返回直播间列表时自动停止监控。
查看弹幕消息
左侧消息面板实时显示直播间弹幕：
- 普通用户弹幕
- 系统消息（自动回复执行结果、功能提醒等）
- 可通过顶部分类筛选查看特定类型消息。
切换直播间
在直播间列表点击另一个直播间的 「进入」，监控窗会自动切换。
客户端更新
客户端采用模块化分发，更新时只下载变化的模块：
- 有新版本时，监控窗消息区会显示系统消息 「立即重启更新」。
- 点击按钮，客户端自动下载更新包并安装。
- 安装完成后自动重启进入监控窗。
也可以直接关闭客户端后重新打开，启动时自动检查更新。
退出登录
点击监控窗左侧底部的 「退出登录」：
- 清除当前业务账号登录态。
- 保留主播后台（anchor）和巨量百应（buyin）的扫码登录态，退出业务账号不会影响这些上游会话。
常见问题
Q：客户端启动后白屏？
- 检查网络连接是否正常。
- 尝试关闭客户端后重新打开。
- 如果问题持续，查看本地日志（
%APPDATA%/yunyun-ai/logs/）。
Q：监控窗提示「直播间已禁用」？
- 该直播间被设置为禁用状态。可在客户端直播间列表或网页端重新启用。
- 禁用期间不会消耗配额，也不会执行自动化任务。
Q：提示「套餐到期」？
- 点击 「前往续费」 跳转到网页端购买页。
- 续费成功后点击 「已续费重启」 恢复使用。
Q：提示「被其他设备占用」？
- 同一账号在同一时间只能有一台设备作为监控端。
- 点击 「重启并逼退对方」 可以强制断开旧连接（请确认自己确实是当前使用者）。