🎯 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，可以使用下方的工具快速检索。

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 (积分) 系数；或者稍微增加【预测间隔】给点提前量。