WhizKid 使用与调参指南

先让软件看得见，再让它跟得准。

按这个顺序完成基础链路：授权、画面、模型、类别和设备。确认能识别、能锁定、能移动后，再进入 FOV、PID、目标跟踪、人性化、扳机、压枪、样本采集、宏和状态排查。调参时重点看手感变化：调大更快还是更稳，调小更干净还是更迟钝。

捕获页模型页类别页设备页 PID 人性化扳机压枪样本采集

会员与授权

会员中心用于查看当前授权是否可用、到期时间和本机机器码。先确认这里正常，再继续后面的捕获、模型和设备配置。

卡密与登录

在会员中心输入卡密后点击验证并激活。若是自己的常用电脑，可以开启记住登录(本机)，下次启动会更省事；需要换号或重新绑定时使用撤销授权。

状态与到期

状态显示是否可用，到期显示剩余时间。这里异常时，先处理授权，再继续调参。

本机机器码

模型页会显示本机机器码，通常用于模型授权、绑定或客服排查。需要复制时直接使用页面里的复制按钮。

首次使用向导

第一次使用建议按向导顺序走完。它不是形式流程，而是在帮你把最常见的“有画面但不动”“有框但不锁”“能动但乱动”逐层排除。

1. 激活授权

先确认会员中心可用，避免后面页面不可操作。

2. 采集到画面

捕获页预览能看到正确画面，不黑屏、不拉伸。

3. 加载模型

模型页加载文件并开始推理，等待构建或加载完成。

4. 看见检测类别

预览里有框，并能看到目标对应类别 ID。

5. 设置三层目标

把正确 ID 填到优先、滞后或其它目标。

6. 连接输出设备

从 SendInput、MAKCU、Net、DhzBox、CatBox、KM Box A、Logitech 中选择当前要用的输出方式并连通。

7. 测试移动

设备页测试移动成功后，再进入 PID 和自瞄。

8. 看框与锁定结果

确认显示框、类别过滤、FOV 和按键都符合预期。

9. 保存当前配置

能稳定跑通后立刻保存一份配置，后续调坏了可以回退。

快速上手

首次使用先不要直接调 PID。WhizKid 的链路是：画面进入软件，模型识别出框，类别页允许这个框参与瞄准，设备能输出移动，最后 PID 才负责“怎么移动”。

完成授权

先确认会员中心显示授权可用。未授权时，捕获、模型、设备等核心页可能无法正常使用。

到捕获页启动画面

选择采集模式，确认预览不是黑屏，裁剪宽高通常跟模型输入尺寸一致。使用采集卡时先确认输入分辨率和解码格式。

到模型页加载模型并开始推理

选择后端、模型类型、模型文件和输入尺寸。先让目标稳定出框，再谈后续手感。

看清模型实际识别出的类别 ID

有检测框不等于能自瞄。先记录目标框的类别 ID，后面要填到类别页的优先/滞后/其它目标里。

到类别页配置三层目标

优先目标、滞后目标、其它目标按顺序生效。只有当前层没有可用目标时，才会降级到下一层。

到设备页连接输出设备

先用“测试移动”确认设备真的能动。不同设备的连接参数和运行库要求不同，不要用 PID 去修设备没连好的问题。

打开自瞄与 FOV

先用固定范围和一个按键测试，确认按住按键时能锁上，再切换动态范围、多按键、分按键参数。

再进入 PID、目标、人性化细调

每次只改一个方向的少量参数，保存一份可回退配置。调参时优先观察：是否慢、是否冲过、是否抖、是否频繁换目标。

最重要的顺序：先调识别稳定，再调类别命中，再调设备输出，最后调移动手感。前面任何一层不稳定，PID 都会被迫背锅。

捕获与预览

捕获页解决的是“软件看到什么”。画面错、裁剪错、帧率不稳，后面的模型和瞄准都会一起变差。

本机屏幕

DXGI 优先用于本机低延迟画面；黑屏或抓不到时再试 WGC 或 GDI。

目标FPS、分辨率、裁剪宽、裁剪高只在本机屏幕模式下直接显示。

外部网络

OBS 填 OBS IP 和端口；NetRecv 填本机接收端口；NDI 刷新后选择 NDI 源。

这类问题先查发送端、同网段、防火墙和端口，不要先改 PID。

采集卡

采集卡用于 HDMI/USB 输入，先选后端和设备，再看输入分辨率、解码格式、目标 FPS、裁剪尺寸。

源画面分辨率负责“进来的画面”，裁剪尺寸负责“喂给模型的画面”。

样本采集

捕获页还有样本采集子页，用来按类别或侧键保存训练/排查图片。

它只保存样本，不会改变模型页过滤、自瞄类别、扳机类别或当前识别结果。

采集模式怎么选

GDI / DXGI / WGC

DXGI 通常优先；WGC 适合部分 DXGI 黑屏或窗口链路；GDI 适合先验证基础可见性。

本机模式先确认屏幕、分辨率和裁剪，再看帧率。

OBS / NetRecv / NDI

OBS 看 IP/端口；NetRecv 看接收端口；NDI 看源列表。

无画面时先查发送端是否在推流，再查防火墙和同网段。

采集卡

自动（推荐）会先尝试更低延迟链路，再回退兼容链路；手动后端用于定位黑屏、格式或延迟问题。

采集卡画面拉伸时，先核对输入分辨率和预览铺满方式。

采集卡后端怎么选

自动（推荐）

先尝试 Magewell（美乐威）专用路径；Pro Capture 走 Pro 低延迟，Eco Capture 走 Eco SDK 私有路径。

不可用时会回退 Media Foundation 或 DirectShow。

日常优先用它；只有排查黑屏、格式或延迟时才手动切后端。

Magewell（美乐威）

面向美乐威 Pro/Eco 采集卡。Pro 走最低延迟路径，Eco 走 Eco SDK 私有路径。

USB 捕获系列和第一代设备不走这条低延迟路径，会回退到兼容链路。

Media Foundation

Windows 原生采集链路，通常比传统兼容路径延迟更低。

自动模式不理想时，用它和 DirectShow 做对比。

DirectShow

兼容性优先的采集链路。

设备老、格式特殊或新链路黑屏时，用它做兜底验证。

现象	先检查	建议
黑屏或无画面	采集模式、屏幕/设备、OBS IP/端口、NetRecv 接收端口、NDI 源、采集卡设备和后端	先切到最简单的本机模式验证，再回到外部链路。
画面拉伸或黑边	采集卡输入分辨率、预览黑边处理、裁剪宽高	输入分辨率跟真实源一致，裁剪尺寸跟模型一致。
帧率忽高忽低	目标 FPS、低延迟模式、截图分离、预览帧率	先关掉不必要预览效果，保证推理链路稳定。

捕获页常用操作

