朱潮 99796408cf Initial commit: Add survey system with enhanced features

- Complete survey management system with web interface
- Question generation tools and prompts
- Report generation and analysis capabilities
- Docker configuration for deployment
- Database initialization scripts

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

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-28 20:28:57 +08:00

3.4 KiB

Raw Blame History

🎯 学科能力测评系统使用指南

🌐 系统启动

确保系统运行在 http://localhost:5678

启动命令：

poetry run python enhanced_server.py

📋 完整使用流程

1️⃣ 访问测评列表页

URL: http://localhost:5678/
功能: 查看所有已完成的测评报告
操作:
- 浏览历史报告
- 分页查看
- 点击"开始新的测评"

2️⃣ 配置测评

URL: http://localhost:5678/survey.html
功能: 填写学员信息并配置抽题规则
必填信息:
- 学员姓名
- 学校名称
- 年级
可选配置:
- 题目标签筛选（年级/册次）
- 自定义抽题规则（JSON格式）

3️⃣ 开始答题

URL: 自动生成，格式为 http://localhost:5678/quiz/{sessionId}
功能: 完成测评题目
操作:
- 查看学员信息
- 答题进度条
- 提交答案

4️⃣ 等待报告生成

功能: 答题提交后自动调用AI生成报告
时间: 通常需要10-30秒
状态: 页面会显示生成进度

5️⃣ 查看测评报告

URL: http://localhost:5678/public/report.html?id={reportId}
功能: 查看详细的个性化测评报告
内容包括:
- 五维能力雷达图
- 错题归因分析
- 知识掌握度评估
- 个性化学习建议

⚙️ 抽题规则配置

默认配置

基础题: 10题 × 5分 = 50分
进阶题: 2题 × 10分 = 20分
竞赛题: 2题 × 15分 = 30分
总计: 14题，100分制

自定义配置

JSON格式示例：

{
  "基础题": 8,
  "进阶题": 3,
  "竞赛题": 3
}

标签筛选

支持按年级/册次筛选题目，例如：

一年级上册1-周围的植物
五年级上册1-光
八年级上册3-电路探秘

🤖 AI报告生成

系统会自动调用大语言模型生成包含以下内容的报告：

📊 核心分析

五维能力评估
- 知识记忆与识别
- 信息提取与分析
- 科学推理与判断
- 生活应用与关联
- 探究思维与甄别

📈 详细报告

错题归因分析
知识体系掌握度
认知能力维度评估
学习行为推测
个性化学习规划

🔧 系统特色

✨ 响应式设计: 支持PC和移动端
🚀 实时进度: 答题进度实时显示
🔄 异步处理: 报告生成不阻塞用户操作
💾 数据持久化: 本地SQLite数据库存储
🧩 模块化架构: 代码结构清晰，易于维护
🤖 AI智能: 个性化专业教育评估

📱 快速开始

访问 http://localhost:5678/
点击"开始新的测评"
填写学员信息
配置抽题规则（可选）
点击"开始答题"
完成所有题目
等待AI生成报告
查看详细测评报告

🛠️ 故障排除

常见问题

Q: 点击"开始新的测评"显示404 A: 确保服务器正在运行：poetry run python enhanced_server.py

Q: 报告生成失败 A: 检查网络连接和外部API是否可访问

Q: 题目加载失败 A: 确保public/questions.json文件存在且格式正确

开发环境要求

Python 3.12+
Poetry依赖管理
网络连接（用于AI API调用）

🎉 现在您可以开始使用完整的学科能力测评系统了！

3.4 KiB Raw Blame History Unescape Escape