# auto_bishe

**Repository Path**: swxu_2005/auto_bishe

## Basic Information

- **Project Name**: auto_bishe
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# auto_bishe

自动化毕业设计成绩录入工具

## 功能

| 脚本 | 对应环节 | 读取 Sheet |
|------|----------|------------|
| `submit_tutor_scores.py` | 指导教师评分 | `指导教师评分` |
| `submit_defense_scores.py` | 答辩成绩提交 | `答辩成绩` |
| `submit_final_scores.py` | 最终成绩提交 | `最终成绩` |

**评语自动生成**：Excel 中评语字段有内容则直接使用；若为空，`comment_generator.py` 会根据分数区间从软件技术专业方向的模板库中随机选取一条填入（优秀/良好/中等/及格/不及格各备有 10-15 条模板）。

## 目录结构

```
auto_bishe/
├── submit_tutor_scores.py     # 指导教师评分脚本
├── submit_defense_scores.py   # 答辩成绩脚本
├── submit_final_scores.py     # 最终成绩脚本
├── comment_generator.py       # 评语模板库
├── config.json                # 账号配置模板
├── 毕设打分模板.xlsx            # 打分数据（三个 Sheet）
└── reference/                 # 接口文档与参考代码（不入库）
```

## 快速开始

### 1. 安装依赖

```bash
pip install requests openpyxl beautifulsoup4
```

### 2. 创建账号配置文件

复制模板并填入真实账号密码：

```bash
cp config.json config_mine.json
```

编辑 `config_mine.json`：

```json
{
    "username": "你的工号",
    "password": "你的密码",
    "excel_path": "/path/to/毕设打分模板.xlsx"
}
```

`excel_path` 为打分 Excel 的路径（绝对路径或相对脚本的相对路径），默认值为 `毕设打分模板.xlsx`。

> `config_*.json` 已加入 `.gitignore`，不会被提交。

### 3. 准备打分数据

在 `毕设打分模板.xlsx` 中填写数据，共三个 Sheet：

- **指导教师评分**：学生姓名、课题名称、各项子分（num1-num9）、合计、评语
- **答辩成绩**：学生姓名、课题名称、打分列（`答辩组长-打分` / `评委N-打分`）、姓名列（`答辩组长` / `评委N`）、最终成绩、答辩记录、评语
- **最终成绩**：学生姓名、顶岗实习（文字等级）、毕业综合实践（分数，支持小数）、指导教师评语

### 4. 运行脚本

```bash
python submit_tutor_scores.py config_mine.json
python submit_defense_scores.py config_mine.json
python submit_final_scores.py config_mine.json
```

## 注意事项

- **答辩成绩**：`submit_defense_scores.py` 中的 `TEACHER_ID_MAP` 须包含所有参与答辩的教师，否则脚本会报错提示补充。
- **最终成绩**：顶岗实习成绩须为中文等级（`优秀` / `良好` / `中等` / `及格` / `不及格`），脚本自动转换为对应数值。
- **评语字段**：评语列留空时自动生成，有内容时原样提交，不会被覆盖。
- **学生范围**：脚本以系统中爬取到的学生名单为准循环处理，Excel 中属于其他教师的学生会被自动忽略，无需手动删除。
- **重复提交**：系统接口为"编辑"操作，重复运行会覆盖已有成绩，请确认数据无误后再执行。