功能	怎么用	注意
开始采集 / 停止采集	先开始采集，看状态是否显示 Cap、UI 帧率和实际分辨率。	只采集不等于已经推理；模型页还要加载模型并开始推理。
目标FPS	本机采集和采集卡都可限制帧率，可选 3060120144165240无限制。	帧率不稳时先限制到稳定值，再追求更高帧率。
截图分离	让预览和检测处理分开跑，预览通常更顺滑。	目标框可能比画面慢一点；调手感时以实际锁定表现为准。
低延迟模式	优先使用最新画面，减少等待。	追求低延迟时打开；如果画面或框不稳，可以关闭对比。
OBS IP / OBS 端口	选择 OBS 模式后填写发送端地址和端口。	黑屏时先确认 OBS 端是否正在发送，IP 和端口是否一致。
接收端口	NetRecv 模式下填写本机接收端口。	端口被占用或发送端端口不一致时会收不到画面。
NDI 源	选择 NDI 后先刷新，再从列表里选源。	列表为空时检查发送端、同网段、防火墙和 NDI 服务。
采集卡设备 / 刷新设备	采集卡模式先刷新设备，再选择采集卡。	采集中刷新格式可能延后，必要时先停止采集再刷新。
采集卡后端	自动（推荐）MagewellMedia FoundationDirectShow	自动会先试 Magewell Pro/Eco 专用路径，再回退 Media Foundation/DirectShow；手动选 Magewell 也会防呆回退。
输入分辨率 / 解码格式	输入分辨率填采集卡源画面，解码格式建议先自动或 NV12。	MJPEG 可能增加解码开销；画面异常再试 YUY2、RGB24/RGB32。
源画面预览	采集卡可独立打开完整源画面预览，支持启用预览、全屏窗口、窗口置顶、显示框和显示器选择。	源画面预览打开时会接管普通预览窗口。
显示模式	自动等比只裁黑边铺满裁切铺满背景填充固定原始比例	只影响源画面预览怎么显示；排查裁剪时优先用自动等比或固定原始比例，看清真实黑边和画面比例。
缩放质量 / 缩放状态	自动高画质（推荐）会按实际尺寸选择 1:1、FSR1 放大或高质量缩小；状态会显示当前缩放方式。	只影响源画面预览的显示质量，不改变采集和推理输入。
自动裁切黑边 / 裁切方向 / 黑边检测	打开后会锁定源画面黑边；方向可选自动判断、只裁左右、只裁上下，也可以点重新检测。	平板源常见左右黑边，手机宽屏源常见上下黑边。画面比例异常时先重新检测。
启用滤镜 / 原画对比 / AI 自动生成	用于采集卡源画面预览的观感校正；AI 自动生成会按当前画面生成一组自定义滤镜。	滤镜只影响预览查看，不改变采集、推理、弹道识别或真实输出。
锐化 / 亮度 / 曝光 / 对比度 / 阴影 / 高光 / 饱和度 / 鲜艳度 / Gamma / 色相偏移 / 色温 / 水平翻转 / 垂直翻转 / 重置	手动微调源画面预览的清晰度、明暗、色彩和方向。	排查识别问题时先确认原画和裁剪正确，再决定是否需要预览滤镜。

样本采集怎么用

样本采集适合收集模型训练图片、留问题样本或复盘识别效果。它依赖模型推理：没有启动推理时，自动按类别采集不会开始；侧键强制采集可以用来保存当前帧。

功能	怎么用	注意
开始采集 / 停止采集	先加载模型并开始推理，再选择采集类别或开启侧键强制采集，最后开始采集。	未选择类别且侧键强制关闭时不会采集。
保存根目录 / 打开目录 / 恢复默认	默认保存到软件目录下的 SampleCollection。相对路径以 WhizKid.exe 所在目录为基准。	图片会实际写入磁盘；长期采集后记得整理或删除不需要的样本。
最小间隔(ms)	限制两张样本之间的最短时间，自动识别采集和侧键强制采集都受它影响。	太低会快速占用磁盘，太高会漏掉变化样本。
图片格式 / PNG压缩 / JPG质量	PNG 更适合保留细节，JPG 更省空间；格式不同会显示对应压缩或质量参数。	训练样本优先保证清晰，空间紧张时再考虑 JPG。
自定义保存尺寸 / 保存尺寸	关闭时保存当前检测画面原始尺寸；开启后中心方形裁切并缩放到指定尺寸。	这里只改变保存出来的样本图，不改变捕获或推理尺寸。
侧键强制采集 / 强制采集按键	按住侧键1或侧键2时，无论有没有检测目标都会按最小间隔保存当前帧。	适合补采失败样本、背景样本或没有框但你想留下来的问题画面。
采集类别与置信度	勾选要采集的类别；需要只收低置信度样本时，打开限制置信度并设置最大置信度。	类别选择只控制样本采集，不会改变模型显示过滤、自瞄类别或扳机类别。
已保存 / 待写盘 / 丢弃 / 失败 / 清空统计	用来观察写盘是否跟得上、有没有队列堆积或保存失败。	统计清空只清计数，不会删除已经保存的图片。

模型与检测

模型页决定“软件能不能认出来”。先追求框稳定、类别正确，再追求速度。

后端

TRT 通常速度更好，但第一次可能需要编译 engine。
DML 适合兼容性测试。
NCNN 需要配套参数文件。

模型类型

模型类型包含 YoloX、v5、v7、v8、v10、v11、v12、v26。文件名提示和实际类型不一致时，优先确认模型来源。

输入尺寸

尺寸越大，看小目标通常更好，但推理压力更高。尺寸越小，速度更好，但远距离目标更容易漏。

置信度与 NMS

参数	调大	调小	建议
置信度	误识别更少，但漏框增加。	更容易出框，但杂框更多。	先从 0.30 左右开始，漏目标再降，杂框多再升。
NMS	重叠框更容易保留。	重叠框更容易被合并/压掉。	同一个目标重复框多时微调，不要大幅乱拉。
目标框丢检保持	短暂丢框不容易断。	切换更干净。	画面偶尔漏检可以开，误锁时先关或降低保持帧数。
小目标增强	远处/小目标更容易被保留。	更干净，但小目标可能漏。	只在确实需要远距离识别时打开。

判断标准：预览里目标框稳定、类别 ID 稳定、框的位置贴住真实目标，才说明模型链路可以进入瞄准调参。

加载、卸载与构建等待

加载前检查

模型文件、后端、模型类型、输入尺寸要互相匹配。
NCNN 需要配套参数文件；TRT 首次构建可能需要等待。
切换模型后，先等加载状态稳定，再开始比较效果。

推理中观察

看框是否贴目标，而不是只看有没有框。
看类别 ID 是否稳定跳变，跳变会直接影响类别页锁定。
看小目标增强是否带来杂框，必要时回调置信度和 NMS。

模型页常用操作

功能	怎么用	注意
复制机器码	机器码显示在模型页顶部，需要时点击复制。	这是本机识别码，换机器后会不同。
加载模型 / 卸载模型	参数选好后加载；要切后端、设备或模型文件时先卸载。	模型加载后，部分模型设置会锁定，避免运行中被改乱。
开始推理 / 停止推理	模型加载成功后开始推理，状态会显示 Det、耗时和 UI 帧率。	有画面但没框时，确认推理是否真的开始。
设备 / 刷新	按当前后端刷新并选择 DML、Vulkan 或 CUDA 设备。	加载或推理中不可随意切换设备，先停止再改。
模型选择 / 刷新	模型放入 models 后点击刷新，再从列表选择。	文件名提示只辅助判断模型类型，最终以实际模型来源为准。
NCNN参数	NCNN 后端需要填写配套参数文件。	ONNX 和 NCNN 参数不匹配会导致加载失败或输出异常。
TRT详细日志	TensorRT 构建或加载排查时打开。	平时可关闭，排查首次构建慢或失败时再开。
TensorRT FP16 选项	TRT 首次加载时会询问是否使用 FP16。	FP16 通常更快，但精度可能略低；不确定先选 FP32。
类别过滤：全选 / 取消全选	模型加载后可勾选允许保留的类别 ID。	取消全选会全部过滤，看不到框也不会参与自瞄。
增强置信比例 / 增强NMS / 最小面积 / 最大面积 / 增强平滑 / 平滑帧数	打开小目标增强后，用这些参数控制小目标候选数量和稳定度。	杂框变多时，先提高增强置信比例或收紧面积范围。

按键与优先级怎么选

功能	可选项	适合场景
自瞄按键 1-5	无左键右键中键侧键1侧键2Shift	先只设一个常用键；多个键用于右键稳跟、侧键快锁、Shift 近身等不同手感。
最后按下优先	多个自瞄键同时按住时，最近按下的键生效。	适合临时切到另一个手感，例如按住右键时再按侧键快锁。
最先按下优先	多个自瞄键同时按住时，最早按住的键保持生效。	适合不想被后续误触打断当前锁定手感。
列表顺序优先	按自瞄按键 1 到 5 的顺序决定谁优先。	适合固定主副优先级，常用主键放前面。

类别与锁定

类别页是 WhizKid 的“能不能锁这个目标”的门槛。很多“有框但不动”的问题，其实是类别页没有命中。

优先目标

最先尝试锁定，适合头部、关键部位或最高优先级类别。

滞后目标

