使用教程 v1.3.3
从硬件连接到参数调优，完成 GB 算力盒的首次配置与日常使用。
模型配置
模型配置决定识别类别、显示名称以及实际参与瞄准的目标。类别编号从 0 开始，并应与训练模型的输出顺序保持一致。
| 配置项 | 说明 | 示例 |
|---|---|---|
| 类别数量 | 模型可识别的目标类别总数 | 2 |
| 类别标签 | 按模型类别顺序填写显示名称 | 头部, 身体 |
| 瞄准类别 | 选择实际用于锁定的类别编号 | 0 |
修改类别后请保存配置并重新启动模型。类别标签数量必须与“类别数量”一致，否则界面显示和目标选择可能错位。
快速开始
硬件连接
- 将显卡的 HDMI 输出连接到 GB 算力盒 HDMI 输入。
- 将串口盒子连接至算力盒，并连接鼠标透传设备。
- 使用网线接入同一局域网，或为设备配置 Wi-Fi 网络。
- 在 Windows 显示设置中选择“复制模式”，确保游戏画面同步输出。
请勿选择扩展模式。首次连接时建议使用网线，确认控制台可访问后再配置无线网络。
访问控制面板
在同一网络的手机或电脑浏览器中打开：http://设备IP:8080。
启动模型
- 在模型列表选择对应游戏模型。
- 核对输入尺寸、精度和类别配置。
- 点击启动，状态显示运行后进入游戏测试。
| 文件名标记 | 含义 |
|---|---|
| v8 / v5 | YOLOv8 或 YOLOv5 模型结构 |
| fp16 | 半精度模型，兼顾速度与识别精度 |
| i8 / 无标记 | INT8 量化模型；无标记通常为默认精度 |
| 256 / 320 / 640 | 模型输入分辨率；越大识别更细致，但算力开销更高 |
推荐先使用 320 + fp16 的模型完成基础调试，再根据帧率与远距离识别效果切换输入尺寸。
目标选择
锁定参数
| 参数 | 作用 | 建议 |
|---|---|---|
| 置信度 | 过滤低可信度目标 | 0.45–0.60 |
| 锁定范围 | 准星周围允许选择目标的半径 | 120px |
| 目标优先级 | 在距离、置信度和部位之间决定目标 | 优先准星最近 |
| 锁定保持 | 短暂丢失检测时继续保持当前目标 | 开启 |
动态范围
| 参数 | 说明 | 推荐值 |
|---|---|---|
| 进入稳定时间 | 持续识别达到该时间后进入稳定跟踪 | 0.5 sec |
| 动态扩展范围 | 快速移动时临时扩大搜索半径 | 60px |
| 丢失保持时间 | 目标消失后保留锁定的最长时间 | 500ms |
| 切换冷却时间 | 连续目标切换之间的最短间隔 | 200ms |
先调置信度和锁定范围，再调动态范围。范围过大容易切错目标，切换冷却过短会造成准星抖动。
瞄准部位
| 部位 | Y 偏移 | 适用场景 |
|---|---|---|
| 头部 | .15 | 优先爆头，目标框上部 |
| 身体 | .40 | 稳定跟随躯干中心 |
| 自定义 | .35 | 兼顾头颈与上半身 |
| 作用范围 | 120px | 准星到目标的最大选择距离 |
Y 偏移按目标框高度的比例计算：数值越小，瞄准点越靠上；数值越大，瞄准点越靠近身体中心。
按键配置
| 功能 | 建议按键 | 行为 |
|---|---|---|
| 按住瞄准 | 鼠标右键 | 按住时启用目标跟随 |
| 开火联动 | 鼠标左键 | 开火时启用或增强跟随 |
| 切换部位 | 鼠标侧键 | 在头部与身体配置间切换 |
| 暂停功能 | 自定义热键 | 临时停止识别输出 |