使用教程 v1.3.3
从硬件连接到参数调优的完整指南。所有参数值基于实际运行逻辑验证，与 Web 面板 UI 一一对应。
模型配置
模型库上方点击 "类别配置" 按钮进行设置。
| 配置项 | 说明 |
|---|---|
| 类别数量 | 模型能识别的类别总数，设为 0 则自动检测 |
| 类别标签 | 每个类别的名称（如：头、身体、手等） |
| 瞄准类别 | 勾选要瞄准的类别，不勾选 = 全部瞄准 |
提示
切换模型时会自动加载对应的类别配置，无需手动调整。快速开始
连接硬件
- HDMI 线 -- 从电脑显卡连接到 GB算力盒 的 HDMI-IN 口
- 串口盒子 -- USB 端插入游戏电脑，串口端插入 GB算力盒
- 网络 -- 确保 GB算力盒 接入网络（网线或 WiFi）
- 显示模式 -- Windows 显示设置选择"复制模式"
注意
必须选择"复制模式"，否则 GB算力盒 无法获取游戏画面。访问控制面板
浏览器打开 http://设备IP:8080，首次使用需输入激活码。
选择模型并启动
- 在首页 模型库 点击模型卡片切换
- 点击 "启动推理"
- 状态栏出现 FPS 数值即表示运行正常
模型文件名含义
| 关键字 | 含义 | 说明 |
|---|---|---|
v8 / v5 | YOLOv8 / YOLOv5 | 架构版本，v8 更新更准 |
fp16 | FP16 半精度 | 精度高，推理约 11ms |
i8 / 无标记 | INT8 量化 | 速度快，推理约 5ms |
256 / 320 / 640 | 输入尺寸 | 越小越快，视野越窄 |
新手推荐
选择带 i8 和 256 或 320 的模型，兼顾速度和精度。目标选择
系统自动锁定准星最近的敌人，目标消失前绝不切换，确保瞄准稳定。
锁定参数
| UI 标签 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 丢失保持 | 0.5 秒 | 0 - 2.0 | 目标消失后继续保持锁定的时间。越大越不容易因瞬间遮挡而丢失目标 |
动态范围
锁定目标后自动缩小检测范围，目标跑远时自动丢失。开启后可防止锁定远处敌人不放手。
| UI 标签 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 动态范围 | 关 | -- | 总开关 |
| 最小范围 | 60 px | 10 - 500 | 范围缩小到此值后不再缩小 |
| 缩小耗时 | 500 ms | 0 - 2000 | 从最大范围缩小到最小范围的时间 |
| 恢复耗时 | 200 ms | 0 - 2000 | 丢失目标后范围恢复到最大的时间 |
调整建议
锁定目标时被远处敌人干扰 → 开启动态范围。目标经常因遮挡丢失 → 增大丢失保持时间。瞄准部位
配置页 → 瞄准设置，交互式人偶选择器。
| UI 标签 | 默认值 | 说明 |
|---|---|---|
| 头 | Y = 0.15 | 检测框顶部往下 15% 处 |
| 身体 | Y = 0.40 | 检测框顶部往下 40% 处 |
| 自定义 | Y = 0.35 | 可自由设置 0 ~ 1.0 |
| 范围 | 120 px | 准心附近多大范围内的目标才会被瞄准，0 = 不限 |
Y 值含义
0.0 = 检测框最顶端，1.0 = 最底端。Y=0.15 表示瞄准检测框顶部 15% 的位置（大约头部）。按键配置
每个鼠标按键可以有独立的瞄准参数。在配置页顶部 "编辑按键" 下拉框中切换不同按键的配置。
| UI 标签 | 说明 |
|---|---|
| 持续瞄准 | 开启后使用选定按键的参数持续瞄准，无需一直按住按键 |
| 编辑按键 | 下拉选择要配置的按键（侧键1/侧键2/右键/左键/中键），每个按键可独立启用并设置瞄准部位、范围、扳机参数 |