# 快捷键训练比赛系统

这是一个独立的小程序。学生账号直接使用原分组系统的 `selfgroup.db`；训练相关数据表也创建在同一个数据库里，但都带 `trainer_` 前缀，不会改动原来的分组表。

## 启动

在本仓库根目录执行：

```bash
python3 shortcut_trainer/app.py
```

- 学生端：<http://127.0.0.1:8010/>
- 教师端：<http://127.0.0.1:8010/teacher>

程序默认用 IPv4/IPv6 双栈监听所有网卡。启动日志会尽量列出本机可访问地址；学生从局域网访问时，选择老师电脑的局域网 IPv4，例如 `http://192.168.1.20:8010/`。

训练页使用 6 种高区分度整屏背景色，并显示超大页码水印，老师从学生屏幕缩略图即可快速确认是否切到了指定页面。

## 共享数据库

程序默认直接使用项目根目录：

```text
selfgroup.db
```

它读取其中的 `students` 表，登录会话写入原来的 `sessions` 表；训练数据保存在这些新表：

```text
trainer_presence
trainer_rounds
trainer_scores
trainer_events
```

所以你在原分组系统教师后台修改学生密码后，学生立刻可以用新密码登录快捷键训练系统。

如果你把 `selfgroup.db` 拷贝到了 `shortcut_trainer/` 目录，这个拷贝文件不会再被使用。可以移走它，避免以后混淆。如需指定其它共享数据库，可这样启动：

```bash
SHARED_DB=/path/to/selfgroup.db python3 shortcut_trainer/app.py
```

## 学生账号

教师端「学生账号」面板可以搜索学生、重置密码、添加新账号，改动直接写入共享的 `selfgroup.db`。

程序启动时会自动补齐这些测试账号（若学号已存在则跳过）：

| 学号 | 姓名 | 班级 | 密码 |
| --- | --- | --- | --- |
| test01 | 测试甲 | 测试 | test1234 |
| test02 | 测试乙 | 测试 | test1234 |
| test03 | 测试丙 | 测试 | test1234 |
| test04 | 测试丁 | 测试 | test1234 |
| test05 | 测试戊 | 测试 | test1234 |


程序启动时会自动读取学生名单库，优先使用：

1. `shortcut_trainer/selfgroup.db`（如果你把数据库拷贝到了这里）
2. 项目根目录的 `selfgroup.db`

教师端使用同一个 `settings` 表里的 `teacher_username` 和 `teacher_password`。如果原分组系统已修改过教师密码，快捷键教师端也使用修改后的密码。

## 课堂流程

1. 学生登录首页，允许 Chrome 弹出窗口。
2. 学生打开 4–6 个训练页；也可按 `Alt+P/Q/R/T/Y/U`。
3. 教师端用可视化表单发布指令：先选目标页面，再选“点击指定按钮”“多步快捷键”“右键菜单”“窗口操作”或“演示链接”，最后选具体目标；不需要手写 JSON。
4. 学生完成操作后，教师端实时显示前 10 名。

训练页按钮做成 Word 式功能面板：`Alt+K` 展开检测面板（`C` 燃料检查、`D` 系统诊断），`Alt+H` 展开推进面板（`R` 火箭准备、`T` 通讯开启），`Alt+B` 展开保障面板（`P` 备用电源、`L` 外部链接）。`L` 之后再按 `A` 打开百度，或按 `B` 打开 Bilibili。也可以继续用 `Alt+1` 到 `Alt+6` 或鼠标点击，判定相同。

## 可自动判定的操作

- 打开指定训练页；
- 点击指定页面按钮（支持按钮序号或名称：火箭准备、燃料检查、通讯开启、系统诊断、备用电源、外部链接）；
- 页面自定义右键菜单 + `E/R/C`；
- 外部链接菜单：`Alt+B` 后按 `L`，再按 `A` 打开百度或 `B` 打开 Bilibili。

## 浏览器限制

Chrome/Windows 会优先处理 `Ctrl+T`、`Ctrl+W`、`Ctrl+N`、`Alt+F4`、`Win+D` 等系统级快捷键；普通网页通常无法可靠拦截这些按键，也无法检测学生手工输入网址或真实窗口菜单。这些内容适合演示和人工观察。训练系统用自定义组合键和模拟窗口完成可计分练习。