# 腕准 WristAim

Windows 独立练枪诊断程序，面向 3200 DPI、手腕操作、小鼠标垫的使用习惯。优先测试三角洲烽火的红点和三倍档，同时支持 CS2 本地配置读取，以及 APEX、无畏契约的手动训练档案。

## 开始使用

双击桌面的「腕准 · 灵敏度测试」快捷方式，或运行 `dist/WristAim.exe`。程序免安装，运行时不需要 Python、浏览器或网络。`WristAim.exe` 和 `WristAim.pck` 须放在同一个文件夹。

1. 先进入「校准与设备」，确认 DPI 为你当前实际使用的值。
2. 如果暂未测量游戏设置，可直接做「基准诊断」，先了解训练中的表现。初始 20 / 60 cm/360、75° / 28.7° 只用于训练，并非读取的三角洲配置。
3. 游戏手感校准：在游戏训练场保持同一开镜档，水平转动 180°，测量鼠标位移并乘 2；空间较小时可用 90° 位移乘 4。重复测量并分别填写红点、三倍档。核对垂直 FOV 后才勾选实测确认。
4. CS2 可以扫描本机 Steam 用户配置，选择自己的账户导入普通视角。普通视角换算使用该文件里的 sensitivity 和 m_yaw；开镜档仍需单独校准。实际测量与配置换算不符时，程序不会给出未经核对的 CS2 数字。
5. 完成基准诊断后，可以做「灵敏度对比」。36 个搜索轮次，每轮默认 20 秒并有 3 秒适应；出现候选时自动安排新轨迹复测。各轮之间可以休息。

操作：ENTER 开始或继续，ESC 暂停并释放鼠标，F11 切换全屏。跟枪任务持续把准星放在球体上；目标切换任务需要单击命中。目标由橙色变为绿色表示准星已进入目标范围。

## 如何理解结果

- 「在靶时间」是准星处于目标范围的时间占比。
- 「平均误差」按每个任务的目标半径归一化，1 表示约一个目标半径。
- 「稳定瞄准耗时」由进入目标后持续约 100 毫秒或成功单击确认；始终未完成的目标也计入耗时。
- 「横向反向」只在静止目标切换任务中统计同一目标内的移动反向，不把每次新目标的转向直接算成修正。
- 「持续落后」由误差在目标运动方向的投影判断，落在目标前方不会被当成落后。
- 提示阈值是首版启发式规则，显示观察结果，不能仅凭一次测试认定心理或操作原因。

灵敏度对比采用 85%、100%、115% 三档，任务与重复轮次配对，顺序打乱，每档有相同难度和对应轨迹；训练参数在测试开始后固定。候选需在新轨迹复测中维持改善，红点还检查近距离跟枪退步，并参考填写的可用活动宽度。证据不足时保持基准；结论只代表本次测过的档位。建议隔天在相同设备和设置下复测。

三角洲、APEX、无畏契约当前通过实测 cm/360 和视角适配。三角洲的鼠标灵敏度未从已找到的本机配置里确认，因此本版不会把载具、手柄或引擎默认字段冒充游戏内鼠标数值。实际游戏存在武器、视角和开镜差异，需在游戏中复测。

## 数据与进度

数据存放在 `%APPDATA%/WristAim/`，可以从程序打开：

- `settings.json`：当前配置；`profiles.json`：各游戏独立档案。
- `pending.json`：最近一次未完成测试的进度。
- `sessions/<测试时间>/`：已完成轮次的 CSV、进度、完成后的 `session.json` 和 `报告.md`。

暂停或切换窗口会冻结采样。返回主页、关闭后可以继续；未完成的旧测试也能从「测试记录」恢复。明显卡顿的轮次会标成无效，可选择重测。测试期间显示的盲测档位在最终报告中揭示。

## 开发与验证

源码位于 `src/`，采用 Godot 4.6 原生 3D 与捕获模式下的鼠标相对位移；不对输入施加鼠标平滑，输入增益不乘帧时间。程序不需要连接游戏进程。

运行 `build.ps1` 会先执行自动检查，再打包到 `dist/`。Godot 官方引擎在 `engine/`；打包方式是独立引擎程序加同名 PCK，运行时不会打开编辑器。发行包内保留 Godot 与依赖许可说明。

测试包含已知轨迹的误差与落后方向、DPI 换算、点击确认、卡顿处理、暂停、候选复测、近距退步撤回、活动空间限制、CS2 换算核对，以及六类任务到报告的完整流程。界面截图保存在 `tests/`，报告预览图片明确标记为示例。