优先目标短暂丢失时的备用层，适合身体框或辅助类别。

其它目标

兜底层。当前两层都不可用时才使用。

模型类别过滤

勾选的类别才进入检测/锁定链路；取消勾选就是硬过滤。

字段	含义	操作建议
类别 ID	模型输出的类别编号；-1 表示禁用该层。	先在预览里看真实 ID，再填这里。
锁定范围最小值 / 锁定范围最大值	目标框内纵向比例，0 是顶部，1 是底部。	想锁头就把范围放在框上部；想锁身体就放宽。
最小置信度	该层单独的置信度门槛。	0 表示不过滤，不是禁用。误锁多就升一点。
头部冻结时长	优先目标短暂丢失时，保留上次头部点的时间。	多人同屏或头部偶尔丢检时有用；过高会感觉粘旧点。

关键提醒：“模型还在原始输出某个类别”和“软件允许这个类别参与预览/自瞄”不是一回事。类别勾选是否生效，以软件最终显示和锁定结果为准。

输出设备

设备页解决“移动指令从哪里发出去”。PID 参数只能改变移动量，不能修复设备未连接、端口错误或网络地址错误。

SendInput

系统级输入方式，最容易测试。部分硬件级能力不可用，例如鼠标死区里的物理轴屏蔽。

MAKCU

串口设备。可填写 COM端口和波特率，也可留空让软件扫描 CH340/CH343。4M升速只在设备支持时打开。

Net / DhzBox

网络设备。Net 需要 IP、端口、UUID；DhzBox 需要 IP、端口、RANDOM。先测试移动，再调瞄准。

CatBox

UDP 设备。填写 CatBox IP、CatBox Port、CatBox UUID 后连接。

UUID 格式不对或设备未响应时会连接失败，先确认同网段和设备供电。

KM Box A

需要完整包里的 km.dll。KM Box VID、KM Box PID 使用十六进制。

提示缺少运行库时，重新解压完整包；连接成功后先测鼠标移动。

Logitech

无需额外参数，依赖完整包里的 logitech.dll 和本机 Logitech G HUB/驱动环境。

提示虚拟鼠标未启用时，先重启或修复 G HUB 驱动，再回软件连接。

手搓模式

手搓模式(去热键) 让业务功能不依赖热键，按勾选项持续运行。常用于调试持续自瞄、持续扳机、手搓压枪。若开启手搓动作需找色命中，对应动作还要等准星找色命中后才执行。

设备页常用操作

功能	怎么用	注意
连接设备 / 断开连接	选好设备类型和参数后连接；切换设备类型会断开旧连接。	显示已连接只是第一步，还要用测试移动确认能输出。
重连设备	设备断线、速率切换或网络恢复后点击重连。	MAKCU 4M 切速后，断电或复位可能要重新连接；CatBox 网络恢复、KM Box A/Logitech 运行库恢复后也要重连。
测试移动	连接后发送一次测试移动。	测试移动不动时，先排设备，不要先改 PID。
按键状态	观察左键、右键、中键、侧键1、侧键2是否和实际按键一致。	按键状态不变时，检查窗口焦点、设备输入或按键绑定。
持续自瞄 / 持续扳机 / 手搓压枪	手搓模式打开后，可让对应动作持续运行。	手搓模式会强制使用统一参数，按键独立参数会暂时锁定。

连接后先点“测试移动”。能移动才继续调 PID；不能移动先检查端口、IP、UUID、设备供电和占用状态。

自瞄基础

这一页控制“什么时候瞄”和“瞄多大范围”。新手建议先固定范围、单按键、统一参数。

参数	含义	建议
启用自瞄	总开关。	排查时先确认这里打开。
显示 FOV	显示当前瞄准范围。	调范围时打开，日常可按习惯关闭。
固定范围	一直使用一个 FOV 百分比。	首次调参推荐固定范围，更容易判断问题。
动态范围	锁定后收缩到最小范围，丢目标后按恢复延迟回到最大范围。	适合已经稳定后追求减少乱锁。
自瞄按键 1-5	支持左键、右键、中键、侧键、Shift 等。	先用一个键验证，再配多键。
多键优先级	最后按下、最先按下、列表顺序三种。	多按键场景才需要关心。
统一参数	所有按键共用一套 PID/FOV/目标参数。	新手打开；成熟后再按键分开调。
瞄准延迟	按下后延迟启动。	需要更自然的起手或防误触时加一点。
动态延迟(±1~10ms)	在启动延迟上加入小范围随机变化。	只影响起手时机，不负责修正移动慢、冲过或抖动。

按键参数

按键参数页用于给不同自瞄键设置不同手感。比如右键要稳、侧键要快、Shift 只做近身锁定，就在这里分开。

什么时候生效

统一参数打开时，所有按键使用全局参数，按键参数页只提示当前来源。
统一参数关闭后，按键参数页按参数按键分别编辑左键、右键、中键、侧键1、侧键2、Shift。
手搓模式开启时，按键独立参数会锁定，统一使用全局参数。

能单独调什么

PID 启用、PID 算法和该算法下的控制参数。
固定/动态 FOV、恢复延迟、目标粘性、近身优先。
锁死加速、防抖、亚像素、一欧元滤波、过冲防护、预测增强、提前量。
跟踪方案、转火冷却、跟踪确认和丢失保持。

场景	做法	注意
新手首次调参	保持统一参数，只调全局自瞄/PID/目标页。	先跑通一套稳定手感，再拆按键。
右键稳、侧键快	关闭统一参数，在参数按键里分别选择右键和侧键调。	每改一个按键都要确认当前选择的参数按键没有选错。
调乱了	先重新打开统一参数，用全局参数恢复可用状态。	不要在多个按键之间来回改还不保存，容易忘记问题来源。

PID 调参

PID 页决定“怎么移动到目标”。调参不要一次改一堆，先把问题归类：慢、冲过、抖、拖尾、横纵不一致。

先打开启用PID，再选择 PID算法。算法下拉里有 Whiz内置、磁吸锁定、Whiz增强、Whiz融合、自适应控制器五个选项。

如果统一参数已关闭，PID 页会提示去按键独立参数页编辑；这时每个按键都可以有自己的算法、PID 和滤波手感。

算法怎么选

算法	适合场景	优先调什么
Whiz内置	最适合起步。P/I/D、单帧移动上限、自适应强度、速度补偿都直观。	P、D、I、单帧移动上限。
磁吸锁定	想用更少参数获得更强贴点感时使用。适合先快速试手感，也适合不想细调太多 PID 项的用户。	X速度/Y速度、力度。
Whiz增强	需要更强预测、限幅和贴近控制时使用。参数多，适合有基础手感后细调。	KP、KD、速率、预测、整体限幅。
Whiz融合	想把基础 PID、预测权重、渐入和输出上限放在一套手感里调。	Kp、Kd、预测权重、渐入时间、输出上限。
自适应控制器	想让控制器按误差大小自动调整力度，同时保留 X/Y 独立调参时使用。	X-P/Y-P、X-D/Y-D、动态P、积分上限。

滤波和 PID 的顺序

一欧元滤波

它在移动控制前先平滑目标误差：目标慢时更稳，目标快时自动放开，减少“稳是稳但慢半拍”的感觉。

先把 PID 调到能用，再开一欧元滤波修细抖。不要一开始同时大改 PID 和滤波。

先后顺序

1 选算法并调 P/Kp、D/Kd，让整体不慢、不冲。

2 再动预测、速度补偿、限幅，让移动目标不拖尾。

3 最后开一欧元滤波，处理小抖、跳点和画面检测轻微晃动。

滤波参数

基础平滑越小越稳但越容易慢半拍；越大越跟手但抖动更多。

速度自适应越大，快速移动时越少平滑、越跟手。

速度平滑影响速度估计，通常保持默认，只在快速目标忽快忽慢时微调。

最大间隔(ms) 防止卡顿后滤波状态跳太大。

每个算法的调参顺序

下面按界面会出现的旋钮分组写。每次只改一类参数，打一小段再判断。

Whiz内置

