# 质量分析

**Repository Path**: jun-sun/quality-analysis

## Basic Information

- **Project Name**: 质量分析
- **Description**: 用来分析小学期中期末成绩的质量分析工具
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-06-18
- **Last Updated**: 2025-11-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 小学质量分析系统 - 交互式成绩分析工具

## 项目简介

这是一个专为小学设计的交互式成绩分析工具，简化版具有智能排除功能和清晰界面。本工具可以帮助教师快速分析学生在不同学科部分（口算、计算、概念、应用）的表现，自动统计各等级人数，并生成详细的分析报告。

## 功能特点

- **多格式支持**：支持上传Excel (.xlsx) 和CSV格式的成绩文件
- **智能排除**：自动检测并排除非数字行（如班级均分、年级均分等）
- **分部分分析**：支持将成绩分为口算、计算、概念、应用四个部分单独分析
- **自定义评分标准**：可为每个部分设置不同的评分阈值（优秀、良好、合格）
- **交互式列选择**：通过点击或按住Shift键多选列来配置各部分包含的题目
- **可视化预览**：实时预览数据，不同部分用不同颜色标识
- **详细分析报告**：生成摘要统计和学生个人详情报告
- **报告下载**：支持将分析结果导出为CSV格式

## 使用方法
### 首先下载并打开index.html文件
### 第一步：上传文件
1. 点击"📁 选择成绩文件"按钮
2. 选择Excel (.xlsx) 或CSV格式的成绩文件
3. 系统会自动加载文件并显示数据预览

### 第二步：配置分析部分
1. 在"题号行"输入框中设置题号所在的行号（默认为第2行）
2. 点击顶部标签切换不同部分（口算、计算、概念、应用）
3. 在预览表格中点击列标题选择该部分包含的题目
   - 单击选择/取消单列
   - 按住Shift键点击可选择连续多列
4. 设置评分阈值（优秀最低分,良好最低分,合格最低分）
   - 可手动输入，如"38,34,26"
   - 或使用快速设置按钮
5. 检查并调整"不参与计算的行"（系统会自动检测非数字行）

### 第三步：查看结果
1. 点击"开始分析"按钮
2. 系统会显示处理状态日志
3. 分析完成后，查看"成绩统计摘要"和"学生成绩详情"
4. 可点击"下载摘要报告"和"下载详情报告"导出CSV文件

## 文件格式要求

- **文件格式**：Excel (.xlsx) 或 CSV
- **表头要求**：
  - 必须包含"姓名"列（学生姓名）
  - 建议包含"班内学号"列（学生学号）
  - 题号应位于同一行（可在"题号行"设置具体行号）
- **数据格式**：
  - 学生数据行应包含数字分数
  - 非数字行（如"班级均分"、"年级均分"）会被自动排除

## 注意事项

1. 确保文件中包含"姓名"列，否则系统将使用"未知(数据行号)"作为姓名
2. 如果没有"班内学号"列，系统将使用"N/A"作为学号
3. 系统会自动检测非数字行并排除，但建议检查"不参与计算的行"列表
4. 每个部分至少选择一列并设置完整的评分阈值才能进行分析
5. 评分阈值应按"优秀最低分,良好最低分,合格最低分"的顺序设置

## 技术支持

如果您在使用过程中遇到问题或有改进建议，请联系技术支持团队。

© 2025 交互式成绩分析工具 | 简化版