# 🎯 Sunset Aimbot 控制端完全指南

【调参很简单，理解本文，你也可以调出赋能、航天顶护的拉枪手感】

## 🚀 快速开始（使用指南）

### 1. 版本选择与硬件要求

- DirectML (DML) 版本 —— 通用型 (所有显卡)
  - 适用人群：任何现代显卡（NVIDIA、AMD、Intel，包括集成显卡）。
  - 优点：无需配置 CUDA 环境，解压即用，兼容性最强。
  - 建议：GTX 10xx/9xx/7xx 系列（老款 NVIDIA）、AMD Radeon、Intel Iris/Xe 或轻薄本/办公用集成显卡用户首选。
- CUDA + TensorRT 版本 —— 高性能型 (仅限 NVIDIA)
  - 适用人群：NVIDIA GTX 1660, RTX 2000/3000/4000/5000 及更新系列。
  - 要求：需要安装 CUDA 13.1 驱动支持（如果未安装，请先点击链接下载安装）。
  - 优点：利用 TensorRT 加速，推理延迟更低，性能更强。支持在设置中切换 CUDA+TensorRT 或 DML 模式。
  - 注意：GTX 10xx (Pascal) 及更早期的显卡因显卡硬件限制，不支持最新版的 TensorRT 加速。

### 2. 采集方式与硬件连接详解

为了获得最低的延迟和最佳的安全性，本程序支持多种画面采集方式。请根据你的硬件环境选择：

- 常规本机采集 (Duplication API)
  - 原理：直接调用 Windows 的桌面复制接口，适合单机使用。
  - 配置：`capture_method` 设置为 `duplication_api`。
  - 优点：无需额外硬件，延迟极低，适配性最广。
- UDP 异步采集（双机网络转发流派，已被TX检测）
  - 原理：在“游戏机（发送端）”截取画面并压缩，通过局域网发送到“AI 机（接收端）”。AI 机只负责目标检测和控制
  - 发送端设置：使用 FFmpeg 将桌面流推送至接收端 IP。示例命令： `ffmpeg -f gdigrab -framerate 60 -i desktop -vf scale=640:640 -vcodec mjpeg -q:v 5 -f mjpeg udp://接收端IP:1234`
  - 你也可以使用OBS双机推流，去b站找教程即可
  - 接收端设置：
    - 在菜单中将 `capture_method` 设置为 `udp_capture`。
    - 确保 IP 设置为 `0.0.0.0`（监听所有地址）或指定的发送端 IP。
    - 开放防火墙 UDP 端口（默认 1234）。
- 采集卡 物理隔离流派 最大程度规避反作弊对采集行为的检测。
  - 原理：通过 HDMI 采集卡将游戏机的画面传输到 AI 机，AI 机通过 OpenCV 直接读取视频采集设备。
  - 硬件连接：`游戏机 HDMI 输出` ➔ `HDMI 一分二 (或带环出的采集卡)` ➔ `采集卡 USB` ➔ `AI 机`。
  - 软件配置：
    - 在菜单中将 `capture_method` 设置为 `VideoCapture` (OpenCV)。
    - 在设备列表中找到你的采集卡名称并选中。
    - 分辨率建议：通常设置为 `1920x1080` 或 `1280x720`，程序会自动在中心裁剪出 AI 运算区域。

### 3. 如何运行

1. 下载并解压 对应版本的压缩包。
2. 对于 CUDA 版本，请确保已安装 CUDA 13.1。
3. 对于 DML 版本，无需额外软件设置。
4. 运行 `ai.exe`。
   - 首次运行：程序会自动导出模型优化，可能需要 1-5 分钟，请耐心等待。
   - 防呆保护机制：如果系统缺失必要环境文件（如 `cpbox_mouse_dll.dll` 等），程序在启动时会立刻弹出清晰的报错提示框，不再存在“双击没反应”的静默闪退情况。
5. 放置模型：将你的 `.onnx` 模型文件放到目录下的 `models` 文件夹中。
6. 开启菜单：在游戏内按 HOME 键打开/关闭设置界面（Overlay）。

### 4. 控制快捷键

- 鼠标右键：瞄准锁定的目标。
- F2：退出程序。
- F3：暂停/恢复瞄准。
- F4：重新加载配置文件。
- Home：开启/关闭菜单界面。

