锐视AI · 使用文档

快速开始

许可证登录
在登录页输入许可证密钥，可选「记住许可证」。验证通过后进入主控制台。
选择模型与推理方式
在「核心系统」中选择当前模型、模型架构与推理框架。涉及截图方式、推理引擎的选项在重启程序后生效。
配置输入设备
在「输入设备」中选择鼠标输入方式（系统 API、WYHID、KmBox、Makcu、G-Hub 等），按提示填写 IP、端口或设备信息并完成连接。
调节检测与瞄准
先在「检测过滤」中设定置信度与范围，再在「瞄准引擎」中选择移动算法并微调速度或 PID / 曲线参数。
启动会话
在「概览」点击启动按钮；可使用 F4 切换自瞄开关（与界面说明一致）。右上角可切换浅色/深色主题，关机按钮用于退出程序。

提示

修改配置文件（如程序目录下的 config.json）时建议先关闭程序，避免写入冲突。参数方案模块支持导入/导出 JSON，便于备份与迁移。

界面与导航

左侧主导航与控制台视图对应关系如下。

导航项	说明
概览	运行状态、遥测指标、一键启动/停止、性能分阶段耗时。
核心系统	模型、推理引擎、截图方式、帧率上限、检测窗口显示。
瞄准引擎	移动算法、速度、PID、人性化曲线、预测、动态微阻尼。
检测过滤	置信度、IOU、死区、检测范围、身体偏移、目标类别。
输入设备	输入方式、外设连接、锁定热键与自定义热键。
辅助功能	后座力补偿、自动扳机及相关参数。
参数方案	保存/加载/导入导出多套参数配置。
高级	附加开关、ROI、限速、显示器选择与调试统计。
运行日志	文本日志输出，便于排查连接与运行异常。

概览

展示实时 FPS、推理延迟，以及截图、预处理、推理、瞄准各阶段耗时，便于判断瓶颈在采集、模型还是后处理。触发计数反映自动扳机累计触发次数。状态指示灯与文案表示当前待机或运行状态。

调节要点

若推理耗时占比过高，可在「核心系统」尝试切换推理框架或启用 FP16（见「高级」）。
若截图耗时异常，检查截图方式是否为本地 DXGI/GDI，双机推流需保证网络与 OBS/UDP 配置正确。

核心系统

当前模型

从下拉列表选择 ONNX 等模型；「重新扫描」用于刷新模型目录。模型架构选项需与文件类型匹配。

推理框架

可在 DirectML 与备用 GPU 路径等选项间切换（界面文案以程序为准）。更改后需重启程序。

截图方式

本地 (GDI/DXGI)：单机截取本机画面。
OBS 串流：双机场景，填写 OBS 推流 IP 与端口。
UDP 推流：双机场景，填写发送端 IP 与端口。

推理帧率上限

可限制每秒推理次数，或选择「无限」。限制 FPS 有助于降低 CPU/GPU 占用与发热。

显示检测窗口

开启后显示调试/可视化窗口（具体表现依赖实现），便于确认检测框与延迟。

瞄准引擎

目标锁定计算机 · 移动算法

线性：按比例直接移动，响应快，参数少。
高级 PID：分别调节 X/Y 轴 Kp、Ki、Kd，适合抑制振荡与过冲；可使用「重置 PID 配置」恢复默认。
人性化曲线：通过移动时间、吸附强度、曲度、速度变化等模拟非匀速轨迹。

参数	作用简述	调节方向
水平/垂直速度	整体跟踪灵敏度	过大易抖动，过小则滞后
PID 增益	比例/积分/微分	先调 Kp，再微调 Ki、Kd 抑制震荡
水平/垂直移动时间 (曲线)	单段移动持续时间	越长轨迹越「柔和」
吸附强度	靠近目标时的贴合程度	与曲度配合调节手感
曲度	路径弯曲程度	调高曲线更明显
速度变化	速度随机/变化幅度	影响曲线自然度

预测引擎

预测帧数：向前推算的帧数，适合移动目标。预测强度：预测位移的加权，过高可能 overshoot。

动态微阻尼引擎

开启后可抑制高频抖动。抖动抑制 (Min Cutoff) 与 响应速度 (Beta) 需在稳定与跟手之间折中： cutoff 越大越跟手但可能更抖；beta 影响滤波响应速度。

检测过滤

参数	说明	建议
置信度阈值	过滤低分检测框	误检多则调高，漏检多则调低
IOU 阈值	非极大值抑制重叠判定	框重叠严重时适当调高
死区半径	中心附近不触发移动的像素范围	减小指针抖动或无意义微移
检测范围	有效搜索半径（像素）	过大增加计算与干扰，过小易丢目标
身体偏移	瞄准点相对框的垂直偏移	按模型类别与游戏视角微调
目标类别	类别 1–4 选择	与训练标签对应

输入设备

鼠标输入方式决定移动与点击如何注入到系统：

