QM2 进化：从静态引擎到 AI 驱动的智能

Source: Dev.to

概览

一个使用 Python 构建的高性能 CLI 测验引擎，如今已进化为集成 Gemini AI 的智能学习伴侣，拥有 84 % 的测试覆盖率。

新发布：QM2 v1.1.0

最新版本通过集成 Google Gemini AI 为引擎添加了“大脑”。目标是在 10 秒内使用 Gemini 1.5 & 2.0 Flash 模型生成一套 20 题、高质量的测验。

AI 驱动的功能

• 主题生成测验 – 只需提供一个主题（例如 “高级 Python 装饰器” 或 “二战历史”），工具即可即时创建完整测验。
• 多类型支持 – AI 会生成四种支持的题型：
  1. 多项选择
  2. 判断题
  3. 填空题
  4. 配对题
• 智能重试 – 指数退避和回退链（Gemini 2.0 Flash → 1.5 Flash → 1.5 Pro）即使在触发速率限制时也能保持体验不中断。
• 高级 JSON 清理 – 自定义模块会剔除任何 AI “闲聊”，提取干净、有效的测验结构。

实现细节

• Google GenAI SDK – 负责与 Gemini 模型的通信。
• 指数退避逻辑 – 优雅地管理 API 速率限制。
• 模拟 AI 测试 – unittest.mock 模拟 Gemini 响应，使 CI/CD 能在没有真实 API 密钥或令牌的情况下验证 JSON 解析和回退逻辑。

安装与使用

# 升级到最新版本
pip install --upgrade qm2

# 设置你的 Gemini API 密钥
export GEMINI_API_KEY="your_google_ai_key"

# 运行 QM2
qm2

在提示时输入主题，CLI 将即时生成测验。

文档与资源

• PyPI:
• GitHub:
• Docs:

行动号召

如果 QM2 对你的学习有帮助，请考虑给 GitHub 仓库加星。欢迎提供反馈——让我们在评论中讨论 AI 生成教育内容的未来！