# Matrix Sport Lab 版本说明

## 版本号: v2.0.0

---

## 一、版本概览

| 版本 | 文件 | 大小 | 定位 |
|------|------|------|------|
| **免费版** | `MatrixSportLab-Free-v2.0.0.zip` | ~30 MB | 单/双视频同步播放工具 |
| **专业版** | `MatrixSportLab-Pro-v2.0.0.zip` | ~179 MB | 全功能姿态分析与运动捕捉系统 |
| **学员管理版** | `MatrixSportLab-TMS-v2.0.0.zip` | ~30 MB | 学员管理系统（会员专属） |
| **权利时间管理版** | `MatrixSportLab-Rights-v2.0.0.zip` | ~20 MB | 付费权利时间管理系统（运营方后台工具） |
| **进销存系统版** | `MatrixSportLab-IMS-v2.0.0.zip` | ~15 MB | 进销存管理系统（商品/供应商/采购/销售/库存/报表） |

---

## 二、免费版功能

### 核心功能
- **单视频播放**：支持常见视频格式（MP4、AVI、MOV 等），播放流畅、画面清晰
- **双视频同步播放**：左右两路视频同步播放，支持逐帧对比
- **播放控制**：播放/暂停、快进/快退、单帧步进、速度调节（0.05x ~ 2x）
- **进度控制**：进度条拖拽，显示帧数/时间信息
- **视频裁剪**：支持裁剪视频片段并导出
- **镜像/旋转**：支持视频画面镜像和旋转操作

### 适用场景
- 教练对比学员动作视频
- 回放观看运动录像
- 基础视频分析需求

### 不包含
- 人体姿态检测与骨骼绘制
- 动作捕捉与轨迹绘制
- 标准动作库与评价系统
- 学员管理与上课系统

---

## 三、专业版功能

### 基础功能（含免费版全部功能）

### 动捕核心功能
- **人体姿态检测**：基于 MediaPipe 深度学习引擎，实时检测 33 个人体关键点
- **骨骼叠加绘制**：在视频画面上叠加显示骨骼连线，支持多种显示样式
- **实时轨迹绘制**：追踪指定关键点运动轨迹，支持 4 种绘制样式：
  - 实线、虚线、渐变、发光
- **关键点筛选**：按身体部位独立开关（肩部、手臂、腿部、躯干、重心）

### 分析功能
- **姿态分析**：对视频中的人体姿态进行逐帧分析
- **四阶段分析**：将动作分解为准备、起跳、空中、落地四个阶段
- **波形对比**：双视频关键点运动轨迹波形对比
- **动作评分**：基于标准动作库对动作进行量化评分

### 标准动作库
- 内置 17 种滑板标准动作模板
- 支持动作保存与对比分析
- 评价报告导出

### 轨迹绘制（专业版独有）
- 选择跟踪关键点（鼻子、肩、肘、腕、髋、膝、踝等）
- 4 种绘制样式（实线/虚线/渐变/发光）
- 颜色选择（红/绿/蓝/黄/青/紫/白）
- 线宽调节（1-10px）
- 一键清除轨迹

### 管理系统
- 学员管理
- 教练管理
- 课程排课
- 考勤记录
- 收费管理
- 报表统计

---

## 三-2、学员管理系统独立版（TMS）

独立的学员管理系统，**会员专属**，开通会员后解锁全部功能：

- 学员档案管理（学员信息、课时余额、状态筛选）
- 教练档案管理
- 课程管理（课程定价、课时数）
- 排课管理
- 考勤签到
- 缴费财务（收款、欠费提醒、缴费流水）
- 报表统计（本月营收、欠费学员数、在册学员数、近6个月营收柱状图）

### 会员套餐

| 套餐 | 价格 | 有效期 |
|------|------|--------|
| 月会员 | ¥9.9 | 30 天 |
| 年会员 | ¥98 | 365 天 |
| 终身会员 | ¥198 | 永久 |

未开通会员时进入系统仅显示「会员开通引导页」，全部功能锁定。详见包内《会员收费说明.md》。

## 三-3、付费权利时间管理系统独立版（Rights）

面向**运营方/机构后台**的独立工具，用于会员权利的生成、登记、续期与到期跟踪，离线使用（SQLite 本地数据库）：

- **激活码生成**：月/年/终身三档套餐批量生成，HMAC-SHA256 签名，防伪造
- **权利台账**：记录激活码、客户/学员名、手机、实收金额、绑定设备指纹、激活/到期时间
- **登记操作**：标记售出、登记激活（设备指纹校验）、续期、删除
- **到期跟踪**：筛选「未售/未激活/已激活/已到期/即将到期」，随时掌握会员权利状态
- **统计概览**：总码数、已售、未售、已激活、已到期等汇总
- **台账导出**：导出 CSV，便于对账归档

详见包内《使用说明.md》。

