QInEX 配置面板使用指南 v1.x

PC 键鼠 → Android 触屏 + 投屏点对点操控 一体化工具

本指南面向最终用户，逐项讲解配置面板内每个模块、每个参数的含义、推荐取值、以及何时该调它。

📍 配置入口：http://localhost:61701 🪟 启动 QInEX.exe 后自动弹出 💾 改动需点「保存配置」才生效
完整版QInEX-V.exe（含投屏 / QQ 验证）

官方主版，首次启动需要 QQ 群扫码验证。

  • ✓ 全部触摸 / 视角 / 宏 / 反作弊 功能
  • ✓ ScreenHub 手机投屏 + 点对点鼠标操控
  • ✓ ADB 模式可选「USB 网络共享直连」（更低延迟）
  • ✓ 配置面板显示 QQ 头像 / 昵称
免验证版QInEX.exe（社区精简版）

无 QQ 群验证，启动即用；功能略少。

  • ✓ 全部触摸 / 视角 / 宏 / 反作弊 功能
  • ✗ 无 ScreenHub 投屏（本指南第 15 章不适用）
  • ✗ ADB 模式无「USB 网络共享直连」开关
  • ✗ 无 QQ 验证 → 启动跳过扫码步骤

怎么看你是哪个版本启动后：弹出 QQ 扫码窗口 = 完整版；直接进入配置面板 = 免验证版。本指南中带 完整版 徽标的条目仅完整版可用；其余两版本通用。

01快速上手

5 分钟跑通最小可用配置。两种传输模式任选其一。

硬件模式（ESP32-S3）默认

  1. 把烧好固件的 ESP32-S3 用 USB 线接到 PC（串口）与手机（OTG）。
  2. 双击程序：完整版会弹出 QQ 群扫码验证窗口；免验证版跳过此步直接进入。
  3. 自动弹出配置面板 → 打开「高级参数微调」，确认串口号（默认 COM5）。
  4. 打开「基础设置 & 截图」→ 上传一张游戏截图、填好参考分辨率（如 2400 × 1080）。
  5. 打开「添加组件」→ 拖出 WASD 轮盘、视角区域、各种按键。
  6. 点「保存配置」。状态行显示成功即可进游戏，按 ALT 切换为视角模式。

免硬件模式（ADB + UHID）免 ESP32

  1. 手机开启 USB 调试，USB 线连 PC（确认 adb devices 能识别）。
  2. 启动程序（完整版需过 QQ 验证；免验证版直接进入）。
  3. 「高级参数微调」→ 把传输模式切到「免硬件 (ADB + UHID)」。
  4. 保存配置 → 程序自动 push dex、拉起手机端进程，等待握手成功。
  5. 其余步骤同硬件模式。

免验证版用户启动时不会出现 QQ 扫码窗口，这是正常的。两版本配置面板从这一步开始完全一致（除少数标 完整版 的功能外）。

提示「保存配置」按钮变橙色 = 你有未保存的改动。任何改动都要保存才会下发到运行中的程序。

02界面总览

打开后整屏分四层，全部可拖拽自由布置。

  • ① 顶左 浮动工具栏：列出所有模块按钮 + 底部「读取 / 保存配置 / 状态行」。完整版通过 QQ 验证后会显示头像与昵称；免验证版不显示此区域。
  • ② 子面板：点击模块按钮后从工具栏右侧弹出，可独立拖动。其中「高级映射组件」是个菜单，点里面的组件会再弹一个面板（菜单不消失，二者并存）。
  • ③ 全屏画布：显示游戏截图作底图，所有"组件"摆在上面（坐标存盘时归一化为 0.0–1.0）。
  • ④ 组件属性面板：选中画布上的组件时自动浮现，每种组件参数不同。

操作拖动方块 = 移动；拖动右下角小手柄 = 改大小；Delete = 删除；Esc = 取消选中或取消"等待放置"。

03配置文件管理

保存多套配置档（不同游戏一档），即点即切。

字段 说明
当前配置 当前生效的 json 文件名（只读）
配置列表 所有 *.json；点击文件名 = 切换并重启服务；右侧 × = 删除（默认 config.json 与当前生效项不可删）
新配置名称 建议英文 / 数字命名，如 wzry / pubg / cf
新建 基于当前内存配置创建新文件

注意不要手改 json。配置写盘走 merge 模式，UI 不识别的字段会在下一次保存时被清空。

04基础设置 & 截图

决定整个配置坐标系的"参考系"，第一次进入务必先填。

输出模式 触摸屏（默认）= 常规手游 / MOBA / FPS； 手柄 = 键盘映射为 XInput 手柄按钮（ESP32 固件也需切到 Gamepad 模式）
上传截图 手机内的游戏截图，仅作底图参考，不会写入配置文件
参考分辨率 手机屏幕实际像素，例 2400 × 1080。 所有触摸点的归一化基准，与手机不一致会导致位置偏移与比例失真

05添加组件（拖拽布键）

点击按钮 → 组件出现在画布中央 → 拖到合适位置 → 调大小。

组件 用途 数量
移动摇杆 WASD 转手机虚拟摇杆（弹簧阻尼物理模型 + 反作弊扰动） 最多 1
视角滑动区域 鼠标移动 → 屏幕滑动（FPS 视角） 最多 1
鼠标轮盘 (Tab/4…) 短按 = 点击；长按 = 进入轮盘，鼠标移动选方向 多个
鼠标 LMB / RMB / X1 / X2 鼠标键 → 触摸点 多个
自定义按键（按下键盘获取） 画布进入监听态，按下任意键盘键完成绑定。同一按键可绑多个触摸点 无限

小技巧已添加的按键再次点击会进入"再点击一次设置位置"模式，可重新放置。Esc 退出该模式。

06组件属性面板

选中画布上某个组件时自动弹出。每种组件参数不同，下面分别讲解。

6.1　移动摇杆（WASD 轮盘）

界面移动摇杆参数较多，面板已按组折叠（基础 / 半屏移动 / 手感·拟人化 / 方向微调），默认只展开「基础」，点组标题可展开其余。鼠标移到某个参数行，画布上对应的图形会高亮（半径圈、落点圈、半屏活动区、各方向射线），冷冰冰的数字一眼对上图形。

基础

半径 轮盘活动半径（像素），游戏内轮盘多大就填多大
上 / 下 / 左 / 右 方向键，默认 WSAD
切换键 进入"走路"等慢速状态的键，默认 Shift
切换半径 切换键按下时的轮盘半径（一般小于正常半径 = 走路）
统一切换 勾选：所有方向统一使用切换半径；不勾：按比例缩放每个方向半径
自动奔跑键 V1.2.8 新 · P4 绑一个键（留空 = 不用）：按一下 = 摇杆自动推满正前方持续奔跑，手可离开键盘；期间按 WASD 立即实时接管方向、松开恢复前奔；再按一次或按后退键（S）取消。走的就是摇杆物理，弹簧 / 拟人 / 走跑半径全继承，游戏看到的和真人按 W 无区别。层勾了"禁用走路摇杆"时同样被压制

手感 · 拟人化（弹簧软硬 + 防检测随机)

对应面板里的「手感 · 拟人化」折叠组。游戏轮盘里的"虚拟手指"不是一按就到位的，会模拟真人手指被一根橡皮筋拉着的感觉。刚度和阻尼就是控制这根橡皮筋的两个旋钮。(注:面板里「统一切换」也在这一组,它的说明见上方「基础」表的「统一切换」行。)

刚度 橡皮筋的"硬度"。越大反应越快、越紧绷；越小越柔、转向慢半拍
阻尼 橡皮筋的"刹车力"。越大越稳、不会回弹晃；越小越Q弹、抖三抖
落点半径 每次按下 W/A/S/D 时，虚拟手指的"落点"不会每次都在同一个像素，而是在以中心为圆点、这个值为半径的小圈内随机落。0 = 机械人式每次完全相同
纯净模式 关掉所有随机扰动 + 关掉橡皮筋，触点严格落在配置位置。仅用于宏录制 / 节奏游戏，正常对局会被认成机器人
调参指南：怎么调出"跟手"的感觉
把刚度想成"油门"，阻尼想成"刹车"。两个要配套调： 只加油门(刚度↑)不加刹车(阻尼↑)会"过冲"，松手时虚拟手指会冲过中心晃几下； 只加刹车不加油门会"软绵绵"，转向迟钝。

四套常用参考（直接抄就行）：

稳重型（MOBA / 走位精细）
MOBA / RPG 探索类
刚度 0.012
阻尼 0.30
落点半径 0.005
默认通用
出厂值，绝大多数游戏即开即用
刚度 0.015
阻尼 0.25
落点半径 0.005
灵敏型（FPS 跑图 / 急停）
射击 / 战术竞技类
刚度 0.022
阻尼 0.22
落点半径 0.006
极致响应（竞速 / 格斗）
QQ 飞车、街霸 ACE
刚度 0.035
阻尼 0.18
落点半径 0.003

怎么判断要调哪个：

  • 松开 W 后角色滑了一小段才停 → 阻尼调大（如 0.25 → 0.30）
  • 按下 W 后角色起步慢半拍 → 刚度调大（如 0.015 → 0.020）
  • 急转弯时角色"原地抖动" → 阻尼调大 + 刚度略减
  • 角色走得"飘"、漂移感强 → 两者一起调大（0.020 / 0.30）

关于「方向微调」：默认轮盘是个正圆——8 个方向推出去一模一样。但游戏里前后左右"推到底"的距离常常不一样，所以面板把每个方向都开放出来单独调,分两组:方向微调 · 半径(改每个方向推多远,常用) 和 方向微调 · 形状(改每个方向扇区的形状,进阶)。不需要就别动,圆形对绝大多数游戏够用。

方向微调 · 半径（每方向单独推多远，常用)

给某个方向单独设一个半径，不影响其它方向。怎么操作:展开属性面板的「方向微调 · 半径」组 → 8 个格子(上/下/左/右/↖ ↗ ↙ ↘)，给想改的方向填像素值。

  • 0 = 沿用上面「基础」里的那个总半径(即不单独调,跟大伙一样)。
  • 非 0 = 该方向单独用这个半径;上限 = 总半径 × 3。
  • 鼠标移到某个格子,画布会从轮盘中心朝那个方向画一条高亮射线 + 端点,直观看到"这个方向能推多远",边看边调。

例:某游戏要向前推得很远才触发疾跑、横向稍推就走 → 把「上」的半径调大(如总半径 120、上方填 200)，其余留 0 不动。

方向微调 · 形状（每方向扇区/凸起，进阶)

比「半径」更精细:不只改推多远,还能改那个方向扇区的形状(边界角度 + 弧线凸起)，把圆轮盘捏成更贴合游戏摇杆判定区的样子。一般用不到,圆形就够;游戏摇杆是异形判定、或想极致贴合时再碰。

怎么操作:展开「方向微调 · 形状」组 → 先点上方的方向标签选一个方向(画布会用金色高亮该方向扇区) → 然后两种方式任选:① 直接在画布上拖动手柄(金色 = edge1/edge2,青色 = bulge),边拖边看形状;② 在面板里填数字。两个控制点各是 角度°(沿圆周) + 径向 px(往外/往里):

  • edge1(金) — 扇区起始边的角度 + 径向偏移。
  • edge2(金) — 扇区结束边的角度 + 径向偏移。
  • bulge(青) — 扇区中间那段弧的凸起控制点(径向正=外凸、负=内凹)。

径向偏移是相对该方向半径的增减。曲线是 edge1 → bulge → edge2 的一段平滑弧。约束:E1A ≤ BA ≤ E2A(角度从起始边到结束边递增) 且 BR ≥ min(E1R, E2R)(中间凸起不能比两边还瘪)——拖手柄时会自动满足这两条约束。默认值 = 标准圆形,留着不动即可。

