02 · 握把尺寸测量
4 个功能中的第 1 个。两种入口都能得到同样的三套体系尺码（Yonex L0–L5 / Wilson 英寸分数 / Head–Prince–Babolat 等效）：
- 🤖 AI 测量 —— 拍一张手掌照片，端侧 MediaPipe Hand 自动算掌长 + 掌宽 + 手指数
- 📏 手工测量 —— 拿尺子量掌长，把数字敲进 App，走完全相同的尺码公式
两条路径用同一套公式映射尺码，所以哪条准就用哪条；互相验证也行。
两条路径一览
| 🤖 AI 测量（拍照） | 📏 手工测量（尺子） | |
|---|---|---|
| 入口 | 首页 → 「AI 测握把尺寸」→ 开始测量 | 首页 → 同卡片下方「Manual Tier Picker」 |
| 需要 | 后置摄像头 + 端侧 ML 模型 | 一把普通尺子 / 卷尺 |
| 耗时 | 30 秒（拍照 + 调整 + 出结果） | 10 秒（量 + 填） |
| 精度 | 实测均方根误差 ±4.2 mm ≈ ±⅓ 档 | 取决于尺子读数精度 |
| 何时用 | 没尺子 / 想要快速初值 / 想看掌心-手腕纹理 | 没摄像头 / 摄像头权限被拒 / AI 反复失败 / 想精确控制起点 |
下面分两段讲。AI 测量更直观（大多数人的默认选项）；手工测量是兜底 + 也常作为 AI 结果的 ground truth 校验。
🤖 AI 测量（拍照）
它能做什么
举起手机对准手掌，App 默认在端侧（不上传）估算：
- 掌心长度（mm）
- 手掌宽度（mm）
- 手指数 + 比例（用于跨手型校准）
- → 同时输出三套体系的推荐尺码
怎么拍才准
关键 1：放在平的桌面上，垫一张 A4 纸，手平放手心向上五指张开
这是拍照前的实时画面：手机正上方俯拍时屏幕上的样子——预览 + 已按 30 cm 工作距算好的绿框 + 底部提示「Place an A4 paper flat on the desk」。让 A4 纸整体进绿框、五指张开、手心向上后，按下快门。
- 桌面要平 —— 在硬的平桌上铺一张 A4 白纸。不要掌心朝外举着拍、不要靠在软物体上。
- 手掌平贴在纸上，五指张开 —— 皮肤贴着纸给 AI 一个清晰的边缘做锚点；A4 纸的尺寸还能反推相机距离（接近 30 cm 标准工作距）。
- 手心向上（朝相机） —— 手背朝向相机的纹理太少，AI 容易定位失败；朝上贴纸面那张纹理最丰富。
- 手指不要弯 —— 手指要自然伸直并分开，哪怕稍微用力撑着也不要蜷。
关键 2：光线均匀
✅ 好 ❌ 差
┌────────────┐ ┌────────────┐
│ 白墙前 │ │ 杂乱桌面 │
│ 🖐 │ │ 🖐 + 📦 │
│ │ │ │
└────────────┘ └────────────┘- 光线要均匀；从窗户侧面斜射的光比顶灯直照更容易拍出阴影
- 光线够的话关掉闪光灯
- A4 白纸还能把头顶硬光「漫射化」，又一次推荐垫纸的理由
关键 3：手机正上方往下拍
- 不要斜拍 —— 正上方俯拍
- 相机离纸面约 30–50 cm
- 用后置摄像头（前置畸变大）
拍照流程
- 「首页」→
AI 测握把尺寸 开始测量→ 申请摄像头权限（首次）- 手机正上方俯拍（≈ 30–50 cm 离纸面），取景框对准平放的手掌，静止 1 秒预检姿态
拍摄（或自动触发）- 等待 1–2 秒：端侧 MediaPipe Hand 检测 → 进入结果页
结果页
结果页把 AI 识别结果叠加在你拍的照片上，左图右数：
| 面板 | 内容 |
|---|---|
| 照片 + 叠加 | 你的手掌 + AI 画的 横纹线（掌心和手腕交界处那条横线） |
| 测量值 | 掌长 + 掌宽（mm） |
| 推荐尺码 | 同时输出 Yonex / Wilson / Head–Prince–Babolat |
三家体系网格示例：
Yonex Wilson Head / Prince / Babolat
L3 4½" 4¾两条修正 AI 结果的路径
在聊结果页长什么样之前，先讲 App 提供的两种修正模式——根据情况挑一种用：
模式 1 —— 在结果页拖横纹线（首选）
这个模式允许你在照片上拖动"横纹线"。横纹线是 AI 估的"掌心起点位置"；如果高估 5 mm（往指尖方向偏），推荐尺码就会跳一档。
- 拍完后你会看到：照片上有一条 AI 画的手腕横线
- 长按后上下拖这条线
- 「测量值」+「推荐尺码」面板实时联动
- 拖动范围限制在 AI 初始位置的 ±15 mm（避免误操作拉到离谱）
- 满意后点
保存到历史
这种模式适合"AI 数字大致对、只是有点偏差（通常 3–10 mm）"的情况。
模式 2 —— 调整页（Adjust Green Frame）：把 A4 纸贴着绿框
如果结果整体比例不对，比如你穿错了几层手胶让图像看着被拉长/压缩了——切到 调整页 给 App 一个已知的物理参考。
这一页的标题是 "Adjust Green Frame"，展示：
- 完整的拍摄照片（手掌 + A4 纸）
- App 按 30 cm 标准工作距算出的一圈 青绿色矩形框
- 底部一行提示："Drag with one finger; pinch to zoom (rotation disabled). Fit the A4 inside the green frame, then Next."
- 一个绿色 Next (Analyze) 按钮
怎么操作：
- 单指拖动 —— 把照片平移，让 A4 纸整体居中到绿框里
- 两指捏合 / 张开 —— 缩放照片，让 A4 纸的四条边尽量贴着绿框
- 让四条纸边与绿框重叠为止 —— 重合越紧，比例标定越准
- 不允许旋转（避免你一不小心把照片转了）
- 对齐到满意后点 Next (Analyze) —— App 用新的比例再跑一次掌长检测
A4 纸的物理尺寸是 210 × 297 mm，告诉 App "绿框 = 一张 A4 纸 + 这个工作距"就把绝对比例钉死了——这是单靠模式 1 拖横纹线达不到的修正。
把这两个模式配合用：模式 2 定比例，模式 1 定掌心起点。
误差预算与缓解
| 误差来源 | 影响 | 缓解 |
|---|---|---|
| 手掌角度倾斜 | 长度 ±5–8 mm | App 提示"请放平" |
| 焦距畸变（前置摄像头明显） | 长度 ±3 mm | 默认强制用后置 |
| 肤色 / 光照 | 关键点偏移 ±2 mm | MediaPipe Hand 2024 模型在多肤色上鲁棒 |
| 手掌部分遮挡（戒指、长指甲） | 失败 / 偏大 | 提前摘掉戒指、剪指甲 |
| 手型训练偏差 | ±3 mm | 用模式 1 拖横纹线，或模式 2 调整页滑块 |
实测均方根误差：端侧 4.2 mm。 转换到档位 ≈ Yonex 体系的 ±⅓ 档。
局限与边界
- ❌ 不支持戴手套：手套会丢关键点
- ❌ 儿童手掌：训练集主要是成年人；儿童手掌测不准
- ❌ 极端光线（暗光、强烈逆光）：拍不到 → 用调整页；或直接走 📏 手工测量
- ❌ 多人合影：App 自动选最大的手掌（也容易挑错）
不保存原图
V1.1 不保存拍的原图。测量完成后只缓存「关键点坐标数组」（~80 字节）用于历史回看，原图当场丢弃。如果你需要「再拍一张用作以后换算」，请到「设置 → 数据管理 → 启用原图存档」主动开启（默认关）。
📏 手工测量（尺子）
走这条路径用和 AI 完全同一套尺码公式——只是入口方式不同。所以如果你尺子量得准，结果会和 AI 一致；如果 AI 偏了，手工可以当 ground truth 校验。
入口
首页 → 「AI 测握把尺寸」卡片下方 → 「Manual Tier Picker」入口。
操作步骤
- 选惯用手（左手 / 右手）—— 页面上的示意图按这一侧来画
- 拿尺子量：从无名指尖正下方量到横纹线（从腕横纹往上数第二条线，也就是掌心和手指的分界）
- 这段距离就是你的 rulerMm——尺码公式用的"掌长"
- 把数字填进 Ruler Method Measurement 输入框（mm）；只想直接选档也可以留空
- 可选：再填一个 Palm Length (mm, optional)，比如你量的是腕横纹→无名指尖而不是横纹线→无名指尖
- App 用和 AI 相机模式完全相同的公式映射到 Yonex / Wilson / Head–Prince–Babolat 三套体系
什么时候用
- 摄像头权限被拒 / 没有摄像头
- 手掌识别反复失败（极端光照、戴手套、手特别小）
- 你已经用尺子量完了，只想把数字敲进 App
- 想给 AI 结果做个 sanity check
怎么量最准
- 用软尺或直尺 + 卡尺都行；精度到 mm 就够（最终输出是 ⅛" 一档）
- 无名指 是标准尺码用的手指（食指 / 中指都比无名指长，跨体系参考时数字不一致）
- 横纹线：掌心和手指的边界。把手攥起来再松开，能看到 3 条纹：腕横纹、掌心横纹（中间那条）、手指根横纹。取中间那条
- 量的时候手自然放松，不要使劲撑（撑开会让掌长偏长 1–3 mm）
常见问题
iPhone / iPad 能用吗?
当前版本不支持 iOS。详见 00 · 支持平台。
端侧检测需要多大算力?
推荐 Snapdragon 7xx / 天玑 800 及以上。低端机会感觉"转圈"几秒。
测出来的数据会上传吗?
不会。所有计算都在端侧跑，图片从不离开你的手机。
AI 和手工两条路径会得到同样的尺码吗?
理论上会——两条路径用同一套尺码公式；实际会有 ⅓ 档左右差异（来源：测量误差 ±4.2 mm + 尺子读数误差）。如果两条路径差到 ≥ 1 档，建议两条各做一次取中间值，或用 📏 手工的 rulerMm 当 ground truth。
我不同意 AI 的结果，怎么办?
按精度由高到低有两种方式：
- 结果页微调横纹线 —— 长按横纹线的把手上下拖；测量值与推荐尺码实时联动。AI 数字大致对、只是有点偏差（通常 3–10 mm）时用这个。
- 调整页 —— 在结果页点
仅调整缩放→ 一根 ±10 mm 滑块。你已经用尺子量完、只想把数字敲进 App 时用这个，或端侧检测完全失败根本看不到照片时。 - 直接走 📏 手工测量 —— 兜底路径；完全脱离 AI。