项目介绍

QuesBank是一个基于Web的题库管理系统，专为教师和学生设计。它提供了完整的题库管理功能， 包括题目录入、分类管理、智能刷题、模拟考试等，帮助用户更高效地进行学习和教学。

主要特点

• 多题型支持：支持单选题、多选题、判断题、填空题等多种题型
• 智能刷题：根据学习进度智能推荐题目，提高学习效率
• 模拟考试：支持随机抽题、倒计时、自动评分等功能
• 数据管理：支持题库导入导出、备份恢复等操作
• 响应式设计：完美适配PC和移动端设备

功能特性

题库管理

• 支持手动输入题目和AI自动生成题目
• 题库分类管理，支持多级分类
• 题目导入导出，支持多种格式
• 题目编辑、删除、批量操作

学习功能

• 智能刷题模式，根据掌握程度推荐题目
• 错题本功能，自动收集错题
• 学习进度跟踪，可视化学习数据
• 题目收藏功能，方便复习

考试功能

• 模拟考试模式，支持随机抽题
• 考试时间设置，倒计时提醒
• 自动评分和成绩分析
• 考试记录保存和查看

用户管理

• 用户注册登录系统
• 角色权限管理（学生/教师/管理员）
• 个人资料管理
• 学习数据统计

安装部署

环境要求

• Web服务器（Apache/Nginx）
• PHP 7.4+
• MySQL 5.7+ 或 MariaDB 10.2+
• 现代浏览器（Chrome、Firefox、Safari、Edge）

快速安装

1. 下载项目文件到Web服务器目录
2. 导入数据库结构（参考 database_schema.sql）
3. 配置数据库连接（修改 js/api.js）
4. 访问 index.html 开始使用

宝塔面板部署

如果使用宝塔面板，可以参考 宝塔面板部署指南.md 进行快速部署。

使用指南

基本使用流程

1. 导入或创建题库：进入刷题模式，手动输入或AI生成题目
2. 管理题库：在题库页面进行新建、编辑、删除等操作
3. 开始学习：选择题库进行刷题或模拟考试
4. 查看进度：在统计页面查看学习数据和进度

详细操作说明

更多详细的使用说明，请参考 帮助页面。

API接口

QuesBank提供了完整的RESTful API接口，支持题库管理、用户认证、数据统计等功能。 详细的API文档请参考 API文档页面。

主要接口

• 用户管理：注册、登录、权限验证
• 题库管理：CRUD操作、导入导出
• 题目管理：题目增删改查、分类管理
• 学习数据：进度跟踪、成绩统计

数据库

项目使用MySQL数据库存储数据，主要包含用户、题库、题目、学习记录等表。 详细的数据库结构请参考 database_schema.sql 文件。

主要数据表

• users - 用户信息表
• question_banks - 题库表
• questions - 题目表
• user_progress - 学习进度表
• exam_records - 考试记录表

部署说明

本地部署

参考 本地测试指南.md 进行本地环境搭建和测试。

服务器部署

参考 数据库部署说明.md 进行服务器端部署。

一键部署

使用提供的批处理文件或Shell脚本进行快速部署：

• QuesBank启动器.bat - Windows快速启动
• 宝塔一键部署.sh - 宝塔面板一键部署

更新日志

v1.3.0 (2025-06-30)

• 全面优化导航栏系统，实现统一、现代化、响应式设计
• 新增毛玻璃效果、渐变色彩、圆角设计，提升视觉体验
• 完善移动端适配，支持触摸友好的汉堡菜单
• 为所有页面添加统一导航栏，修复遮挡问题
• 优化用户状态管理和权限控制，提升交互体验
• 重构test.html页面，采用现代化设计风格

v1.2.0 (2025-06-15)

• 新增AI题目生成功能，支持根据知识点自动生成题目
• 优化考试模式，增加考试时间设置和自动评分功能
• 改进用户界面，提升视觉体验和交互效果

贡献指南

欢迎为QuesBank项目贡献代码！如果您发现了bug或有新的功能建议，请通过以下方式参与：

• 提交Issue报告bug或建议新功能
• Fork项目并提交Pull Request
• 完善文档和测试用例
• 分享使用经验和最佳实践

许可证

QuesBank采用MIT许可证，您可以自由使用、修改和分发本项目。 详细信息请参考项目根目录下的LICENSE文件。