手机上也能调这套 8 方向形状在手机 QInEScreen APP 的 P4 配置里也有专属的全屏触屏拖拽编辑器,手机上配键位时同样能拖金/青手柄改形状。

半屏移动（自由 / 跟手摇杆，MOBA 类）

很多游戏的左半屏是自由摇杆：手指按在哪儿、哪儿就是摇杆原点，松手即停。开启「半屏移动」后，摇杆不再固定在一个点，而是每次按下在活动区内重新起杆，更贴近真人、也更适配这类游戏。

半屏模式总开关。关 = 固定中心轮盘（原行为）；开 = 启用下面几项
原点随机0~1，每次按下原点在活动区内随机的幅度。0=原点固定在中心（子类型 A）；0.5~0.8=每次都不同（子类型 B，推荐 MOBA 类）
反向重锚方向急转（≥120°）时抬手 → 下一帧在新原点重按，转向更干脆。要平滑过渡就关
防误点首帧后保证的最小位移（半径比例），防止被游戏判成"点按"而非起杆。0=不强制；半径很小或游戏误判时再开（如 0.3）
活动区宽 / 高归一化 0~1，以中心为心的矩形。0=自动取贴边最大对称矩形（默认覆盖左半屏），一般不用改

画布开「半屏模式」后，画布会画出蓝色虚线的"半屏移动区"框（摇杆可出现的范围）；摆好摇杆中心，活动区会自动贴边覆盖左半屏。不接这类游戏就别开，保持固定中心轮盘即可。

急停身法（响应档 / 反向瞬切）新　控制方向变化时的"刹车/转向"手感，默认完全是原来的柔弹簧，不动就和以前一样。

响应档方向变化时是否绕过弹簧惯性。柔(原弹簧)=最拟人(默认)；中=阻尼快速趋近；脆(端游)=瞬切，最跟手但更机械。半屏模式下不生效。
反向瞬切A↔D / W↔S 反向那一下跳过中点、直接瞬切到反向（拉枪急停手感）。独立于响应档，可单独开。

怎么用想要端游那种"撒手即停、反向即走"的硬朗手感 → 响应档调脆 + 开反向瞬切；越脆越跟手但拟人度越低、越像脚本。求稳/拟人就保持默认柔。上位机 / P4 单机 / 手机 APP 三端通用。

6.2　视角滑动区域（FPS）

灵敏度 鼠标推 1 cm，屏幕里视角滑多远的总倍率。默认 1.0；FPS 一般 0.8 ~ 2.5
自动抬起 (ms) 鼠标停下后多久"松开手指"。0 = 永不松，200~500 常用
绑左键 勾选：必须按住鼠标左键才会滑视角（用于"开镜才转视角"的玩法）
纯净模式 忽略灵敏度和加速度，鼠标按 PC 整屏 1:1 映射到视角，用于精准点点击
加速度曲线 8 个橙色控制点，决定"不同速度推鼠标的倍率"。三个预设按钮：关闭 / 中等 / 强烈
灵敏度怎么调：从"鼠标转一圈 = 屏幕转几圈"说起
灵敏度就是个"放大倍数"。它只控制总体的快慢，不改变手感曲线。 如果你在游戏里 1 圈鼠标只能转半圈视角 → 灵敏度调大； 如果稍微一推鼠标视角就甩出去 → 灵敏度调小。

从 1.0 开始，1 次只动 ±0.2。最稳的做法：进游戏 → 鼠标推到鼠标垫尽头 → 看视角转了多少 → 调到你想要的角度即可。

不同游戏的参考：

FPS 中近距离
射击类中距离压枪
灵敏度 1.2 ~ 1.6
自动抬起 300 ms
加速度曲线 关闭
FPS 大转身
CSGO/CF 类、需 180° 快转
灵敏度 0.9 ~ 1.2
自动抬起 200 ms
加速度曲线 中等
狙击 / 精确
远距离架枪点头
灵敏度 0.5 ~ 0.8
自动抬起 500 ms
加速度曲线 关闭
高 DPI 玩家
鼠标 DPI ≥ 3200，手感太快
灵敏度 0.3 ~ 0.6
自动抬起 300 ms
加速度曲线 关闭
加速度曲线：什么时候开、开哪一档
加速度曲线是一个"鼠标推得越快、屏幕转得越快"的额外加成。 慢推鼠标时保留你设的灵敏度；快推时屏幕"自动加倍"。 好处：低速能精确点头，高速能一甩 180°；坏处：手感不"线性"，肌肉记忆要重新练。

三档预设的实际效果：

关闭（默认）
想要"鼠标多远 = 视角多远"的线性手感
慢速 ×1.0
中速 ×1.0
快速 ×1.0
中等
需要偶尔大转身但不想完全失控
慢速 ×1.0
中速 ×1.4 左右
快速 ×2.0 左右
强烈
小鼠标垫、想要"轻甩一下转一圈"
慢速 ×1.0
中速 ×2.0 左右
快速 ×4.0 ~ ×5.0

建议：第一次玩这套工具时用"关闭"，等灵敏度调到自己舒服再考虑开。MOBA 类不需要开。

自动抬起：选 200 还是 500 的判断方法
自动抬起就是"鼠标不动了，多久后松开屏幕上的手指"。 游戏里推完视角，手指不离开屏幕时，下一次推会"接着上次的位置"继续； 手指一旦松开，下一次推会从屏幕中心重新开始。
  • 0 ms：永远不松手 → 视角连续滑动不间断，但鼠标推到屏幕边缘会"卡住"
  • 200 ms：节奏快、对枪频繁 → 推一下停一下，手感"清爽"
  • 300 ms（推荐起点）：兼顾连贯和及时复位
  • 500 ms：边走边瞄、想保持视角连续 → 长时间不动才放
  • 1000 ms 以上：基本等同于不松手

6.3　鼠标轮盘（Tab 类技能位）

鼠标可移动范围 V1.0.6 改 触点跟鼠标 1:1 滑动的范围半径 —— 这才是决定"触点能滑多远"的。鼠标挪多少，触点就滑多少（同像素），到这个半径为止。不设（0）= 沿用「触摸半径」当滑动范围（老配置行为不变）。想让触点滑得更远 → 调大它。
触摸半径 V1.0.6 改 触点落点的随机范围半径。每次按下激活轮盘时，触点在"中心 ± 这个半径"内随机取一个落点（反检测、更像真人），之后就交给鼠标接管。它不决定能滑多远，只管落点随机的大小。
长按 (ms) 短于此时间松开 = 单纯点击；达到此时间 = 进入轮盘模式，鼠标锁中心、移动选方向

V1.0.6 重做：两个半径彻底独立老版本把"触摸半径"当滑动圈、"鼠标行程"当灵敏度缩放，很多人以为设了鼠标行程触点就能滑更远——其实不能，容易误解。现在纠正为：
· 鼠标可移动范围 = 触点 1:1 滑动的实际范围（决定滑多远）；
· 触摸半径 = 每次按下的落点随机范围（反检测），和滑多远无关；
· 两者互相独立。要触点滑更远，调"鼠标可移动范围"，别调"触摸半径"。
画布上：紫色虚线圈 = 鼠标可移动范围（实际滑动范围），实心圈 = 触摸半径（落点随机范围）。老配置（没设鼠标可移动范围的）行为完全不变。手机 APP 的轮盘属性卡字段同步改名。

6.4　普通按键 / 鼠标键 / 侧键

半径 触摸点视觉 / 碰撞半径，主要影响显示和随机偏移最大幅度，不影响触摸精度
触发方式 V1.0.9 新 这个触点什么时候触发（同一位置）：按住保持（默认，按住一直按着、松开抬起）／按下点击（按下瞬间点一下就抬）／抬起点击（松开瞬间才点一下）／按下+抬起各点一次（一个键两次触发，如按下拔弦、松开投掷）。一个键带多个触点时，每个触点可各选各的。

V1.8.8 / V1.2.2 修复普通按键现在会正确使用自己设置的触摸半径;修复了“半径调大仍只落在很小范围”以及半径为 0 时完全不随机的问题。老配置半径为 0 时才回退全局随机范围。

07高级映射组件（背包 / 载具 / 开镜 / 手势）

这 6 个组件在左侧「高级映射组件」里——点它出一个菜单，再点进各组件配置。用于"跑跳战斗"之外的场景：开背包用鼠标点、上车换一套键、开镜降灵敏、一键翻滚等。坐标都用「画布拾取」在底图上点。

想看口语版实战嫌这章偏"说明书"?另有一份单独的《实战配置·口语教程》(同目录 HTML),照着做就行——含"开镜全家桶(右键开镜+停移动+Q/E 歪头+滚轮切倍镜)"等整套实战配方。

共同前提多态交互的"鼠标点屏幕"只负责"点得到"，要"看得见"光标还得开 投屏窗口（看电脑）或 vPointer（把光标画到手机上，看手机）二选一。

7.1　多态交互（背包 / 商店 / 地图）

按一个键 → 打开背包/商店等 UI，同时鼠标变成能点屏幕的光标（左键点、拖动滑）；再按一下 / Esc → 关掉、回到游戏。

例：把键绑成 B、"打开位置"点到背包图标 → 游戏里按 B 开背包、用鼠标点装备，点完按 B 关。要看见光标得开投屏（看电脑）或 vPointer（看手机）。

触发键点「按键绑定」再按键盘键或鼠标侧键
名称辨识用，如"背包""地图"
打开 tap + 坐标勾选后，进入时先在该坐标点一下（替你点开 UI）。点「画布拾取」在底图上点位置
切回方式再按一次(Toggle，最适合背包) / 松手(Hold，快速瞄一眼) / 仅 Esc
Esc 兜底勾上后 Esc 永远能切回（安全舱，建议勾）
关闭 tap + 坐标勾选后，退出时在该坐标点一下（替你关 UI）

画布上：青色「开 N」= 打开 tap 位置，红色「关 N」= 关闭 tap 位置。

高频多义交互键怎么配（以 F 键为例）有些游戏里同一个交互键身兼数职：长按 = 一种动作（如破门）、单击 = 另一种（如开门 / 刷卡）、对着可搜索目标单击又会弹出需要鼠标点选的列表。千万别把这种键设成多态交互键——会在普通交互时误把鼠标调出来。正确配法：

① F 配成普通按键触点（第 6 章）：按住 = 长触、单击 = 短触，游戏自己区分，频繁按零误触发。
② 另设一个"搜索 / 拾取"键（本组件，触发键绑空闲的鼠标侧键如 X1）：「打开 tap」拾取到 F 在屏幕上的位置 + 切回方式选"仅 Esc" + 勾 Esc 兜底。于是：普通交互 / 快速拾取按 F；需要细选时按 X1（自动点 F 弹列表 + 进指针）→ 点完 Esc 退。用"按哪个键"区分意图，绕开"我们感知不到游戏弹没弹 UI"这个物理限制。

7.2　轻触 / 长按双功能

同一个键：轻触（短按抬起）发一组触点，长按（超过阈值）发另一组触点。例：轻触换弹、长按丢武器。配了此项的键不再走普通按键映射。

触发键「按键绑定」获取
长按阈值 (ms)按住超过它算长按，否则算轻触。默认 200
长按方式按住保持=到点落一个持续触点、松开按键才抬起（适合长按开镜 / 拉弓 / 持续压住）；到点点一下=到点发一次完整点击、当场触发一次、之后不用松手也不重复（适合丢雷 / 用道具 / 触发型技能）。新建默认「到点点一下」
轻触触点短按时点一下的位置（画布拾取，黄色「轻 N」标记）
长按触点长按时按下的位置（画布拾取，橙色「长 N」标记）

7.3　手势滑动键

一键触发一次定向滑动：翻滚闪避、快速 180° 回头、滑动手势技能。画布上绿色箭头 = 起点→终点。

名称 / 触发键辨识 + 「按键绑定」
起点 / 终点各「画布拾取」一个点，滑动从起点划到终点
时长 (ms)整段滑动耗时。默认 80。越短越"瞬移"

触发键能用滚轮「按键绑定」时滚一下滚轮即可录成 WHEELUP / WHEELDOWN。于是"滚轮 = 触发一次手势"。把手势放进某个扩展层 → "开镜时滚轮切倍镜、平时滚轮不动"。注意滚轮是瞬时键(滚一下=点一下),只适合手势 / 点触,不适合按住型。

7.4　按键层（载具 / 建造 / 法术栏）

基础层为主（摇杆、视角、常用键都在这），再加最多 6 个扩展层。按住或切换一个键 → 进该扩展层，这套按键临时变成扩展层的键；扩展层没配的键仍用基础层。每个扩展层卡片上有「📋 复制映射」：选来源（基础层或其它扩展层）一键把可分层的映射（普通按键 / 多态交互 / 轻触长按 / 手势 / 蓄力）拷进本层（同名按键覆盖、其它保留；摇杆 / 视角 / 鼠标轮盘 / 滚轮等基础层专属不会复制）。

例：加个"载具"层、激活键设 V、勾"禁用走路摇杆" → 按住 V 时 WASD 不走路，改走载具层里给 WASD 配的油门 / 方向触点；松开 V 回到走路。

名称如"载具""建造"
激活键进该层的键（如 V / LSHIFT），别和 FPS 切换键 / 方向键撞。也能用右键 / 侧键：绑定时直接按右键即录成 RMB —— 这样"按住右键 = 开镜的同时进该层"
激活方式按住（松手回基础层） / 切换（再按退出）
禁用走路摇杆勾上：本层激活时 WASD 不走摇杆、只走本层按键（配载具）；不勾：走路摇杆照常
编辑此层点它 → 主画布变成该层编辑器，用「添加组件」正常加键、画布直接拖 / 删；还能进「高级映射组件」给本层加多态交互 / 轻触长按 / 手势 / 蓄力（都归本层）；再点「编辑基础层」回去

能加到层的按键、以及 多态交互 / 轻触长按 / 手势 / 蓄力 这四个组件都能加到扩展层——进某层后加的就归该层。只属于基础层的是：摇杆、视角、鼠标轮盘、开镜 ADS。扩展层没定义的键 / 组件自动用基础层的（加性叠加）。切层瞬间会抬起按住的触点防卡键。

例"载具"层里给 E 配一套和基础层不同的轻触长按（轻触鸣笛、长按下车），按住 V 进载具层时 E 就走载具那套，松开回基础层 E 还是原来的。编辑层时基础层的摇杆/视角等会半透明显示、锁住不能误改。

7.5　开镜灵敏度（ADS）

按住某键（通常右键）期间，临时把视角灵敏度换成一个更低的值，开镜不甩飞。松手即恢复。

启用勾选才生效
按住键通常 RMB；也可绑别的键
开镜灵敏度按住期间替换的视角灵敏度，越小越稳
过渡 (ms)预留，0 = 立即切换

与右键开镜共存如果右键同时配了"开镜触点"（keyMap 的 RMB），两者独立叠加：一个负责发触点开镜，一个负责降灵敏度，互不冲突。右键还能再兼当"瞄准层"的激活键(见 7.4)——于是按住右键一键搞定:开镜触点 + 降灵敏 + 进瞄准层(停移动 + 层内 Q/E / 滚轮切倍镜)。完整配法见单独的《实战配置·口语教程》。

7.6　蓄力瞄准（手雷 / 弓）

按住键 → 触点落在起始位并随鼠标拖动瞄准（手雷弹道 / 弓箭）→ 松开抬起（投掷）。画布上紫色「蓄 N」= 起始触点。

名称 / 触发键辨识 + 「按键绑定」
起始触点按下瞬间触点落点（通常技能位），画布拾取
跟随灵敏度拖动时触点跟随鼠标的快慢

注意蓄力期间鼠标被"夺走"用于瞄准，视角本帧不动（符合直觉）。蓄力依赖鼠标原始增量，在 FPS / 瞄准态下最稳。

7.7　压枪（后坐力补偿）

按住开火键期间，软件每一帧把视角往下拉一点点（可带水平），抵消枪口上抬，让连发更稳。它和你自己的鼠标瞄准叠加——你照常压枪/微调，它只是额外帮你往下带。仅在 FPS 视角模式（按了切换键、视角触点在工作）下生效。

⚠ 封号风险自负（务必先读）压枪是所有辅助里最容易被反作弊识别的——"开火时视角恒定下拉"是很强的非人特征，服务端统计/行为检测会盯这个。默认关闭。是否开、开多大，请自行评估目标游戏的反作弊与封号风险，后果自负。建议：①强度宁小勿大、留点残差靠手压；②开抖动加随机；③用起始延迟让前几发不压；④优先只在练习/低风险场景用。

启用总开关，默认关
开火键按住才压，通常左键 LMB（「按键绑定」可录左键/侧键）。它和"开火触点"独立叠加，不冲突
下拉强度每帧向下的归一化位移，越大压越狠。先从很小试起（如 0.002 ~ 0.01），边打边加到刚好压平枪口
水平补偿枪有左右飘时用：右飘填负、左飘填正；不需要填 0
起始延迟(ms)开火后多久才开始压——很多枪前几发不太跳，延迟一下更贴合，也更不像机器
仅开镜时勾上则只有同时按住「开镜键（ADS 那把）」时才压枪；腰射不压
抖动每帧在强度上加一点随机（±），轻量防检测。0=关，建议给强度的 10%~30%

怎么调① 进游戏、对墙按住开火；② 强度从 0.003 起，弹孔还往上跑就加、往下扎就减，调到一梭子大致压平；③ 不同枪后坐力不同——可以配不同配置档分别调好，换枪切档；④ 想更隐蔽就把强度调保守 + 开抖动 + 加起始延迟，剩下的上抬靠手补。频率/出帧不用管(已按时间归一,8000Hz 和 125Hz 压的量一样)。

7.7.1　固定弹道压枪（弹道表回放）V1.2 新 · P4 单机 + 手机 APP

上面的压枪是"每帧恒定往下带"；固定弹道则是按每把枪的真实弹道逐发回放补偿——第 1 发到第 N 发各有自己的位移向量（含左右漂移），按射速节拍插值播放，前几发跳得狠就多压、后段横向蛇皮就跟着横移。每把枪一条弹道，游戏内按"切换热键"即时切换。仅 P4 单机版（固件 V1.2.0+）支持，在 QInEScreen APP → P4 映射配置 → 组件页 → 固定弹道压枪 里编辑。

和普通压枪的关系固定弹道不是独立组件：它复用 7.7 压枪组件的「启用 / 开火键 / 起始延迟 / 仅开镜时」做触发与门控——压枪组件必须启用。一旦「选用」了某条弹道，回放就替代「下拉强度 / 水平补偿 / 抖动」；取消选用（或没有弹道）自动回落普通恒定压枪，老配置行为不变。

弹道列表每把枪一条（最多 24 条 × 每条 64 发）。「选用」= 立即生效（直接发到板子，无需重启）；「编辑」进轨迹编辑器；弹道存板子上（设备级，不随配置档走），APP 里「推送 / 拉取」整表同步
轨迹编辑器画布画的是补偿轨迹（金点=瞄准起点，往下=压枪方向）。轻点选中某发、拖动微调（只动这一发，后续形状不变）；双指缩放、拖空白平移；±加减发数
每发间隔(ms)= 60000 ÷ 射速RPM。例：600 RPM 填 100。回放按它对时间插值，出帧档位无关
整体强度 scale整条弹道的缩放，标定用：推送试打后，压不住 → 加大；反向过头 → 调小。和游戏灵敏度强相关，换灵敏度要重新标定
开镜倍率 adsScale按住开镜键(ADS)期间额外乘的倍率（倍镜下同样的枪口上抬对应更大视角位移时用）
切换热键给弹道绑一个键（通常和游戏切枪键一致,如 1/2）：游戏内按下即切到该弹道,和该键原有触点映射不冲突
回放方式设备级开关（弹道列表页）。「按住回放」（默认）=按住开火键期间回放,松开即停,再按必从第 1 发从头开始（不续播）；「按下播完」=按一下就把整条弹道播完为止,中途松开不打断（适合点射节奏的全自动枪）。播放中再按下也是从头重来。legacy 恒定压枪不受该开关影响,始终按住式
录制手压推荐最准的生成方式：APP 点「录制生成」预备 → 切回游戏,手动压枪打一梭子（按住压枪开火键,手往下带抵消上抬）,松开自动完成 → APP 按「每发间隔」把录到的手压轨迹切成逐发弹道。板子录的是实际施加到视角的位移（已含灵敏度/DPI/加速度/开镜影响）,零识别误差。录全新弹道先「取消选用」再录；若录制时本弹道正在选用（回放工作中）,录到的是你补的残差 → 用「录制叠加校正」,越录越准。录完可在编辑器里逐发微调。最长 8 秒
AI 弹孔识别训练场对墙打一梭子 → 截图 → 视觉模型识别弹孔自动生成弹道（接口在「模型设置」里填,用你自己的 Key,和 AI 自动配置共用一套设置）。「迭代校正」= 按当前弹道压枪后再截一张,把残余偏差叠加回弹道,打几轮越来越准。
发送前 APP 会在截图上自动叠加品红参考网格（10×10 格+刻度）,让模型对着格子读坐标——弹孔位置（含左右漂移）的识别精度比裸图高很多。若结果仍被标成一条竖线/一个点,APP 会提示"模型定位失败",此时换定位更强的模型（Qwen-VL-Max / GPT-4o / Gemini 等旗舰视觉模型）,便宜的小模型往往只数得对数量、给不准位置

上手路径① 7.7 压枪组件启用、绑好开火键；② APP 新建弹道,填好「每发间隔」→ 「录制手压」在训练场手压一梭子生成（首选;AI 识别/手动拖为备选）→ 推送到板子 → 选用；③ 试打,偏差用「录制叠加校正」再录一遍收敛（或调 scale）；④ 给每把枪配切换热键,游戏内切枪即切弹道。风险提示同 7.7——弹道回放比恒定下拉更拟人,但仍属辅助,自行评估目标游戏反作弊风险。

7.8　连点（Turbo 自动连发）新

按住或开关一个键，触点按节拍自动重复"按下→抬起"。常用于：半自动武器连发、快速拾取、刷技能/连击。「+ 添加连点键」新增，每个连点点位独立设触发键、位置、节拍。

连点触点触发键 + 在屏幕上的落点（点画布放置），就是连点时手指反复点的位置
模式按住连点(Hold)=按住期间一直连、松开停；Toggle=按一下开始连、再按一下停（适合长时间连点不用一直按）
间隔(ms)一个「按下→抬起」完整周期的总时长。越小越快（如 60≈16 次/秒）；太小会被游戏/手机吞点，按手感调
按下占比(%)一个周期里"按下"占的百分比（1–99）。50=按一半松一半；点击类调小、需要长一点按压的调大

建议留一点随机半径/抖动防检测；连点本质是高频规律点击，仍属辅助，请自行评估目标游戏风险。三端通用（上位机 / P4 单机 / 手机 APP 调参都支持）。

7.9　连招（顺序点击 / 滑动）收尾机制 P4 V1.8.0 / QInEX V1.2.1

