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

14 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
handsomezhuzhu
eeccabf486 fix: 修复服务器部署时前端无法连接后端的问题 
- 将 VITE_API_URL 从 http://localhost:8000 改为相对路径 /api
- 添加 REACT_APP_API_URL 配置用于 Vite 代理转发
- 解决浏览器访问时 localhost 指向用户电脑而非服务器的问题
- 前端请求现在通过 Vite 代理转发到 backend 容器

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-02 00:19:05 +08:00
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
0ea8e5aa1e 🔧 Fix alembic config and add Docker database support 
Fix:
- Fix alembic.ini version_path_separator syntax error
- Add scripts to start with Docker database
- Add automatic fix and start script

New files:
- start_with_docker_db.bat: Start with Docker PostgreSQL
- fix_and_start.bat: Auto-fix and start with options

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 13:58:08 +08:00
handsomezhuzhu
018ed27099 🔧 Fix frontend warnings and add diagnostic tools 
Fix:
- Add type: module to package.json to eliminate ES module warning
- Create separate backend/frontend startup scripts
- Add system status check tool

New files:
- check_status.bat: Diagnose system status
- start_backend_only.bat: Start backend separately
- start_frontend_only.bat: Start frontend separately

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 13:54:05 +08:00
handsomezhuzhu
3a9bf04401 🔧 Fix encoding issues - Add English version scripts 
Fix:
- Remove Chinese characters causing encoding errors
- Create pure English version scripts

New files:
- setup.bat: Simple configuration script (English)
- start_app.bat: Auto-deploy script (English)
- README_QUICKSTART.md: Quick start guide

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 13:47:33 +08:00
handsomezhuzhu
2d8f20296f 📝 Add quick start guide and config tool 
## 新增
- quick_config.bat: 快速配置工具
- START_HERE.txt: 3步启动指南

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 13:44:26 +08:00
handsomezhuzhu
9c96cdd526 🚀 Add full auto-deploy script for Windows 
## 新增
- auto_setup_and_run.bat: 全自动部署启动脚本
  - 自动检查环境
  - 自动配置数据库
  - 自动安装所有依赖
  - 自动启动前后端服务
  - 一键完成所有配置

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 13:42:40 +08:00
handsomezhuzhu
6da18ea7ab 📚 Add GitHub push guide and automation script 
## 新增

- GITHUB_PUSH_GUIDE.md: 完整的 GitHub 推送指南
  - Personal Access Token 认证
  - SSH Key 配置
  - 问题排查

- push_to_github.bat: 自动化推送脚本
  - 一键提交并推送
  - 友好的交互提示

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 13:03:01 +08:00
handsomezhuzhu
39f7091e1f 🔧 Fix Docker network issues for China users 
## 修复

### Docker Compose
- 移除过时的 version 字段警告
- 优化配置以支持最新版本

### 网络优化
- 添加 Docker 镜像加速器配置指南
- 创建自动化配置脚本
- 提供国内优化版启动脚本

## 新增文件

- DOCKER_MIRROR_SETUP.md: 详细的镜像加速配置教程
- setup_docker_mirror.bat: 交互式配置指南
- start_windows_china.bat: 国内网络优化版启动脚本

## 改进

- 解决 Docker Hub 访问慢/失败问题
- 提供多个国内镜像源配置
- 自动检测和提示配置镜像加速

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 12:51:36 +08:00
handsomezhuzhu
1b3dd929fe ✨ Add Windows deployment support 
## 新增功能

### 📝 Windows 部署文档
- WINDOWS_DEPLOYMENT.md: 完整的 Windows 部署指南
  - Docker Desktop 部署方式
  - 本地源码部署方式
  - 详细的问题排查指南

- QUICK_START.md: 5 分钟快速上手指南
  - 简化的部署步骤
  - 测试功能清单
  - 常见问题解答

### 🚀 Windows 启动脚本
- start_windows.bat: 一键启动服务
- stop_windows.bat: 停止服务
- logs_windows.bat: 查看日志

### 📚 测试数据
- test_data/sample_questions.txt: 10 道基础题目
  - 单选题、多选题、判断题
  - 适合快速功能测试

- test_data/sample_questions_advanced.txt: 8 道简答题
  - 测试 AI 评分功能
  - 高级概念题目

## 改进
- 优化 Windows 用户体验
- 提供一键启动方案
- 包含完整测试数据

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-12-01 12:45:54 +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