Skip to content

tyr1105/breathing-app

Repository files navigation

冰人呼吸法训练应用

一款帮助用户练习 Wim Hof 呼吸法的应用。

功能特性

核心功能

  • ✅ 可自定义训练(呼吸次数、轮数、恢复时间)
  • ✅ 呼吸引导动画(多层光环)
  • ✅ 憋气计时与记录
  • ✅ 恢复呼吸倒计时
  • ✅ 声音提示和振动反馈
  • ✅ 暂停/恢复功能
  • ✅ 键盘快捷键支持

数据追踪

  • ✅ 训练历史记录(100条)
  • ✅ 7天训练趋势图
  • ✅ 连续训练天数追踪
  • ✅ 个人最佳记录
  • ✅ 周报统计

激励系统

  • ✅ 11个成就徽章
  • ✅ 成就解锁提示动画
  • ✅ 新纪录庆祝效果

分享与导出

  • ✅ 训练成果分享
  • ✅ JSON数据导出/导入

用户体验

  • ✅ 首次使用引导(4步)
  • ✅ 呼吸技巧说明页
  • ✅ 安全提示弹窗
  • ✅ 训练提醒通知
  • ✅ 主题切换(深色/浅色/自动)
  • ✅ PWA离线支持

技术特性

  • ✅ 错误边界处理
  • ✅ 代码分割优化
  • ✅ Service Worker 缓存
  • ✅ 响应式设计

技术栈

  • 前端: React 18 + TypeScript
  • 样式: Tailwind CSS 3
  • 动画: Framer Motion
  • 构建: Vite 7
  • 移动端: Capacitor 7
  • CI/CD: GitHub Actions

快速开始

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

# 预览
npm run preview

版本历史

V3.0.0 (2026-03-03) 🎉

  • 完整发布版本
  • 30个版本迭代完成
  • 11个成就徽章
  • 主题切换支持
  • PWA离线支持
  • 键盘快捷键
  • 完整的文档系统

V2.5.0 (2026-03-03)

  • 主题切换(深色/浅色/自动)
  • PWA离线优化
  • 代码分割优化
  • 错误边界处理
  • 性能优化文档

V2.1.0 (2026-03-03)

  • 呼吸技巧说明页
  • 关于页面(版本信息)
  • 更新日志

V2.0.0 (2026-03-03)

  • 周报统计功能
  • 数据导出/导入
  • 训练提醒
  • 成就系统(11个徽章)
  • 分享功能

V1.0.0 (2026-03-02)

  • 核心呼吸训练功能
  • 3轮×30次呼吸训练
  • 声音和振动反馈
  • 训练历史记录
  • 连续天数追踪

项目结构

breathing-app/
├── src/
│   ├── components/
│   │   ├── breathing/      # 呼吸训练组件
│   │   ├── safety/         # 安全提示
│   │   ├── summary/        # 训练总结
│   │   ├── settings/       # 设置页面
│   │   ├── history/        # 历史记录
│   │   ├── achievements/   # 成就系统
│   │   ├── onboarding/     # 引导页
│   │   ├── share/          # 分享功能
│   │   ├── report/         # 周报统计
│   │   └── tips/           # 技巧说明
│   ├── utils/
│   │   ├── audio.ts        # 音频管理
│   │   ├── storage.ts      # 数据存储
│   │   ├── achievements.ts # 成就定义
│   │   ├── export.ts       # 数据导出
│   │   └── reminder.ts     # 训练提醒
│   └── App.tsx             # 主应用
├── android/                 # Android 项目
└── .github/
    └── workflows/           # CI/CD

成就列表

成就 条件 图标
初次尝试 完成第一次训练 🎯
连续3天 连续训练3天 🔥
一周坚持 连续训练7天 🌟
月度冠军 连续训练30天 👑
憋气新手 憋气达到30秒 💨
憋气达人 憋气达到1分钟 💪
憋气大师 憋气达到90秒 🏆
冰人附体 憋气达到2分钟 ❄️
勤奋学员 完成10次训练 📚
呼吸专家 完成50次训练 🎖️
呼吸大师 完成100次训练 🏅

下载

许可证

MIT

About

冰人呼吸法训练应用 - Wim Hof Method Training App

Resources

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors