# 关于职教智慧云的签到研究

本项目记录对“职教智慧云” App 及其 Flutter 框架的研究，以及如何从日志中获取 Cookie、请求课程与打卡信息并完成打卡的基本实践。理论上可以直接跳过蓝牙设备验证进行远程打卡

- 目标：从日志中截取 `token`，获取课程与打卡信息，并执行打卡。
- 平台：Android；命令示例包含 Windows PowerShell 与 Linux/macOS 两种形式。

## 1. 抓取 Cookie（token）

连接 Android 设备后，查看 Flutter 在 Dart 层输出的日志并筛选包含 `cookie` 的行。

Windows（PowerShell）：
在此之前您需要安装安卓调试工具（platform-tools）

```powershell
adb shell
logcat -s flutter | grep -i cookie
```

Linux/macOS：

```bash
adb logcat -s flutter | grep -i cookie
```

从输出中截取形如 `token=XXXX` 的值，后续作为请求头中的 Cookie 使用。

## 2. 获取课程与打卡信息

接口地址：`https://m-zjt.kefang.net/api/zms/zhijiaotong/page/homePageData`

通用请求头（表单）：

```http
User-Agent: Dart/3.6 (dart:io)
Accept-Encoding: gzip
Content-Type: application/x-www-form-urlencoded
Cookie: token=YOUR_TOKEN
```

示例（PowerShell/curl）：

```powershell
curl --silent `
    -H "User-Agent: Dart/3.6 (dart:io)" `
    -H "Accept-Encoding: gzip" `
    -H "Content-Type: application/x-www-form-urlencoded" `
    -H "Cookie: token=YOUR_TOKEN" `
    "https://m-zjt.kefang.net/api/zms/zhijiaotong/page/homePageData"
```

示例（Linux/macOS/curl）：

```bash
curl -s \
    -H "User-Agent: Dart/3.6 (dart:io)" \
    -H "Accept-Encoding: gzip" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Cookie: token=YOUR_TOKEN" \
    "https://m-zjt.kefang.net/api/zms/zhijiaotong/page/homePageData"
```

从响应中提取 `contentId` 以及后续需要的 `attendanceId` 等字段。

## 3. 提交打卡

接口地址：`https://m-zjt.kefang.net/api/zms/attendance/attendanceRecord/punchCourseByStudent`

方法：`PUT`；`Content-Type`：`application/x-www-form-urlencoded`

示例（PowerShell/curl）：

```powershell
curl -X PUT `
    -H "User-Agent: Dart/3.6 (dart:io)" `
    -H "Accept-Encoding: gzip" `
    -H "Content-Type: application/x-www-form-urlencoded" `
    -H "Cookie: token=YOUR_TOKEN" `
    -d "attendanceId=YOUR_ATTENDANCE_ID" `
    "https://m-zjt.kefang.net/api/zms/attendance/attendanceRecord/punchCourseByStudent"
```

示例（Linux/macOS/curl）：

```bash
curl -X PUT \
    -H "User-Agent: Dart/3.6 (dart:io)" \
    -H "Accept-Encoding: gzip" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -H "Cookie: token=YOUR_TOKEN" \
    -d "attendanceId=YOUR_ATTENDANCE_ID" \
    "https://m-zjt.kefang.net/api/zms/attendance/attendanceRecord/punchCourseByStudent"
```

您可在项目文件 main.py 中查看示例脚本
返回结果若包含“操作成功”的 `message`，则表示打卡成功。

## 4. 常见问题

- `token` 过期：重新通过日志抓取；或在 App 内重新登录再抓取。
- 403/401：检查 `Cookie` 是否正确；确认 `Content-Type` 是否为表单。
- 字段变动：以实际接口响应为准，名称或层级可能更新。

## 5. 注意事项

- 仅用于学习与研究，请勿用于任何不当用途。
- 请妥善保护个人隐私与账号安全。
- 操作前请确保已安装 `adb` 并正确连接设备。