ArithmaBattle/README.md

117 lines
2.8 KiB
Markdown
Raw Normal View History

<p align="center">
<img src="./src/assets/logo.svg" alt="Arithma Battle Logo" width="200">
</p>
2025-04-25 06:39:48 +00:00
# Arithma Battle
2025-04-25 14:49:22 +08:00
基于Vue.js的心算竞技场 | 实时对战PK × 渐进式训练
2025-04-25 14:49:22 +08:00
✓ 成绩追踪
2025-04-25 14:49:22 +08:00
📊 使用Vue.js构建的网页端数学训练平台融合游戏化设计支持多难度级别、排行榜、响应式布局适合教育与娱乐场景。
2025-04-25 14:49:22 +08:00
🚀 通过组件化开发实现高效交互,后续计划扩展社交分享与成就系统。
2025-04-25 14:49:22 +08:00
## 项目概述
2025-04-25 15:39:24 +08:00
ArithmaBattle 是一款基于网页的交互式心算训练与竞技平台旨在通过趣味PK模式和单机练习模式提升用户的计算速度和数学能力。
2025-04-25 15:39:24 +08:00
### 核心功能:
2025-04-25 15:39:24 +08:00
- 实时对战模式(支持加减乘除运算)
- 多难度级别适应不同年龄段用户
- 成绩追踪系统记录进步轨迹
- 响应式设计适配各种设备
### 项目特色:
- ✓ 将数学练习与游戏对战完美结合
- ✓ 单人训练与多人PK双模式
- ✓ 竞技机制激发学习动力
- ✓ 简洁直观的用户界面
- ✓ 适合课堂教学或家庭娱乐
无论是想提升计算能力的学生,还是喜欢数字游戏的爱好者,都能在这里找到挑战乐趣。
## 在线演示
[![Demo](https://img.shields.io/badge/demo-online-green)](https://ab.co1d.in)
2025-04-26 12:52:41 +08:00
可直接访问[https://ab.coldin.in](https://ab.co1d.in) 查看演示
上述链接为演示部署版本。
## 技术栈
- 前端框架Vue.js
- UI组件自定义组件
- 状态管理Vuex
- 路由管理Vue Router
- 构建工具Vite
- CSS预处理SCSS/LESS
- 响应式设计Flexbox/Grid
2025-04-25 15:39:24 +08:00
## 安装与运行
2025-04-25 15:39:24 +08:00
### 前提条件
- Node.js (v14.0+)
- npm 或 yarn
### 安装步骤
```bash
# 克隆仓库
git clone https://github.com/Coldin04/ArithmaBattle.git
# 进入项目目录
cd ArithmaBattle
# 安装依赖
yarn install
# 启动开发服务器
2025-04-25 15:39:24 +08:00
yarn dev
```
### 构建生产版本
```bash
2025-04-25 15:39:24 +08:00
yarn build
```
## 功能展示
![练习模式](./screenshots/practice-mode.png)
![对战模式](./screenshots/battle-mode.png)
## 贡献指南
欢迎对ArithmaBattle项目做出贡献请按照以下步骤参与
1. Fork本仓库
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启一个Pull Request
## 开发计划
- [ ] 添加更多数学运算类型(如指数、开方等)
- [ ] 实现多人在线对战房间
- [ ] 添加成就系统
- [ ] 开发移动应用版本
- [ ] 支持自定义题目难度
## 许可证
本项目采用MIT许可证 - 查看[LICENSE](LICENSE)文件了解详情
## 联系方式
项目维护者: Coldin04 - https://co1d.in
2025-04-25 21:39:37 +08:00
项目链接: [https://github.com/Coldin04/ArithmaBattle](https://github.com/Coldin04/ArithmaBattle)