1 P_X/P_Y：先决定横向、纵向跟随速度。慢就小幅加，冲就退一点。

2 D_X/D_Y：冲过目标、回拉明显时增加一点；贴近后细抖就降一点。

3 I_X/I_Y：只在准星长期停在目标旁边、总差一点时少量加；拖尾或贴近后抖就先降 I。

4 单帧移动上限：限制每帧最大移动量，太低会慢，太高容易一下拉过头；0 表示不限制。

5 自适应强度、速度补偿：移动目标慢半拍时再加，先小幅试。

磁吸锁定

1 X速度/Y速度：先定横向、纵向追点速度。哪边跟不上就加哪边，过冲就退一点。

2 力度：决定贴向目标的强度。想更贴就小幅加，发硬、拉过头或贴近抖就降。

3 目标与跟踪：磁吸锁定很吃目标选择稳定性。乱吸时先调类别、FOV、目标粘性和跟踪方案。

4 一欧元滤波/防过冲震荡：只在目标稳定后用来压细抖，不要拿它们替代速度和力度调参。

Whiz增强

1 XY轴参数同步：横纵手感差不多先开同步；纵向单独不稳时再关闭，分开调 X/Y。

2 KP、KD、速率：KP 管速度，KD 管刹车，速率管推进感；先把不慢、不冲调出来。

3 KI、积分模式：有长期偏差再加 KI；提前量模式偏跟随，锁死模式偏贴住中心。

4 预测、预测速率：移动目标拖尾再加预测；预测速率决定预测介入多快。

5 比例限幅、积分限幅、微分限幅、整体限幅、积分+预测死区：最后用来压住瞬间拉动、补偿堆积和贴近细抖。

Whiz融合

1 X-Kp/Y-Kp：先决定横向、纵向基础速度。慢就加，冲就降。

2 X-Kd/Y-Kd：冲过、回弹、摆动时增加；贴近细抖就降。

3 X预测权重/Y预测权重：移动目标慢半拍时加。横向拖尾只加 X，纵向拖尾只加 Y。

4 初始缩放、渐入时间、输出上限：起手太猛就降初始缩放或拉长渐入；整体拉动太大就降输出上限。

5 X-Ki/Y-Ki、自然噪声：Ki 只修长期偏差；自然噪声最后再加，过大容易破坏稳定感。

自适应控制器

1 X-P/Y-P：先定基础跟随速度。横向慢调 X-P，纵向慢调 Y-P。

2 X-D/Y-D：冲过或来回摆时增加；贴近细抖就降。

3 X-I/Y-I、积分上限：只修长期偏差。拖尾或粘住时先降 I 或积分上限。

4 动态P、动态P强度：需要远距离更快、近距离更柔时再开，强度从低开始试。

5 启用Y轴速度归零：纵向回正太慢或有残留时再开，并用延迟控制介入时间。

各参数核心含义

Whiz内置

P 响应当前误差，调大更快，过大容易冲过。
I 修长期静差，调大更能补尾，但过大容易拖和抖。
D 抑制过冲，调大更稳，过大也可能细抖。
单帧移动上限只影响 Whiz内置；0 表示不限制，非 0 会限制每帧最大移动量。
自适应强度 / 速度补偿用来改善移动目标慢半拍，建议最后少量加。

磁吸锁定

X速度 / Y速度控制横向、纵向贴向目标的速度。
力度控制吸附强度。力度越大越贴，但越容易硬、冲或抖。
它参数少，但更依赖目标选择稳定；多人乱切、框抖或类别错时，先回目标页和类别页。

Whiz增强

KP / KI / KD 控制响应、补尾和刹车，调节幅度要小。
预测让准星提前追目标移动方向，拖尾时有用，过大容易越过目标。
速率控制输出推进感，越大越跟手，过高会硬。
比例/积分/微分/整体限幅限制各部分最大输出，防止瞬间拉太猛。
积分模式 / 积分+预测死区用来控制贴近中心后的补偿方式和细抖。

Whiz融合

Kp / Ki / Kd 基础快慢、长期偏差和刹车。
预测权重控制提前量，移动目标拖尾时优先看这里。
初始缩放 / 渐入时间控制锁定初期的起手力度，起手冲就降低或拉长。
输出上限控制最大输出，压住突然大幅拉动。
自然噪声增加轻微不规则感，稳定性没调好前不要加。

自适应控制器

X-P / Y-P 控制横向、纵向基础拉力。
X-I / Y-I 修长期偏差，配合积分上限防止越积越多。
X-D / Y-D 负责刹车，主要用来压过冲和摆动。
动态P 会按误差大小调整力度，适合想远处快、近处柔的手感。
Y轴速度归零用来处理纵向残留移动，默认不需要频繁动。

一欧元滤波

一欧元滤波开关打开后，目标误差会先经过自适应平滑再进入移动控制。
基础平滑控制慢速时的稳定程度。
速度自适应控制快速移动时放开平滑的程度。
速度平滑控制速度估计的稳定性。
最大间隔(ms) 防止卡顿或掉帧后滤波状态跳变。

自动调参 / 自动预判

自动调参 / 自动预判会在你正常按住自瞄热键时采样手感，尝试一组候选参数，并给出当前最佳结果。采样完成前不会写入配置文件，确认好以后再点保存最佳。

按钮	作用	使用建议
开始调参	自动测试当前算法的 Kp/Kd 类基础手感，目标是找到更合适的速度和刹车。	先保证画面、类别、设备和目标选择稳定，再开始；测试时按平时的自瞄键打真实目标。
开始预判	自动测试预测/提前相关参数，改善移动目标拖尾。	只在基础速度已经能用、但移动目标慢半拍时再用。
停止调参 / 停止预判	停止当前采样。若已经有最佳结果，仍可以保存最佳。	发现目标乱切、画面卡顿或设备输出异常时先停止，不要把异常样本喂进去。
保存最佳	把本轮评分最好的参数写回当前配置。	保存后打一小段确认手感，再到配置页保存一份可回退方案。

自动调参支持 Whiz内置、Whiz增强、Whiz融合、自适应控制器。磁吸锁定参数少，手动调 X速度、Y速度、力度更直接。

调参节奏：一次改 5%-15%，打一小段，再改下一项。感觉变差立刻退回上一版。

按手感调

手感问题	优先动作	一欧元滤波	别急着动
整体太慢	内置加 P；磁吸加 X/Y速度或力度；增强/融合加 KP 或速率；确认输出上限、单帧移动上限没有太低。	先降低基础平滑，或提高速度自适应。	不要先加 I/KI，容易拖尾。
冲过目标	先降 P/KP 或磁吸力度，再加 D/KD；增强可降预测、速率或整体限幅；融合可降初始缩放或输出上限。	小幅降低基础平滑通常不是首选，先处理 PID 刹车。	不要同时加预测和速度补偿。
贴近后抖	降 P/KP、I/KI 或磁吸力度；增强加积分+预测死区；融合降 Kd 或输出上限。	打开滤波后适当降低基础平滑数值，慢慢找稳和跟手的平衡。	不要继续加 D/KD，可能越刹越抖。
拖尾慢半拍	内置加 P 或速度补偿；磁吸加对应轴速度；增强加 KP、预测或速率；融合加预测权重或缩短渐入时间。	提高速度自适应，必要时提高基础平滑。	不要先大幅加 I/KI。
横向好纵向差	分开调 Y 轴 P/KP/Kd/预测权重；磁吸单独调 Y速度；增强先关闭 XY轴参数同步。	滤波是双轴一起作用，轴向差异优先从 PID 轴参数解决。	不要把 X 轴也一起改坏。

目标与跟踪

目标页负责“选谁、粘多久、什么时候换”。多人同屏、目标重叠、短暂丢框时，这一页比 PID 更关键。

目标粘性

越大越不容易在多个目标间来回切换。单目标可低一点，多目标乱跳就升一点。

近身优先

目标距离很近时，提高中心附近目标权重。适合近距离快速切换，但过高可能忽略更正确的大框。

锁死加速

接近目标中心时附加加速。距离和倍率越大，吸附越明显，也更容易有“拉”的感觉。

