故障排查
导入报错：架构版本不受支持
Section titled “导入报错：架构版本不受支持”桌面脚本与应用版本不一致。
- 确认已安装的应用版本
- 使用匹配版本的准备脚本重新切分片段
- 重新导入
导入报错：「该视频已导入」
Section titled “导入报错：「该视频已导入」”- 进入 素材
- 找到 id 相同的已有卡片
- 点击垃圾桶图标并确认
- 重新导入
导入报错：区域代码未定义
Section titled “导入报错：区域代码未定义”击球清单使用了其他项目的代码。
- 羽毛球单打：
FL FC FR BL BC BR - 请检查
--sport参数与 CSV 中的区域代码是否一致
导入报错：contact_time_ms 与 contact_frame 不符
Section titled “导入报错：contact_time_ms 与 contact_frame 不符”帧率是假定的而非从文件读取的。手机实际记录 119.88 fps，而非 120.0。
- 重新运行准备脚本，它会从容器元数据读取精确帧率
- 切勿手工编辑清单中的
fps
「N / M 个片段在磁盘上缺失」
Section titled “「N / M 个片段在磁盘上缺失」”clips/ 文件夹未与清单一同传输，或在导入后被移动。片段文件会在测试开始前检查，因此该问题出现在设置阶段，而不会在测试中途暴露。
- 在 素材 页删除该素材
- 将整个输出文件夹（清单与片段一起）复制到 iPad
- 重新导入
导入后请勿移动或重命名该文件夹 —— 片段是相对于导入时清单所在位置定位的。
「暂无已标注的击球」
Section titled “「暂无已标注的击球」”没有符合条件的已导入素材。设置页会给出具体原因：
| 提示 | 处理方式 |
|---|---|
| 暂无已标注的击球 | 尚未导入，或标注时排除了全部击球。请导入素材 |
| 已导入 N 个击球，但均未确认击球帧 | 请完成标注 —— 素材 → 标注击球帧 |
| 有 N 个已标注击球无法使用……请重新导入 | 由未记录片段位置的旧版本导入。删除后重新导入 |
测试无法收敛
Section titled “测试无法收敛”阶梯法需要至少 6 次反转，且具备合理的一致性。
- 使用 60 个试次而非 20 或 40 —— 这是最常见的原因
- 确认运动员事先完成了熟悉性测试
- 检查疲劳或分心。测试中途漂移的表现会产生离散的反转
- 确认运动员理解应当猜测，而不是让试次超时
计时无效试次过多
Section titled “计时无效试次过多”- 确认整个测试期间应用始终处于前台
- 检查 iPad 是否因过热而降频 —— 若机身发烫请先冷却
- 关闭其他应用后重新运行
- 运行 T1 校准。若 T1 未通过，该设备上的阈值不可信
正确率高得可疑
Section titled “正确率高得可疑”- 检查导入警告中的区域覆盖情况。若某些区域没有击球，运动员的实际选择范围就小于 6，正确率随之虚高
- 确认您读取的是随机校正正确率，而非原始正确率
- 确认素材视角为
receiver
两次测试之间阈值变化很大
Section titled “两次测试之间阈值变化很大”- 将变化幅度与 2 × 标准误 比较。小于该值即为噪声
- 确认两次测试使用了同一组素材。不同对手是不同的刺激材料
- 确认两次测试使用了相同设备与相同试次数量
- 若该运动员的基线测试不足两次，单次结果尚不可信
标注工作丢失
Section titled “标注工作丢失”标注仅在队列完成时才会写入。
- 请一次性走完整个队列。遇到难以判断的击球请用 跳过 推迟，而不要退出界面
运动员数据与他人混在一起
Section titled “运动员数据与他人混在一起”应用目前没有运动员管理功能 —— 所有测试都归入同一个隐含运动员。
- 请自行按运动员留存书面记录。见当前限制
界面语言被重置
Section titled “界面语言被重置”语言选择不会在重启后保留。请在主界面重新设置。