README.md

metadata

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. 克隆仓库:

   git clone https://huggingface.co/spaces/duqing26/math-master-gen
   cd math-master-gen
   

2. 安装依赖:

   pip install -r requirements.txt
   

3. 运行应用:

   python app.py
   

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

💡 使用场景

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

📝 License

MIT License