防抖

小误差区间内减少输出，降低贴近中心时的微抖。过高会感觉停在目标旁边不动。

亚像素累积

累积小数位移，让长期移动更细腻。通常建议开启。

一欧元滤波

让目标误差先做自适应平滑。框轻微跳、贴近后细抖时再开；如果开完明显慢半拍，就提高速度自适应或提高基础平滑。

预测增强

在原有控制基础上，按目标运动趋势额外补一点位移，适合快速移动目标拖尾。

它和提前量互斥，只能同时开一种。先从默认开始，拖尾再加，打到目标前方就降。

提前量

按目标速度提前瞄一点，适合横向移动目标。核心看提前时间(ms)、提前增益、最大提前位移(px)。

开完飘或打前方，先降提前增益或最大提前位移；目标忽快忽慢时再动速度平滑和提前死区。

防过冲震荡

准星进入目标后，若短时间反复穿过中心并摆幅明显，会短暂刹车。适合压住“左右晃”。

预测增强和提前量怎么选

功能	适合什么时候开	先调什么
预测增强	目标移动快，准星总慢半拍，但基础 PID 已经不慢。	先调单帧最大预测位移，再看动态限幅、速度平滑和加速度平滑。
提前量	横移目标需要前置补偿，想让准星更主动地追到目标运动方向。	先调提前时间(ms) 和提前增益，再用最大提前位移限制过头。
两个都不开	目标选择还不稳、检测框抖、PID 还在冲过或贴近抖。	先回到类别、跟踪和 PID 基础参数，别急着加预判。

防过冲震荡怎么调

什么时候开

防过冲震荡只处理进入目标附近后的左右晃、来回穿中心。

如果问题是跟不动、起手慢、目标选择错，先回 PID、目标选择或跟踪方案，不要用它硬压。

先调强度

保护强度和触发灵敏度都有低中高。

先用低强度、低灵敏度；还晃再升强度，明显不介入再升灵敏度。

触发条件

检测窗口(ms) 决定观察多久；进入框比例X/Y 决定离中心多近才开始看。

最小反转次数和最小摆幅(px) 用来避免正常微调被误判为震荡。

触发后动作

抑制时长(ms) 和输出缩放决定刹车多久、剩多少输出。

触发停帧、重置预测、重置PID 只在普通抑制压不住时逐个试。

跟踪方案

跟踪会尽量守住当前目标，减少多人同屏、短暂遮挡、检测框抖动时乱切。目标页和按键参数页都能调跟踪；统一参数关闭后，不同自瞄键可以用不同跟踪手感。

默认追踪

通用多人场景先从这里开始。它最适合判断“是目标选择问题，还是 PID 手感问题”。

最大丢失(帧) / 保持锁定(帧)：调大更不易丢锁，调小释放更快。
跟踪防跳帧：调大换目标更谨慎，调小换目标更灵敏。
最小 IoU / 最大归一距离：用来控制同一目标匹配严格程度。

敏捷追踪

适合目标移动快、交叉多、希望转火更跟手的场景。

确认稳定所需帧数：调小起锁更快，调大更稳。
未匹配删除延迟(帧)：调小丢失后更快释放，调大更能抗短暂丢框。
水平速度噪声 / 垂直速度噪声：调大响应更活，调小移动估计更稳。
框宽变化噪声 / 框高变化噪声：调大更能接受目标大小变化。
检测量测噪声：调大更少被单帧抖框带跑，调小更贴当前检测框。

稳定追踪

适合检测框抖、短暂遮挡、目标不快但容易误切的场景。

稳定-确认帧数：调大确认更稳，调小起锁更快。
稳定-删除延迟(帧)：调大更抗遮挡，调小失去目标后更快释放。
稳定-水平速度噪声 / 稳定-垂直速度噪声：目标确实在快速变化时再加。
稳定-框宽变化噪声 / 稳定-框高变化噪声：框大小抖时先小幅调。
稳定-检测量测噪声：调大更稳，调小响应更直接。

通用跟踪参数

跟踪启用

打开后会尽量延续当前锁定目标。多人乱切时打开；单目标测试 PID 时也可以先打开，减少变量。

转火冷却(ms)

切到新目标后，短时间内不再频繁换目标。乱跳就加一点，转火慢就降一点。

转火领先阈值(%)

新目标要比旧目标明显更合适，才允许切过去。误切多就调高，被旧目标粘住就调低。

单一目标模式

更偏向守住一个目标，不主动来回挑。打固定目标或训练稳定性时可开，需要快速转火时关闭。

跟踪调参顺序：先选方案，再调通用项；只有确认目标选择稳定后，再回 PID 调移动手感。

轨迹人性化

人性化页改变的是移动轨迹，不是识别准确率。它适合在“已经能稳定锁”的基础上，让轨迹更自然。

先打开启用轨迹人性化，再选择曲线算法。需要看到更多细项时打开显示高级参数。

曲线算法

贝塞尔曲线适合轻量、直观的轨迹变化。

神经网络曲线使用 .wkcurve 曲线文件，内置参考曲线会自动保留，正在使用或内置曲线不能删除。

拟人瞄点

可以让瞄点在锁定范围内产生横向/纵向随机落点、过冲、微过冲、惯性停止和重试。

拟人瞄点不稳定时，先降低概率和随机范围，再看曲线。

参数	调大	调小
曲线随机性	轨迹更不重复。	轨迹更稳定、可预测。
拟人程度	更明显的人手轨迹。	更接近直线控制。
短距离直线	近距离更少绕路。	小距离也会保留曲线感。
最大段数 / 段间隔(ms)	大移动更像分段手动。	轨迹更简洁。
曲线强度 / 曲线抖动	弧线和扰动更明显。	更稳、更直。
直达/过冲/微过冲概率	对应行为更常出现。	轨迹更可控。
启用拟人瞄点、横向随机落点、纵向跟随锁定范围、修正重试	瞄点更像人为选择落点，并在偏离后尝试修正。	不稳定时先降低随机和重试，再调曲线强度。

如果还没稳定锁目标，先别开高强度人性化。否则你看到的“歪”和“慢”，可能只是曲线在故意绕路。

曲线模型管理与训练

曲线模型列表用于选择、导入、刷新和使用 .wkcurve 文件。内置参考曲线适合先体验轨迹效果；自定义曲线适合在你已经有稳定基础参数后再尝试。

曲线测试模式

模式	能看什么	怎么用
追目标点	模拟准星追向红点，观察当前曲线实际移动过程。	先用它看曲线是否太绕、太慢或过冲。
曲线对比	分开看原始直线、贝塞尔曲线、神经网络曲线的形状。	只比较轨迹形状，不会改变真实参数。
拟人瞄点	看目标框内随机落点、锁定范围、延迟、过冲、惯性和重试效果。	拟人瞄点开启后，用它判断随机范围是否太大。

功能	影响	建议
刷新列表 / 打开目录	刷新会重新扫描曲线文件，打开目录便于管理本机曲线。	导入或删除文件后刷新一次。
使用 / 导入 / 删除	正在使用的曲线和内置参考曲线不会被删除。	删除前先切到其它曲线，避免误删自己正在对比的版本。
曲线测试 / 测试模式 / 目标X / 目标Y	可以用目标 X/Y 或自动测试观察轨迹，不必进入完整瞄准链路。	训练前先用测试模式确认曲线方向和强度。
训练预设 / 训练参数	快速推荐精细会自动带出采集目标、训练轮数和学习率；自定义用来手动细调。	先用快速试跑，确认可用后用推荐；追求更细再用精细或自定义。
开始采集 / 停止采集 / 清空样本 / 训练并保存	用于记录曲线训练所需的目标移动数据，或清空当前记录重新来。	这里只服务于曲线训练，不影响模型检测类别。
保存曲线	保存名会成为后续选择的曲线文件。	文件名写清用途，比如“近身轻曲线”“跟枪慢起手”。

扳机与压枪

扳机控制开火时机，压枪控制开火后的补偿。两者都建议先统一参数跑通，再按按键或类别细分。

扳机

统一扳机参数打开后共用一套数值；关闭后按自瞄键分别保存。
范围可视化用准星框看触发区域，调区域偏移和大小时务必打开。
开火前摇越大越晚开火，越稳但慢。
按下时长决定一次点击按住多久。
松开间隔决定连续触发间隔。
丢目标自动收枪目标丢失后主动结束扳机状态，通常建议开启。
类别分离不同类别使用不同触发框，比如头/身分开调。

压枪

统一压枪参数打开后所有按键共用，关闭后按键分开。
弹道压枪使用 Firearm 里的武器 JSON；开启后简易两段式压枪不会叠加。
压枪补偿直通输出让压枪输出更直接，便于验证手感。
压枪延迟从开火到开始补偿的等待。
压枪速度每步下拉强度。
首发下拉/首发时长专门修第一发抬头。
屏蔽 Y 轴开火后屏蔽物理鼠标 Y 轴，需设备支持。

扳机怎么启用

功能	怎么用	注意
统一扳机参数	打开后用一套扳机参数，并按自瞄按键槽位 1-5 单独开关扳机许可。	槽位括号会跟随自瞄页的按键绑定变化；手搓模式下强制使用全局扳机参数。
适用自瞄键	关闭统一扳机参数后，可分别配置右键、中键、侧键1、侧键2。	调之前先看当前选的是哪个物理键，避免改错槽位。
扳机开关	打开后，当前扳机配置才会参与自动开火。	统一模式下还要确认对应自瞄槽位已允许扳机。
开火模式	速点会按下再松开；按住会保持按下直到条件结束。	点射类先用速点；需要持续压住左键时再用按住。
按下时长 / 松开间隔	速点模式下决定每次按多久、两次开火之间隔多久。	连点太快不触发时，加按下时长或松开间隔。
开火间隔随机	给速点间隔加入小幅变化。	只改变开火节奏，不会修正目标框、类别或设备输出问题。
类别分离	打开后先选配置类别，再给该类别单独设置触发区域。	头部和身体触发框不同的时候再开；类别 ID 要和模型输出一致。
触发区域预览	白框是示例目标，红框是触发区域，绿色十字是屏幕中心。	屏幕中心进入红色区域才触发；预览只看比例关系，不代表真实目标大小。

压枪怎么启用

步骤	操作	结果
1. 选择参数方式	打开统一压枪参数，所有按键共用；关闭后在参数按键选择左键、右键、中键、侧键1、侧键2 或 Shift 分别配置。	先统一跑通，再按按键分开调。
2. 打开压枪	开启压枪启用。	开火时开始执行压枪逻辑。
3. 选择压枪模式	关闭弹道压枪(使用 Firearm 文件) 时使用简易两段式；打开后使用当前枪械 JSON。	两种模式同时只生效一种，不会叠加。
4. 验证输出	需要直接验证手感时开启压枪补偿直通输出。	压枪输出更直接，方便快速判断参数是否有效。

简易压枪

基础参数

压枪延迟开火后等多久开始压枪；首发抬头明显时通常不要设太晚。
压枪速度第二阶段每步下拉像素；枪口持续上飘就加，压太低就降。
首发下拉第一阶段总下拉量；专门处理第一发跳动。
首发时长第一阶段持续多久；时间太短会突兀，太长会拖。

限制条件

压枪目标判断开启后只有检测到目标才压枪；关闭后只要开火就压。
屏蔽Y轴开火后屏蔽物理鼠标 Y 轴，适合需要避免手动上抬干扰的场景。
Y轴屏蔽延迟控制开火后多久开始屏蔽 Y 轴。
X轴偏移给压枪增加水平修正，弹道向一侧飘时再调。

弹道压枪制作器

开启压枪启用和弹道压枪(使用 Firearm 文件) 后，先选择或添加枪械，再用下方制作器做这把枪的弹道。修改会自动保存到当前武器 JSON，切换枪械会自动加载对应弹道。

页签 / 功能	用途	注意
枪械 / 添加枪械	从 Firearm 下选择 .json；没有就输入枪械名后点击添加。	武器 JSON 用来保存这把枪的弹道，不和总配置 .ini 混在一起。
数据设置	设置武器名、全局倍率、底层步进、X/Y 反向、压完后继续末段补偿，也可以保存、导出或从剪贴板导入。	弹道走势正确但整体力度偏大/偏小时，优先调全局倍率；方向反了再开 X反向或 Y反向。
弹道点阵	导入弹道图片，按开火顺序标每一发；也可以自动识别点位，再手动拖动微调。	第 1 个点是起点，不单独生成压枪；从第 1 点到第 2 点才产生第一段位移。
点位倍率	把图片上的弹孔距离转换成实际补偿像素。	倍率越大，同一张弹道图生成的补偿越强；整体压不住就加，压过头就降。
武器射速 RPM	填写游戏里的每分钟射速，软件会换算每发间隔。	射速不准会导致压枪节奏错位：前几发对、后面越来越偏时要检查这里。
弹夹子弹数	按完整弹匣生成弹道；0 表示只按当前点位生成。	点位少于弹匣时，会按后几段趋势自动补齐后段。
每段微调	在生成结果里改 number、x/步、y/步，也可以按点位重新生成。	手动改表格会立即保存；重新生成会覆盖手动微调。
识别图像	截取源画面，框住当前武器图标或整条高亮武器栏，保存为当前枪械识别。	开启“自动识别命中才压枪”后，识别成功才会应用对应弹道；采集源不支持时只能手动选枪。
规则设置	把识别图像绑定到要应用的武器弹道，可设置优先级、冷却、固定区域或高亮槽位。	多个规则都命中时，优先级更高的先应用；冷却用于避免识别抖动来回切枪。
实测校准	用初版弹道打一梭，导入压枪后的弹孔图，标首弹和最后落点，把残余偏移反向修回去。	第一次校准强度建议 0.50-0.80；修正范围默认后半段，避免破坏起枪手感。
日志状态	查看最近模板、匹配分数和原因，用来判断自动识别是否命中。	识别不到时，先看这里，再回识别图像或规则设置修 ROI、阈值和规则。

制作器里的常用操作

位置	按钮 / 参数	怎么判断
枪械栏	删除枪械	会删除 Firearm 下当前武器 JSON；删前先确认不是唯一正在使用的弹道。
数据设置	保存当前弹道、导出到剪贴板、从剪贴板导入	用于手动保存、分享或导入一把枪的弹道参数。
弹道点阵	导入弹道图片、从路径导入	导入原始弹道图后再点位；换图会清空当前点位和生成段。
弹道点阵	重置视图、滚轮缩放、中键/右键拖动画布	只影响看图和点位操作，不改变压枪参数。
弹道点阵	左键点位、拖动点位、Shift + 左键插入	按开火顺序标弹孔；点错后可拖动修正，缺一发可插入到最近线段。
弹道点阵	自动识别点位	弹孔颜色清晰时可先自动识别，再手动检查每个点的顺序和位置。
弹道点阵	在后面插入、删除选中、撤销最后、清空点位	用于修点位数量和顺序；清空点位会同时清空生成的压枪段。
弹道点阵	曲线预览	红色看弹孔走势，绿色看软件补偿；两条趋势方向应互相抵消。
每段微调	按点位重新生成	点位、倍率、射速或弹夹数改过后，用它重新生成 stages；会覆盖手动微调。
识别图像	自动识别命中才压枪、识别FPS	打开后只有识别到规则绑定的武器才压枪；识别频率越高越及时，也更吃性能。
识别图像	截取源画面、框选 ROI、X/Y/W/H	框普通武器图标时只框图标；框高亮槽位时要框整条武器栏。
识别图像	新增当前枪械识别、更新当前识别	新增会保存一张新识别图像并绑定当前枪械；更新只修当前选中的识别图像。
识别图像	新增高亮槽识别、更新高亮槽识别	用于有当前武器高亮条/边框的界面，软件会先找高亮槽，再匹配槽位里的武器。
识别图像	测试匹配、处理方式、匹配阈值、二值阈值	处理方式有灰度模板二值白底二值黑底；普通图标先用灰度模板，黑白对比强再试二值。
规则设置	新增规则、识别模板、应用武器	触发条件为识别到模板；命中后切换到这把武器的弹道。
规则设置	固定区域、高亮槽位、槽位数、容差	图标位置固定用固定区域；武器栏有高亮状态用高亮槽位，槽位数按武器栏格数填。
实测校准	导入校准图、校准强度、修正范围	修正范围有全段后半段最后三分之一；起枪准就只修后段，整条同向偏再选全段。
实测校准	自动识别残余点、手动点残余、应用校准到弹道、撤销上次校准	至少标首弹和最后落点；应用后如果反向过头，就撤销或降低校准强度再试。

