
一、准备工作
1.1 你需要提前准备
| 项目/软件 | 说明 | 备注 |
| Windows 电脑 | 推荐 Win10 / Win11,需能运行 OBS | / |
| Echo Live 整合包 | 解压后的文件夹(含 `启动 Echo Live.bat`) | / |
| Supabase 账号 | 免费注册 [supabase.com](https://supabase.com),新建一个项目 | 数据库存储 |
| 激活码 | 联系客服索取 Echo Live 授权码 | 开通会员后下载 |
| 大模型 API Key | 推荐 DeepSeek;也支持通义、豆包等 OpenAI 兼容接口 | 建议Deepseek |
| OBS Studio / 直播伴侣 | 用于添加浏览器源 / 窗口源 | 直播搭建 |
> 建议:每位主播使用**自己的 Supabase 项目**,不要多人共用一个数据库。
二、启动EchoLive
下载后解压到电脑目录,双击运行 启动器 / 右键 管理员权限运行启动器

启动成功后你会看到

复制下面的链接至浏览器:
http://localhost:3080/admin
若窗口闪退,请确认已安装 **Node.js 18+** 或整合包内 `runtime\node.exe` 存在
三、配置 Supabase 数据库
3.1 建表(推荐:Admin 一键初始化)
1. 登录/注册 Supabase → 进入你的项目(免费)地址:https://supabase.com/dashboard/org/zjhuqtrapphhwyquxdqp

配置数据库信息:请记住数据库密码,后面需要用到

2. Project Settings → API 复制 URL、anon key、service_role key

3. Project Settings → Database 复制 Database password(创建项目时设置的 Postgres 密码)
4. 打开 Echo Live Admin → 数据库与清理

5. 填写上述四项 → 保存 Supabase 并校验连接
6. 点击 一键初始化数据库→ 确认提示
四、授权激活与 AI 密钥
1. 在 Admin 找到 「授权与 AI 密钥」

2. 填写:
– 激活码:运营方发放的 license code(此后每次进后台都要用,已自动记住)
– 大模型 API Key:如 DeepSeek 的 sk-…
– API Base URL(可选):非 DeepSeek 官方地址时填写,如百炼: https://dashscope.aliyuncs.com/compatible-mode/v1
DeepSeek:https://api.deepseek.com/v1
– 模型 ID(可选):如 deepseek-chat、qwen-plus
3. 点击 「保存并校验授权」
4. 成功后会显示授权到期时间与 Arena 地址
注意
– 激活码 = 后台管理密码,请勿泄露
– 重新更换 API Key 时,需再次填写激活码
五、发布直播战役

1. 在 「发布战役」填写辩题,例如:华为手机 vs 苹果手机
2. 可选:赞助名、配色、Logo、背景图、辩手头像等
3. 在 「画面方向」选择 竖屏 9:16或 横屏 16:9(与 OBS 画布一致)

4. 点击 「发布直播战役」(首次)或「保存当前战役设置」(已有战役时改样式)
5. 在 「OBS 与导播」复制 OBS 浏览器源 URL

六、直播伴侣(建议)/ OBS 设置(可选)
6.1 OBS配置
1. OBS → 来源 → 浏览器
2. 粘贴刚复制的 URL
3. 宽高建议:
– 竖屏:1080 × 1920
– 横屏:1920 × 1080
4. 勾选 「控制音频 via OBS」(可选)
5. 勾选 「刷新浏览器时缓存图像」 的反义——建议关闭缓存,改设置后便于刷新
6. 右键浏览器源 → 属性 → 勾选 「自定义帧率」可设 30fps(可选)
改完后台样式后:右键浏览器源 → 互动 → 刷新,或重新打开属性页。
测试礼物(无需真实弹幕):在导播 URL 末尾已有 `studio=1`,打开后可点模拟礼物按钮。
6.2 直播伴侣配置
1. 建议横屏直播
2. 场景 → 添加素材 → 窗口

七、接入礼物与站队(推荐:快捷键)
适合使用直播伴侣 / 键盘精灵 / 中控台快捷键的主播, 建议使用 中控台功能:


+指令 → 触发来源:观众互动触发[发弹幕] → 添加触发效果:执行快捷键
1. Admin → 「快捷键桥接」 → 勾选 启用
2. 系统会自动绑定当前进行中的战役
3. 在直播软件里为礼物配置与后台表格完全一致的快捷键:
| 观众行为 | 默认快捷键 | 效果 |
| 扣 1 / 站正方 | Ctrl+Num1 | 加入正方(不触发 AI) |
| 扣 2 / 站反方 | Ctrl+Num3 | 加入反方(不触发 AI) |
| 礼物「加油鸭」 | Ctrl+J | 正方礼物 + AI 推演 |
| 礼物「鲜花」 | Ctrl+X | 反方礼物 + AI 推演 |
4. Admin端快捷键桥接

5. 若快捷键捕获失败,请以管理员身份重新运行 Echo Live
八、开播前检查清单
– [ ] Echo Live 服务已启动(bat 窗口不要关)
– [ ] Admin 显示 「已授权」
– [ ] 已发布战役,OBS URL 已粘贴
– [ ] OBS 浏览器源刷新后能看到辩题与正反方
– [ ] 导播模式测试一次礼物,画面有 AI 辩词更新
– [ ] (可选)Studio 模式右下角显示 「实时通道已连接」
九、常见问题
Q1:Admin 提示「需要 x-admin-key」
Q2:OBS 画面空白或 403
Q3:礼物发了但没有 AI 推演
Q4:推演失败 / Arena 报错
Q5:音效没有
Q6:换电脑或重装后无法激活
Q7:数据库满了
需要帮助?
联系客服或在线提交工单
