Medusa 策略控件
约 1756 字
Medusa 控件用于设置策略进程的队伍颜色、进攻方向、Test Mode、TestPlay 和战术包,也可以启动比赛守护进程。启动前必须重点核对队伍颜色和进攻方向。

Medusa 控件标注
编号 1~12 与下方说明逐一对应

Medusa 控件原图
未标注的实际界面
编号总览
| 编号 | 控件 | 作用 |
|---|---|---|
| 1 | 折叠按钮 | 展开或收起整个 Medusa 区域 |
| 2 | Monitor Start / Stop | 启动或停止 Medusa 守护进程 |
| 3 | 刷新按钮 | 重新扫描 TestPlay 和战术包列表 |
| 4 | Dir 方向开关 | 设置蓝方的进攻方向;黄方启动时自动使用相反方向 |
| 5 | 蓝方 Test Mode | 决定蓝方是否运行指定 TestPlay |
| 6 | 黄方 Test Mode | 决定黄方是否运行指定 TestPlay |
| 7 | 蓝方 TestPlay | 选择蓝方测试脚本,仅在编号 5 开启时可用 |
| 8 | 黄方 TestPlay | 选择黄方测试脚本,仅在编号 6 开启时可用 |
| 9 | 蓝方战术包 | 选择蓝方使用的 opponent / 战术配置 |
| 10 | 黄方战术包 | 选择黄方使用的 opponent / 战术配置 |
| 11 | Blue 启动按钮 | 启动或终止蓝方 Medusa |
| 12 | Yellow 启动按钮 | 启动或终止黄方 Medusa |
启动一支队伍
通过编号 4 选择进攻方向
编号 4 显示的是蓝方进攻方向。视觉画面左半场为蓝方时选择
L→R;左半场为黄方时选择R→L。正式比赛应以 ssl-game-controller 中的半场设置为准;不确定时联系裁判或组委会确认。通过编号 5~8 选择运行模式
正常比赛关闭本方 Test Mode;专项测试则开启本方 Test Mode,并在下方选择 TestPlay。
通过编号 9 或 10 选择战术包
蓝方使用编号 9,黄方使用编号 10。若 Client 运行期间新增、删除或重命名了 Lua 文件,先点击编号 3 刷新。
通过编号 11 或 12 启动
蓝方点击编号 11,黄方点击编号 12。按钮出现
RUN标识表示对应进程正在运行;再次点击可终止该进程。
启动前必须核对
队伍颜色或进攻方向错误会使坐标系、攻防目标与实际比赛相反。正式比赛中,应在 Vision、Radio 和裁判信息稳定后再启动 Medusa。
编号 2:Monitor 守护进程
Monitor 用于比赛中的进程保活。Medusa 意外退出会导致机器人停止运动;守护脚本会持续重新拉起 Medusa,降低策略进程意外崩溃带来的风险。日常测试通常不需要开启。
Monitor 使用的是最后写入的 Medusa 配置
守护脚本直接启动 Medusa,因此它会读取 zss.ini 中最后一次应用的队伍、方向、Test Mode、TestPlay 和战术包。开启前必须先让目标队伍的配置写入一次。
以“黄方、蓝方进攻方向为 R→L”为例:
- 用编号 4 选择
R→L,再配置黄方的编号 6、8、10。 - 点击编号 12 启动黄方 Medusa,使黄方配置写入
zss.ini。 - 再点击编号 12 将黄方 Medusa 关闭。
- 点击编号 2 的 Start 启动 Monitor。
关闭 Monitor 时,应先点击编号 2 的 Stop,再关闭 Monitor 拉起的 Medusa 终端。若只按 Ctrl+C 或直接关闭终端,ProcessAlive.sh 的循环会再次启动一个 Medusa 终端。
编号 3:刷新脚本与战术包
点击刷新按钮后,Client 会重新读取:
ZBin/lua_scripts/play/下所有子目录中的.lua文件,作为 TestPlay 列表;ZBin/lua_scripts/opponent/目录中的.lua文件,作为战术包列表。
这项功能用于处理 Client 运行期间脚本新增、删除或更名的情况。刷新后会更新蓝黄双方的候选列表,并重新加载默认战术包选择。
编号 4:进攻方向
方向开关显示 L→R 时,表示蓝方从左向右进攻;显示 R→L 时,表示蓝方从右向左进攻。启动黄方时,Client 会自动应用与蓝方相反的方向,因此无需再手动把开关反拨一次。
该设置最终写入 ZAlert/IsRight。启动具体队伍时,Client 还会同时写入 ZAlert/IsYellow,自动组合颜色与方向参数。
编号 5~8:Test Mode 与 TestPlay
- 关闭本方的编号 5 或 6。
- 收到裁判指令时优先运行相应 RefPlay;没有裁判指令时运行战术包定义的 NormalPlay。
- TestPlay 输入框会被禁用,避免误把测试脚本带入正式比赛。
- 开启本方的编号 5 或 6。
- 在编号 7 或 8 中输入脚本名的一部分,从建议列表选择目标脚本;匹配不区分大小写。
- 脚本名过长时会滚动显示。修改 Lua 文件后,使用编号 3 重新扫描。
- 没有裁判指令时,Medusa 运行所选的
gTestPlay。
蓝黄双方的 Test Mode 和 TestPlay 在界面中分别保存。点击编号 11 或 12 启动时,Client 才把对应队伍的值应用到 Medusa 共用的配置字段。
编号 9~10:战术包
战术包决定 Medusa 使用哪套 opponent 配置和 NormalPlay。蓝方与黄方可以在界面中分别选择;启动对应队伍时,所选值会写入 ZAlert/tacticName。
Client 启动时会读取上次保存的 ZAlert/tacticName 作为默认选项。如果列表中找不到该名称,则回退到第一项。
编号 11~12:启动与终止
- 编号 11 以蓝方参数运行 Medusa,编号 12 以黄方参数运行 Medusa。
- 启动前,Client 会先应用该队伍独立保存的 Test Mode、TestPlay 和战术包,再设置队伍颜色与方向。
- Simulation 模式下会建立对应颜色的仿真通信;Real 模式下会建立对应队伍的串口数据连接。
- 按钮具有约
600 ms的切换保护,连续快速点击不会反复启动多个进程。 - 启动失败时,按钮状态会回退;再次点击运行中的按钮则终止对应进程。
配置字段与源码对应
ZAlert/IsYellow 表示当前启动的是不是黄方,ZAlert/IsRight 表示进攻方向,类型均为 bool。界面上的编号 4 以蓝方为基准,黄方启动时由 Client 自动换算相反方向。
ZAlert/TestMode 决定是否进入测试模式,ZAlert/gTestPlay 保存测试脚本名。当前版本启动 Client 时会读取已有值作为蓝黄双方的初始值,并不会在启动或退出时强制清空。
ZAlert/tacticName 保存当前应用的战术包名称。
TestPlay 的模糊匹配、下拉建议和长文本滚动显示由 ZPlaySuggestBox.qml 实现。