Pv1 操作手册
精确到每一个参数的完全参考指南 — 涵盖压枪、AI 自瞄、自动扳机、水平修正、模板管理等全部功能模块,所有参数均标注取值范围与默认值。
概述
Pv1 是一款桌面辅助工具,核心功能包括 AI 自瞄、压枪修正、自动扳机、水平后坐力修正、武器配件识别 和 姿势识别。软件通过智能目标检测实现敌人定位,通过自瞄算法实现平滑瞄准,通过枪械弹道数据实现压枪补偿。
界面布局
主界面分为左右两个面板:
左侧面板 — 状态信息区
左侧面板顶部显示软件运行时的实时状态,所有字段为只读显示:
| 显示项 | 说明 |
|---|---|
| 到期时间 | 授权卡密的过期时间 |
| 分辨率 | 当前显示器分辨率(宽 × 高) |
| GPU | 当前显卡型号(AI 功能需要) |
| 截图区域 | AI 检测截图的屏幕坐标(左上角X:Y:宽:高) |
| 姿 势 | 当前识别的人物姿势:站姿 / 蹲姿 / 卧姿 |
| 屏 息 | 当前屏息状态:屏息 / 未屏息 |
| 手 持 | 当前手持武器名称 |
| 1号枪 / 2号枪 | 背包武器及配件信息(锁定时显示红色) |
快捷开关
| 参数名 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 静音 | 开关 | 开 | 关闭所有操作提示音 |
| 压枪 (F7) | 开关 | 开 | 总压枪开关,按触发模式自动下压补偿后坐力 |
| 左右修正 | 开关 | 关 | 水平后坐力修正,图像识别准星偏移进行左右补偿 |
| 显示性能参数 | 开关 | 关 | 显示 AI 检测性能调试数据(需先开检测线程) |
| 自瞄 (F8) | 开关 | 关 | AI 自瞄总开关,需先开启检测线程 |
| 检测窗口 | 开关 | 关 | 显示 AI 检测预览窗口,实时看到目标检测框 |
| 检测线程 | 开关 | 关 | AI 检测线程总开关,关闭后自动关闭检测窗口和自瞄 |
底部操作按钮
底部还显示局域网监控地址(http://<本机IP>:17890/),可在手机/其他设备实时查看武器状态和 AI 状态。
快速设置
基础设置 — 热键与武器
| 参数名 | 类型 | 默认 | 说明 |
|---|---|---|---|
| 屏息热键 | 热键 | 左Shift | 按住则表示此时是屏息状态 |
| 主副武器按键互换 | 开关 | 关 | 交换游戏中1号/2号枪的切换按键识别 |
| 固定武器识别结果 | 开关 | 关 | 开启后可固定当前1/2号枪识别结果,锁定期间武器文字显示红色,不影响手持武器切换 |
| 快速拾取 | 开关 | 关 | 自动快速拾取地面物品 |
压枪触发设置
选择压枪在什么条件下触发,三选一:
姿势识别设置
控制人物姿势(站/蹲/卧)的识别方式,五选一:
掏雷设置
设置你的切雷操作按键,按下此按键后会取消压枪功能,避免丢雷时压枪功能误触发下压:如需正常使用压枪功能请按1,2切会手持武器。
| 参数名 | 选项 | 默认 | 说明 |
|---|---|---|---|
| 切雷按键 | 数字5 / 按键G / 无 | 无 | 选择游戏中切换手雷的按键,选中后按该键时暂停压枪 |
武器匹配阈值
控制武器与配件图像识别的匹配严格程度:一般无需修改
| 参数名 | 范围 | 默认 | 说明 |
|---|---|---|---|
| 一号枪 | 0.01 ~ 1.00 | 0.60 | 主武器匹配阈值,越高越严格准确,越低越容易识别但可能误判 |
| 二号枪 | 0.01 ~ 1.00 | 0.40 | 副武器匹配阈值,越高越严格准确,越低越容易识别但可能误判 |
自适应灵敏度
当游戏内灵敏度不是默认值时,使用此功能进行适配,使压枪幅度与游戏灵敏度匹配。设置完成后点击「应用灵敏度设置」生效:
| 参数名 | 范围 | 默认 | 说明 |
|---|---|---|---|
| 垂直灵敏度 | 0.01 ~ 2.00 | 1.00 | 游戏内垂直灵敏度,与压枪下压力度直接相关 |
| 开镜灵敏 | 1.0 ~ 100.0 | 50.0 | 基础开镜(红点/全息)灵敏度 |
| 二倍镜 | 1.0 ~ 100.0 | 50.0 | 2倍镜开镜灵敏度 |
| 三倍镜 | 1.0 ~ 100.0 | 50.0 | 3倍镜开镜灵敏度 |
| 四倍镜 | 1.0 ~ 100.0 | 50.0 | 4倍镜开镜灵敏度 |
| 六倍镜 | 1.0 ~ 100.0 | 50.0 | 6倍镜开镜灵敏度 |
| 应用灵敏度设置 | — | 点击后根据上述数值重新计算所有枪械弹道数据 |
压枪参数
鼠标驱动
选择软件控制鼠标的方式,三选一
| 参数名 | 选项 | 默认 | 说明 |
|---|---|---|---|
| 驱动模式 | Windows API / Ghub / 内核驱动 | Ghub | 鼠标移动注入方式,三选一! |
| 驱动测试 | — | 选择驱动模式后点击后测试当前驱动是否能正常控制鼠标,鼠标向右下角移动则正常 | |
| 屏幕缩放比例 | 下拉 | — | 仅内核驱动模式下显示,设置系统缩放比例 |
驱动方式教程
垂直修正
垂直修正由每把枪的独立弹道数据控制,在「垂直修正」 页中查看和编辑。每把枪都有对应的弹道参数,软件会根据当前识别到的武器自动调用:
| 参数/操作 | 类型 | 说明 |
|---|---|---|
| 枪械选择 | 下拉 | 选择要编辑弹道的枪械(AKM、M416、M762 等 45 把) |
| 新增枪械 | 新增当前枪械列表中不存在的枪械,并以当前所选枪械的参数作为初始配置 | |
| 弹道数据编辑 | 表格 | 每发子弹的下压量,可逐发微调 |
| 倍镜切换 | 标签 | 红点/2倍/3倍/4倍/6倍/8倍,各倍镜独立弹道 |
新增枪械
- 先选择一把参数相近的现有枪械,再点击“新增枪械”按钮。
- 输入列表中不存在的枪械名称并选择枪械类型,然后点击“确认”。新枪械会复制当前所选枪械的参数并保存到 config.ini。
- 前往“模板管理”,为新枪械新增识别模板。
旧版枪械配置添加教程
水平修正(左右修正)
通过图像识别准星在射击时的水平偏移,自动进行左右鼠标移动补偿:
左右修正依靠游戏中顶部的罗盘(看方向的刻度盘),特殊游戏模式或场景中没有顶部的罗盘时左右修正无效
游戏设置:FPP视野:90,罗盘阴影:开启
左右修正参数请勿随意修改,资深玩家随意
| 参数名 | 范围 | 默认 | 说明 |
|---|---|---|---|
| 左右修正 | 开关 | 关 | 水平修正总开关 |
| 灰度阈值 | 0 ~ 255 | 170 | 图像二值化阈值,提取准星/枪口火焰区域 |
| 最小轮廓面积 | ≥ 0 | 1 | 忽略小于此面积的轮廓,过滤噪点 |
| 最大轮廓面积 | ≥ 0 | 200 | 忽略大于此面积的轮廓,过滤大面积干扰 |
| 循环间隔(ms) | 0 ~ 50 | 0 | 每次检测循环休眠时间,0为全速 |
| 移动死区 | 0 ~ 10 | 0 | 偏移小于此值不修正,防止微抖 |
| 最大偏移量 | 1 ~ 30 | 20 | 单次修正最大像素偏移,防止过度修正 |
| 固定修正量 | 1 ~ 10 | 1 | 固定模式下每次修正的像素量 |
| 稳定帧数 | 1 ~ 20 | 3 | 建立基准点需要连续稳定的帧数 |
| 基准容差 | 1 ~ 10 | 2 | 基准点判定的像素容差范围 |
| 稳定帧计数 | 1 ~ 20 | 5 | 判断瞄准状态稳定所需连续帧数 |
| 像素变化阈值 | 1 ~ 10 | 1 | 帧间像素变化小于此值视为稳定 |
模板管理
管理武器/配件图像识别模板,支持截图新增和查看删除:
当武器或者任意配件无法正确识别时,请新增识别模板!
当新增新的武器是,请新增识别模板!
| 参数/操作 | 类型 | 说明 |
|---|---|---|
| 模板类型 | 下拉框 | 枪械 / 枪口 / 握把 / 倍镜 / 枪托 |
| 模板名称 | 下拉框 | 对应类型下的具体模板(akm、补偿器、垂直握把、4倍镜等) |
| 打开模板管理 | 查看/删除已保存的模板图片 | |
| 截图新增模板 | 游戏中打开背包,点击此按钮会对当前所选中的模板类型进行截图,可在截图后的弹窗中选择符合要求的模板图 |
提示:若旧版软件无新增模板功能,请使用新版软件制作好模板后,手动将制作好的模板复制到旧版软件目录中!
自瞄控制
自瞄热键
点击控件后按下目标按键即可绑定,按 ESC 取消:
| 热键名 | 默认键 | 说明 |
|---|---|---|
| 自瞄热键1 | 鼠标右键 | 按住开启自瞄(可设3个,任一按下即生效) |
| 自瞄热键2 | E键 | 第二自瞄触发键 |
| 自瞄热键3 | Q键 | 第三自瞄触发键 |
| 暂停自瞄热键1 | 无 | 按住临时暂停自瞄(可设2个) |
| 暂停自瞄热键2 | 无 | 第二暂停自瞄键 |
检测模型
请勿随意修改,资深玩家随意
截图后端推荐使用 DXGI,游戏需开启无边框模式
| 参数名 | 选项 | 默认 | 说明 |
|---|---|---|---|
| 选择模型 | 模型文件列表 | 第0个 | 下拉选择 AI 检测模型文件 |
| 推理后端 | 自动(TensorRT优先) / TensorRT / DirectML | auto | AI 计算方式,切换后自动重启检测 |
| 截图后端 | 自动(WGC优先) / WGC / DXGI / MSS / Win32 | auto | 屏幕截图方式,自动选择最优方案 |
界面实时显示「当前截图后端」和「当前推理后端」的实际运行状态。
检测范围
设置 AI 屏幕截图区域大小(屏幕中心正方形),三选一:
检测范围越大,越吃显卡性能
自瞄范围
在检测范围内进一步限制自瞄有效区域(屏幕中心圆形):
| 参数名 | 范围 | 默认 | 说明 |
|---|---|---|---|
| 瞄准时自瞄范围限制 | 开关 | 开 | 开启后仅瞄准 FOV 圆形范围内的目标 |
| 自瞄范围 | 10 ~ 320 | 320 | FOV 圆半径(像素),悬停滑块时屏幕中心预览圆圈 |
| 开火时自瞄范围限制 | 开关 | 开 | 动态FOV,开火时用更小范围(开启自动开启普通FOV) |
| 动态自瞄范围 | 10 ~ 320 | 320 | 开火时的 FOV 圆半径(像素) |
| FOV颜色 | 十六进制颜色 | #39d353 | FOV 圆圈显示颜色 |
检测设置
| 参数名 | 范围 | 默认 | 说明 |
|---|---|---|---|
| 帧率限制 | 1 ~ 1000 | 252 | AI 检测循环最大帧率(FPS),限制可降低CPU/GPU占用 |
| 置信度 | 0.00 ~ 1.00 | 0.60 | 目标检测置信度阈值,高于此值才认定为有效目标 |
扳机设置(自动扳机)
| 参数名 | 范围/选项 | 默认 | 说明 |
|---|---|---|---|
| 自瞄扳机热键1/2/3 | 热键 | 左键/无/无 | 按住开启自动扳机 |
| 扳机瞄准误差 | 1 ~ 200 | 32 | 准星与目标距离小于此值才自动开火 |
| 扳机方式 | 自动判断 / 全自动 / 连点扳机 | 全自动 | 0=自动判断武器,1=全自动持续开火,2=连点器 |
| 失去目标停火延时(ms) | 0 ~ 500 | 50 | 目标丢失后延迟多少毫秒停火,防止短暂丢目标断火 |
扳机设置下方还有一套独立的扳机自瞄算法参数,结构与各倍镜自瞄算法参数完全相同(见下节),独立保存一套参数。
自瞄参数(按倍镜独立配置)
软件为每个倍镜档位(1倍/2倍/3倍/4倍/6倍/8倍)和扳机模式各保存一套独立自瞄算法参数。每个档位独立保存一套参数。
瞄准设置(每套自瞄算法通用)
| 参数名 | 范围 | 默认(x1) | 说明 |
|---|---|---|---|
| 开启自瞄 | 开关 | 开 | 当前倍镜档位的自瞄总开关 |
| 锁头 | 开关 | 开 | 优先瞄准头部区域 |
| 锁身体 | 开关 | 开 | 优先瞄准身体区域 |
| 准星误差修正 | 开关 | 关 | 开启准星位置误差自动修正 |
| X追踪保持 | 开关 | 开 | 目标横向移出后保持X轴追踪 |
| Y追踪保持 | 开关 | 开 | 目标纵向移出后保持Y轴追踪 |
| 瞄准误差 | 1 ~ 200 | 10 | 准星与目标距离小于此值视为已瞄准,停止移动 |
| 预瞄位置 | 0 ~ 100 | 25 | 瞄准点在目标框垂直位置:0=顶部,100=底部(约24对应头部) |
| Y轴准星偏移补偿 | 开关+数值 | 开/25 | 开火时若准星始终锁定在敌人头以上位置,请增加此值! |
| Y轴准星偏移补偿(按枪械定制) | 开关+数值 | 未设置 | 仅倍镜分页显示,可为每把枪单独设Y补偿,覆盖全局值 |
| X轴准星偏移补偿 | 0 ~ 3 | 0.248 | 若右侧头准星锁定在敌人右侧时可以增加此值进行修正 |
移动算法 二选一
1.调整移动算法前,请先确定好你的灵敏度不再发生变化
2.调整移动算法前,请先保证你的AI检测帧率稳定
预测控制模式
X轴 / Y轴 预测控制
| 参数名 | 范围 | 默认(x1) | 说明 |
|---|---|---|---|
| X响应力度 | 0 ~ 2 | 0.30 | X轴自瞄算法比例增益,越大响应越快但可能过冲 |
| X预测强度 | 0 ~ 20 | 1.05 | X轴目标运动预测前馈增益,越大预判越激进 |
| X输出平滑 | 0 ~ 100 | 0 | X轴输出低通滤波系数,越大越平滑但延迟越高 |
| Y响应力度 | 0 ~ 2 | 0.30 | Y轴自瞄算法比例增益 |
| Y预测强度 | 0 ~ 20 | 0 | Y轴目标运动预测前馈增益 |
| Y输出平滑 | 0 ~ 100 | 0 | Y轴输出低通滤波系数 |
卡尔曼滤波参数,不需要调整
| 参数名 | 范围 | 默认(x1) | 说明 |
|---|---|---|---|
| 过程噪声 | ≥ 0 | 2 | 卡尔曼过程噪声协方差Q,越大越信任预测、跟踪越快 |
| 测量噪声 | ≥ 0 | 0.02 | 卡尔曼测量噪声协方差R,越大越平滑但延迟越高 |
积分与输出限制参数,不需要调整
| 参数名 | 范围 | 默认(x1) | 说明 |
|---|---|---|---|
| 控制死区 | ≥ 0 | 1 | 误差小于此值不输出控制量,防止微抖 |
| 积分修正范围 | 1 ~ 200 | 50 | 误差在此范围内才开始积分累积,防止大误差积分饱和 |
| 积分建立速度 | 0 ~ 0.2 | 0.050 | 积分项累积速率(Ki),越大稳态误差消除越快 |
| 积分输出力度 | 0 ~ 1 | 0 | 积分项输出到控制量的增益系数 |
| 积分限幅 | 0 ~ 500 | 100 | 积分项最大绝对值,防止积分饱和 |
| 积分输出死区 | 0 ~ 20 | 1 | 积分输出小于此值时清零 |
| 输出限幅 | 1 ~ 5000 | 2000 | 单次控制输出最大绝对值,防止鼠标猛移 |
| 微输出清零阈值 | 0 ~ 5 | 0.50 | 控制输出小于此值时清零,过滤微小抖动 |
分段式模式
| 参数名 | 范围 | 默认(x1) | 说明 |
|---|---|---|---|
| X移动速度 | 0.01 ~ 2 | 0.15 | X轴鼠标移动速度系数 |
| Y移动速度 | 0.01 ~ 2 | 0.05 | Y轴鼠标移动速度系数 |
移动预测设置(分段式模式下)
| 参数名 | 范围 | 默认(x1) | 说明 |
|---|---|---|---|
| 移动预测 | 开关 | 开 | 开启横向移动目标的预判偏移 |
| 预测目标宽度阈值 | 1 ~ 200 | 80 | 目标框宽度小于此值才启动预测(远距离目标) |
| 预测敏感 | 1 ~ 200 | 10 | 预测参考历史帧数,越大越稳定但反应越慢 |
| 预测幅度 | 0.01 ~ 10 | 0.65 | 预测偏移量的倍率系数 |
| 开始预测阈值 | 1 ~ 50 | 10.13 | 目标移动速度大于此值时开始预测 |
| 停止预测阈值 | 1 ~ 50 | 7.40 | 目标移动速度小于此值时停止预测 |
| 移动波动阈值 | 1 ~ 50 | 2 | 目标移动方向波动大于此值时终止预测(防反向预判) |
附录
附录 A — 支持枪械列表(45把)
突击步枪 (AR) — 14把
冲锋枪 / 霰弹枪 (SG) — 16把
狙击步枪 / 精确射手步枪 (SR) — 11把
轻机枪 (LMG) — 4把
附录 B — 热键功能索引(12个)
| UI显示名 | 默认 | 说明 |
|---|---|---|
| 自瞄热键1 | 鼠标右键 | 按住开启自瞄 |
| 自瞄热键2 | E键 | 按住开启自瞄(备用) |
| 自瞄热键3 | Q键 | 按住开启自瞄(备用) |
| 暂停自瞄热键1 | 无 | 按住临时暂停自瞄 |
| 暂停自瞄热键2 | 无 | 按住临时暂停自瞄(备用) |
| 快速拾取 | 鼠标侧键 | 触发快速拾取 |
| (预留) | 无 | 自动扳机预留位 |
| 自瞄扳机热键1 | 鼠标左键 | 按住开启自动扳机 |
| 自瞄扳机热键2 | 无 | 按住开启自动扳机(备用) |
| 自瞄扳机热键3 | 无 | 按住开启自动扳机(备用) |
| 屏息热键 | 左Shift | 按住标记屏息状态 |
| 固定热键 | F3 | 切换武器锁定状态 |
附录 C — 全局快捷键
| 快捷键 | 功能 |
|---|---|
| F7 | 切换压枪开关 |
| F8 | 切换自瞄开关(需先开检测线程) |
| F3 | 切换武器锁定/解锁(默认固定热键) |
| ESC | 热键绑定时取消设置 |