### 5. 界面与防混淆提示新特性

- 当前硬件路径 (区块)：在“采集范围”页面，你会看到清晰的硬件分配指示。分别展示正在录制画面的[采集源]，以及真正在执行运算的[推理设备]，拒绝设备名混淆。
- 显卡智能调度 (DML)：使用通用的 DML 版时，底层不再盲目绑定默认的显卡 0。系统会智能检测出最优的 GPU，甚至当你手动瞎配 `dml_device_id` 时，也能智能回退并展示出实际的详细显卡型号。

## 一、 参数全解析：每个参数都在做什么？

### 1. 视野 (FOV)

决定了 AI 在屏幕上寻找和锁定目标的区域大小。

- 视角 X (FOV X): 水平方向的搜索范围。
- 视角 Y (FOV Y): 垂直方向的搜索范围。

> 💡 调参影响：
> - 调大：AI 会尝试锁定距离准星更远的目标，但在人多的情况下容易频繁在不同目标之间切换（也就是乱锁）。
> - 调小：AI 只会锁定准星附近极小范围内的目标，不易受干扰，但需要你手动将准星拉到非常接近目标的位置才会触发。
> 每个游戏都有引擎自带的标准 FOV，可以使用下方的工具快速检索。

🔍 常用游戏 FOV 快速查阅工具
FOV X (水平视角) -
FOV Y (垂直视角) -

### 2. 速度倍率 (Speed Multiplier)

限制了鼠标移动的极值，这直接影响跟枪手感。全新版本移除了生硬的最大/最小速度瞬间突变硬切，改为了连续平滑的时间过渡，让拉枪告别死板的机械感。

- 最小速度倍率 (Min Speed Multiplier): 移动速度的下限乘数。
- 最大速度倍率 (Max Speed Multiplier): 移动速度的上限乘数。

> 💡 调参影响：
> - 影响着整个光标由远及近飞向目标时的“绝对限速范围”。
> - 如果你觉得总体拉枪偏慢，可以适当调大最大速度倍率。
> - 如果远近距离拉枪都太快像非人类，需要调小最大速度倍率。

### 3. 轨迹预测 (Prediction)

打移动靶的核心机制。目前底层现已全部打通且强制走动态 Alpha-Beta 预测链路，追踪锁敌更精准丝滑。

- 预测间隔 (Prediction Interval): 预判未来的时间跨度参数（UI 现已提升为保留3位小数的毫秒级显示精度）。系统在底层已接入精准延迟补偿引擎，使用公式 `基础预测间隔 + 实时推理延迟` 计算提前量，彻底解决总是吃尾气慢半拍的问题。
- 预测位置数 (Future Positions): 取历史多少帧位置数据来进行运动轨迹推演。

> 💡 调参影响：
> - 调大间隔：准星会瞄向目标运动前方的更远距离（提前量变大），适合子弹飞行速度慢或目标移动极快的游戏。
> - 调小/禁用：准星仅仅锁定目标当前的真实位置。打静止靶极准，但打高移速移动靶时准星总会跟在目标后方吃尾气。

### 4. 目标修正 (Target Correction) ⭐ 核心手感区

这一块主要决定“当准星由远到近贴近目标时，速度如何平滑过渡以及如何锁死”。

- 吸附半径 (Snap Radius)：距离准星极近时的“强行吸附”范围。在这个范围里，光标几乎不减速或提供极强的最终一击锁敌。
- 近距半径 (Near Radius)：光标进入该半径时，开启减速机制的区域。通常远大于吸附半径。
- 速度曲线指数 (Speed Curve Exponent)：控制光标进入近距半径后的“减速曲线”。
  - 数值 < 1.0 (例如 0.5)：减速非常缓慢，光标在靠近目标时速度依然较快并且线性减弱。
  - 数值 = 1.0：标准的线性匀减速。
  - 数值 > 1.0 (例如 2.0~3.0)：指数级急减速，靠近目标时突然变慢，显得很平滑但可能导致最终锁定略有迟缓。
