README.md

---
title: Math Master Gen
emoji: 🧮
colorFrom: indigo
colorTo: blue
sdk: docker
pinned: false
license: mit
short_description: 智能口算练习题生成器 - 支持填空题与答案页
---

# 智能口算大师 (Math Master Generator)

这是一个专为家长和老师设计的智能口算练习题生成工具。只需简单配置，即可生成包含加减乘除的口算题，并支持一键导出 PDF 打印。

## ✨ 核心功能 (Features)

*   **灵活配置**: 支持自定义数字范围 (Min/Max) 和题目数量。
*   **多模式支持**: 自由组合加 (`+`)、减 (`-`)、乘 (`×`)、除 (`÷`) 四则运算。
*   **🧠 填空题模式**: [新增] 支持生成如 `3 + ( ) = 5` 的逆向思维训练题。
*   **📝 答案页生成**: [新增] 可选附带独立的参考答案页，方便家长/老师快速批改。
*   **🖨️ 排版定制**: [新增] 支持自定义 PDF 列数 (2-5列) 和字体大小适配。
*   **实时预览**: 生成前即可查看题目样式，所见即所得。
*   **PDF 导出**: 一键生成 A4 格式的 PDF 试卷，完美适配打印机。
*   **极简设计**: 清爽的现代化 UI (Tailwind CSS)，无广告干扰。

## 🛠️ 技术栈 (Tech Stack)

*   **Backend**: Flask (Python) - 处理核心逻辑
*   **Frontend**: HTML5, Tailwind CSS (CDN) - 响应式现代化界面
*   **PDF Engine**: ReportLab - 高性能 PDF 渲染 (支持中文)
*   **Deployment**: Docker - 容器化部署 (适配 Hugging Face Spaces)

## 🚀 快速开始 (Quick Start)

### 本地运行

1.  克隆仓库:
    ```bash
    git clone https://huggingface.co/spaces/duqing26/math-master-gen
    cd math-master-gen
    ```

2.  安装依赖:
    ```bash
    pip install -r requirements.txt
    ```

3.  运行应用:
    ```bash
    python app.py
    ```

4.  打开浏览器访问: `http://localhost:7860`

## 💡 使用场景

*   **幼小衔接**: 生成 10 以内的加减法，可开启"填空题模式"锻炼思维。
*   **小学低年级**: 生成 20-100 以内的加减法。
*   **九九乘法表**: 设置范围 1-9，选择乘法。
*   **假期练习**: 批量打印，勾选"附带答案页"，每天一张。

## 📝 License

MIT License