开源算法包
==========

在电脑上对着采集盒导出的录像跑，不装进盒子。盒子停录时通常已经把头戴格子带解成 imu.csv；这个包用来自己复现、补解，或看手点。

需要本机 Python 3.9+。第一次：

  Windows: 双击 START.bat
  Mac/Linux: ./START.sh

然后把录像拖到 START.bat 上（默认做手部检测），或在解压目录里执行：

  python detect_hands.py 录像.mp4
  python detect_hands.py 一场recording_目录
  python split_stereo.py 头戴.mkv
  python decode_imu.py 头戴.mkv -o imu.csv

1) detect_hands.py  手部检测
   每只手 21 个像素点（0 手腕，每指 4 点从根到尖）。头戴左右拼图默认只跑左目；
   --eye right / --eye both 改右目或两眼。写出 out_hands/hands_overlay.mp4 和 hands.jsonl。
   模型是 MediaPipe Hands。

2) split_stereo.py  双目拆分
   头戴 4000×1200 = 左边 160 像素码带 + 右目 1920 + 左目 1920。
   先裁码带再按右、左切开。不要从正中间 2000 切开（会把右目撕掉一条）。
   写出 left.mp4 / right.mp4。腕部单目不用拆。

3) decode_imu.py  头戴码带 → 表格
   解开最左边 160 像素那条黑白码带。要用未裁切的 4000 宽母带。

自检（不需要录像）：

  python detect_hands.py --self-check
  python split_stereo.py --self-check