- 吸附加速倍数 (Snap Boost Factor)：一旦进入“吸附半径 (Snap)”范围，提供一段最后的速度爆发，防止光标因为上面的减速曲线而卡在目标周围进不去中心。
- 速度估计与 EMA 平滑：处理由于画面采集或物理操作带来的高频抖动。
  - 速度估计平滑系数 / 线性输出平滑系数：数值越低（如 `0.1`）极度平滑，但响应有明显拖影/延迟；数值 `1.0` 意味着无平滑，响应极快但在非绝对稳定环境下会发生准星跟随后微小抽搐。
- PID 增强 (Ki & Kd 比例)：
  - Ki (积分)：用于解决“稳态误差”。比如你发现平滑开得高，准星永远追不上移动目标，差了几个像素。调大 Ki 能够让 AI 意识到“我已经落后很久了，我要加速补回这一段”。
  - Kd (微分)：用于防止“超调”。阻尼刹车作用。

### 5. 游戏配置 (Game Profile) ⭐ 必须第一步设置对！

AI 必须知道游戏内的物理引擎映射，才能计算该把鼠标移动多少，这是基石。

- 当前配置 (Profile) & 游戏内鼠标灵敏度/偏航角/俯仰角：这些影响整体的拉枪速度，可以简单理解为PID的p值。
  - 灵敏度 (Sens)：这是决定拉枪速度的核心参数。在余晖代码逻辑下，数值越低，瞄准拉枪越快；数值越高，瞄准拉枪越慢。请根据跟枪速度的需求按需调整。最优先是调整这个值
  - 偏航角 (m_yaw) & 俯仰角 (m_pitch)：必须与游戏内设置（通常为 `0.022`）保持绝对一致，以确保计算准确。

> 💣 如果填错了会怎样？
> AI 会发现：我明明移动了这么多，为什么准星没到？接着 AI 又会再次猛拉，表现为光标疯狂鬼畜摇摆，或者是拉不到位/甩过头。正常情况就是拉枪到目标且不抖动，就说明灵敏度设置正确。

### 6. 拟人轨迹与微扰 (Bezier / Perturbation)

- Bezier 轨迹曲线：控制整体拉枪的宿主曲线。启用后，瞄准轨迹会带有人性化的弧度，而非死板的直线寻路。
  - 曲线强度：控制轨迹产生弧度的大小。
- 鼠标微扰 (Wind Perturbation)：在基础轨迹上，施加沿法线方向的随机物理微颤抖（类似手抖）。这种细微的扰动极大程度粉碎反作弊的异常平滑度侦测。
  - 微扰强度：只需通过这一个滑条即可控制物理抖动的拟人幅度。拉高增加波动感，但过高会感到屏幕轻微晃动。
- 鼠标输入方式：推荐使用 GHUB / KMBOX / MAKCU 等外设模拟，以规避反作弊对纯软件 WIN32 进程的监控。

## 二、 科学调参 6 步法：如何从零调出完美手感？

> 💡 调参心法则：每次只调一个参数，并在靶场测试感受它的变化。千万不要一次性乱改五个参数，一旦手感变差你根本不知道是谁引起的问题。

### 📌 步骤 1：对齐物理基准（最重要的一步！）

1. 进入【游戏配置】栏目。
2. 设置游戏灵敏度 (Sens)：重点理解——调低数值 = 加快拉枪速度，调高数值 = 减慢拉枪速度。根据实际游戏内的拉枪手感微调。
3. 确保你的 `m_yaw` 数值与游戏引擎底层（大多数是 0.022）一致。

### 📌 步骤 2：设定舒适的瞄准视野

在界面中输入你刚才在上方工具中查阅到的对应游戏的 FOV 数值。

### 📌 步骤 3：基础跟枪手感打磨（暂闭平滑与增强）

1. 暂且将【移动修正】面板中的 速度估计平滑系数 和 线性输出平滑系数 设为 `1.0` (即无平滑)，或者直接取消勾选 启用线性输出 EMA 平滑。
2. 先把 启用 PID 增强 取消勾选。
3. 先把【轨迹预测】的 预测间隔 调为 `0` (关闭)。
4. 调整 最小/最大速度倍率。在靶场看着静止目标按住锁定键。【一般情况0.1就行】
   - 目标：确保拉枪的速度符合预期，不慢得像蜗牛，也不快得像瞬移。
