ArithmaBattle/README.md
2025-04-26 12:52:41 +08:00

116 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<p align="center">
<img src="./src/assets/logo.svg" alt="Arithma Battle Logo" width="200">
</p>
# Arithma Battle
基于Vue.js的心算竞技场 | 实时对战PK × 渐进式训练
✓ 成绩追踪
📊 使用Vue.js构建的网页端数学训练平台融合游戏化设计支持多难度级别、排行榜、响应式布局适合教育与娱乐场景。
🚀 通过组件化开发实现高效交互,后续计划扩展社交分享与成就系统。
## 项目概述
ArithmaBattle 是一款基于网页的交互式心算训练与竞技平台旨在通过趣味PK模式和单机练习模式提升用户的计算速度和数学能力。
### 核心功能:
- 实时对战模式(支持加减乘除运算)
- 多难度级别适应不同年龄段用户
- 成绩追踪系统记录进步轨迹
- 响应式设计适配各种设备
### 项目特色:
- ✓ 将数学练习与游戏对战完美结合
- ✓ 单人训练与多人PK双模式
- ✓ 竞技机制激发学习动力
- ✓ 简洁直观的用户界面
- ✓ 适合课堂教学或家庭娱乐
无论是想提升计算能力的学生,还是喜欢数字游戏的爱好者,都能在这里找到挑战乐趣。
## 在线演示
[![Demo](https://img.shields.io/badge/demo-online-green)](https://ab.co1d.in)
可直接访问[https://ab.coldin.in](https://ab.co1d.in) 查看演示
上述链接为演示部署版本。
## 技术栈
- 前端框架Vue.js
- UI组件自定义组件
- 状态管理Vuex
- 路由管理Vue Router
- 构建工具Vite
- CSS预处理SCSS/LESS
- 响应式设计Flexbox/Grid
## 安装与运行
### 前提条件
- Node.js (v14.0+)
- npm 或 yarn
### 安装步骤
```bash
# 克隆仓库
git clone https://github.com/Coldin04/ArithmaBattle.git
# 进入项目目录
cd ArithmaBattle
# 安装依赖
yarn install
# 启动开发服务器
yarn dev
```
### 构建生产版本
```bash
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
项目链接: [https://github.com/Coldin04/ArithmaBattle](https://github.com/Coldin04/ArithmaBattle)