按一个键,按你摆好的顺序把多个步骤依次执行一遍。快捷购买、技能连招一键放完。「+ 添加连招键」新增,每个连招由若干「步骤」组成,画布上显示编号圆点 1→2→3 + 虚线连线。

触发键 / 名称「按键绑定」获取 + 辨识名
触发方式按下执行(默认)=按一下整套放完,松键不打断,执行中重按忽略;按住循环=按住反复整套执行,松手停止继续循环
松手放完本轮仅「按住循环」生效。关闭=松手后尽快停;开启=松手后把当前这一轮剩余主步骤补完再停,避免招式放到一半
收尾步骤独立于主步骤的一组 finally 动作。无论正常结束还是中途松手,最后都会完整执行,适合收刀、关面板、切回主武器。留空=不执行
步骤类型点按(默认)= 在一个位置点一下;滑动P4 V1.6.0+ = 从起点按住划到终点再抬手
点按步画布拾取位置 +「间隔」(距上一步抬起的毫秒数,第 1 步=按键后延迟)+「按住」(该步按住时长)+「随机」(落点随机半径)。↑ 上移排序,× 删除
滑动步单独拾取起点 / 终点(各带随机半径)+「滑动时长」+「弧度」:0=直线,加弧度=轨迹带弯(垂直于连线方向鼓出),更像真手划屏。收尾自带小幅回勾(松手前反向带一小下、十几毫秒,拟人收笔)。适合转轮盘、拉滑条、搓技能轮、划屏翻页
抖动(±ms)每步间隔加随机抖动,防检测(固定节拍连招易被识别),0=关

说明整套连招同时只占 1 根手指(逐步执行、不同时按);可放进按键层。点按/滑动可在同一套连招里混排(点技能→划轮盘→再点确认)。仍属辅助,请自行评估目标游戏风险。松手放完本轮 / 收尾步骤需 P4 V1.8.0+ 或 QInEX V1.2.1+。P4 可执行点按/滑动步骤;电脑上位机/S3 当前执行点按步骤,但会保留配置中的 P4 滑动数据。S3 v5.0 请配套 QInEX V1.2.2+。

7.10　键冲突检查（左侧独立模块）

所有组件（按键映射 / 多态交互 / 按键层 / 轻触长按 / 手势 / 蓄力 / 连点 / 轮盘 / 拖拽键 / 自动奔跑键 / FPS 切换键）都从同一套键里抢键。同一个键被多处用 → 按固定优先级"先到先得"，可能误触发。左侧「键冲突检查」点一下，列出重复的键 + 谁会生效，改键避开即可。保存时若有冲突也会提示。

7.11　拖拽键（一键丢弃 / 固定拖动）V1.2.8 新 · P4 单机 + 手机 APP

按一下 = 自动完成「抓起 → 拖到指定点 → 松手」一整套动作。典型用法：绑到鼠标右键放进背包层，背包里右键点一下某件装备，就自动把它抓起、沿拟人弧线拖到丢弃区放手 —— 一键丢弃。

触发键 / 名称「按键绑定」获取（推荐 RMB）+ 辨识名
起点光标位置（默认）= 从光标当前指的地方抓起，指哪抓哪；固定坐标 = 起点终点都固定（例：地图层从屏幕中心拖到角落 = 挪地图）。两种模式都仅指针态生效（先进背包/地图等多态模式），FPS 视角下按了不触发
终点拖到哪（丢弃区 / 目标位），画布拾取
抓住停留 (ms)落指后先按住多久再开始拖。"长按才能拿起"类 UI 调大到 300~500，默认 100
拖动时长 (ms)拖过去用多久，默认 300。执行时自动 ±15% 随机，路径带弧线不走机器直线
到点停留 (ms)到终点后停多久再松手，默认 80
随机半径起终点落点随机偏移（防检测），默认 0.004

说明绑 RMB 时，该层内右键默认的"按住跟手拖"自动让位给它，退层恢复。支持按键层：放进背包层 = 背包里才生效，平时右键照旧。整套只占 1 根手指；执行中重按忽略。拖拽键是指针态专属组件——拖拽本来就是"用光标操作 UI"的动作，FPS 视角下按了一律不触发，也不会干扰该键在视角态的开火/开镜等功能。仅 P4 单机版（固件 V1.2.8+），在手机 APP 组件页 / 组件坞配置。

7.12　滚轮手势（捏合缩放 / 滑动）V1.2.8 新 · P4 单机 + 手机 APP

指针态（光标模式）下滚滚轮，在光标当前位置自动生成一个双指手势 —— 光标指哪，手势就以哪为中心，指哪缩哪。滚轮上 / 滚轮下各配一份。

手势双指捏合 = 两指张开（放大）/ 收拢（缩小），配地图缩放、查看物品；滑动 = 单指或双指往一个方向划（上/下/左/右），配背包、商店列表滚动
双指起始半距捏合模式两指落下时离中心多远，默认 0.10
双指角度 (°)捏合两指连线的角度（执行时 ±8° 随机），默认 45
每格位移滚一格手指移动多少（归一化），默认 0.05。想一格缩更多就调大
单格时长 (ms)一格手势做多久，默认 150

说明连滚合并：手势执行中继续滚，目标距离顺势加长、一气呵成，不会一格一格重启。支持按键层整组覆盖：基础层配一套，地图层可换成"捏合缩放"、背包层换成"上下滑列表"，不自定义的层跟随基础层。只在指针态生效；FPS 视角下滚轮仍走「鼠标滚轮配置」（第 08 章）和 WHEELUP/WHEELDOWN 组件玩法。指针态下手势独占滚轮：某方向启用了滚轮手势，指针态里这个方向的滚轮就只出手势——绑在 WHEELUP/WHEELDOWN 上的其他组件（手势键/轻触等）该格不再同时触发，防一格滚轮出两个动作；未启用的方向照常。仅 P4 单机版（固件 V1.2.8+）。

08鼠标滚轮配置

把鼠标滚轮的上滑 / 下滑分别绑定为屏幕动作。这是全局、不分层的简单做法。

还有更灵活的玩法除了这里的全局滚轮动作,滚轮上 / 下现在还能当两个可绑定键 WHEELUP / WHEELDOWN,去触发手势等组件;把手势放进某个扩展层就能做到"开镜时滚轮才切倍镜"。需要"只在某状态下滚轮才生效"就用那条路(见 7.3 / 实战教程);只要简单的全局滚轮动作就用本页。

模式 说明
无 (none) 不响应
点击 (tap) 滚一格 = 在指定位置点一下
滑动 (swipe) 滚一格 = 从 A → B 做一次短滑动（需在画布上点 2 个点）

下拉选模式 → 点「设置」→ 画布进入"等待点击"态 → 在底图上点位置即可。

滑动耗时 (ms)

整段滑动持续时间。默认 200。越短越"瞬移"，越长越"自然手指划"。

09宏系统配置

宏 = 一个触发键 + 一串动作（按下 / 抬起 / 移动 / 延迟 / 触摸 / 手柄 / …）。

基本信息

名称 随便起，方便辨识
触发键 VK Code；点「获取」再按任意键自动填
模式 Once 按下立即执行一次； Hold 按住不停循环； Toggle 按一下开始循环，再按一下停止； Sequence 按下时依次推进到下一个动作（手动节拍）
拦截原按键 勾选：触发键不再传给原映射（专属宏）；不勾：宏 + 原映射并行

动作类型一览

编号 名称 说明
0 延迟 (Delay) 等待 N 毫秒
1 / 2 / 3 KeyDown / KeyUp / KeyPress 键盘键按下 / 抬起 / 按下后立即抬起
4 移动 (Move) 鼠标绝对 / 相对移动
5 / 6 / 7 鼠标按下 / 抬起 / 点击 指定鼠标键
8 滚轮 (Scroll) 滚动指定距离
9 / 10 TouchDown / TouchUp 在指定归一化坐标按下 / 抬起虚拟手指
11 TouchClick 指定坐标点击
12 Swipe A → B 滑动 N ms
13 设置 FPS 模式 强制进入 / 退出 视角模式
14 设置遮罩层 显示 / 隐藏 Overlay
15 / 16 / 17 手柄按下 / 释放 / 点击 A / B / X / Y / LB / RB / LT / RT / Back / Start / LS / RS / D-Pad
18 StickMove 给手柄左 / 右摇杆赋值

注意触发键不要和「切换键 (ALT)」或「遮罩键 (F8)」冲突，否则会触发死循环或意外行为。编辑完动作后务必点「保存修改」。

10高级参数微调

传输 / 性能 / 全局热键。除非排错，否则大多保持默认即可。

传输

传输模式 硬件ESP32-S3 串口 · 免硬件ADB + UHID
串口号 硬件 ESP32 在 PC 上分配的 COM 号（设备管理器查）

ADB 配置 免硬件

USB 网络共享直连 完整版 手机开启"USB 网络共享"后，PC 走 RNDIS IP 直传触控帧，比 adb forward 延迟更稳。免验证版无此开关，默认走 adb forward
adb.exe 路径 / dex 路径 留空 = 用 exe 同级 tools/adb/adb.exe 与 qine-server.dex，一般无需改
本地端口 / 手机端口 adb forward 用的 TCP 端口，默认 27183。被占用时可改

屏幕 / 热键 / 遮罩

屏幕旋转 0 / 90 / 180 / 270，填手机当前显示方向。免硬件建议勾「自动旋转」由手机自报
切换键 默认 ALT。在"鼠标模式 ↔ 视角模式"之间切换（按一下开、再按一下关）
强制开 FPS 键 留空 = 不用。按下 = 强制进入视角模式（不是切换，多按不翻转）。可同时在「按键映射」给这个键配一个触点 —— 例如绑 ESC：按 ESC 既点一下某个位置、又确保回到视角模式
强制关 FPS 键 留空 = 不用。按下 = 强制退出视角进光标模式（同样不是切换）。一样可叠加自己的触点
灵敏度 + / - 键 V1.1.0 新 留空 = 不用。游戏里按一下就实时把视角灵敏度调高/调低一档（默认 5%，见下方「步进」），不用退出去改配置——边打边找手感。上位机：倍率作用于视角含开镜，会话内保留（重启软件恢复）；找到满意值后建议记进「视角灵敏度」永久保存。P4 单机版：调的就是板载页「实时灵敏度」滑块那个值（面板永远显示真值，板子记住、重启也在）；注意开镜灵敏度（ADS，7.5 节）是独立参数，开镜手感请直接调「开镜灵敏度」。
灵敏度步进(%) 灵敏度 ± 键每按一下变化的百分比，默认 5。
鼠标 DPI V1.1.0 新 填上你鼠标的 DPI（如 800 / 1600），视角手感就按 800 DPI 统一基准折算 —— 以后换鼠标、或改了鼠标 DPI，视角手感不会再乱掉；灵敏度的数值也从此有了固定参照。0 = 不折算（和以前完全一样，不填就是这个）。只影响视角瞄准，不动走路摇杆/轮盘。启用后需要重新调一次灵敏度（老配置的灵敏度数值是基于你旧 DPI 调的）。
遮罩键 默认 F8。显示 / 隐藏屏幕透明 Overlay
遮罩缩放 Overlay 总体缩放，默认 1.0
遮罩透明度 (%) 0 = 仅边框可见，100 = 不透明，默认 12
遮罩边框效果 勾选启用 RGB 流光
同步鼠标映射 勾：遮罩关闭时一并关掉鼠标点击 / 滚轮 / 视角等映射事件
误触 Ctrl+C 不退出 无需设置、自动生效：Ctrl+C 会被吃掉、不再退出软件（解决"误触 Ctrl+C 把程序关了"），且不影响键盘映射 / 打字。配套地，软件被任何方式退出（关窗 / 崩溃）都会自动还原系统光标，不会再出现"鼠标卡死要重启"。遮罩默认开机不显示，按遮罩键(F8)才显示