系统 API：默认软件层输入，兼容性好。
WYHID：需填写 VID/PID 并连接设备。
KmBox：网络盒子，填写 IP、端口、UUID/MAC 后连接。
Makcu：串口设备，填写 COM 口后连接。
G-Hub：通过加载 G-Hub 集成路径注入（按界面按钮操作）。

热键

锁定热键：从鼠标左键、右键、侧键等中选择按住以启用锁定逻辑。自定义热键：点击输入框后按下键盘或鼠标键绑定；若与已有功能冲突，界面会提示。

辅助功能

后座力控制

开启后按「补偿值」在垂直方向施加反向移动，需与游戏内灵敏度配合逐步加大，避免过度补偿。

自动扳机

当准星与目标距离小于「扳机范围」且满足条件时自动点击。可设置扳机热键（按住启用）、首发延迟、开火间隔。人性化抖动与抖动幅度用于在间隔中加入随机性。

参数方案

将当前界面全部可调参数保存为命名方案，支持加载、重命名、复制、删除、刷新列表。导出生成 JSON 文件；导入从 JSON 恢复。适合为不同游戏或分辨率维护多套配置。

高级

快捷键

瞄准开关键：全局切换瞄准功能开关（与 F4 等逻辑协同，以实际程序为准）。
压枪开关键：独立控制后座力补偿是否生效。

截屏显示器

多显示器环境下选择采集源显示器。

功能开关（节选）

Kalman 跟踪：平滑目标位置估计。
类无关 NMS：合并框时忽略类别差异。
FP16 推理：半精度，通常更快、略省显存。
异步流水线：重叠采集与推理以提升吞吐。
动态 ROI：限制每帧搜索区域，需配合 ROI 最大偏移。
多目标跟踪：在多目标间保持 ID 或优选策略（以实现为准）。
贝塞尔鼠标路径 (API)：使用 API 移动时走贝塞尔曲线。

性能相关滑块

ROI 最大偏移：动态 ROI 允许的中心漂移范围。瞄准每帧限速：单帧最大移动像素，0 表示不限制，用于抑制突变。

底部统计区与「概览」类似，便于在高级页直接观察分段耗时。

运行日志

只读文本区域滚动显示运行期消息。出现连接失败、模型加载错误、网络超时等问题时，优先根据时间顺序检索日志关键字，再结合「输入设备」与「核心系统」配置排查。

调节流程建议

推荐按下列顺序逐项收敛，减少变量耦合：

检测稳定：先固定移动算法为「线性」，调置信度、IOU、范围、类别，使框稳定少跳变。
基础跟枪：调水平/垂直速度，再切换 PID 微调 Kp/Ki/Kd，或换曲线模式调时间与吸附。
移动目标：小步增加预测帧数与强度，观察是否过冲，配合 Kalman（高级）。
手感细化：开启微阻尼，调节 cutoff 与 beta；需要时加死区与每帧限速。
辅助与扳机：最后开压枪与自动扳机，单独调补偿与延迟/间隔，避免与瞄准参数同时大改。
固化方案：满意后在「参数方案」中保存并导出备份。

常见问题

修改推理引擎或截图方式后不生效？

这两项标注为重启后生效，请完全退出程序后重新启动。

双机画面不同步或黑屏？

核对 OBS 或 UDP 的 IP、端口与防火墙；推流端与接收端协议需一致。

KmBox / Makcu 连接失败？

检查网线/串口、UUID/MAC、COM 号及驱动；查看「运行日志」中的错误描述。

热键冲突？

自定义热键、扳机热键与高级开关键避免绑定同一按键；界面会提示冲突。

DirectML / GPU 推理异常或掉驱动？

在 Windows 设置中检查「显示适配器」驱动是否为芯片厂商（NVIDIA / AMD / Intel）官网最新稳定版；更新后重启。若仍异常，可在「核心系统」切换推理框架或暂时改用 CPU 路径（若有），排除是否为 GPU 兼容层问题。

模型无法加载或 ONNX 报错？

确认模型文件路径可读、扩展名与「模型架构」一致；勿在加载过程中移动或删除文件。若从他人拷贝模型，核对是否与当前推理引擎、精度选项（如 FP16）匹配。

截图黑屏、只有桌面没有游戏？

全屏独占游戏可能无法被 GDI 截取，可尝试窗口化或无边框；DXGI 采集需游戏与显示器在同一适配器上。多显示器时在「高级」中核对「截屏显示器」是否选对。

程序需管理员权限或被安全软件拦截？

键鼠注入、截屏与网络监听可能触发防火墙或杀软提示；可将程序目录加入信任区。是否「以管理员身份运行」以你的环境与权限策略为准，异常时可在同等权限下对比测试。

启用异步流水线后卡顿或不同步？

异步与动态 ROI 会改变时序与负载，若不稳定可先关闭相关选项，固定 FPS 上限后再逐项开启，并结合「概览」分段耗时判断瓶颈。

锐视AI 控制台使用文档