5. 测试并调整【速度曲线指数】和【近距半径】。
   - 如果拉枪太突兀不自然，把曲线指数调到 `1.5 - 2.5` 之间，让靠近时有减速感。
   - 如果最后阶段总是进不去目标中心，稍微调大【吸附加速倍数】(例如调到 `1.5`) 和【吸附半径】(例如 `2.0`)。

### 📌 步骤 4：消除机械感与抖动（启用平滑）

1. 开始缓慢调小 速度估计平滑系数（如有需要可勾选并向左调节 线性输出平滑系数），从 `1.0` 慢慢往下试（如 `0.8` -> `0.6` -> `0.4`）。
2. 每降一点，感受一下光标移动是否变得丝滑。
3. 寻找临界点：当你发现虽然丝滑，但感觉“拖泥带水，总是比目标慢半拍”时，说明平滑系数太低了。稳妥的数值通常在 `0.4 - 0.7` 之间。

### 📌 步骤 5：攻克移动靶难题（预测与 PID）

1. 应对延迟：如果你的画面因为采集计算延迟，总落后于敌人的真实位置，稍微开启一点【预测间隔】（例如 `0.02 - 0.05` 秒），让准星提前去预测目标前方的身位。
2. 解决稳态误差（总是跟在屁股后面偏一个身位）：勾选【启用 PID 增强】。
   - 逐渐增加 积分 Ki 比例（例如调到 `0.05` -> `0.1`）。你会发现原本平滑带来的滞后感消失了，准星会“加速用力”追上一段填平这段差距。
   - 如果 Ki 太大导致准星像钟摆一样在目标身上左右摇晃甩过头，就微微增加 微分 Kd 比例 (例如 `0.001 - 0.005`) 来给鼠标踩一脚刹车，专门抑制这种摇晃。

### 📌 步骤 6：伪装得更像人类（曲线与微扰）

1. 切换到【移动修正】面板，拉到底部，勾选 启用轨迹曲线 和 启用微扰。
2. 通过拖动下方的 曲线强度 和 微扰强度 滑条来打磨你想要的拟任性。通常只需适度拉高开启一点点（如 `0.2 ~ 0.5` 区间），即可在保证准度的前提下，让锁敌的轨迹路线发生极具真人的随机浮动和偏移。

## 🎉 常见疑难解答 (Troubleshooting)

- Q: 双击打开没反应，没有运行或者直接无故消失？
  A: 你缺失了核心运行库（如驱动 DLL），仔细留意启动时弹出的报错明细窗，补齐缺少的文件即可。
- Q: 准星疯狂左摇右晃、抽搐停不下来？
  A: 绝对是【游戏配置】里的灵敏度(Sens) 没调整正确，说明参数超调了（数值越低，瞄准拉枪越快；数值越高，瞄准拉枪越慢）。
- Q: 远距离拉枪很准，但进了近战范围锁定总是差最后一点贴不上？
  A: 调高【目标修正】里的【吸附加速倍数 (Snap Boost)】，或者调低【速度曲线指数 (Speed Curve)】。也可能是平滑系数开得太低太拖沓了。
- Q: 打移动靶时，准星始终在它身后一点点？
  A: 开启【PID 增强】，适度加一点 Ki (积分) 系数；或者稍微增加【预测间隔】给点提前量。

## 🕹️ 互动调参沙盒

拖动下方滑块，实时观察【曲线指数】与【微扰强度】对拉枪轨迹的改变。
直观解答误区：你可以发现，所谓的“随机鼠标微扰”只会作用在 大范围拉枪的途中，当准星贴近敌人身旁时，程序会自动将其削弱至 0，从根本上杜绝了部分玩家担心的“死锁敌人时依然疯狂抽搐”的幻觉。

🔴 移动敌方靶子 ⚪ 你的准星轨迹
速度曲线指数 (Speed Curve) 1.5
微扰强度 (Perturbation) 2.5
拉枪基础速度 (Speed Base) 0.12

* 提示：直接在黑色画布内点击任意位置，可自定义瞄准起步点。

### 🚗 轻松一刻：3D 驾驶游乐场 (Bruno Simon)

一直盯着枯燥的参数数据看不仅头晕脑胀，还容易让人越调越暴躁？不如把鼠标放下一边，来这里摸会儿鱼吧。
休闲解压 🏖️：我们搬来了享誉全球的 WebGL 标杆之作。点进画面，控制你的越野小车去撞翻积木、按按喇叭、来几个随性的漂移。清空一下压力，休息好了咱们再战！

