Skip to content

Repository files navigation

⚽ MatchMind - AI 足球分析软件

专为校园足球打造的智能战术分析平台,助力球队数据化管理与科学训练。

React TypeScript Vite Tailwind CSS License: MIT


功能特性

球员管理

  • 创建、编辑球员信息(姓名、学号、位置、惯用脚、身高体重等)
  • 批量导入:下载 Excel 模板,一键导入多名球员
  • AI 自动评分:根据球员最近 3 场比赛数据,从 8 个维度自动评分
  • 一键批量评分:点击一次按钮,自动为所有球员进行 AI 评分
  • 搜索与筛选,快速定位球员

比赛录入

  • 完整的比赛信息录入(时间、地点、比分、天气等)
  • 两支队伍的详细数据统计(射门、传球、控球、扑救等)
  • 每位球员的个体数据(进球、助攻、传球、抢断、黄牌红牌等)
  • 快捷导入:通过 Excel 模板批量导入整场比赛数据,导入后可进入编辑界面补充球员详细数据
  • 门将数据独立统计(扑救、出击、长传等)

AI 智能分析

  • 整体分析:AI 对整场比赛的战术、节奏、关键节点进行深度分析
  • 队伍分析:分别分析两队表现、优势与不足
  • 球员评分:多维度评分(进攻、防守、组织、体能、技术、团队合作、心态、决策能力)
  • AI 问答:与 AI 对话,获取针对性战术建议

自动分队

  • 选择参与分队的球员,AI 自动平衡两队实力
  • 可与 AI 沟通调整分队方案
  • 实时显示两队评分对比

数据备份

  • 导出数据库:将所有球员和比赛数据导出为 JSON 文件
  • 导入数据库:从 JSON 文件恢复数据
  • 建议定期导出备份,防止浏览器数据丢失

技术栈

技术 说明
React 18 前端框架
TypeScript 类型安全
Vite 构建工具
Tailwind CSS 样式方案(英超配色主题)
Dexie.js IndexedDB 封装,本地数据持久化
Recharts 数据可视化(雷达图等)
xlsx Excel 模板生成与解析
智谱 GLM-4.6 AI 大模型(支持 OpenAI 兼容格式)

项目结构

MatchMind/
├── src/
│   ├── components/          # 可复用组件
│   │   ├── Layout.tsx       # 全局布局与导航栏
│   │   ├── PlayerModal.tsx  # 球员新增/编辑弹窗
│   │   ├── PlayerImportModal.tsx  # 球员批量导入弹窗
│   │   ├── MatchImportModal.tsx   # 比赛快捷导入弹窗
│   │   └── RatingRadar.tsx  # 评分雷达图
│   ├── pages/               # 页面组件
│   │   ├── HomePage.tsx     # 首页仪表盘
│   │   ├── PlayersPage.tsx  # 球员管理
│   │   ├── MatchCreatePage.tsx   # 比赛创建(四步流程)
│   │   ├── MatchDetailPage.tsx   # 比赛详情与分析
│   │   ├── TeamBalancerPage.tsx  # AI 自动分队
│   │   └── SettingsPage.tsx # 系统设置
│   ├── services/            # 业务服务层
│   │   ├── aiService.ts     # AI API 调用(分析、评分、分队)
│   │   ├── matchService.ts  # 比赛数据 CRUD 与导入解析
│   │   ├── playerService.ts # 球员数据 CRUD 与历史查询
│   │   └── dataExportService.ts  # 数据导出/导入
│   ├── store/               # 数据层
│   │   └── db.ts            # Dexie (IndexedDB) 数据库定义
│   ├── types/               # TypeScript 类型定义
│   │   └── index.ts         # 所有接口与常量
│   ├── context/             # React Context
│   │   └── AppContext.tsx   # 全局状态(Toast 通知等)
│   └── App.tsx              # 路由配置
├── tailwind.config.js        # Tailwind 配置(英超紫色主题)
├── vite.config.ts            # Vite 构建配置
└── package.json

快速开始

本地开发

# 克隆仓库
git clone https://github.com/Feipi/MatchMind.git
cd MatchMind

# 安装依赖
npm install

# 启动开发服务器
npm run dev

浏览器访问 http://localhost:5173

构建生产版本

npm run build

构建产物在 dist/ 目录下。


使用说明

首次使用

  1. 进入「设置」页面,配置 AI API Key
    • 默认适配智谱 GLM-4.6,也支持任何 OpenAI 兼容格式的 API
    • 智谱 API Key 获取:https://open.bigmodel.cn
  2. 在「球员管理」中创建或批量导入球员
  3. 在「录入比赛」中记录比赛数据
  4. 进入比赛详情,点击「AI 分析」获取智能分析报告
  5. 在「球员管理」中点击「一键评分」批量更新球员评分

数据安全提示

  • 所有数据存储在浏览器本地(IndexedDB)
  • 强烈建议定期使用「导出数据库」功能备份数据
  • 清理浏览器缓存会导致数据丢失
  • 如需跨设备使用,请手动导出/导入数据

AI 配置

本项目默认适配智谱 GLM-4.6 模型,也支持任何兼容 OpenAI Chat Completions 格式的 API。

配置项 默认值
API Base URL https://open.bigmodel.cn/api/paas/v4/chat/completions
Model Name glm-4.6
Temperature 0.7

在设置页面填入 API Key 即可使用。AI 功能包括:

  • 比赛分析:深度思考模式,超时 180 秒
  • 球员评分:基于近 3 场比赛数据,超时 120 秒
  • 自动分队:智能平衡两队实力,超时 120 秒
  • AI 问答:针对比赛的自由提问,超时 60 秒

部署方式

方式一:静态网站托管(推荐)

dist/ 目录部署到以下平台:

方式二:内网服务器

dist/ 目录复制到任意静态文件服务器(Nginx、Apache 等)。


评分维度说明

AI 从 8 个维度对球员进行 1-10 分评分:

维度 说明
进攻 (Attack) 射门、传球、跑位等进攻能力
防守 (Defense) 抢断、拦截、卡位等防守能力
组织 (Organization) 传球视野、比赛阅读、战术理解
体能 (Fitness) 耐力、速度、爆发力
技术 (Technique) 控球、传球、盘带等技术能力
团队合作 (Teamwork) 配合意识、传球选择、跑位配合
心态 (Mentality) 抗压能力、专注度、比赛态度
决策能力 (Decision Making) 关键时刻的判断和选择

注意事项

  • 本软件为纯前端应用,数据完全存储在本地浏览器中
  • AI 分析功能需要有效的 API Key,请自行准备
  • 建议使用 Chrome、Edge、Firefox 等现代浏览器
  • 校园足球场景下,不保证专业级数据分析精度

许可证

MIT License


⚽ 记录每一场精彩比赛,用数据驱动进步!

About

⚽ AI 驱动的校园足球智能分析平台 - 球员管理、比赛录入、AI 战术分析、自动分队

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages