# MathFBox

**Repository Path**: solgull/math-fbox

## Basic Information

- **Project Name**: MathFBox
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-24
- **Last Updated**: 2025-12-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数式绘算盒 (MathFBox)

> 一款功能全面的离线数学工具应用，支持 HarmonyOS / Android / iOS

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-HarmonyOS%20%7C%20Android%20%7C%20iOS-green.svg)]()
[![uni-app](https://img.shields.io/badge/framework-uni--app%20%2B%20Vue3-brightgreen.svg)]()

## 📖 项目简介

数式绘算盒是一款完全离线的数学工具类应用，专为学生、教师和数学爱好者设计。应用涵盖几何计算、方程求解、函数图像、数学公式等多个模块，提供专业的数学计算和可视化功能。

### ✨ 核心特点

- 🔒 **完全离线** - 无任何网络请求，保护用户隐私
- 🌍 **多语言支持** - 支持中文和英文界面切换
- 📱 **跨平台** - 支持 HarmonyOS、Android、iOS 多端运行
- 🎨 **现代化 UI** - 简洁美观的用户界面设计
- ⚡ **高性能** - 优化的计算引擎，流畅的用户体验

## 🚀 功能列表

### 1. 几何计算
- **平面几何**: 三角形、矩形、正方形、圆形、椭圆、梯形、平行四边形、菱形、扇形、正多边形
- **立体几何**: 长方体、圆柱、球体、圆锥、金字塔、正方棱锥
- **解析几何**: 两点距离、三角形面积（坐标法）

### 2. 方程求解
- 一元一次方程
- 一元二次方程（实根/复数根）
- 二元一次方程组
- 三元一次方程组

### 3. 函数图像
- 支持多种函数类型绘制
- 可缩放、平移的坐标系
- 函数收藏与管理

### 4. 数学公式库
- 几何公式
- 代数公式
- 三角函数公式
- 导数与积分公式
- 公式收藏功能

### 5. 矩阵计算器
- 矩阵加减乘运算
- 矩阵转置
- 行列式计算

### 6. 数列计算器
- 等差数列
- 等比数列
- 斐波那契数列
- 智能数列分析

### 7. 统计分析
- 平均数、中位数、众数
- 方差、标准差
- 数据可视化

### 8. 练习系统
- 每日挑战
- 答题闯关
- 错题本
- 练习统计

## 🛠️ 技术栈

| 技术 | 说明 |
|------|------|
| uni-app | 跨平台应用开发框架 |
| Vue 3 | 前端框架 |
| JavaScript | 编程语言 |
| Canvas | 函数图像绘制 |
| uni.storage | 本地数据持久化 |

## 📁 项目结构

```
MathFBox/
├── components/          # 公共组件
│   ├── common/         # 通用组件
│   └── ...
├── pages/              # 页面文件
│   ├── geometry/       # 几何计算
│   ├── equation/       # 方程求解
│   ├── graph/          # 函数图像
│   ├── formula/        # 公式集合
│   └── profile/        # 个人中心
├── utils/              # 工具函数
│   ├── geometry.js     # 几何计算引擎
│   ├── analysis.js     # 数学分析工具
│   ├── mathFormat.js   # 数学格式化
│   ├── errorHandler.js # 错误处理
│   └── i18n.js         # 国际化
├── lang/               # 多语言资源
│   ├── zh-CN.js        # 中文
│   └── en-US.js        # 英文
├── static/             # 静态资源
├── tests/              # 测试文件
├── docs/               # 文档
└── auto_test.js        # 自动化测试脚本
```

## 🔧 安装与运行

### 环境要求

- Node.js >= 14.0
- HBuilderX (推荐) 或 VS Code
- 对应平台的开发环境（HarmonyOS DevEco Studio / Android Studio / Xcode）

### 安装步骤

1. 克隆项目
```bash
git clone https://github.com/your-username/MathFBox.git
cd MathFBox
```

2. 安装依赖
```bash
npm install
```

3. 运行项目
```bash
# 使用 HBuilderX 打开项目
# 选择运行 -> 运行到浏览器/模拟器/真机
```

### 构建发布

```bash
# HarmonyOS
# 在 HBuilderX 中选择 发行 -> App-Harmony

# Android
# 在 HBuilderX 中选择 发行 -> 原生App-云打包

# iOS
# 在 HBuilderX 中选择 发行 -> 原生App-云打包
```

## 🧪 测试

### 运行测试

```bash
# 运行所有测试
node run-all-tests.js

# 运行单个模块测试
node auto_test.js
node tests/geometry.test.js
node tests/analysis.test.js
node tests/mathFormat.test.js
node tests/errorHandler.test.js
```

### 测试覆盖

| 模块 | 测试数 | 覆盖内容 |
|------|--------|----------|
| 主测试 | 25 | 方程、矩阵、统计、数列、存储、工具函数 |
| 几何计算 | 30 | 平面几何、立体几何、解析几何 |
| 统计分析 | 18 | 积分、导数、零点、极值 |
| 数学格式化 | 20 | 分数转换、根式识别、格式化 |
| 错误处理 | 20 | 输入验证、错误消息 |
| **总计** | **113** | **通过率 100%** |

## 📚 API 文档

详细的 API 文档请参阅 [docs/API.md](docs/API.md)

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

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) 文件

## 👨‍💻 作者

- 开发者：[Your Name]
- 邮箱：[your.email@example.com]

## 🙏 致谢

感谢所有为本项目做出贡献的开发者！

---

<p align="center">
  Made with ❤️ for Mathematics
</p>