# AI Coding 教学项目

**Repository Path**: thelongestday/ai-coding-demo

## Basic Information

- **Project Name**: AI Coding 教学项目
- **Description**: 这是一个教学用项目。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-15
- **Last Updated**: 2026-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai-coding-demo

一个用于教学演示与日常练习的 AI 编程示例仓库，包含课堂互动工具、成绩分析工具、示例数据，以及两套数据分析实践项目。所有 HTML 工具均为单文件、零依赖，双击即可在浏览器中使用。

## 目录结构

```
ai-coding-demo/
├── 班级成绩分析与教学报表工具.html     # 成绩分析 + 教学报表生成
├── 代码审查辅助工具.html               # 代码审查清单与报告生成
├── 课堂知识PK互动工具.html             # 双人知识抢答 / PK
├── 计算机基础知识题库.json             # PK 工具的示例题库
├── 计算机专业大一成绩.csv              # 示例成绩数据（40 人 / 5 门课）
├── Trae数据分析实战项目/               # Python + CSV 成绩分析实战
│   ├── analyze_grades.py               # 分析脚本（零第三方依赖）
│   ├── grades.csv                      # 示例数据
│   └── analysis_report.html            # 生成的 HTML 报告
└── 数据分析课程学情分析/               # 学情分析迭代项目
    ├── 第二版/                         # 报告 + 图表 + 看板
    └── 第三版/                         # 修正评分口径的报告与 ECharts 看板
```

## 内容说明

| 文件 / 目录 | 说明 | 使用方式 |
| --- | --- | --- |
| 班级成绩分析与教学报表工具.html | 粘贴 CSV 成绩后自动统计各科指标、生成图表，并输出可复制 / 打印的教学报表 | 浏览器直接打开 |
| 代码审查辅助工具.html | 按分类勾选审查清单、标记严重度并填写发现，自动汇总为审查报告 | 浏览器直接打开 |
| 课堂知识PK互动工具.html | 双人答题 PK，支持自定义题库、倒计时与历史战绩本地保存 | 浏览器直接打开，可导入 `计算机基础知识题库.json` |
| 计算机基础知识题库.json | 10 道计算机基础单选题，含选项、答案与答题时限 | 作为 PK 工具题库导入 |
| 计算机专业大一成绩.csv | 40 名学生、5 门课程的示例成绩数据 | 作为成绩工具的输入示例 |
| Trae数据分析实战项目/ | 读取 `grades.csv`，完成清洗、描述统计、SVG 图表，生成 HTML 分析报告 | `python3 analyze_grades.py` |
| 数据分析课程学情分析/第二版/ | 成绩分析报告、Matplotlib 图表与静态看板 | 打开报告 Markdown 或 `dashboard/index.html` |
| 数据分析课程学情分析/第三版/ | 修正三层评分口径后的学情报告与 ECharts 看板 | 运行 `analyze_report.py`、`generate_dashboard.py` |

## 快速开始

**HTML 工具**：直接双击对应 `.html` 文件，或在浏览器中打开即可，无需安装任何依赖。

**Python 分析脚本**：

```bash
# Trae数据分析实战项目：零第三方依赖，仅用标准库
cd Trae数据分析实战项目
python3 analyze_grades.py

# 数据分析课程学情分析/第三版：依赖 pandas、numpy、scipy、matplotlib
cd 数据分析课程学情分析/第三版
python3 analyze_report.py
python3 generate_dashboard.py
```

## 数据格式

- 成绩 CSV：表头为 `学号,姓名,班级,科目1,科目2,...`，成绩列填 0~100 的数值；空值、非数字与越界分数会被自动跳过。
- 题库 JSON：数组结构，每道题包含 `question`、`options`、`answer`（正确选项下标，从 0 开始）与 `timeLimit`（秒）。

## 许可证

本项目基于 [LICENSE](LICENSE) 中的条款开源。