制作顺序：添加枪械 → 导入弹道图 → 按开火顺序点每一发或自动识别点位 → 填射速和弹夹数 → 看曲线预览 → 对墙测试 → 用每段微调或实测校准修后段。旧弹道文件没有图片和点位时，才会显示简化阶段配置。

扳机区域怎么调

区域偏移X / 区域偏移Y 决定触发框相对目标点的位置，区域大小X / 区域大小Y 决定触发容忍范围。先打开范围可视化，让准星框只覆盖你希望触发的位置。太小会不触发，太大容易误触发。

准星找色与鼠标死区

准星找色用于辅助校准中心点，也可作为手搓动作的命中条件。鼠标死区用于在命中区间降低物理鼠标干扰。

准星找色

先选识别模式：简单纯色准星用旧版RGB，复杂准星、发光边缘、圆环或 T 形优先用智能找色。
智能找色至少要有一个启用的目标色段；容易吃到背景时，再加排除色段。
作为瞄准中心时，先验证找色点和真实准星中心一致。

鼠标死区

启用鼠标死区后，在命中区域内减少物理鼠标干扰。
死区范围越大越容易进入死区，但手感会更“粘”。
轴屏蔽需要 Net/MAKCU/DHZ 等设备支持；SendInput、CatBox、KM Box A、Logitech 不做硬件轴屏蔽。

准心找色参数

