AI数字健康教练:基于 Vue 3 + TypeScript + Vite 的智能健康助手应用项目

•基于魔珐星云具身智能技术打造的「健康教练数字人」,通过自然交互引导用户养成健康饮食、规律运动、科学作息的生活方式,实现行为层面的健康管理。

Branch1Tags0
FilesLast commitLast update
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago
9 months ago

AI健康教练数字人项目

项目简介

AI健康教练数字人项目是一个基于Vue 3 + TypeScript + Vite开发的智能健康助手应用。通过数字人技术与大语言模型的结合,为用户提供专业的健康指导和个性化的健康建议。

功能特性

🎯 核心功能

  • 三栏布局设计:左侧健康数据面板,中间数字人渲染,右侧控制面板
  • AI健康教练:专业的健康指导,科学合理的健康建议
  • 健康评估表单:BMI计算、腰高比分析、健康状态评估
  • 语音交互:支持语音输入,实现自然对话
  • 实时状态反馈:数字人状态实时显示,服务连接状态监控
  • 动态对话历史:自动更新最近对话,只显示话题,限制显示3条

📊 健康数据展示

  • 体温监测:实时显示体温数据
  • 血压监测:正常血压范围展示
  • 心率监测:健康心率状态显示
  • 睡眠质量:睡眠时长和质量评估
  • 健康评估结果:BMI、腰高比、评估结论

🔧 系统特性

  • 环境变量配置:通过.env文件管理服务配置
  • 服务组合选择:支持通用服务和专用服务切换(可选大模型或者专用智能体作为数字人的“大脑”)
  • 智能提示词:大模型以健康教练身份回答,控制回答字数
  • 自动滚动:表单提交后自动滚动到底部,方便用户操作
  • 状态重置:服务停止后自动重置侧边栏状态

技术栈

  • 前端框架:Vue 3 + Composition API
  • 类型系统:TypeScript
  • 构建工具:Vite
  • 数字人技术:XmovAvatar SDK
  • 语音识别:腾讯云ASR
  • 大语言模型:豆包大模型
  • 状态管理:Vue 3 reactive + computed
  • 样式:CSS3

快速开始

1. 环境要求

  • Node.js 16.0+
  • npm 7.0+ 或 pnpm 6.0+

2. 安装依赖

# 使用 npm
npm install

# 或使用 pnpm
pnpm install

3. 配置环境变量

复制 .env.example 文件并重命名为 .env,然后填写相应的配置信息:

# 数字人服务配置
VITE_AVATAR_APP_ID=your_avatar_app_id
VITE_AVATAR_APP_SECRET=your_avatar_app_secret

# ASR服务配置
VITE_ASR_APP_ID=your_asr_app_id
VITE_ASR_SECRET_ID=your_asr_secret_id
VITE_ASR_SECRET_KEY=your_asr_secret_key

# LLM服务配置
VITE_LLM_MODEL=doubao-1-5-lite-32k-250115
VITE_LLM_API_KEY=your_llm_api_key

# Coze AGENT配置(可选)
VITE_COZE_AGENT_BOT_ID=your_coze_bot_id
VITE_COZE_AGENT_API_KEY=your_coze_api_key

4. 运行开发服务器

npm run dev

项目将在 http://localhost:5173 启动。

5. 构建生产版本

npm run build

构建产物将输出到 dist 目录。

项目结构

├── src/
│   ├── components/        # Vue组件
│   │   ├── AvatarRender.vue      # 数字人渲染组件
│   │   ├── ConfigPanel.vue       # 右侧控制面板
│   │   ├── HealthDashboard.vue   # 左侧健康数据面板
│   │   └── ObesityForm.vue       # 健康评估表单
│   ├── composables/       # 组合式函数
│   │   └── useAsr.ts             # 语音识别Hook
│   ├── constants/         # 常量配置
│   │   └── index.ts              # 全局常量定义
│   ├── services/          # 服务模块
│   │   ├── avatar.ts             # 数字人服务
│   │   ├── coze.ts               # Coze服务
│   │   └── llm.ts                # 大语言模型服务
│   ├── stores/            # 状态管理
│   │   └── app.ts                # 应用状态管理
│   ├── types/             # 类型定义
│   │   └── index.ts              # TypeScript类型定义
│   ├── utils/             # 工具函数
│   │   └── index.ts              # 通用工具函数
│   ├── App.vue            # 根组件
│   ├── main.ts            # 入口文件
│   └── style.css          # 全局样式
├── public/                # 静态资源
├── .env.example           # 环境变量示例
├── package.json           # 项目配置
├── vite.config.ts         # Vite配置
└── README.md              # 项目说明

使用指南

1. 启动服务

  1. 在右侧控制面板选择服务组合(通用服务或专用服务)
  2. 点击「启动服务」按钮
  3. 等待服务连接成功,状态显示「已启动」

2. 与数字人交互

  • 文字输入:在消息输入框中输入问题,点击「发送消息」按钮
  • 语音输入:点击「语音输入」按钮,说出你的问题,系统会自动识别并发送

3. 健康评估

  1. 输入与健康评估相关的关键词(如「BMI」、「健康评估」等)
  2. 系统会弹出健康评估表单
  3. 填写身高、体重、腰围等信息
  4. 点击「计算评估」按钮,查看评估结果
  5. 评估结果会自动填充到消息输入框,点击发送获取健康建议

4. 停止服务

点击「停止服务」按钮,系统会自动重置侧边栏状态,包括隐藏表单、清空输入框等。

常见问题

1. 服务连接失败

  • 检查配置:确保 .env 文件中的配置信息正确
  • 网络状态:确保网络连接正常
  • 服务状态:检查数字人、ASR、LLM等服务是否正常运行

2. 语音输入不工作

  • 配置检查:确保ASR服务的配置信息正确
  • 权限检查:确保浏览器已授权麦克风权限
  • 网络状态:确保网络连接稳定

3. 数字人不说话

  • 服务连接:确保数字人服务已成功连接
  • 消息发送:确保消息已成功发送
  • LLM响应:检查大语言模型是否正常响应

4. 健康评估表单不弹出

  • 关键词检查:尝试使用不同的健康评估相关关键词
  • 服务状态:确保数字人服务已成功连接

技术支持

如果遇到技术问题,请参考以下资源:

  • 项目文档:本README文件
  • 环境配置:检查 .env.example 文件
  • 控制台日志:打开浏览器开发者工具,查看控制台日志

版权信息

© 2026 AI健康教练数字人项目. All rights reserved.

Introduction

•基于魔珐星云具身智能技术打造的「健康教练数字人」,通过自然交互引导用户养成健康饮食、规律运动、科学作息的生活方式,实现行为层面的健康管理。

Customize your domain