使用教程
这篇教程覆盖从下载到开播的完整流程。你不需要懂代码，按顺序做完即可。当前版本 未同步
1. 运行环境 开始之前请先准备
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11 64 位，或 Windows Server 2022（主播用普通 Windows 即可） |
| 游戏 | 《红色警戒 2：尤里的复仇》+ CnCNet 联机环境（游戏侧目录下文简称 RA2YR） |
| 运行库 | Microsoft Edge WebView2 Runtime、Microsoft Visual C++ 2015-2022 x64 运行库 |
| 网络 | 能访问 https://auth.acylive.top 和 wss://live.acylive.top/ws |
| 授权 | 你的直播间已在授权服务白名单中 |
2. 下载与解压
根据你在对局中的位置，从下载页选择对应角色包：
- observer：观战 / 导播端，可同时观察双方；适合 OBS 主机或第三视角。
- left：左方（盟军）主播端，预设已配置好该角色。
- right：右方（苏军）主播端，预设已配置好该角色。
把 zip 解压到一个固定且可写的目录，例如：
D:\DouyinLiveGui不要放在 Program Files 等需要管理员权限的目录，否则自动更新可能失败。也不要只放在桌面临时目录，更新器需要长期定位这个目录。
解压后目录里应当包含：
douyin_live_gui.exe
douyin_live_sdk.dll
WebView2Loader.dll
ui\
assets\
config.example.json
rules.json
product.json3. 首次运行与配置
- 双击
douyin_live_gui.exe。第一次运行会自动从config.example.json生成config.json。 - 在控制台里添加你的直播间：房间号、备注名。observer 端还需要为每个房间选择左方 / 右方归属。
- 确认网络配置已经由角色包预设：
auth.server_url指向授权服务，liveService.url指向中心服务，公钥已内置。正常情况下不需要手动修改。 - 规则矩阵和盲盒可以在界面里编辑；保存后会写入
rules.json。升级时这两个文件不会被覆盖。
角色包里的公钥来自发布时的线上授权服务。如果界面上提示公钥指纹不匹配，请重新下载最新角色包，或联系管理员确认授权服务没有轮换密钥。
4. 游戏侧部署
- 找到你的 RA2YR 游戏目录（包含
gamemd-spawn.exe和 CnCNet 启动器的目录）。 - 把
ra2_live_bridge.dll放到 RA2YR 目录，并按项目提供的tools\apply_mod.ps1注入到 CnCNet 启动流程；桥接 DLL 只通过本地加密命名管道接收控制台的指令。 - 管道名和密钥使用默认值即可：
DouyinLiveRa2Pipe/Ra2LivePipeKey16。如需多人共用一台机器，可再调整。 - 桥接日志位于
RA2YR\debug\ra2_live_bridge.log，排查问题时非常有帮助。
桥接 DLL 注入在游戏进程内，游戏运行时无法替换。自动更新会先更新 GUI / 采集 DLL，游戏组件等游戏完全关闭后再提示更新。
5. 启动顺序与开播流程
- 通过 CnCNet 启动游戏，进入联机对局或启动单机/观战局。
- 启动
douyin_live_gui.exe，等待界面显示授权通过、中心服务已连接、桥接已连接。 - 在直播间扫码登录采集 SDK，添加 / 启用你的房间，然后点击"连接采集"。
- 观众弹幕、礼物、点赞经过规则匹配后，会在游戏内生成单位 / 超武 / 基地血量变化；控制台与 Overlay 会回显触发结果。
- 对局结束后，桥接会上报结果，中心服务完成结算并更新积分和排行。
如果房号相同但双方没有进到同一个中心服务房间，先检查两边配置里的稳定 roomId 是否一致。
6. 更新与回滚
- 控制台启动时会检查
https://acylive.top/data/latest.json，也可以手动点"检查更新"。 - 更新按文件哈希增量下载，只替换发生变化的文件，保留
config.json、rules.json和日志。 - GUI / 采集 DLL 更新完成后会自动重启控制台；如果新版本启动失败，更新器会回滚到上一版本。
- 游戏桥接 DLL 的更新会等到游戏关闭后再执行，旧版本文件会保留为
ra2_live_bridge.dll.bak-*，可在控制台里手动恢复。 - 更新记录见更新记录页，内容直接来自 GitHub Release。
7. 遇到问题
先看 FAQ；仍然无法解决时，请提供控制台日志（位于 LOCALAPPDATA 里的 DouyinLiveGui\logs）和桥接日志，并说明你的角色包版本和游戏版本。