功能	怎么用	注意
启用准心找色	在屏幕中心附近寻找准心颜色，用于辅助压枪、瞄准中心修正或手搓动作命中条件。	手搓模式下会强制开启，并固定持续找色。
识别模式	旧版RGB 使用固定颜色表匹配；智能找色使用 HSV 色段和形状中心。	旧配置可继续用旧版RGB；新准星或复杂颜色建议先试智能找色。
智能搜索半径 / 准星类型 / 最少匹配像素	智能找色的圆形搜索范围、形状倾向和最低命中像素数。	先用自动类型；圆环准星需要明确选圆环。误判多提高最少匹配像素，找不到就降低。
X轴范围 / Y轴上 / Y轴下	旧版RGB从屏幕中心向左右、上方、下方扫描多大区域。	范围越大越容易找到，也越容易扫到无关颜色。
颜色容差	旧版RGB三通道允许的颜色误差。	建议从 12-25 开始；太大容易吃到 UI 或背景颜色。
X找色平滑 / Y找色平滑	平滑找色命中点，减少颜色抖动。	越接近 1 越跟手，越接近 0 越平滑但延迟明显。
找色修正模式	动态中心权重更稳；准星误差增益更猛。	新手先用动态中心权重，稳定后再试误差增益。
找色参与权重 / 准星误差增益	控制找色结果对瞄准中心的影响强度。	左右变差时先降低 X 权重；压枪纵向不足时再看 Y。
X找色死区	X 偏移小于该像素时按 0 处理。	用于减少左右小幅晃动。
找色仅用于Y轴压枪	只修正 Y 轴中心，X 轴仍用屏幕中心。	适合只想让找色辅助纵向压枪、不想影响横向跟枪的情况。
用于瞄准中心	开启后找色命中点参与瞄准中心；关闭后只用于状态、门控和显示。	先用显示命中点确认找对准心，再让它参与瞄准。
准心找色开镜判断	开启后只在自瞄/开镜条件满足时运行找色。	关闭后常驻运行；手搓模式下固定常驻。
显示找色扫描范围 / 显示找色命中点	在预览或覆盖层看扫描区域和命中位置。旧版RGB显示矩形范围，智能找色显示圆形半径。	调范围、颜色和容差时建议打开。
显示调试PIP	在 Detection Result 右上角显示本次准心找色调试图。	智能找色找错中心、误吃背景或总是未找到时打开。
吸取屏幕中心目标色 / 从 Detection Result 取目标色	智能找色用来建立目标色色段；从 Detection Result 取色时，在预览里点选真正属于准星的颜色。	智能找色需要至少一个启用的目标色段。点选前先让预览里能看到准星。
吸取屏幕中心排除色 / 从 Detection Result 取排除色	智能找色用来排除背景、UI 高亮或准星旁边容易误吃的颜色；从 Detection Result 取色时，点选要排除的位置。	只在误判明显时加；排除色段过宽会把真实准星也排掉。
目标色色段 / 排除色色段	可开关、命名、调 H/S/V 范围；排除色段还有强度。	先让目标色命中，再加排除色。H 表示色相，S 表示饱和度，V 表示亮度。
吸取屏幕中心颜色 / 从 Detection Result 取RGB / 添加到颜色表	旧版RGB把取到的颜色加入准心颜色表；从 Detection Result 取RGB 时，在预览里点选要加入的准心颜色。	屏幕中心取色前先让准心处于屏幕中心，避免吸到背景。
手动添加颜色(#RRGGBB) / 删除 / 清空颜色表	旧版RGB可手写颜色，逐条删除或清空重建颜色表。	颜色表过多会更容易误命中，保留真正的准心颜色即可。

鼠标死区参数

死区模式分为范围模式和时间模式，先按自己的控制习惯选模式，再调对应范围或延迟。

模式	含义	建议
范围模式	以检测框同心缩小后的矩形作为死区。	死区范围越大越容易进入死区，但手感更粘。
时间模式	过瞄准延迟后计时，到达延迟时间才进入死区。	0ms 表示当帧生效；需要保留起手手动控制时加延迟。
轴屏蔽	命中死区后屏蔽物理鼠标 X/Y，自瞄注入移动仍会下发。	需要 Net、MAKCU 或 DHZ 支持；SendInput、CatBox、KM Box A、Logitech 不做硬件轴屏蔽。

宏与背闪

宏页处理按键输出和目标条件联动，背闪页处理检测到闪光弹后自动移动。先用输出测试确认设备能发鼠标/键盘事件。

模块	关键参数	建议
宏输出测试	当前输出设备、SendInput 键盘、MAKCU 键盘、Net 键盘、DhzBox 键盘。	先测试左键、右键、SPACE、SHIFT 等基础输出；CatBox、KM Box A、Logitech 当前只测试鼠标输出。
宏参数	统一宏参数、参数按键、阈值可视化、开镜模式、目标过滤。	先统一，确认动作逻辑，再按键拆分。
高级宏	规则名称、启用状态、触发方式、冲突策略、冷却、条件和动作。	一条规则只做一件事，先关闭其它规则单独验证。
自动背闪	闪光弹类别ID、触发最小置信、背闪移动像素、方向模式、回移延迟、背闪冷却。	先把类别 ID 和置信度调准，避免把普通目标当闪光弹。

输出测试与背闪方向

位置	可选项	怎么选
SendInput 键盘	自动VK模式扫描码模式	默认先用自动；游戏不吃普通按键时试扫描码模式，快捷键类再试 VK 模式。
MAKCU 键盘	自动名称命令HID数值命令	默认先用自动；个别按键不触发时，在名称命令和 HID 数值命令之间切换测试。
Net / DhzBox 键盘	跟随对应设备链路输出。	先用宏输出测试确认左键、右键、SPACE、SHIFT 都能正常下发。
CatBox / KM Box A / Logitech	用于鼠标移动和鼠标按键输出。	当前不支持键盘输出；需要键盘宏时换 SendInput、MAKCU、Net 或 DhzBox。
方向模式	自动(背向目标)固定左固定右	默认用自动；只想每次固定往一边躲时选固定左或固定右。
开镜模式	长按开镜点按开镜	游戏里右键要一直按住才开镜就选长按；点一下切换开镜就选点按。

基础宏

功能	怎么用	注意
统一宏参数	打开后所有按键共用基础宏参数；关闭后按左键、右键、中键、侧键1、侧键2、Shift 分开。	手搓模式下强制全局宏参数。
自动爆闪	目标高度占屏幕(%) 达到阈值时，输出设置的爆闪键位VK。	先开阈值可视化，看阈值是否符合实际距离；VK 可填 Y、F1、SPACE、X1 或 0x 值。
自动急停	开火起始时触发急停逻辑。	只在你确实需要开火前配合移动状态时开启。
自动开镜	有有效目标时自动输出开镜动作。	先确认宏输出测试里右键或对应设备键盘/鼠标输出正常。
自动架点关镭射	右键进入开镜状态后，按设置延迟输出镭射键位VK。	开镜模式分长按开镜和点按开镜；延迟太短可能抢在开镜前触发。
启用目标过滤 / 添加目标类别	只对填写的目标类别 ID 触发爆闪提示，最多 8 个。	类别 ID 先在预览里确认，不要凭名字猜。

高级宏怎么排查

触发方式

成立瞬间触发适合一次性动作，例如按一下、切换、补一个键。
成立期间循环适合条件持续成立时重复输出，必须设置好冷却。
条件不成立时释放适合按住类动作，避免规则结束后按键残留。

冲突策略

同输出高级优先适合让高级宏覆盖基础宏。
允许基础宏同时执行适合互不冲突的不同输出。
规则触发时暂停基础宏适合需要完整接管一段动作时。

高级宏条件与动作

位置	可选项	怎么理解
条件连接	如果且或	第一条用如果；条件必须同时满足用且；任一满足即可用或。
条件类型	类别ID、置信度、高度比例、宽度比例、是否有目标、是否锁定目标、鼠标按键、自瞄键、开火状态、准心命中、最大目标高度比例、最大目标宽度比例。	先用一两个条件验证命中，再逐步加限制；条件越多，越容易因为某一项不成立而不触发。
数值判断	=!=>>=<<=	类别 ID 常用等于；置信度和比例常用大于或大于等于。
状态判断	成立不成立	用于是否有目标、是否锁定、开火状态、准心命中这类开关状态。
按键判断	按下抬起；鼠标键可选左键、右键、中键、侧键1、侧键2。	需要按住才触发用按下；需要松开后触发或释放动作时用抬起。
动作类型	键盘点击、键盘按下、键盘抬起、鼠标点击、鼠标按下、鼠标抬起、鼠标移动、等待。	点击适合一次动作；按下/抬起适合持续动作；等待用于动作之间留间隔。

高级宏编辑

功能	怎么用	注意
启用高级宏 / 诊断记录	总开关控制高级宏是否运行，诊断记录用于查看规则命中和动作下发。	排查时只开一条规则，诊断记录更容易看懂。
新增规则 / 复制规则 / 删除规则	左侧管理规则，右侧编辑当前选中的规则。	删除规则前先确认没有正在按住的输出；修改规则会释放该规则已按住的键，避免卡键。
执行策略 / 冲突处理	成立瞬间触发用于一次性动作；成立期间循环用于持续重复动作。	循环规则一定要设置合适冷却，避免刷太快。
失效释放	条件不成立时释放这条规则按住的输出。	键盘按下、鼠标按下类动作建议开启，避免条件结束后残留。
条件块	支持类别ID、置信度、高度比例、宽度比例、是否有目标、是否锁定目标、鼠标按键、自瞄键、开火状态、准心命中、最大目标高度/宽度比例。	第一行是“如果”，后续用“且/或”；不要一开始写太复杂。
动作块	支持键盘点击/按下/抬起、鼠标点击/按下/抬起、鼠标移动、等待。	鼠标移动用于相对位移，等待用于动作之间留时间。
记录命中	单条规则级别的命中记录。	只给正在排查的规则打开，避免诊断内容太多。

宏的调试顺序：先用输出测试确认设备能发键鼠，再开基础宏，再开高级宏；高级宏出问题时打开诊断记录，观察命中次数、条件是否成立和动作是否真的下发。

配置与状态

配置页负责保存和切换方案，状态页负责查看当前链路有没有跑起来。重点是能回退、能复现、能定位哪一层断了。

配置页

配置名用来给当前方案起名字，建议写清场景和按键。
保存当前配置适合把当前参数保存成一个新方案。
保存到当前文件适合覆盖正在使用的方案。
加载用来切换方案；切换后重新确认捕获、模型、设备状态。
删除删除后不可恢复，先确认不是唯一能用的配置。

状态页

看采集帧、推理、移动队列、发送计数是否在变化。
看按钮状态是否符合实际按键，避免热键没有触发。
看设备心跳、错误、串口/网络接收状态，定位输出链路。
看流水线是否运行，确认不是只开了界面没开工作链路。

界面主题

主界面右上角的皮肤按钮可以在经典 SpeX 风格和 iOS 科技风之间切换。
主题只影响界面外观、窗口圆角和色彩层次，不改变采集、推理、设备输出或调参结果。
如果录屏、投屏或远程桌面显示异常，先切回经典风格对比。

建议的配置命名

命名方式	例子	好处
按输入链路	采集卡-640-稳	换采集方式后不容易混用旧参数。
按按键手感	右键-稳枪 / 侧键-快锁	能快速回到某种手感。
按调参阶段	基础跑通 / 稳定跟枪 / 轻度人性化	调坏后能回到上一个稳定阶段。

调参配方

下面不是固定数值，而是调参路线。按症状走路线，比照抄参数更可靠。

稳枪型

固定 FOV，先把置信度和类别过滤调干净。
Whiz内置里 P 小幅降低，D 小幅提高。
打开防抖，必要时开鼠标死区。
人性化只开轻度曲线，先别开高过冲概率。

跟枪型

动态范围可开，但最大范围不要过大。
适当提高 P 和速度补偿。
移动目标拖尾时，优先试 Whiz融合的预测权重，或在目标页调整提前量。
目标粘性略高，减少多人同屏乱切。

近身快锁型

FOV 不要过大，避免吸到旁边目标。
开启近身优先和锁死加速，小幅增加倍率。
单帧移动上限不要卡得太低。
冲过目标就先降 P 或锁死倍率。

保存习惯：每调出一版能用的手感，就到配置页保存一个新名字。比如“右键-稳”“侧键-快”“采集卡-640”。

问题排查

遇到问题先按链路排查：画面、模型、类别、设备、参数。不要从最后一层倒着猜。

问题	最可能原因	处理顺序
有画面但没有框	模型未加载、推理未开始、模型类型/输入尺寸不匹配、置信度过高。	模型页确认加载和推理，降低置信度测试，检查模型类型。
有框但不自瞄	类别页 ID 不匹配、类别过滤未勾选、自瞄未开、按键未触发、设备未连接。	先看类别 ID，再测设备移动，再确认自瞄按键。
能动但方向/幅度很怪	PID 参数过激、单帧上限过低或过高、锁定范围选错、准星找色偏移。	关人性化和复杂功能，用 Whiz内置固定范围重测。
多人同屏乱切	目标粘性太低、跟踪确认太快、类别层级设置不清。	提高目标粘性，检查优先/滞后/其它 ID，增加跟踪确认帧。
贴近目标抖	P/I 过高、D 不够、防抖未开、框本身抖。	先观察预览框是否抖，再调 PID；必要时开防抖/死区。
扳机松开后又误触发	触发区域太大、丢目标收枪关闭、类别分离配置不对。	打开范围可视化，缩小区域，开启丢目标自动收枪。
压枪时手动 Y 轴干扰	未启用屏蔽 Y 轴或设备不支持硬件轴屏蔽。	确认使用 Net/MAKCU/DHZ；CatBox、KM Box A、Logitech 只走鼠标输出，不做硬件轴屏蔽。