节拍 / 发送 全模式

自动刷新率 免硬件 让节拍跟随手机屏幕刷新率（60 / 90 / 120 Hz 自动）。优先级：自动 > 回报率 > 间隔
自动旋转 免硬件 屏幕旋转跟随手机实际方向，默认开
间隔 (ms) 每帧最大间隔。默认 8（≈125 Hz）。仅当上面两项都未启用时生效
回报率 (Hz) 每秒处理映射次数。0 = 用间隔；最大 8000。常用 125 / 250 / 500 / 1000
保活节拍 (ms) 静态触点最低重传频率。默认 20，多键场景偶尔丢帧时可降到 15
视角重置 uplift：抬手再落，兼容性最好（有几 ms 短暂停顿）
pingpong：双指交替，无停顿但瞬间有两个触点（部分游戏可能误判多指）
发送模式 async：入队即返回，节拍稳但高速移动时少数 MOVE 帧可能被合并丢弃（FPS 推荐）
sync：直接阻塞写，零丢帧但高峰期可能拖慢节拍（录屏 / 节奏游戏推荐）
回报率：是不是越高越好？
回报率就是"软件每秒处理多少次鼠标/键盘 → 触摸映射"。 可以理解为播放器的"帧率":太低画面卡，但超过显示器刷新率也没意义。 手机屏幕一般 60 / 90 / 120 / 144 Hz，所以软件回报率超过这个值之后，提升几乎感觉不到，只是徒增 CPU 占用。

不同需求的参考：

日常 / 省电
MOBA、手游、休闲
回报率 125 Hz
典型 CPU 极低
FPS 推荐
大多数 FPS 玩家最优解
回报率 500 Hz
典型 CPU 低
极致顺滑
120 Hz 高刷手机、想要最低延迟
回报率 1000 Hz
典型 CPU 中等
免硬件 + 高刷
推荐勾"自动刷新率"
回报率 跟手机
典型 CPU 低

反直觉提醒：125 → 500 提升明显；500 → 1000 微小；1000 → 8000 在大多数游戏里肉眼不可见。硬件模式串口带宽有限，超过 1000 反而可能丢帧；先求"稳"，再求"快"。

视角重置 uplift / pingpong：选哪个？
鼠标推到屏幕边缘必须"重新落手指"。这两种是"如何重新落"的两种风格：
· uplift（抬落）：先把手指抬起来，再放回中心 — 像写字时墨水笔抬起来再蘸一次，中间有一瞬空白
· pingpong（接力）：先用另一根手指按中心，再把原来那根抬走 — 永远有手指在屏幕上，无空白

如何选择：

  • uplift（默认 / 兼容性最好）：所有游戏都能用，转大圈时有几毫秒视角"卡顿感"
  • pingpong：转视角无缝衔接，但:
    • ⚠️ 硬件（ESP32-S3）模式重要提醒：部分手机的 USB 多点触控驱动不接受 pingpong 的"双触点交替"，会导致 S3 卡死、所有控制失效，必须把手机端 USB 拔插一次（重新枚举）才恢复。S3 模式请优先用 uplift；只有确认自己手机不卡时再考虑 pingpong。
    • 瞬间会有 2 个触点 — 极少数游戏会误判为"双指缩放"或"误触"
    • 建议先在野外/训练场测试再用
    • FPS 类大多无碍；MOBA 类不建议（缩放手势会被触发）

判断方法：开启 pingpong 后，进游戏快速大转身一圈，看视角是否流畅且没有意外缩放/缩小、以及手机有没有卡死。有任何问题就回 uplift。

保活节拍：通常不用动，几种场景下要调
当你按住某个键（如开镜）保持不动时，软件仍要定期"提醒"手机"我还在按"。 这个值就是提醒的频率。值大 = 省带宽 + 长时间按住更稳；值小 = 偶发丢帧时恢复更快。
场景 建议值 原因
默认 / 大多数游戏 20 ms 不动
硬件模式多键长按偶尔卡 15 ms 提醒更频繁，丢帧恢复更快
免硬件模式 + 网络稳定 30 ~ 50 ms 省 USB / TCP 流量，省手机功耗
蓝牙鼠标 / 不稳定环境 10 ~ 15 ms 更激进地补帧
发送模式 async / sync：什么时候选哪个
async（异步）像微信发消息——按下回车就不管了，转头干别的； sync（同步）像电话——必须等对方确认你才能说下一句。 绝大多数游戏 async 已经足够稳；只有"每一帧都不能丢"的极端场景才选 sync。
场景 选哪个
FPS / MOBA / 大多数手游 async（默认）
录屏做教程、严格保留每一帧 sync
音游 / 节奏游戏（节拍敏感） sync
串口偶尔卡顿、CPU 较弱 async

怎么判断你是否被影响：用「基准测试」跑一次，看"异常帧占比"。async 模式如果异常帧极少，就没必要切 sync。

触摸校准（接采集卡 / 外接屏后触点偏移）

手机插了采集卡或外接屏后，画面分辨率会变成采集卡的（比如手机原本 20:9、采集卡是 16:9）。游戏画面被等比缩小、上下（或左右）留黑边居中，于是你摆好的那套触点整体偏移——按键、视角全偏。不用重新摆点，在面板顶栏「触摸校准」里补一个几何变换就对齐了。

  1. 点面板顶栏 触摸校准 按钮打开子面板。
  2. ① 自动：填「画面原始分辨率」（你做这份配置时手机的分辨率，如 2400 × 1080）和「采集 / 投屏分辨率」（如 1920 × 1080）→ 点「自动计算」。程序按两者宽高比算出黑边占比，把触点压回画面内容区，多数情况这一步就对齐。
  3. ② 微调（可选）：若黑边不在正中、还差一点，手动调「上 / 下 / 左 / 右」黑边占比（0~0.45）对齐。
  4. 不想要了点「重置」清零。改完点主面板 「保存配置」 生效。

说明每个值是该侧裁掉的占比。只对"等比缩放 + 留黑边"有效（绝大多数采集卡场景）；若某游戏是按新比例重排了按钮位置（不是缩放），那只能按新比例重摆一份配置。不接采集卡 / 无黑边时四个值全留 0，零影响。

11vPointer 配置

可选的"在手机屏幕上画虚拟光标"的伴生 App。需先安装 vPointer App 才有效。

启用 勾选才会发送数据
IP 手机 IP。建议手机开 USB 网络共享，直连最稳
端口 默认 6533
旋转 0 / 90 / 180 / 270，与 vPointer App 内设置一致
协议 JSON v2（归一化，默认）：发归一化坐标，App 按手机真实分辨率自己缩放，不用再填参考分辨率、换屏不用改——需配 QInEScreen App v2 及以上。CSV（旧版像素）：发绝对像素，兼容老版 App。用新 App 默认 JSON 即可，连不上画面错位再切回 CSV 试。
自动发现 默认开。开启后监听手机 App 的广播，自动锁定手机 IP，免手填（手机一上线就连上）；上面的 IP 框作为收不到广播时的兜底。

桌面版需重装 DLL桌面版 JSON v2 走 VirtualPointer.dll 发送，请更新到随本版附带的新 DLL（放在 QInEX.exe 同目录）。若用的是旧 DLL，会自动回退成 CSV（JSON 发不出，但不报错）。P4 单机版无此问题。

12反作弊参数

让触摸"看上去像真人"。建议先用默认值，遇到问题再按下方场景调。

类比真人玩手机时：① 每次按按钮位置不会完全一样（手指有抖动）；② 滑动时方向和力度不会"机械精确"；③ 按住不动时手指会有微小漂移。这 6 个参数就是分别还原这三种"人类不完美"。

参数 说明（用真人的行为类比） 默认
点击随机偏移 每次点击按钮，落点不会一模一样。值越大越散；0 = 机械臂式每次完全相同 0.005
初始角度随机 按下 W 时角色不会瞬间正北笔直，会有几度偏。0.35 ≈ ±10° 偏转 0.35
初始半径随机 每次按 W，"推杆力度"会有些许差异，不会每次都顶满。0.1 = ±5% 力度波动 0.10
微动速度 按住按钮不动时"手指抖动"的频率（多快） 0.05
微动幅度 按住按钮不动时"手指抖动"的最大范围（多大） 0.008
微动延迟 (ms) 按下后多久才开始抖。真人按下瞬间手是稳的，按住一段时间后才会有微小漂移 1000
四套场景化预设：按你的需求挑一套
稳妥保守
日常游玩，无明显需求；想"看起来差不多就行"
点击随机偏移 0.005
初始角度随机 0.35
初始半径随机 0.10
微动速度 0.05
微动幅度 0.008
微动延迟 1000
更像真人
偶尔被识别"机械"，想让数据更分散一点
点击随机偏移 0.008
初始角度随机 0.45
初始半径随机 0.15
微动速度 0.06
微动幅度 0.012
微动延迟 800
极致拟人
极少数严苛环境；接受少许操作精度损失
点击随机偏移 0.012
初始角度随机 0.55
初始半径随机 0.20
微动速度 0.08
微动幅度 0.018
微动延迟 500
绝对精确
宏录制、节奏游戏；只要"每次完全一样"
点击随机偏移 0
初始角度随机 0
初始半径随机 0
微动速度 0
微动幅度 0
微动延迟 10000

另外的开关：「移动摇杆」的纯净模式会一次性强制清空所有反作弊扰动 + 关掉橡皮筋。需要"绝对精确"时勾这一个就够，不用挨个清零。

各参数变化时的实际效果

点击随机偏移

  • 0：每次点同一个像素 — 任何检测都能一眼识别
  • 0.005（默认）：落点在按钮直径 1% 范围内浮动 — 肉眼难辨
  • 0.015：明显散开 — 在小按钮上可能误触相邻按钮

初始角度随机（按 W 时角色起手方向）

  • 0：完全正北 — 起步轨迹笔直如尺子
  • 0.35（默认）：起手 ±10° 偏转 — 自然
  • 0.7：起手 ±20° 偏转 — 走路像喝多了

微动幅度 / 速度 / 延迟（按住不动时的"手抖"）

  • 幅度 0：按住时一动不动
  • 幅度 0.008（默认）：肉眼几乎看不出
  • 幅度 0.02：可见的小漂移 — 可能影响精确架枪
  • 延迟 1000（默认）：按下后 1 秒才开始抖 — 按瞬间是稳的
  • 延迟 0：按下瞬间就开始抖 — 不自然，不推荐
P4 移动摇杆拟人层（自动，无需配置）

P4 单机固件在移动摇杆上额外内置了 4 项拟人细节，不需要任何配置——只要「微动幅度」>0 且没开「纯净模式」就自动生效（幅度随微动幅度缩放）；开纯净模式或微动幅度清 0 则整层关闭、恢复精确手感：

  • 生理震颤：持握期触点带 8~12Hz 微幅抖动（每次按下随机换频率/相位），模拟真人拇指无法绝对静止。
  • 起杆路径波动：起步/换向的拖动轨迹不再是干净的弹簧曲线，途中带 1~2 个自然弯，到位后自动消失、不影响持握位置。
  • 回滑抬指：松开方向键时触点先朝圆心回缩 5~15%（12~30ms 内完成）再抬起，消除"满偏位置凭空消失"的机器指纹；时长约等于游戏 1 帧，急停手感无感。
  • 瞬切拆帧：「响应手感=脆」和「急停反向瞬切」的大跳变拆成 2~3 个带侧偏的中间样本（全程 ≤3ms），游戏侧等效仍是瞬切，触摸日志里却是一次真实的极速滑动。
  • 弧线换向（V1.2.5+）：45°/90° 级方向切换时触点沿轮盘圆弧滚过去（约 90~130ms，角速度每次随机），替代"直线弦抄近路"的机器人多边形轨迹；180° 反向仍直穿中间（真人反向本来就抄中路），急停瞬切/纯净模式不受影响。