## 三-4、进销存系统独立版（IMS）

面向**门店/批发商日常进销存管理**的独立业务工具，本地 SQLite 数据库（离线），无需联网、无需会员：

- **商品管理**：商品建档（名称/分类/规格/单位/进价/售价/库存预警阈值/备注），支持新增/编辑/删除/查询
- **供应商管理**：供应商建档（名称/联系人/电话/地址/备注）
- **采购进货**：登记采购单据，自动增加对应商品库存
- **销售出库**：登记销售单据，自动扣减库存并校验库存是否充足
- **库存查询**：当前库存、低库存预警、库存流水明细
- **报表统计**：采购额、销售额、毛利统计及趋势图表
- **联动刷新**：采购/销售单据变更后，库存与报表自动刷新

详见包内《使用说明.md》。

## 四、技术架构

| 组件 | 技术选型 |
|------|----------|
| 界面框架 | Qt 6.6.0 (C++20) |
| 视频解码 | OpenCV 4.10.0 + FFmpeg |
| 姿态检测引擎 | MediaPipe 0.10.13（已内置，随包分发） |
| Python 运行时 | Python 3.12.10 嵌入式（MediaPipe 依赖，已随包内置，无需系统安装） |
| 数据库 | SQLite 3 |
| 构建系统 | CMake 3.25+ / Visual Studio 2022 |

---

## 五、安装与运行

### 系统要求
- 操作系统：Windows 10/11 64位
- 硬件：建议 8GB 内存以上，独立显卡可加速动捕处理
- 磁盘空间：免费版约 100MB，专业版约 500MB

### 使用方法
1. 解压对应版本的 zip 压缩包
2. 双击 `启动.bat` 运行
3. 专业版首次启动时会自动加载 Python 运行时，请稍候

### 注意事项
- 免费版无需任何外部依赖
- 专业版已内置 MediaPipe 动捕引擎及便携式 Python 嵌入式运行时，无需提前安装 Python 或 MediaPipe，解压即用
- 动捕功能需要一定的计算资源，建议在配置较好的机器上运行

---

## 六、版本对比

| 功能 | 免费版 | 专业版 | 学员管理版 | 权利时间管理版 | 进销存系统版 |
|------|:------:|:------:|:----------:|:--------------:|:----------:|
| 单视频播放 | ✓ | ✓ | — | — | — |
| 双视频同步播放 | ✓ | ✓ | — | — | — |
| 速度调节 | ✓ | ✓ | — | — | — |
| 视频裁剪 | ✓ | ✓ | — | — | — |
| 镜像/旋转 | ✓ | ✓ | — | — | — |
| 人体姿态检测 | ✗ | ✓ | — | — | — |
| 骨骼叠加绘制 | ✗ | ✓ | — | — | — |
| 实时轨迹绘制 | ✗ | ✓ | — | — | — |
| 四阶段分析 | ✗ | ✓ | — | — | — |
| 波形对比 | ✗ | ✓ | — | — | — |
| 标准动作库 | ✗ | ✓ | — | — | — |
| 动作评分 | ✗ | ✓ | — | — | — |
| 学员管理系统 | ✗ | ✓（登录内） | ✓（独立版） | — | — |
| 会员激活码生成/权利台账 | ✗ | 内嵌激活 | 内嵌激活 | ✓（独立运营方工具） | — |
| 商品/供应商/采购/销售/库存/报表 | ✗ | ✗ | ✗ | ✗ | ✓（独立版） |
| Python 嵌入式运行时 | 不包含 | 包含 | 不包含（TMS 无动捕） | 不包含（无动捕） | 不包含（无动捕） |
| 会员收费 | ✗ | 动捕会员 | 学员管理会员 | 运营方后台管理 | 无（免费业务工具） |

---

## 七、更新日志

### v2.0.0 (2026-08-20)
- 项目更名为 Matrix Sport Lab
- 首次发布免费版/专业版双版本
- 新增实时轨迹绘制功能（专业版）
- 弃用 ONNX 动捕后端，统一使用 MediaPipe
- MediaPipe 引擎与 Python 嵌入式运行时已随专业版打包内置，无需系统安装 Python
- 优化免费版构建体积，仅包含视频播放核心功能
- 新增收费/会员功能：动捕专业版（月 9.9 / 年 98 / 终身 198）
- 新增学员管理系统独立版（TMSApp）：整系统会员制，激活码激活，会员套餐同三档（月 9.9 / 年 98 / 终身 198）
- 新增付费权利时间管理系统独立版（RightsApp）：运营方后台工具，激活码生成 + 权利台账登记/续期/到期跟踪/CSV 导出，离线 SQLite 存储
- 新增进销存系统独立版（IMSApp）：商品/供应商/采购进货/销售出库/库存/报表一体化业务工具，本地 SQLite 离线使用，免费