适用于当前 aiAssistance Web 控制台
完整使用说明
按步骤完成设备激活、模型导入、热键配置、移动控制调参、辅助功能设置和系统维护。
01 快速开始
第一次使用时，先保证电脑或手机能打开设备网页，再完成激活、导入模型和基础参数设置。
电脑或手机连接到设备同一网络，浏览器打开 http://x-game.local:8000。如果打不开，就在路由器里查设备 IP，再打开 http://设备IP:8000。
进入网页后按提示输入激活码。首次激活需要联网，激活过程中不要断电，也不要关闭页面。
进入“模型库”，点击“导入模型”，选择 RKNN 或 ONNX 文件。导入完成后选择当前模型；少数设备绑定模型才需要导入加密文件。
进入“热键控制”，新增或修改热键配置，选择对应目标类别，设置 X/Y 轴瞄点偏移。
回到“总览”，点击“启动”。先确认预览能看到画面、目标能被框住，再继续调整移动控制和辅助功能。
重要：升级、扩容、激活、分辨率切换时请保持供电稳定。参数调试建议一次只改一个方向，感觉不对就回到预设。
02 激活设备
设备未激活时，网页会显示激活弹窗或“设备授权”区域。输入卡密后，系统会自动完成授权验证、模拟显示器身份准备和鼠标输出准备。
输入已获得的有效卡密后点击“激活设备”。
激活后如果页面还停留在未激活，可以点击“刷新状态”。
只有更新后提示授权不属于当前设备时再使用，正常情况下不要反复点击。
激活时需要注意
| 情况 | 处理方法 |
|---|---|
| 提示无法连接服务器 | 检查设备是否联网。可以先在“网络配置”连接 Wi-Fi，或用网线连接路由器。 |
| 激活后仍提示未激活 | 点击“刷新状态”，或者刷新浏览器页面。仍然失败时，核对卡密状态和网络连接。 |
| 更新后提示设备身份异常 | 进入“系统状态”，点击“授权修复”。这个功能不会清除模型和预设。 |
03 总览
“总览”是日常启动、停止和观察运行状态的页面。
主要区域
| 区域 | 作用 | 怎么判断正常 |
|---|---|---|
| 实时预览 | 显示设备采集到的画面和检测结果。 | 画面正常、目标能被框住，说明采集和模型基本正常。 |
| 启动/停止 | 控制主程序是否开始输出移动和辅助动作。 | 点击启动后状态变为运行中，检测帧率有数值。 |
| 链路延迟、采集帧率、检测帧率 | 观察当前性能。 | 数值稳定比单次峰值更重要。导入大模型或裁切尺寸过大时，检测帧率会下降。 |
| 截取尺寸 | 决定模型输入附近画面的大小。 | 建议和模型输入尺寸一致，例如 320 模型选 320，416 模型选 416。这样延迟最低，也能少一次缩放预处理。 |
| FOV 半径 | 限制可锁定范围。 | 太小会锁不到远处目标，太大容易锁到不想要的目标。 |
| 目标置信度 | 过滤低可信度目标。 | 误识别多就调高，漏目标多就调低一点。 |
| 重叠过滤 IoU | 处理多个框重叠时的保留规则。 | 同一目标出现多个框时可以适当调。 |
分辨率和截取尺寸不是同一个东西：分辨率在“硬件”里的 EDID 控制；截取尺寸是 AI 从画面中心附近取多大一块给模型检测。截取尺寸优先跟模型尺寸一致，不一致时系统还要缩放，延迟会更高一点。
04 模型库
“模型库”用于查看当前模型、导入新模型、复制设备码和给模型绑定预设参数。
选择并启动测试
导入普通模型，常规模型使用这个流程
点击“导入模型”。
RKNN 可以直接导入。ONNX 会自动转换为 RKNN，转换需要等待一段时间；如果有校准图压缩包，可以一起上传。
游戏标签用于模型筛选。描述可以写类别说明、适用场景或版本信息。
导入后建议到“总览”把截取尺寸设置成模型输入尺寸。例如模型是 320 输入，就选 320；模型是 416 输入，就选 416。这样检测延迟最低。
少数情况：导入设备绑定的加密模型
加密模型适合需要限制模型只能在指定设备使用的场景。导入常规模型时，不需要复制设备码。
| 操作 | 说明 |
|---|---|
| 复制设备码 | 点击“复制设备码”，把复制出来的一串 ID 发给模型供应商。 |
| 供应商加密 | 供应商用这个设备码加密模型。加密后的模型只能在这台设备使用。 |
| 导入设备 | 拿到 .rknn.enc 或 .enc 文件后，直接在“导入模型”里选择。设备会自动识别并解密导入。 |
设备码重启后不会变化。只要设备本地模型密钥没有被清除，同一个设备码加密的模型都可以继续使用。
模型和预设绑定
如果某个模型需要一套单独参数，可以先在“预设参数”保存当前参数，再回到“模型库”给模型绑定该预设。以后切换模型时，就能同时切到对应参数。
05 热键控制
“热键控制”决定按哪个鼠标键时启用锁定、锁哪些类别、瞄准目标框里的哪个位置。
每条热键配置包含什么
| 参数 | 效果 | 建议 |
|---|---|---|
| 热键 | 按住该键时才启用这条锁定配置。“自动”表示不需要额外按键。 | 常见设置是右键开镜锁定，或侧键临时锁定。 |
| 目标类别 | 只锁选中的类别。类别前面的数字从 0 开始，对应模型输出类别。 | 不确定时先全选，确认类别后再缩小范围。 |
| X 轴偏移 | 目标框内横向瞄点。0 是最左边，1 是最右边。 | 默认 0.5，即目标框横向中心。 |
| Y 轴偏移 | 目标框内纵向瞄点。0 是最上面，1 是最下面。 | 默认 0.5。想靠近头部可降低，想打身体可保持中间或略高。 |
| 灵敏度 | 只影响这一条热键配置的移动强度。 | 同一模型里不同武器或不同热键可以分开调。 |
如果锁定点偶尔跑到框外，先检查类别是否选错、模型框是否稳定、X/Y 偏移是否设置过偏，再看“移动控制”的曲线和预判是否过大。
06 移动控制
“移动控制”决定准星怎么从当前位置移动到目标位置。当前页面主要包含 PID 控制器、目标锁定、开火延迟释放 Y 轴、拉枪曲线和持续提前量。新手调参建议先理解三个核心：拉力主要管拉枪速度，预判主要弥补链路延迟并增强移动目标追踪，持续提前量才用于锁定提前身位。
建议先调什么，后调什么
移动控制不要一上来同时调很多项。最稳的顺序是：先调拉力，把拉枪速度调到能跟上目标；拉力调完再调预判，用来弥补检测、计算和输出带来的延迟；最后只在需要时加一点跟随。持续提前量默认不需要打开，只有明确要锁定移动目标提前身位时才开。
| 顺序 | 先调项目 | 目标 | 推荐调法 |
|---|---|---|---|
| 1 | 先确认基础状态 | 排除模型、类别、瞄点导致的问题。 | 先保存预设；移动倍率保持 1；积分和刹车建议保持 0；拉枪曲线和持续提前量先关闭；确认热键类别选对，X/Y 偏移先用 0.5。 |
| 2 | X轴拉力 | 先把横向拉枪速度调到够用。 | 横向拉不动、追不上就小幅增加；冲过头、左右来回摆就降低。先调 X 轴，因为大多数目标移动主要在左右方向。 |
| 3 | Y轴拉力 | 把上下拉枪速度调到够用，但不乱跳。 | 上下跟不上就小幅增加；跳跃、落地或目标框高度抖时上下晃，就降低。Y 轴一般不要比 X 轴更激进。 |
| 4 | X轴预判 | 弥补横向移动目标的延迟。 | 拉力速度稳定后再加。横跑时总是滞后、跟不贴就小幅增加；方向一晃一晃或修正过度就降低。不要用预判解决整体速度慢的问题。 |
| 5 | Y轴预判 | 弥补上下移动目标的延迟。 | 通常保持很小或不动。跳跃、落地、坡度场景容易抖，新手没有明确需求就别加。 |
| 6 | X/Y轴跟随 | 让输出增长更积极。 | 反应慢、刚锁上跟不上时可以加一点；刚锁上突然一窜就降。新手只需要小幅调整，不要把跟随当主速度用。 |
| 7 | 持续提前量 | 连续横向追踪时锁定提前身位。 | 默认不需要开启。只有想让移动目标锁定到身位前方时才开；先小幅增加“提前量系数”，身位提前过多就降系数或增大进入距离。 |
| 8 | 基础死区 / 丢失帧 | 让到点后更安静，短暂丢框时更连贯。 | 到目标附近还碎抖再加一点基础死区；目标偶尔丢框再看丢失帧。不是优先调的速度参数。 |
| 9 | 移动倍率 | 整体统一放大或缩小。 | 拉力、预判、跟随都基本合适后再动。整体太慢就小幅增加，整体太暴躁就小幅降低。 |
| 10 | 拉枪曲线 | 让远距离拉到新目标时轨迹更自然。 | 这是高级手感项，基础锁定稳定后再开。新手可以先不动。 |
新手重点：先调 X/Y 拉力控制拉枪速度，拉力调完再调 X 轴预判补延迟；积分和刹车建议保持 0。跟随可以加一点，但不要大幅加。持续提前量默认关闭，只有需要锁定移动目标提前身位时才打开。
每次调参怎么测试
看准星能不能停在框内目标点附近。这里主要判断拉力和基础死区，积分、刹车先不要参与。
看准星是速度不够、因为延迟滞后，还是修正过度。这里主要判断 X 轴拉力、X 轴预判和少量跟随。
看持续同方向移动时是否需要锁定到更靠前的身位。这里主要判断持续提前量，适合调提前身位枪。
基础控制参数解释
| 参数 | 调大后的效果 | 调太大的表现 |
|---|---|---|
| 移动倍率 | 整体输出变大。 | 所有方向都更容易冲过头。通常优先调拉力和预判，最后再动移动倍率。 |
| X轴拉力 / Y轴拉力 | 拉枪速度更快，更快把准星拉向目标。 | 来回冲、压不住、到目标附近晃。 |
| X轴预判 / Y轴预判 | 补偿目标移动和系统链路带来的延迟，移动目标追踪更贴。 | 修正过度，目标轻微抖动时感觉方向不稳。新手主要调 X 轴预判，Y 轴预判谨慎动。 |
| X轴积分 / Y轴积分 | 补偿长期残余误差。 | 容易漂移、越修越偏或来回晃。新手建议保持 0。 |
| X轴刹车 / Y轴刹车 | 对速度变化做刹车。 | 数值过大容易把检测抖动放大。新手建议保持 0，冲过头优先先降拉力。 |
| X轴跟随 / Y轴跟随 | 输出增长更快，跟随更积极。 | 突然一窜，或者小误差时也动作很明显。可以小幅增加，不要一次加太多。 |
| 基础死区 | 离目标近时少动或不动，更稳。 | 死区过大时，准星会停在目标附近但不继续修正。 |
| 丢失帧 | 短时间丢框时继续保持锁定。 | 过大可能在目标消失后还短暂跟随旧位置。 |
现象和参数对应关系
| 看到的现象 | 优先动哪个 | 先别急着动哪个 |
|---|---|---|
| 目标在左/右移动，准星一直落后 | 先加 X 轴拉力；稳定后再加 X 轴预判。 | 不要一开始就大幅加移动倍率，也不要用持续提前量去补基础延迟。 |
| 目标在上/下变化，准星跟不上高度 | 先加 Y 轴拉力，再小幅加 Y 轴跟随。 | Y 轴预判不要太早加，容易带来跳动。 |
| 准星到目标附近来回摆 | 先降对应方向拉力，再适当加基础死区。 | 不要继续加拉力。 |
| 准星碎抖、一晃一晃 | 先确认积分和刹车是不是 0，再降低预判，确认检测框是否稳定。 | 不要把刹车当成“越大越稳”。 |
| 锁上目标的一瞬间突然一窜 | 降低跟随，必要时降低拉力。 | 不要先动死区，死区主要管到点后的微小修正。 |
| 整体都慢，但方向不抖 | 先分别加对应方向拉力；都稳定后再小幅加移动倍率。 | 不要大幅加预判，预判解决的是延迟补偿和追踪滞后，不是整体速度。 |
| 连续横移时想打在身位前方 | 只有这个需求明确时才开启持续提前量，小幅增加提前量系数。 | 不要把持续提前量当常规追踪参数，也不要用它补基础延迟。 |
开火延迟释放 Y 轴
开启后，持续开火超过设定时间，会停止上下方向输出，只保留左右跟随。适合开火时上下方向容易被压枪或后坐力影响的场景。
持续提前量
| 参数 | 效果 | 建议 |
|---|---|---|
| 启用持续提前量 | X 轴持续同方向移动一段距离后，把瞄点往目标移动方向前方偏移。 | 默认不需要开启；只在需要锁定移动目标提前身位时开启。基础拉力和预判稳定后再考虑。 |
| 进入距离 px | 累计同方向移动超过这个距离后才进入持续提前。 | 提前量太容易触发就调大；触发太晚就调小。 |
| 提前量系数 | 提前偏移大小，按目标框宽度乘系数计算。 | 从小值开始加。提前过头就降，想更靠前再加。 |
| 渐入 / 渐出时间 | 控制提前量出现和消失的柔和程度。 | 突然偏过去就增加渐入；停下后拖得太久就缩短渐出。 |
拉枪曲线
| 参数 | 效果 | 建议 |
|---|---|---|
| 启用拉枪曲线 | 只在新目标距离较远、刚开始拉枪时加入曲线。 | 已经锁定跟踪后会自动停止，不用于持续跟踪阶段。 |
| 曲线强度 | 弧线更明显，最高到 2。 | 想肉眼明显可以调高，但过大可能绕路。 |
| 随机抖动 px | 拉枪曲线期间加入随机感。 | 0 为关闭。过高会影响落点稳定。 |
| 启用距离 px | 目标离准星超过这个距离才使用曲线。 | 希望近距离不弯，就把距离调大一点。 |
移动控制的核心目标是“先用拉力调拉枪速度，再用预判补延迟”。新手不需要动积分和刹车；持续提前量不是必开项，只在需要锁定移动目标提前身位时使用。
07 拓展功能
辅助功能包括自动下移、切换延迟、自动开火、自动连点、自动背闪和准星识别。建议先把基础锁定调稳定，再逐个开启。
自动下移
| 参数 | 说明 |
|---|---|
| 主按键 / 副按键 / 触发方式 | 决定按什么键压枪。触发方式可以选任一按键，或者两个键同时按住。 |
| 下移速度 | 越大下压越明显。0 表示不下压。 |
| 仅有目标时下移 | 开启后检测到目标才下压，避免空枪时也向下压。 |
| 目标丢失释放 ms | 目标短暂消失后仍保持下移的时长；0 表示立即释放。 |
| 拟人曲线强度 / 横向抖动 / 抖动频率 | 让下压移动动作更柔和、更不固定。过高会影响稳定。 |
自动开火
自动开火现在是多配置模式。默认没有配置，点击“新增配置”后才启用。每条配置都能单独设置热键、类别、延迟、冷却和连续模式。
| 参数 | 效果 |
|---|---|
| 按住热键 | 选择右键、中键、侧键时，需要按住该键才允许自动开火。选择“自动”时，不需要额外按键。 |
| 目标类别 | 只对选中的类别触发。类别编号从 0 开始。 |
| 进入延迟下限 / 上限 | 准星进入匹配目标框后，随机等待这个范围内的时间再开火。 |
| 冷却下限 / 上限 | 两次自动开火之间的随机间隔。 |
| 连续模式 | 目标持续在框内时，会按冷却间隔重复开火。 |
自动开火触发条件是“准星进入匹配目标框内”，不再限制必须进入固定位置。若开启准星识别，会优先使用识别到的准星中心；否则使用画面中心。
连点
按住设置的触发按键后，系统会循环模拟左键点击。基础按下时间决定每次按住多久，基础间隔时间决定两次点击之间间隔多久。
自动背闪
| 参数 | 说明 |
|---|---|
| 触发类别 | 检测到指定类别后触发动作。 |
| 转身像素 | 横向移动距离。正值向右，负值向左。 |
| 停顿 ms | 转身后等待多久再回正。 |
| 平滑步数 | 动作拆成多少步。步数低更快，步数高更平滑。 |
| 冷却和随机 | 冷却避免频繁触发；随机降低每次动作完全相同的感觉。 |
准星识别
按游戏内准星形状和颜色选择。准星识别开启后，自动开火会优先使用识别到的准星位置判断是否入框。颜色越接近，识别越稳定。
08 硬件与分辨率
“硬件”页面主要负责模拟显示器 EDID 和 USB 鼠标硬件信息。分辨率、刷新率相关问题优先看这里。
显示器 EDID 怎么选
| 场景 | 建议设置 |
|---|---|
| 日常推荐 | 首选模式设置为和主显示器一致的分辨率，刷新率选择主显示器支持的最高值。例如主显示器是 1080p240，就选 1920x1080 @ 240 Hz。 |
| 第一次使用 | EDID 模式可以先用“电竞高刷模式”，然后把首选模式改成主显示器实际使用的分辨率和最高刷新率。 |
| 采集稳定，游戏正常显示 | 保持和主显示器一致即可，不需要主动切模式。 |
| 采集不稳定、黑屏、偶发掉画面 | 再尝试切换自定义模式，例如“先设置1920*1080@120”再切换“1920*1080@240”，可以恢复显示链路帧率异常问题。 |
| 游戏内看不到想要的分辨率 | 先确认 EDID 模式包含该分辨率，再到 Windows 显示设置里选择对应分辨率和刷新率。 |
显示器身份信息
显示器名称、厂商代码、产品 ID 和序列号用于模拟显示器身份。不确定具体取值时，可以点击“随机身份”后“保存并应用”。
USB 鼠标模式
| 模式 | 说明 | 建议 |
|---|---|---|
| 完整透传 | 尽量使用真实鼠标硬件信息。 | 日常优先使用，兼容性和手感更接近真实鼠标。 |
| 合成模式 | 使用设备生成的鼠标身份，可以自定义 VID、PID、制造商、产品名等。 | 只有完整透传不适配或需要特殊身份时再使用。 |
09 网络配置
“网络配置”用于设置局域网访问黑名单。
局域网黑名单
扫描局域网设备后，可以选择某个 IP 拉黑，阻止该 IP 访问本机网页。只支持单个 IPv4，不支持填写网段。
10 预设参数
预设参数用于保存当前配置，方便不同游戏、不同模型、不同武器或不同客户环境之间切换。
输入预设名称，点击“保存预设参数”。建议名称写清楚用途，例如“1080p-默认模型-稳定版”。
从“预设参数列表”选择后点击“加载”。加载后当前参数会变成该预设的内容。
导出 JSON 可用于备份和问题排查。导入 JSON 可以恢复已有参数配置。
建议每次调出满意效果后立即保存预设。继续尝试新参数前再保存一份，这样调坏了也能马上回退。
11 更新与扩容
“系统状态”里包含设备授权、系统更新、版本切换和存储扩容。
系统更新
点击“检查更新”，设备会向服务器查询可用版本。
如果需要指定版本，点击“切换版本”，从服务器版本列表选择目标版本。
点击“安装更新”后等待进度完成。更新过程中不要断电，不要重启设备。
刷新页面，确认系统状态正常、模型还在、热键和预设未丢失，再启动测试。
12 推荐调参流程
调参数最怕一次改太多。建议按下面顺序，从“检测稳定”到“移动稳定”，最后再加辅助功能。
进入“预设参数”，保存一份“原始参数”。后面任何时候感觉不对都能回退。
在“总览”观察预览。先把截取尺寸设置成模型输入尺寸，再调 FOV、置信度和 IoU，让目标框稳定出现。
在“热键控制”只选需要的类别，X/Y 轴偏移先用 0.5，确认锁定点在框内再微调。
追不上目标、拉枪速度不够就小幅增加 X/Y 轴拉力；冲过头或来回摆就降低对应方向拉力。积分和刹车新手建议保持 0，先不要参与调试。
目标横向移动时因为延迟总是滞后，就增加 X 轴预判；方向晃或修正过度，就降低预判。跟随可以加一点，用来改善刚锁上时的响应，但不要一次加太多。
基础锁定稳定后，再按需求开启拉枪曲线、压枪、自动开火等功能。持续提前量默认不需要开，只有想锁定移动目标提前身位时才打开。
常见现象怎么调
| 现象 | 优先调整 |
|---|---|
| 准星追不上目标 | 先加对应方向拉力，再小幅加跟随。整体都慢、且不抖时再加移动倍率。 |
| 准星冲过目标来回晃 | 降低对应方向拉力，确认积分和刹车保持 0，必要时适当增加基础死区。 |
| 目标横跑时总是落后 | 先确认 X 轴拉力速度够用；如果仍因延迟滞后，再小幅增加 X 轴预判。不要一次加太多。 |
| 目标轻微抖动时准星一晃一晃 | 降低预判，确认积分和刹车为 0，适当增加基础死区，并检查检测框是否稳定。 |
| 连续横移时想打提前身位 | 只有这个需求明确时才开启持续提前量。基础拉力和 X 轴预判稳定后，小幅增加提前量系数；身位提前过多就降低系数或增大进入距离。 |
| 自动开火不触发 | 确认已新增配置，类别选对，热键状态正确，准星确实进入目标框内。 |
13 常见问题
打不开网页怎么办
先确认电脑或手机和设备在同一网络。尝试 http://x-game.local:8000，不行就到路由器设备列表查 IP，再用 http://设备IP:8000。如果改过端口，要用新端口访问。
预览有画面但没有框
检查是否选择了模型、模型是否适配当前游戏画面、置信度是否过高。截取尺寸建议先设置成模型输入尺寸，例如 320 模型选 320，416 模型选 416。
有框但不移动
检查是否点击“启动”、热键是否按住、热键配置是否选择了目标类别、FOV 半径是否覆盖目标。也要确认鼠标输出状态正常。
锁定目标不对
先检查类别选择和类别编号。类别编号从 0 开始，模型输出类别错了会导致锁错对象。再检查置信度和 IoU，避免错误框参与锁定。
导入加密模型失败
确认模型是用这台设备复制出来的设备码加密的。不同设备码加密的模型不能混用。如果设备曾经被重置并清除了模型密钥，需要重新复制设备码并让供应商重新加密。
更新后 Wi-Fi 找不到
先重启设备，再进入“网络配置”扫描。如果仍然没有无线网卡，建议更新到最新完整包，因为完整包会带上常见无线网卡固件修复。
分辨率改完黑屏或识别异常
优先恢复“开机安全 + 全模式”，首选模式改成主显示器一致的分辨率和刷新率，保存并应用后重新检测 HDMI。仍不稳定时，再尝试兼容模式或自动模式。
参数调乱了怎么恢复
如果之前保存过预设，到“预设参数”加载旧预设。移动控制和辅助功能页面也有“恢复本页默认值”。