从零开始快速上手九九乘法训练系统安装与配置详细教程
系统概述与环境准备
九九乘法训练系统是一款专为数学基础教育设计的智能化训练平台，支持练习模式、错题本、成绩统计等功能。本教程将基于Windows 10/11操作系统，使用Python 3.9+运行环境进行部署。在开始前请确保满足以下基础条件：
1. 已安装64位操作系统（推荐Windows 10 21H2及以上版本）
2. 预留至少500MB磁盘空间
3. 确保网络连接正常（用于依赖库下载）
4. 具备管理员权限账户
建议优先使用Anaconda或Miniconda管理Python环境。若尚未安装Python，请访问[Python官网]下载3.9.x版本安装包。安装时务必勾选"Add Python to PATH"选项。
系统部署流程详解
1. 源码获取与解压
访问项目GitHub仓库（示例地址：/multiplication-trainer）下载最新发行版压缩包。建议选择以`release_vx.x.x`命名的稳定版本。解压至`D:\\MathTrainer`目录（路径避免包含中文或空格）。
2. 依赖库安装
打开命令提示符执行以下命令：
```bash
cd D:\\MathTrainer
pip install -r requirements.txt --trusted-host --trusted-host files.
```
该命令将自动安装Flask 2.0、PyQt5 5.15、SQLAlchemy 1.4等核心依赖库。若遇网络超时，可添加`-i
3. 数据库初始化
系统采用SQLite作为默认数据库，执行初始化脚本：
```bash
python database_init.py
```
成功执行后将生成`trainer.db`文件，包含users、question_bank、error_records三个核心数据表。如需改用MySQL，需修改`config.ini`中[database]段落的配置参数。
关键配置项说明
打开项目根目录下的`config.ini`文件，重点关注以下配置项：
1. 系统端口设置
```ini
[server]
port = 8080
```
默认使用8080端口，若端口冲突可修改为1024-65535之间的空闲端口。通过`netstat -ano | findstr :8080`命令检测端口占用情况。
2. 训练参数配置
```ini
[training]
max_questions = 50
time_limit = 300
difficulty_level = 2
```
3. 界面个性化设置
```ini
[ui]
theme = light
font_size = 14
```
支持light/dark两种主题模式，字体大小建议设置在12-18pt区间。
系统启动与验证
1. 单机版启动方式
双击运行`local_gui.pyw`文件，等待3-5秒将出现登录界面。初始管理员账号：admin，密码：123456（首次登录后请立即修改）。
2. 网络版部署方案
执行命令启动Web服务：
```bash
python web_server.py
```
访问`）即可使用浏览器访问。如需外网访问，需在防火墙中开放对应端口。
功能测试与验证
完成部署后请依次验证以下功能模块：
1. 用户管理模块
2. 训练核心功能
3. 数据统计模块
常见问题处理指南
1. 依赖库安装失败
若出现"Could not find a version that satisfies..."错误，尝试以下解决方案：
2. 数据库连接异常
当出现"OperationalError: unable to open database file"时：
3. 界面渲染异常
如遇控件错位或文字乱码：
系统维护建议
1. 每日定时备份`trainer.db`文件至云端或外部存储
2. 每季度检查一次依赖库更新（注意版本兼容性）
3. 定期清理logs目录下的历史日志文件
4. 建议每学期初执行`python database_optimize.py`进行数据库索引优化
本教程已涵盖系统部署的核心要点，实际使用中可根据教学需求调整训练参数。建议教师在正式投入使用前，先进行为期一周的试运行，观察系统稳定性及资源占用情况。遇到技术问题可查看`docs`目录下的技术手册，或通过issues页面与开发团队联系。