以上全部计算走低频节流路径，对视角流畅度与出帧节奏零影响。

防呆护栏（V1.2.5+）：「弹簧刚度」调太高或「阻尼」调太低会让弹簧欠阻尼——触点在顶点来回过冲画"针刺"、斜向换向绕圈画"漩涡"，一眼机器轨迹。固件已内置阻尼下限自动拦截病态区（保留 ~5% 轻微过冲，似真人小回勾），随便调参数都不会再出现针刺/漩涡；追求更快到位请调高刚度即可，无需把阻尼压到底。

担心被检测？所有值按 30%~50% 适度上调即可。

想要绝对精确？所有值清 0 + 轮盘开「纯净模式」。

13手柄映射配置

把键盘按键映射为 XInput 虚拟手柄按钮。

前置「基础设置」→ 输出模式切到「手柄」。硬件模式 ESP32 固件也需切到 Gamepad 模式；免硬件模式暂仅支持触摸输出。

按键映射

「+ 添加映射」选键盘按键 ↔ 手柄按键：A / B / X / Y / LB / RB / LT / RT / Back / Start / LS / RS 及 D-Pad 四向。

摇杆

  • 左摇杆：WASD（含切换键修饰）自动映射
  • 右摇杆：FPS 模式下鼠标移动；灵敏度 / 加速度沿用「视角区」参数

14基准测试

量化你的电脑 + 硬件 + 配置的真实性能。

点「开始基准测试」后顺序采集两阶段：

  1. 空闲态 500 帧（约 4 秒）
  2. 模拟 WASD + FPS 满载 500 帧（约 4 秒）

测试期间请勿操作其他程序、勿切窗口。输出指标：

  • 平均帧间隔 (TickerLoop)
  • 单帧处理耗时
  • 串口写入耗时 硬件
  • 网络写入耗时 免硬件
  • 异常帧占比

异常诊断速查

平均帧间隔 >> 1000/Hz 系统电源 / 进程优先级问题；改电源计划为"卓越性能"
串口写入耗时 > 3ms 换线 / 换 USB 口 / 关蓝牙 / 关 USB 选择性挂起
网络写入耗时 > 5ms 开启「USB 网络共享直连」试试

15ScreenHub 投屏窗口 完整版

把手机屏幕镜像到 PC，并在 PC 端用鼠标"所见即所点"操作真机。

仅完整版本章所述功能仅完整版（QInEX-V.exe）可用。免验证版的 Console UI 没有投屏开关按钮，mirror.json 也不会被读取。如果你用的是免验证版，可直接跳过本章。

开启

Console UI（黑色终端窗口）底部 ♥ 语言按钮旁边的开关按钮按一下，即弹出 ScreenHub 窗口。再按一下关闭。

窗口特性

  • 无边框，自动锁定宽高比，首帧自动居中
  • 鼠标靠近边缘时弹出 Hub 工具条，离开自动隐藏
  • 拖拽 Hub 工具条空白处 = 移动整个窗口；拖拽窗口边缘 = 调整窗口大小

工具条按钮（Segoe MDL2 Assets 图标）

⚙ 设置 展开内含：分辨率 / 码率 / 帧率 / 编码 / 模式 / 操控热键 / USB 网络共享 / 应用
⤢ 全屏 全屏 / 还原
📌 置顶 窗口 Topmost
🔑 关键帧 强制下一个关键帧（画面花屏时按一下）
🪟 停靠 Hub 停靠位置循环（上→右→下→左→上）
控制开关 开启"鼠标所见即所点"模式

设置面板

  • 分辨率 / 码率 / 帧率 / 编码（H264 / H265）/ 模式
  • 操控热键：点「绑定」再按键盘任意键即可完成绑定。默认无热键，Esc 永远是安全退出
  • USB 网络共享：勾选后走 RNDIS + UDP 视频（延迟更稳）
  • 应用：仅码率改动会"热更新"；其他改动会持久化 mirror.json 并在不关窗口前提下重连一次

快捷键

S 打开 / 关闭设置面板
F 全屏 / 还原
T 置顶
K 强制关键帧
D 停靠循环
+ / − 调整码率
Esc 逐级退出：操控 → 全屏 → 设置面板

控制模式安全机制进入控制模式后鼠标被锁定到投屏画面内部。唯一退出方式是键盘 Esc 或你绑定的操控热键，鼠标点击不能退出。这是为了防止你不小心点出画面打断游戏。

配置文件投屏使用独立配置 mirror.json（位于 exe 同级目录），与主 config.json 互不影响，不进入 Web UI，不参与"保存配置 → 重启"流程。

16快捷键 & FAQ

全局快捷键

ALT 切换 鼠标模式 ↔ 视角模式（可在「高级参数」改）
F8 显示 / 隐藏屏幕遮罩 Overlay（可在「高级参数」改）
Esc 取消画布上的"等待放置"等待态 / 取消选中
Delete 删除画布上选中的组件

配置面板技巧

  • 工具栏标题栏拖拽 = 移动工具栏；右上角 − 折叠
  • 子面板的标题栏也可以拖
  • 保存按钮变橙色 = 你有未保存的改动

卡顿 / 延迟排查（重点 · 对号入座）

先分清卡在哪一段卡顿分三段,排错顺序固定:① PC 端处理(回报率/发送模式/CPU占用)→ ② 传输(硬件 USB 线材口 / 免硬件 ADB 转发)→ ③ 手机端(省电降频/后台清理/画质)。大多数"卡"其实是回报率设太高 + 手机端省电,这两条先查。

症状 最可能原因 先试这个
触摸点黏、慢半拍、拖枪不跟手 出帧缓冲 / 回报率 S3 板子:板载页「出帧模式」切丝滑;回报率设 1000;发送模式选异步
视角忽快忽慢、抖 回报率不稳 / 加速度 回报率固定 1000;关或重调加速度曲线;P4 板载页开稳帧
整体掉帧、电脑发烫、CPU 高 回报率拉太高(如 8000)反噬 回报率降到 1000~2000;关录屏/直播/杀毒实时扫描
免硬件(ADB)模式延迟大 TCP 经 adb forward 转发 完整版开USB 网络共享直连;开自动刷新率;线插主板 USB3 直出
投屏画面卡(不影响触摸) 码率/分辨率/编码/WiFi 降分辨率+码率;编码选 H.265;靠近路由走 5GHz
怎么调都卡 手机端 / 线材 / USB 口 见下方「手机端」「线材」两条
触摸点"黏"、点了慢半拍、拖枪跟不上手?

这是出帧缓冲带来的延迟,按你的硬件分:

  1. S3 硬件接收器:进板载配置页(开机按住 BOOT → 连热点 QInE-Touch-Config)把「出帧模式」切成「丝滑」 → 近乎零缓冲、最跟手(详见「S3 板子 · 板载配置页」章)。
  2. PC 端通用:「高级参数微调」把回报率设 1000(不是越高越好,见下条);发送模式选「异步」。
  3. 免硬件模式:打开「自动刷新率」让出帧跟随手机刷新率。
回报率(pollingRate)是不是越高越好?设 8000 反而更卡?

不是越高越好。回报率越高,PC 每秒要处理/发送的帧越多,很多电脑 CPU 跟不上,反而出现抖动、忽快忽慢、掉帧。经验:先用 1000,手感稳了再往 2000 试;一旦发烫/变卡就往回降。8000 只适合高端 U + 真有 8000Hz 鼠标的场景,普通机器别上。

"发送模式"同步 / 异步 选哪个?和卡顿有关吗?

有关。异步(默认推荐):移动帧可合并、不阻塞主循环,更跟手,极限情况下可能丢一两个中间帧(对连续移动无感);同步:一帧不丢但发送时会阻塞,偶尔出现顿挫。觉得卡 / 顿就用异步。

免硬件(ADB)模式特别卡、延迟高?
  1. 完整版「高级参数 → ADB 配置」勾上 USB 网络共享直连(RNDIS):绕开 adb forward 的端口转发,延迟明显更低。
  2. 打开 自动刷新率(pollingAuto),让出帧节拍跟随手机实际刷新率。
  3. 数据线插主板后置 USB3 口,别走前置面板 / USB hub / 劣质延长线。
  4. 免硬件本质是软件路径,延迟天花板高于硬件;真要极致跟手,上 S3 / P4 硬件版。
用了 S3 硬件接收器还是卡?
  1. 板载配置页把「出帧模式」切「丝滑」(最有效)。
  2. 换质量好的数据线,插主板直出 USB 口(别用机箱前置、hub、延长线 —— 这些最容易导致丢包/掉帧)。
  3. 确认 PC 程序是管理员权限运行(否则部分游戏会吞掉底层输入,表现像卡顿丢操作)。
视角忽快忽慢、像在抖?

多半是回报率不稳或加速度曲线导致,不是"卡":

  1. 「高级参数」回报率设固定 1000(别用过高值)。
  2. 视角属性里关掉或重调「加速度曲线」(全 1 = 等同关闭加速度)。
  3. P4 单机版:板载配置页打开「稳帧出帧」。
电脑 CPU 占用高 / 发烫,然后就卡?
  1. 回报率从过高值降到 1000~2000。
  2. 关掉同时在跑的录屏 / 直播推流 / 杀毒实时扫描(它们抢 CPU)。
  3. 不需要看手机画面时关掉投屏(投屏解码吃 CPU/GPU)。
手机端卡(画面 / 触控跟不上)?

这类是手机侧因素,PC 怎么调都没用:

  1. 给游戏 / app 关后台清理、关省电模式、设高性能(很多手机省电会偷偷降触控采样率)。
  2. 手机发烫降频会卡 —— 散热 / 别边充边玩。
  3. 游戏画质 / 分辨率 / 帧率档位降一档。
  4. 关掉手机里其他后台 app。
投屏(ScreenHub)画面卡,会拖累触摸吗?

不会 —— 投屏和触摸是两条独立通道,投屏卡不影响点击/视角的及时性。投屏想更流畅:设置面板降分辨率 + 码率、编码选 H.265(同画质更省带宽)、PC 与手机都靠近路由走 5GHz WiFi。

常见问题

完整版和免验证版有什么区别？该用哪个？

两者核心触摸 / 视角 / 宏 / 反作弊功能完全相同，区别只有三处：

  1. 启动验证：完整版需 QQ 群扫码；免验证版直接进入。
  2. 投屏 ScreenHub：仅完整版有（本指南第 15 章）。免验证版的 Console UI 没有投屏开关。
  3. USB 网络共享直连：仅完整版的"高级参数 → ADB 配置"里有此勾选项；免验证版固定走 adb forward。

怎么选：需要投屏或想用 USB 网络共享降延迟 → 完整版；只用键鼠映射 / 不想扫码 / 想极简 → 免验证版。两版本的 config.json 完全兼容，可以无缝迁移。

免验证版启动没出现 QQ 扫码窗口，正常吗？

正常。免验证版去除了 QQ 验证流程，启动后会直接进入配置面板，无需任何账号操作。

免验证版能用投屏功能吗？

不能。投屏 / ScreenHub / mirror.json 相关功能全部在免验证版被移除，相关代码不存在。如果你需要"PC 看手机画面 + 鼠标点点点"的能力，请用完整版。

按键摆好后游戏里没反应？
  1. 是否点了「保存配置」？
  2. 输出模式是不是「触摸屏」？
  3. 参考分辨率是否与手机一致？
  4. 是否在游戏内、且程序是管理员权限运行？
切换键 ALT 在某些游戏里冲突？