💡 驾驶提示：点击上方游戏画面激活焦点，随后使用键盘 `W` `A` `S` `D` 或方向键开车。

## 📅 更新日志 (Changelog)

v2.1.2 Latest 界面、采集卡与设备体验更新

- 新增雷蛇支持：添加 `RAZER` 移动方式，支持使用雷云 3 驱动的鼠标。
- 界面显示优化：补全常用按键中文翻译，优化配置区排版，偏移预览图更加直观清晰。
- 采集卡兼容提升：优化 `MJPG` 画面解码逻辑，降低画面中断概率，增强多格式适配能力。
- 偏移参数独立保存：身体与头部的瞄准偏移现已按检测模型独立保存，切换模型不再互相覆盖。
- 异常状态提示：改进雷蛇状态显示，并在环境异常时弹出明确报错，避免程序静默闪退。

v2.1.1 Update 连接稳定性与扳机控制更新

- 连接修复：修复 MAKCU 盒子自动连接，改善设备自动识别与初始化流程稳定性。
- 准星找色：新增准星找色功能，支持围绕准星颜色做检测与相关配置。
- 自动急停：新增 net 扳机自动急停，触发时可联动急停控制，提升开火阶段稳定性。

v2.1.0 Feature 全新拟人轨迹与预测升级

- 强化预测：接入 Dynamic Alpha-Beta 预测链路，并把延迟补偿接到实时预测与 future positions 的 lookahead 计算。
- 拟人轨迹：扩展轨迹系统，加入短 Bezier、线性步进、step quantizer、微扰动、轨迹模式与预设。
- 调试能力：新增 Aim Debug 录制与导出能力，便于回放和分析瞄准过程。
- 设备体验：新增 MAKCU 自动匹配与 Auto 串口 / 波特率配置，并优化 DML 推理设备选择与显示。
- 界面与稳定性：优化速度切换与 `predictionInterval` 显示，补强虚拟相机启动 / 切换稳定性。

v2.0.0 Major AI压枪与硬件适配升级

- AI压枪修正：压枪功能变更为智能模式，结合目标锁定状态进行平稳的纵向与轻微横向补偿控制。
- 透传适配：无缝适配 CloudPierce Box 等纯硬件级透明透传设备，全面提升链路防检测能力。
- 底层修复：修复切换配置时可能误重连键鼠盒子的中断 bug。

v1.9.0 算法优化与兼容性扩展

- 优化了多项自适应曲线参数与 EMA 平滑权重，全面增强了对无后座绿玩的锁定追击手感。
- 扩大了 TensorRT 引擎的算力层兼容，无缝覆盖 GTX 1660 直通下世代 RTX 50 系显卡。
- 修复 MAKCU 控制板的热键响应；提升 OBS 虚拟相机抓取兼容；采集卡新增多路帧率/格式协商。

v1.8.0 UI重构与视觉满配

- UI面板主色调强化加强与精美分类小图标全面加护。
- 引入实用的“自动绘制瞄准范围框”以及距离优先级挂载的多目标防抖过滤。
- 追加应对长发卡壳的“长 TTK 保持开火”功能，以及各类别敌对角色独立的头身 Y轴 微调高度。

v1.5.0 - v1.7.0 帧率突破与极限保护

- 为采集卡接入自适应 NV12 硬件解码及极速调度，支持跨格式回退，彻底打破过去锁死 60fps 的天花板。
- 本机采集(WinRT API)增设多帧留取复用机制破除屏幕物理上限困扰。
- 界面控制添加长按免解锁 Y 轴等便利键位操作与拉枪极致振幅溢出限制。

v1.1.0 - v1.4.0 奠基时刻：手感重炼

- 在此确立并引爆了 `预测预瞄 + EMA重平滑 + PID微分闭环` 的坚固三角瞄准控制基座，一举拔高基础跟踪精度。
- 完善了不同环境分辨率下的精细扳机识别，分离式 X/Y 轴拉枪占比拆分等首批进阶参数群。

内测交流
加入Q群
群号: 891746243
获取新版本，同时和群友开黑！