zzh/QQuiz
1
0
Fork 0
mirror of https://github.com/handsomezhuzhu/QQuiz.git synced 2026-02-20 20:10:14 +00:00
Code Issues Packages Projects Releases Wiki Activity
14 Commits 3 Branches 0 Tags
eeccabf486e67bff214641598341d316a3b5b42f
Commit Graph

5 Commits

Author SHA1 Message Date
handsomezhuzhu
ed87aae014 docs: 完善文档和清理项目，添加 Gemini 配置指南 
主要更新：

📚 文档改进
- 新增 AI_CONFIGURATION.md：详细的 AI 提供商配置指南
- 新增 CHINA_MIRROR_GUIDE.md：中国镜像加速指南
- 删除 6 个过时文档（DEPLOYMENT.md, QUICK_START.md 等）
- 更新 README.md：添加 Gemini 功能特性和 AI 提供商对比表

🧹 脚本清理
- 删除 11 个重复/过时脚本（从 25 个减少到 14 个）
- 删除 PostgreSQL 相关脚本（项目使用 MySQL）
- 删除重复的启动脚本（start_windows.bat, start_app.bat 等）

⚙️ 配置文件更新
- 更新 .env.example：添加 Gemini 配置示例和说明
- 默认 AI_PROVIDER 改为 gemini（推荐）
- 添加各提供商的获取 API Key 链接

🎯 核心改进
- 突出 Gemini 原生 PDF 理解优势
- 提供清晰的 AI 提供商选择指南
- 简化项目结构，提高可维护性

清理内容：
- 删除 docs: DEPLOYMENT.md, DOCKER_MIRROR_SETUP.md, GITHUB_PUSH_GUIDE.md,
  QUICK_START.md, README_QUICKSTART.md, START_HERE.txt
- 删除 scripts: auto_setup_and_run.bat, check_postgres.bat, logs_windows.bat,
  push_to_github.bat, quick_config.bat, restart_docker.bat, setup_docker_mirror.bat,
  start_app.bat, start_postgres.bat, start_windows.bat, start_windows_china.bat

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 23:21:04 +08:00
handsomezhuzhu
f403eacb9d refactor: 重构 Gemini 为 REST API 调用以支持自定义代理服务 
核心改进：
- 🔄 完全重写 Gemini 实现方式
  - 移除 google-genai SDK 依赖
  - 改用 httpx 直接调用 Gemini REST API
  - 完全控制请求 URL 和参数

- 🌐 完美支持自定义 Base URL
  - 支持代理服务（如 https://load.zhuzihan.com/proxy/gemini-self）
  - 支持 API Key 轮训中转服务
  - 兼容标准 Gemini API 格式（v1beta/models/{model}:generateContent）

- 📄 保留完整的 PDF 处理能力
  - 使用 inline_data 格式（base64 编码）
  - 原生 PDF 理解（最多 1000 页）
  - 完整保留图片、表格、公式等视觉元素

- ⚡ 优化性能和稳定性
  - 统一使用 httpx.AsyncClient
  - 120 秒超时配置
  - 连接池管理（max_keepalive_connections=5）
  - 完善的错误处理和日志输出

技术细节：
- 移除依赖：google-genai==1.0.0
- 请求格式：标准 Gemini REST API
- 响应解析：直接从 JSON 提取 candidates[0].content.parts[0].text
- PDF 上传：inline_data with base64 encoding

影响范围：
- 文本内容解析 ✅
- PDF 文档解析 ✅
- 简答题评分 ✅
- AI 参考答案生成 ✅

🎉 现在 Gemini 可完美配合用户自建的代理/轮训服务使用！

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 23:01:44 +08:00
handsomezhuzhu
d24a1a1f92 feat: 添加 Gemini 支持和 AI 参考答案生成功能 
主要功能：
- 🎯 新增 Google Gemini AI 提供商支持
  - 原生 PDF 理解能力（最多1000页）
  - 完整保留图片、表格、公式等内容
  - 支持自定义 Base URL（用于代理/中转服务）

- 🤖 实现 AI 参考答案自动生成
  - 当题目缺少答案时自动调用 AI 生成参考答案
  - 支持单选、多选、判断、简答等所有题型
  - 答案标记为"AI参考答案："便于识别

- 🔧 优化文档解析功能
  - 改进中文 Prompt 提高识别准确度
  - 自动修复 JSON 中的控制字符（换行符等）
  - 智能题目类型验证和自动转换（proof→short等）
  - 增加超时时间和重试机制

- 🎨 完善管理后台配置界面
  - 新增 Gemini 配置区域
  - 突出显示 PDF 原生支持特性
  - 为其他提供商添加"仅文本"警告
  - 支持 Gemini Base URL 自定义

技术改进：
- 添加 google-genai 依赖
- 实现异步 API 调用适配
- 完善错误处理和日志输出
- 统一配置管理和数据库存储

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 22:43:08 +08:00
handsomezhuzhu
a01f3540c5 feat: 实现数据库驱动的API配置管理和项目结构重组 
## 新功能
- 实现管理后台API配置管理（OpenAI/Anthropic/Qwen）
- API配置保存到数据库，实时生效无需重启
- API密钥遮罩显示（前10位+后4位）
- 完整endpoint URL自动显示

## 后端改进
- 新增 config_service.py 用于加载数据库配置
- LLMService 支持动态配置注入，回退到环境变量
- 更新 exam.py 和 question.py 使用数据库配置
- 扩展 schemas.py 支持所有API配置字段

## 前端改进
- 重写 AdminSettings.jsx 增强UI体验
- API密钥显示/隐藏切换
- 当前使用的提供商可视化标识
- 移除"需要重启"的误导性提示

## 项目结构重组
- 移动所有脚本到 scripts/ 目录
- 移动所有文档到 docs/ 目录
- 清理 Python 缓存文件

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 19:24:12 +08:00
handsomezhuzhu
c5ecbeaec2 🎉 Initial commit: QQuiz - 智能刷题与题库管理平台 
## 功能特性

✅ **核心功能**
- 多文件上传与智能去重（基于 content_hash）
- 异步文档解析（支持 TXT/PDF/DOCX/XLSX）
- AI 智能题目提取与评分（OpenAI/Anthropic/Qwen）
- 断点续做与进度管理
- 自动错题本收集

✅ **技术栈**
- Backend: FastAPI + SQLAlchemy 2.0 + PostgreSQL
- Frontend: React 18 + Vite + Tailwind CSS
- Deployment: Docker Compose

✅ **项目结构**
- 53 个文件
- 完整的前后端分离架构
- Docker/源码双模部署支持

🚀 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 12:39:46 +08:00