「高级参数微调」→ 切换键 改成别的，例如 \ 或 Caps Lock。

视角晃动不流畅？
  1. 「高级参数」回报率设到 500 ~ 1000 Hz
  2. 视角属性里调整「灵敏度」和「加速度曲线」到适合自己的手感
  3. 免硬件模式打开「自动刷新率」
免硬件模式连不上手机？
  1. 先在 cmd 跑 adb devices 确认能识别设备
  2. 拔插 USB 后重启 QInEX
  3. 看「设备激活 & 状态」的具体错误提示，按提示处理
反作弊扰动会影响精度吗？

默认数值很小，几乎察觉不到。如确实打不准，开「纯净模式」即可关闭所有扰动。

切换配置文件会丢失改动吗？

会。切换前请先点「保存配置」。

投屏窗口的"控制"模式怎么关？

Esc 或你在设置面板绑定的操控热键。鼠标点击退不出来，这是防误触机制。

多个手柄按键能映射到同一个键盘按键吗？

不能。同一键盘键只能映射一个手柄按键。但同一键盘键可以映射多个触摸点。

改了投屏分辨率 / 码率没生效？

仅码率是热更新；其他改动需要点设置面板里的「应用」按钮，或重新打开投屏。

P4P4 单机版固件 · 板上配置面板 单机

ESP32-P4 单机版(硬件费用120￥):不需要电脑。键鼠直接插板子,板子内部完成映射后把触摸发给手机。配置不再靠 PC 程序,而是用手机/电脑浏览器连板子自带的 WiFi 配置页。

它和 PC 上位机什么关系P4 单机版吃同一份 config.json(用 PC/服务器配置面板做好键位后导出),板内映射逻辑逐项复刻 PC 上位机(视角 / WASD 摇杆 / keyMap / 鼠标轮盘 / 滚轮 / 拟人化全有)。所以:用电脑配键位 → 导出 json → 导进 P4 → 拔了电脑单机玩。

先烧对固件ESP32-P4 有两个互不兼容的芯片版本,固件也分两个,烧错会卡在重启死循环、连不上配置页:
· QInEX-P4-ModeA-v4.0.bin —— v1.x 老芯片(2024 批次,多数现有板子)
· QInEX-P4-ModeA-v4.0-v3.bin —— v3.x 新芯片(2025 批次起,eco6+)
判断:串口工具(115200)看开机第一行 ESP-ROM:esp32p4-ecoN —— eco2 一类用前者,eco6 或更高用后者。或更省事:开机串口反复刷 rst:…CHIP_LP_WDT_RESET 死循环、连不上,就是版本烧错了,换另一个 bin 重烧。 详细烧法见固件包里的 烧录说明.md。

进入配置页(四个入口)

板载配置页是板子内置的网页,哪条网络通就走哪条,四个入口打开的是同一个页面:

入口地址说明
① 板子热点(保底)http://192.168.4.1连 WiFi QInEX-P4-Config(密码 12345678)。免访问密码。热点永远开着,板子连上路由器也不会关。
② 板子连路由器 WiFihttp://<WiFi路由IP>在面板「网络」页让板子连上家里 WiFi 后,同局域网任何设备可访问。IP 看 kmboxNET 卡片「WiFi 路由」一行。
③ 网线直连电脑http://192.168.2.188网口默认直连模式,板子自带 DHCP,电脑插线即通。
④ 网线接路由器http://<网口IP>面板切「网口:路由模式」后由路由器分配 IP。

访问密码从路由器 WiFi / 网线(入口②③④)打开配置页需输入访问密码,默认 qinghebaba,「系统 → 访问密码」可修改;连板子热点(入口①)免密——APP 走热点,完全不受影响。忘了密码:恢复出厂即回默认(设备授权保留)。它防的是同局域网路人乱改设置,网吧等公共网络别长期挂路由模式。

面板按 状态 / 调参 / 配置 / 网络 / 系统 五个标签页分类,点顶部标签切换;右上角 ◐ 按钮切换主题(暗色 / 亮色 / 手绘)。

5 步快速上手

  1. 接线:跳线 H3 = HOST;键鼠插板子 USB-A 口;手机插 H2 USB-C 口。
  2. 连配置页(见上)。
  3. 激活设备(未激活不输出触摸 → 见下"设备激活")。
  4. 导入从 PC/服务器面板导出的 config.json(见"导入配置")。
  5. 进游戏,按 ALT(默认 toggle 键)切换视角模式。手感不对就在面板拖"灵敏度"。

键鼠选择 · V1.8.16+V1.4.0 起「USB 全速兼容模式」默认开启,普通办公键鼠、无线 dongle、1000Hz 鼠标通常即插即用。只有真 8000Hz 高速鼠标想跑满回报率时才考虑关闭该模式。V1.8.16 进一步加强复合键鼠、多接口/多 Report ID、异常短报文和多键盘兼容;出现部分键不认或快速点按漏掉时先升级固件,再看「输入监控」或跑 APP 一键自检。

面板各卡片说明

标签页 卡片 作用 / 何时用
状态 设备信息 固件版本、MAC、空闲内存、USB 挂载、已导入配置字节数、激活状态、当前生效 VID/PID。
输入监控 调试 实时显示识别到的键鼠(如 MOUSE@2(boot) KEYBOARD@3)、当前按下的键、鼠标键/位移、帧数。排障:设备栏空 = 没认到设备(换 HS 键鼠);有按键显示但手机无触点 = 映射或未激活问题。
系统 设备激活 未激活时不输出触摸。当前用 ① 手动激活:复制「设备码」交客服换激活码,填入即可。
② 在线激活(填家里 WiFi → 连接 → 点「在线激活」自动取码)暂不可用 —— 激活服务器还没搭建,先用手动激活。「连接网络」也可用于局域网联机(NET)。
配置 导入配置 选 PC/服务器配置面板导出的 config.json → 导入并重启。这是 P4 的键位来源。
存储卡(TF 卡配置仓库) V1.3.0+ 插 TF 卡 = 多配置档仓库:「存入」把当前生效配置存成一档,列表里点「应用」切档(重启生效)、「删」清理。不插卡一切照旧(生效配置永远在板内,SD 只是仓库)。FAT32 卡即插即用;64GB+ 的 exFAT 大卡首次挂不上时点「格式化」清卡转 FAT。一键换机:卡根目录放 QINEX/autoload.json(任意配置档改名),开机自动导入并重启生效,导入后自动改名为 autoload.applied.json 防止重复导入。拔卡前先点「卸载」。
调参 灵敏度(实时) 拖滑块即时生效并保存,无需重新导入或重启。调视角手感最常用。0 = 用 config.json 里的灵敏度。
屏幕旋转(实时) 0 / 90 / 180 / 270 四档,即时生效并保存。横竖屏方向不对时调。
出帧档位 P4 单机的出帧节拍,四档:默认 / 高档 / 超高 / 极速。档位越高视角越跟手、延迟越低,即时生效并保存(不重启)。极速是实验档(红色按钮):CPU/发热更高、WiFi 协处理器高负载下可能不稳,建议自测后再常用;默认档最稳。P4 节拍只看这里,不受电脑端配置(回报率/间隔)影响。
触摸校准 接采集卡/外接屏后画面比例变了、触点整体偏移时用:填采集卡分辨率「自动计算」黑边;不对称再手调上下左右黑边(%)。详见下方「触摸校准」。即时生效并保存。
系统 HID 设备信息(设备信息) 改手机看到的触摸屏 VID/PID/厂商/产品名。支持:编辑当前、随机填充、存多套套餐自由切换、每次开机随机(从套餐里随机选一套,身份每次变)。改后需重启重新枚举。
网络 kmboxNET 网络控制 网络 把 P4 当 kmboxNET 盒子:已适配 kmboxNET 的软件用 kmNet_init(IP, 端口, 盒子MAC) 连本机,鼠标/键盘命令经网络 → 映射 → 手机触摸。WiFi 与网口同时在线,详见下方「kmboxNET 用法」。可选「网口模式(直连/路由器)」「强制加密」。
vPointer 光标 可选 关 FPS(toggle 键)进光标模式:鼠标移动 → 手机出现可见光标、左右键点击拖拽,用于点菜单/背包。需手机装 vPointer app + 与板子同网。默认关、不用则手机无需装任何 app。可选坐标协议(JSON v2 归一化默认 / CSV 旧版像素)与自动发现(默认开,监听广播自动锁定手机 IP,免手填)。
呼出复位:每次呼出指针回到画面中心、不停在上次位置——「跟随配置」=用导入 config 里的设置;「强制开 / 强制关」=板载覆盖,即时生效、不用重推配置。
光标偏移:光标和真实触摸落点固定差一截时用,拖到光标正好压在落点上。归一化(占屏比例),正 X=右、正 Y=下,只动光标显示、不动触摸坐标。
测试光标:点一下,手机上光标描一圈 + 点一下,动了即连通。
系统 固件升级 网页选官方提供的升级固件(.bin) → 上传升级,免接线。升级中勿断电,完成自动重启。
调试 开启后串口(921600)打印键鼠原始 HID 报告。键鼠不工作时打开,把日志反馈给开发者。
设备控制 立即重启 / 恢复出厂(清空激活、导入配置、灵敏度、HID、vPointer、网口/kmboxNET 等全部设置)。

设备信息推荐玩法先在「HID 设备信息」里存几套不同身份(填几个真实设备的 VID/PID + 名称,各点「存为一套」),再打开「每次开机随机」——每次上电就从套餐里随机换一套,手机端看到的触摸屏信息纹不固定。

进阶:上位机直驱 Mode C(V1.7.0+ · 默认关)

键鼠留在电脑,电脑运行 QInEX-Link 转发原始键鼠信号,P4 仍用板内映射引擎处理,再以最高 8000Hz 输出给手机。适合追求高回报率且接受电脑常驻的玩家;普通用户保持单机模式即可。

  1. 板载页「系统」开启「上位机直驱模式」。
  2. 跳线 H3 拨到 DEVICE;手机改插板子 USB-A 口。
  3. 电脑运行最新版 QInEX-Link,选择回报率,然后重启 P4。

V1.8 系列稳定性已修复 WASD 弹簧时间基准、连接心跳误判、偶发乱输入和快速点按漏边沿。使用 Mode C 时请把 P4 固件与 QInEX-Link 一起更新,不要只换其中一端。

P4 单机版 vs PC 上位机

PC 上位机 P4 单机版(Mode A)
是否要电脑 要(常驻运行) 不要(键鼠直插板子)
配置方式 PC 程序配置面板 板上 WiFi 配置页 + 导入 json
映射逻辑 原生 复刻 PC,行为一致
键位来源 直接在面板编辑 导入 PC/服务器导出的 config.json
手机端 免 root 免 app(vPointer 除外) 免 root 免 app(vPointer 除外)

kmboxNET 用法(把 P4 当网络盒子)

已适配 kmboxNET 协议的软件可直接把 P4 当盒子用:在「设备」标签打开 kmboxNET 开关,然后在你的软件里调用 kmNet_init(盒子IP, 端口, 盒子MAC)——鼠标/键盘命令经网络送进板子,走完整映射后变成手机触摸。盒子 MAC 在该卡片显示。

连接方式 盒子 IP 填什么 说明
网口直连
(默认推荐)		 192.168.2.188 网线直插 PC 与板子。板子固定 IP + 自带发 IP:PC 网卡设「自动获取」即上线,或手动配 192.168.2.x 静态。能 ping 通即连通。
网口接路由器 面板「网口直连」行显示的地址 「设备 → 网口模式」切到路由器(自动),板子接路由器自动拿 IP,PC 与板子同路由器即可连。
WiFi 直连 192.168.4.1 PC 连板子热点 QInEX-P4-Config 后用此地址。
WiFi 同路由 面板「WiFi 路由」行显示的地址 板子在「激活」标签连了家里 WiFi、PC 也在同一路由器时用。

