Zone Ai 双机 AI 新手认知说明
第一次接触 Zone Ai 时先读这一篇，理解主机、副机、鼠标盒子和双机部署关系。
本文面向第一次接触 Zone Ai 的客户，用来说明它是什么、主机和副机分别做什么、为什么需要鼠标盒子、为什么需要独立显卡，以及部署前应该准备哪些东西。
一句话理解
Zone Ai 是一套双机视觉推理方案：主机负责运行游戏并输出画面，副机负责接收画面并运行 Ai.exe 做 AI 推理，鼠标盒子负责把副机计算出的移动结果作用到主机鼠标。
它不是把所有程序都装在游戏电脑上的单机方案。标准部署中，Ai.exe 运行在副机，主机只运行发射器或接入采集链路。
主机负责什么
主机就是运行游戏的电脑。
主机侧通常负责：
- 正常运行游戏。
- 运行发射器，或通过 OBS、采集卡输出画面。
- 接收鼠标盒子的输入结果。
- 不运行
Ai.exe。 - 不负责模型推理。
客户需要记住：主机不是推理电脑，主机主要负责游戏画面来源。
副机负责什么
副机就是运行 Ai.exe 的推理电脑。
副机侧通常负责：
- 安装 NVIDIA CUDA / TensorRT 环境包。
- 放置
Ai.exe、config.ini、模型和配套 DLL。 - 接收主机发射器或采集链路传来的画面。
- 调用显卡进行 AI 推理。
- 计算目标位置和鼠标移动量。
- 连接 KMBOX、MAKCU 等鼠标盒子。
副机性能会直接影响识别速度、响应速度和参数上限。副机建议使用独立显卡，NVIDIA RTX 20 系及以上更适合当前 CUDA / TensorRT 版本。
鼠标盒子负责什么
副机只负责计算，不直接成为主机鼠标。鼠标盒子的作用是把副机计算出来的移动指令转换成主机能接收的鼠标输入。
常见盒子包括：
- KMBOX NET：网络方式连接，配置时关注 IP、端口和固件状态。
- MAKCU：串口方式连接，配置时关注 COM 口、波特率和固件状态。
如果盒子没有连接成功，可能出现“副机能识别目标，但主机鼠标没有反应”的情况。
画面是怎么传到副机的
副机必须能看到主机画面，才能做视觉推理。常见画面来源有三类：
- 发射器：主机运行发射器，通过 UDP 把画面推给副机，是当前标准部署方式。
- OBS：使用 OBS 进行画面采集和传输，适合熟悉 OBS 的用户。
- 采集卡：使用硬件采集链路，主机侧更干净，但成本和调试门槛更高。
新手建议优先按发射器方案跑通完整流程，再考虑 OBS 或采集卡。
模型和软件是什么关系
Zone Ai 软件本身是推理和控制框架，模型文件决定它能识别什么目标。
客户需要理解：
- 没有对应模型，就无法稳定识别对应游戏目标。
- 模型质量会影响识别率、误识别、漏识别和锁点稳定性。
- 新角色、新皮肤、新画面风格可能影响模型效果。
- 模型尺寸越大不一定越好，还要看副机显卡推理速度。
软件、模型、显卡、画面质量、网络延迟和参数共同决定最终效果。
正确部署顺序
- 确认主机和副机处于同一局域网。
- 主机准备发射器。
- 副机准备环境包、
Ai.exe、配置包和模型。 - 副机首次启动
Ai.exe，按本机显卡构建 engine。 - 主机发射器填写副机 IP 和端口。
- 确认副机能收到画面。
- 确认模型能识别目标。
- 确认鼠标盒子能控制主机鼠标。
- 再开始调整参数。
不要一开始就追求最强效果。正确顺序是先跑通，再调稳，最后再追求更快的跟枪和更强的吸附。
新手常见误解
主机要不要装 Ai.exe？
不需要。标准双机方案中，主机运行游戏和发射器，副机运行 Ai.exe。
副机要不要装发射器？
通常不需要。副机运行 Ai.exe 接收画面。
只有一台电脑能不能按这个教程部署？
不能按标准双机方案部署。标准方案需要主机和副机分开。
为什么需要独立显卡？
Ai.exe 需要调用显卡做模型推理。副机显卡越合适，推理耗时越低，响应越容易稳定。
为什么需要鼠标盒子？
副机计算的是移动结果，鼠标盒子负责把结果变成主机鼠标输入。没有盒子，识别到目标也无法正常控制主机鼠标。
为什么别人参数不能直接照抄？
不同显卡、模型、画面尺寸、网络延迟、游戏灵敏度、鼠标盒子和枪械后坐力都会影响参数。别人参数只能参考，不能保证直接适配。
部署前检查清单
- 已准备一台游戏主机。
- 已准备一台带独立显卡的副机。
- 已准备 KMBOX NET、MAKCU 或其他已适配鼠标盒子。
- 主机和副机能互相访问。
- 已下载当前正式环境包和 EXE 包。
- 已准备对应游戏模型。
- 已确认 RTX 50 系客户使用新版 CUDA / TensorRT 环境包。
风险边界说明
Zone Ai 标准双机方案不把推理端 Ai.exe 放在游戏主机运行，也不依赖读取游戏内存。实际使用风险仍会受到采集方式、鼠标盒子固件、客户本机环境和使用行为影响。
不要混用来路不明的单机工具，不要把旧版 DLL、旧版 EXE、旧版 engine 混入新版目录。