外观
人体姿态检测系统：实时关键点与手部骨骼识别
人体姿态检测系统是一款基于 Python 开发的实时姿态识别软件，底层采用业界领先的 OpenCV 与 Google MediaPipe 技术。无需穿戴任何传感器，只需一个普通摄像头，即可实现人体姿态的实时检测、骨架绘制与手部骨骼识别。
软件支持 Windows 与 macOS 双平台运行，界面直观、即装即用。它能够实时捕捉人体动作与骨骼结构，并对每个关节进行标注与追踪，适用于健身教学、康复训练、动作捕捉、体育分析、教学演示及姿态矫正等多种场景。
核心功能
- 实时人体姿态检测：基于 MediaPipe 最新模型，实时识别头部、肩膀、手臂、臀部等关键部位
- 手部骨骼识别：双手同时检测，共 21 个关键点，完整呈现 5 根手指的骨骼结构
- 自动骨架绘制：自动连接身体与手部关节，绘制清晰的骨架线条
- 关键点标签显示：每个关节点实时标注名称（如 Nose、L-Shoulder），便于观察与分析
- 多人 / 双手检测：支持同屏多人与双手同时识别
- 一键截图保存：随时按
s键保存当前帧画面，方便前后对比与记录 - 实时 FPS 显示：窗口左上角实时显示运行帧率，便于评估性能
- 灵活扩展：代码结构清晰，可自定义颜色、线条粗细、检测点位，支持二次开发
技术亮点
- 采用 MediaPipe Tasks API（最新版深度学习框架），精度与速度兼得
- 集成 OpenCV 高效图像处理，保证画面流畅显示
- 使用轻量级模型
pose_landmarker_lite.task，低配置电脑也能流畅运行 - 手部检测模块独立可选，按需启用，兼顾性能与功能
- 模块化面向对象设计，便于扩展与维护
检测范围
身体关键点（9 个）
| 部位 | 关键点 |
|---|---|
| 头部 | 鼻子（头部中心） |
| 肩膀 | 左肩、右肩 |
| 手臂 | 左肘、右肘、左手腕、右手腕 |
| 臀部 | 左髋、右髋 |
手部关键点（21 个）
- 手腕（1 个）
- 拇指（4 个关节）
- 食指（4 个关节）
- 中指（4 个关节）
- 无名指（4 个关节）
- 小指（4 个关节）
骨架连接
程序自动绘制包含：肩膀连线、左右手臂连线、躯干两侧连线、臀部连线等，完整还原人体骨架结构。
可视化界面
界面设计清晰直观，通过不同颜色区分身体与手部：
| 颜色 | 用途 | 说明 |
|---|---|---|
| 绿色线条 | 身体骨架连接线 | 连接身体各个关节 |
| 红色圆点 | 身体关节 | 标记身体关节位置 |
| 蓝色圆点 | 头部中心 | 标记鼻子位置 |
| 黄色线条 | 手部骨骼连接线 | 连接手指关节 |
| 青色圆点 | 手指关节 | 标记手指关节位置 |
| 白色文字 | 关键点标签 | 显示关键点名称 |
此外，窗口左上角实时显示 FPS（帧率），方便随时掌握运行状态。
运行性能
经测试，不同配置下的运行表现如下：
| 配置 | 运行帧率 | 处理延迟 |
|---|---|---|
| 低端配置（4GB 内存） | 15–20 FPS | 50–70ms |
| 中端配置（8GB 内存） | 25–30 FPS | 30–40ms |
| 高端配置（16GB+ 内存） | 30+ FPS | 20–30ms |
提示：调低摄像头分辨率、关闭无需的手部检测，可进一步提升流畅度。
系统要求
最低配置
- 操作系统：Windows 10/11 或 macOS 10.15+
- Python：3.8 或更高版本
- 内存：4GB RAM（推荐 8GB+）
- 存储：至少 500MB 可用空间
- 摄像头：USB 摄像头或电脑内置摄像头
推荐配置
- 操作系统：Windows 11 或 macOS 12+
- Python：3.10 / 3.11
- 内存：8GB RAM 或更多
- 显卡：支持硬件加速的 GPU（可选，可提升性能）
安装部署
三步即可完成部署，几分钟内开始体验：
- 安装 Python 3.8+ 并配置环境变量
- 安装依赖包：
pip install -r requirements.txt - 下载模型文件并放到项目目录，运行
python pose_detection.py
软件包内已附带完整的《安装指南》与《使用说明》文档，涵盖 Windows 与 macOS 对应步骤、虚拟环境配置与常见问题排查。
操作说明
| 按键 | 功能 |
|---|---|
q | 退出程序 |
s | 保存当前帧截图 |
隐私与安全
- 全程本地运行：视频与图像数据不会上传任何服务器
- 仅在程序运行时访问摄像头，退出即释放
- 截图保存在本地，绝不自动上传
应用场景
1. 姿态矫正训练
检查站姿、坐姿是否正确。站在摄像头前观察骨架连线是否对称，调整姿势使双肩、臀部保持水平，适合久坐人群与体态矫正练习。
2. 运动姿势监控
监控深蹲、举重等动作是否规范，实时观察关节角度变化，帮助健身爱好者与教练及时发现动作偏差，避免错误姿势带来的运动损伤。
3. 康复辅助训练
辅助康复训练，监控关节活动范围并记录关键点位置变化，帮助康复者循序渐进地恢复活动能力。（请在医生指导下使用）
4. 简易动作捕捉
执行动作时按 s 键保存关键帧截图，分析动作细节，可作为动作捕捉与动作教学的辅助工具。
5. 教学与演示
作为计算机视觉、人工智能课程的教学演示工具，直观展示深度学习与姿态识别的原理，帮助学生快速理解。
常见问题（FAQ）
- 检测不到人体？ 请确保光线充足、身体完整入镜，并与摄像头保持 1.5–2 米距离
- 骨架频繁跳动？ 保持稳定光线、减缓移动速度，或关闭占用 CPU 的无关程序
- 运行卡顿、帧率低？ 调低摄像头分辨率；如不需要手部识别，可移除手部模型以提升性能
- 摄像头无法打开？ 检查摄像头是否被其他软件占用、是否已授予摄像头权限
开发者友好
- 代码采用面向对象设计，核心类
BodyPoseDetector清晰易读 - 支持自定义：摄像头 ID、录制分辨率、骨架颜色、线条粗细、关键点半径等
- 预留关键点数据导出接口，可二次开发接入数据记录或服务器
- 支持单文件运行，环境搭建简单，适合二次开发与学习研究
版本历史
- v1.1.0（2025-01-05）：新增手部骨骼识别功能，支持双手检测
- v1.0.0（2025-01-05）：初始版本发布，支持实时人体姿态检测
下载地址
链接: https://pan.baidu.com/s/1lKBsUkLixSy7F8K0QhhiRw?pwd=hn5n 提取码：hn5n
作者：sssi.cn
软件包内含主程序、依赖清单、身体与手部模型文件、安装指南及使用说明，按文档操作，几分钟即可完成部署体验。
免责声明
本软件仅供学习与研究使用，不适用于医疗诊断或专业医疗用途。使用本软件进行任何健康相关活动前，请咨询专业医生或相关专家。