# AI 手势识别使用教程：上传图片本地识别点赞比耶等手势

> 来源：工具派（https://gjupai.com） 原文页面：https://gjupai.com/tutorial/ai-gesture-recognizer-guide

## 工具简介

**AI 手势识别**是工具派推出的一款浏览器端 AI 图像识别工具：上传一张包含手部的图片，工具会调用 Google MediaPipe 的 Gesture Recognizer 模型在**浏览器本地**完成推理，识别出画面中的手势类别（如点赞、比耶、握拳等），判断是左手还是右手，给出置信度百分比，并在原图上绘制 **21 个手部关键点及连线骨架**。整个过程图片不会上传到服务器，隐私安全有保障；识别完成后还能一键下载带骨架标注的结果图。

## 功能亮点

- **7 种常用手势识别**：可识别「张开手掌、握拳、点赞、点踩、比耶、指向上、我爱你」7 种手势，无法归类时显示「未识别」。
- **21 点手部骨架标注**：在结果图上用紫色圆点标出 21 个手部关键点，并按手掌结构连线，手势姿态一目了然。
- **左右手判断 + 置信度**：每只手都会单独列出「左手 / 右手 · 手势名称 · 置信度百分比」，结果清晰可量化。
- **最多同时识别 4 只手**：模型按 `numHands: 4` 配置，多人合影、双手动作也能逐只识别。
- **浏览器本地运行，保护隐私**：基于 MediaPipe WebAssembly + GPU 加速在本地推理，图片不出浏览器，无需担心隐私泄露。
- **模型一次加载、缓存复用**：首次识别时显示「模型加载中 X%」进度条，加载完成后驻留内存，之后再次识别无需重复下载。
- **一键下载标注图**：识别完成后可将带关键点骨架的结果图保存为 PNG 文件，方便分享与留档。

## 参数说明

| 参数 | 说明 | 默认值 / 取值范围 |
| --- | --- | --- |
| 上传图片 | 点击「选择文件」上传待识别的手部图片 | 支持 JPG / PNG / WEBP，最大 10MB |
| 开始识别 | 触发手势识别的按钮；未上传图片或识别进行中时禁用 | 首次点击会先加载模型并显示进度条 |
| 模型加载进度 | 首次识别时显示「模型加载中 X%」进度条 | 0–100%，加载完成后自动缓存复用 |
| 识别到的手势 | 结果列表，每只手一行：左右手 · 手势名称 · 置信度 | 左手 / 右手；7 种手势或「未识别」；置信度 0–100% |
| 原图 / 手势识别结果 | 并排展示上传原图与绘制骨架后的结果图 | 识别成功后才显示结果图 |
| 下载标注图 | 将带关键点骨架的结果图保存到本地 | PNG 格式，文件名 `gesture_时间戳.png` |

## 使用步骤

1. **打开工具页面**：页面顶部是工具标题卡（名称与功能说明）和用户交流群入口，中部是上传图片区域，无需安装任何软件，打开即用。

![AI 手势识别工具主界面（未上传图片状态）：顶部白色标题卡显示工具名「AI 手势识别」及功能说明「上传图片，使用 Med](article/202607/1783999861524_8146.png)

2. **上传图片**：在「上传图片」区域点击「选择文件」，选择一张手势清晰、背景简单的图片（支持 JPG / PNG / WEBP，最大 10MB），上传后按钮变为可点击状态。

3. **点击「开始识别」**：首次使用会先从 CDN 加载 MediaPipe 运行环境和手势识别模型，页面显示「模型加载中 X%」进度条，请耐心等待到 100%。

4. **查看识别结果**：识别完成后，页面并排显示「原图」和「手势识别结果」（带 21 点紫色骨架），下方「识别到的手势」列表逐只手给出左右手、手势名称和置信度百分比；若画面中没有手，会提示「未检测到手势，请尝试其他图片」。

5. **下载标注图（可选）**：点击「下载标注图」按钮，将带骨架标注的结果图以 PNG 格式保存到本地。

## 使用技巧

- **手势清晰、背景简单效果最好**：页面上传区也提示了这一点——手部完整入镜、无遮挡、与背景对比明显时，关键点定位和手势分类都更准。
- **光线要充足**：逆光、暗光或手部模糊会显著降低置信度，尽量在明亮环境下拍摄。
- **手势要标准**：点赞、比耶等手势尽量做出典型姿态，介于两种手势之间的动作可能被判为「未识别」或置信度偏低。
- **首次慢、之后快**：第一次识别需要下载模型，之后模型会缓存复用，连续识别多张图时只快不慢，可以一次性把要测的图片都处理完。
- **看置信度判断结果可靠性**：列表中的百分比越高越可信，低于预期的结果建议换一张更清晰的图重新识别。
- **多人场景注意 4 只手上限**：画面最多识别 4 只手，手太多时超出部分不会被标注。

## 常见问题

**Q1：支持识别哪些手势？**
共 7 种：张开手掌（Open_Palm）、握拳（Closed_Fist）、点赞（Thumb_Up）、点踩（Thumb_Down）、比耶（Victory）、指向上（Pointing_Up）、我爱你（ILoveYou）。不属于这些类别的动作会显示「未识别」。

**Q2：我的图片会上传到服务器吗？**
不会。模型通过 MediaPipe WebAssembly 在浏览器本地运行（GPU 加速），图片从加载到推理全程在本机完成，不会离开你的设备，隐私有保障。

**Q3：为什么第一次点击识别后要等很久？**
首次使用需要下载 MediaPipe 运行环境和手势识别模型，页面会显示「模型加载中 X%」进度条。加载完成后模型会缓存复用，后续识别就是秒级完成。

**Q4：提示「未检测到手势」怎么办？**
说明模型在图中没有找到手。请换一张手部清晰完整、无遮挡、光线充足的图片；手太小、被物体挡住或严重模糊都可能导致检测失败。

**Q5：一张图里有多只手能识别吗？**
可以。工具最多同时识别 4 只手，每只手会在「识别到的手势」列表中单独一行显示左右手、手势名称和置信度，结果图上也会分别绘制各自的骨架。

**Q6：上传图片有什么限制？**
支持 JPG / PNG / WEBP 格式，文件大小不能超过 10MB。超出限制会提示「图片大小不能超过 10MB」，压缩后再上传即可。