XMU IQA Helper (厦门大学自动评教助手) 🚀

你是否也曾因为评教时需要面对几十门课程、几百个单选框而感到无比烦躁？ 你是否觉得把宝贵的生命浪费在机械点击“非常满意”上是一种折磨？

这是一个专为厦门大学学生评教系统（IQA）打造的全自动化脚本。它存在的唯一目的，就是帮你从枯燥、重复的点击与下拉中彻底解脱。你只需要完成登录，剩下的交给脚本——实现“登录即挂机，片刻即完成”的极致评教体验。

✨ 功能特性

• 全自动处理：自动遍历所有待评教课程。
• 智能识别：自动跳过已结束或已完成的评教项目。
• 万能评价：主观题自动填充正向万能回复。
• 精准评分：客观分自动计算并填充（默认接近满分）。
• 安全清理：运行结束后自动关闭浏览器上下文，不留痕迹。

---

🛠️ 环境要求

项目基于 Python 3.13 开发，使用 uv 或 pip 管理依赖。

• Python: >= 3.13
• 核心依赖: playwright (浏览器自动化库)

---

🚀 快速开始

1. 克隆或下载本项目

确保你的目录下包含 main.py、pyproject.toml 等文件。

2. 安装环境

推荐使用 uv：

# 安装依赖
uv sync
# 安装浏览器内核
uv run playwright install chromium

或者使用普通的 pip：

pip install playwright
playwright install chromium

3. 运行脚本

执行以下命令启动自动化程序：

python main.py

4. 使用步骤

1. 脚本启动后会打开一个 Chrome 浏览器窗口并跳转至统一身份认证登录页。
2. 使用统一认证完成登录。
3. 一旦进入评教系统首页，脚本将接过控制权，开始自动执行。
4. 请勿在自动化运行期间关闭窗口或手动点击，直至终端显示“评教完成”。

---

📝 预设参数说明

你可以在 main.py 的顶部修改以下内容来个性化你的评教：

• REPLY: 默认主观题回复内容。当前设为："教学认真负责，各方面都做得很好。"
• 评分逻辑: 脚本会自动获取该题满分并填入 满分 - 0.01。

---

⚠️ 免责声明

• 本项目仅供学习 Playwright 自动化技术使用。
• 请在法律和校规允许的范围内使用。
• 评教是学生的权利与义务，建议对确实有反馈需求的课程进行手动认真填写。

---

🤝 贡献与反馈

如果你在厦门大学评教系统更新后发现脚本失效，欢迎提交 Issue 或 Pull Request！