不用纠结选哪个WiFi 与网口同时在线,「设备 → kmboxNET」卡片会列出所有可用地址,挑一个能 ping 通的填进 kmNet_init 即可。

加密默认明文与加密(XXTEA)自动识别,普通 kmNet_* 和加密 kmNet_enc_* 调用都能用。开启「强制加密」后只接受 kmNet_enc_* 命令(防局域网抓包),改动需重启生效。

物理回读(给第三方软件用)

有些第三方软件需要先知道你的物理按键状态,再决定如何向盒子发送鼠标/键盘指令。键鼠插在板子上,板子就负责把物理键鼠状态回报给软件——软件调 kmNet_monitor(端口) 即可读到。「设备 → kmboxNET」卡片的物理回读行在软件接入后会变绿(显示「第三方已连接」)。

回传频率 含义
合并(默认) 多次输入合并上报,省流量,日常够用。
实时 每次物理输入都立即上报,延迟最低、最跟手,适合高要求场景。

面板「回传频率」按钮实时切换,无需重启。

手机出现"幽灵触点" / 没插鼠标也像在动?这是视角自动回中时间(config 里的 autoReleaseTimeMs)设成了 0 —— 板子会在屏幕中心一直按住一个视角触点(哪怕没动鼠标)。把它改成大于 0(例如 800 毫秒):空闲一会儿就自动抬起,既不会误触手机、也不空耗资源;一动鼠标视角立刻恢复。

手机 APP 配置(QInEScreen 1.1 · P4 映射配置)

不用电脑——QInEScreen 1.1 内置原生触屏编辑器。手机连 P4 热点后,可以摆键位、管理高级组件、游戏内调参、一键自检、套用离线预设,并使用 P4 独占的「QInEX 个性摇杆模型」。

  1. 手机安装 QInEScreen APP → 主页点「P4 映射配置」卡片。
  2. 首次验证:连 P4 热点 QInEX-P4-Config(密码 12345678)→ 点「验证」。已激活的 P4 自动通过,本机记住、之后不再验证(未激活会提示先到板载面板激活)。
  3. 先看就绪页:确认 P4 在线、已激活、USB/当前配置/校准状态正常;异常项按页面修复入口处理。
  4. 布局页配键位:点悬浮「组」气泡展开组件坞,把组件拖到画布;拖动移位、轻点弹属性卡、选中后双指捏合改大小、空白双指缩放画布。
  5. 推送:「配置档」页 →「推送当前档到 P4」,按页面提示重启后生效。实时调参可在悬浮窗里先预览再保存。
页面 干什么
就绪 开玩前状态中心:在线 / 激活 / USB / 当前配置 / 校准一页看清;常用任务和一键自检入口。
布局 全屏画布摆键位,可导入游戏截图当底图;摇杆 8 方向形状、视角加速度曲线都有专属的触屏拖拽编辑器。
组件 多态 / 轻触长按 / 手势 / 蓄力 / 按键层 / 连招 / 连点 / 压枪 / 固定弹道 / ADS / 滚轮 / 键冲突检查,以及 QInEX 个性摇杆模型。
配置档 多套配置切换 / 推送 / 拉取 / 导入导出 config.json;内置离线游戏预设;板子地址和访问密码设置。
设备 打开板载面板,处理激活、HID、固件升级、网络与其他设备维护。

地址 / 401 / 404连热点时地址推荐只填 192.168.4.1,不要附加 /api/...;局域网填板子 IP 或 IP:端口。局域网访问提示 401 时填写板载访问密码(默认 qinghebaba)。QInEScreen 1.1 已修正粘贴完整 URL/末尾路径导致的偶发 404。P4 连接家用路由器只支持 2.4GHz WiFi。

游戏内调参悬浮窗 2.0 + 一键自检

从 APP 主页或「就绪」页进入调参悬浮窗,可缩成“准 / 键 / 感”小球:做两点自动/手动校准、拖动/新增/修改/删除键位、实时预览鼠标灵敏度。P4 V1.8.14+ 调试时先只改内存,点「完成并保存」才永久保存;点「放弃」恢复原设置。

「一键自检」通常约 5 秒。检测时移动鼠标并按几下键,APP 会检查激活、USB、键鼠、映射、内存、触摸输出、校准、网络与光标接收,并给出修复入口和可分享报告。复合键鼠/快速点按异常建议升级到 P4 V1.8.16+。

QInEX 个性摇杆模型(P4 V1.9.0+ 独占)

入口:组件 → QInEX 个性摇杆模型。APP 采集你本人推动移动摇杆时的起杆、保持、换向和松手,在手机本地训练,提供默认引擎与个性模型 A/B 预览,再把最终模型部署到 P4。它的目标是更接近真实人手行为,不是简单追求“丝滑”。

  1. 摆采集区:默认跟随当前配置中的移动摇杆;也可选“手动拖动”放到真实游戏的左下角/左半屏。开始采集后位置锁定,不影响采样。
  2. 完成基础 36 次:包含方向推动、连续换向、持续保持与松手。无效动作当场提示且不计数;之后只补采低置信项目,通常总量约 44 次,极端最多 56 次。
  3. 本地训练与预览:训练的是几十段二维触摸时间序列,通常几秒完成。原始轨迹只在当前过程内存中使用,不上传云端;完成/取消后不保留原始轨迹。
  4. 部署:查看最低方向/换向与建议强度后部署到 P4,按提示重启;页面可启用、停用或删除 P4 模型。
65% / 85% / 100%是模型应用强度,不是质量分。你选择的是请求上限,APP 会按训练置信度自动限制
选 85% 却显示 65%整体可信度低于 78%或最弱方向低于 68%时的安全限幅。打开效果预览找薄弱项,按提示补采后重训
提示转向样本不足换向动作不要抬手;等目标切换后连续转过去。方向动作推到目标附近停稳再松,长按保持约 1.2 秒
部署后没效果检查 P4 V1.9.0+、已部署并重启、模型已启用/已加载;移动摇杆开启「纯净模式」时个性模型不会运行

安全边界个性模型能减少固定模板和完全机械节拍,但不承诺规避任何游戏检测。置信度限幅是保护机制,不建议绕过;请遵守目标游戏规则。

配置分享(APP「配置档」页)

把整份配置档发给好友,四种方式任选;导入方在「配置档」页选对应入口即可,导入后成为一个新配置档:

分享码纯文本一长串,QQ / 微信 / 任意渠道直接发,对方粘贴导入
分享文件导出成文件发送(QQ / 微信 / 网盘均可)
分享图配置藏在一张 .png 里,好看好发。务必以「文件 / 原图」方式发送——被聊天软件压缩后配置数据会丢,导入失败
在线 6 位码上传后生成 6 位短码,对方输码即得。需手机能上网,仅已激活 P4 的用户可上传
游戏内键位码选填的附带字段:游戏自己的控制 / 灵敏度分享码,对方导入配置后一键复制、粘进游戏设置里
加载次数上限选填:限制这份分享最多被导入几次(0 = 不限)

触摸校准(接采集卡 / 外接屏后触点偏移)

手机/平板插了采集卡或外接屏后,画面分辨率会变成采集卡的(比如手机原本 20:9,采集卡是 16:9)。游戏画面被等比缩小、上下(或左右)留黑边居中,于是你导入的那套触点整体偏移——按键、视角全偏。这不用重新摆点,在面板「映射 → 触摸校准」里补一下即可(纯几何缩放,一个变换就对齐)。

  1. 面板「映射」标签 → 触摸校准 卡。
  2. ① 自动:填上采集卡的分辨率(如 1920 × 1080)→ 点「自动计算」。板子按"配置原始分辨率 vs 采集卡分辨率"算出黑边,把触点压回画面内容区。多数情况这一步就对齐了。
  3. ② 微调(可选):若黑边不在正中、还差一点,手动调「上 / 下 / 左 / 右黑边(%)」对齐。
  4. 不想要了点「恢复默认(不校准)」。全程即时生效并保存,不重启。

说明「配置原始分辨率」= 你做这份配置时的手机分辨率(配置里自带);自动计算就靠它和采集卡分辨率的比例差。只对"等比缩放 + 留黑边"有效(绝大多数采集卡场景);若某游戏是按新比例重排了按钮位置(不是缩放),那只能按新比例重摆一份配置。

官网更多教程、配置导出与固件更新见官网 qinetouch.qinghe.ink。

S3S3 板子 · 板载配置页 板载

硬件模式(默认)的 ESP32-S3 接收器板子自带一个 WiFi 配置页,用来改 USB 身份伪装、运行模式、出帧模式(触控手感)、设备激活、WiFi 配网。配置存在板子里(掉电不丢),改完重启生效 —— 和电脑端 PC 程序的设置互不影响。

进入方式:开机白色LED亮的时候按 BOOT配置页和正常触摸是互斥的两种开机模式:
· 进配置页:按住板子 BOOT 键再上电,板子进入配置模式(WiFi 热点亮起)。
· 正常使用:不按 BOOT 直接上电,板子进触摸接收模式(此时没有配置页)。
所以流程是:开机白色LED亮的时候按 BOOT 开机 → 连配置页改设置 → 保存 → 断电重新上电(不按 BOOT)→ 新设置生效。

进入配置页

  1. 开机白色LED亮的时候按 BOOT 给板子上电,进入配置模式。
  2. 手机/电脑连 WiFi 热点 QInE-Touch-Config(密码 12345678)。
  3. 浏览器打开 http://192.168.4.1/ 即是板载配置面板。

面板各项说明

区块 作用 / 何时用
设备激活 未激活不输出触摸。复制页面上的 MAC/设备码交客服换 16 位激活码,填入「激活码」点激活。
WiFi 配网 & 在线激活 填家里 WiFi → 连接;连上后可点「在线激活」自动取码(需激活服务器在线)。也用于联机 / 在线功能。
VID / PID / 厂商 / 产品名 改手机看到的这台"触摸屏"的 USB 身份(反指纹)。改后需重启重新枚举 USB。
运行模式 触摸屏模式(默认)/ 游戏手柄模式。改后需重启。
出帧模式 新增 触控手感二选一(稳定 / 丝滑),见下。改后重启生效。
重启设备 保存的设置在重启后生效;也用于从配置模式回到正常触摸模式。

出帧模式:稳定 vs 丝滑

这是触控"跟手程度"的取舍开关。S3 通过 USB 最高 1000Hz 把触摸发给手机,而电脑端出帧可能更快;多出来的帧有两种处理法:

模式 手感 代价 / 适用
稳定(默认) 有序、稳,高回报率下略有黏滞(最高约 32ms 缓冲延迟) 不漏点、按下/抬起完整。大多数人用这个。
丝滑 近乎零延迟、非常跟手(复刻老版 3.5 手感) 极端高频下偶发漏一次点击 / 触点短暂残留(由上位机自动重发兜底)。追求极致跟手、或觉得稳定挡发黏时选它。

怎么选先用默认(稳定);如果觉得拖枪 / 滑动"黏、跟不上手",切到丝滑试试。丝滑挡若偶尔出现触点卡住,多半是漏了抬起帧 —— 一般上位机会自动补发收掉;持续卡住再切回稳定。

和电脑端的关系出帧模式是板子自己的设置(存在板子里),和电脑端 PC 程序、config.json 互不影响;换板子要重新设。

17支持作者 · 赞赏

这个工具是用爱发电的个人项目。如果它帮到了你，欢迎请作者喝杯奶茶 ☕

祝你玩得开心 ~ 反馈邮箱：1348984838@qq.com

更多技术细节请参阅随附 README.md

↑