PKU BDKJ

这是一个面向北京大学空间学术研讨教室的 Rust 命令行工具说明：覆盖 IAAA 单点登录与会话管理、按教学楼查询教室、查询已约时段与学生信息、提交和取消预约，以及参与人分组持久化；同时给出 crate 目录结构、各源文件职责与关键实现注意事项。

wjsoj

热度 33.80

最近更新 2026-05-18 11:44:02

分类：协作依赖：代码执行 / 读写文件 / 第三方 API应用场景：日程安排 / 任务管理 / 工作流 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add pku-bdkj

Metadata

name: bdkj
description: 北京大学空间 (bdkj.pku.edu.cn) 学术研讨教室预约 CLI 工具。当用户提及 bdkj、北大空间、学术研讨教室、教室预约、研讨间、借教室或想要查询/预约/取消二教/四教/地学教学楼里的空闲学术研讨教室时使用此 skill。支持保存固定参与人分组（如课题组），重复发起预约时只需 `--group <名字>`。Also use when dealing with bdkj IAAA SSO callback (app_id=bdkj), `/room/classRoom` / `/classRoom/seachStudent` / `/classRoom/handle/submit` 这些端点，或 bdkj groups.json 持久化。
version: 1.0.0

bdkj - 北大空间学术研讨教室预约 CLI

A CLI client for PKU's academic discussion room reservation system at bdkj.pku.edu.cn.

Architecture

Crate location: crates/bdkj/
Auth flow: IAAA SSO (app_id="bdkj") → /login/oauth 回调种 JWTUser/SESSION/rememberMe cookies
API: 混合 JSON (/room/classRoom, /classRoom/seachStudent, /classRoom/historyTime) + HTML form 步骤 (/classRoom/applyStep, /classRoom/handle/submit) + GET 取消 (/classRoom/cancelApply/<id>)
HTML 列表：用 scraper 解析 div#results > div.row

Key Source Files

src/main.rs — tokio::main，调用 pku_bdkj::run()
src/lib.rs — Clap CLI 定义 + dispatch
src/client.rs — reqwest client 构造
src/login.rs — IAAA 登录 + JWTUser cookie 提取
src/api.rs — 教室/时段/学生/提交/取消/列出的核心 API
src/commands.rs — 各子命令实现
src/display.rs — 终端渲染（colored）
src/groups.rs — 参与人分组持久化（~/.config/info/bdkj/groups.json）

CLI Commands

Command	用途
`login -p`	IAAA 密码登录（keyring → env → interactive）
`status` / `logout`	会话管理
`rooms <building>`	列出教学楼下所有教室（二教/四教/地学）
`history <room_id>`	查询教室已被预约时段
`student <serial> <name>`	查询学生信息
`list` / `ls`	列出当前用户的预约记录
`reserve --room-id ... --begin ... --end ... --reason ... -g <group>`	提交一次预约（用分组）
`reserve ... -p 学号:姓名 -p ...`	提交一次预约（手动列参与人）
`cancel <apply_id>`	取消一次预约
`group list` / `show <name>` / `set <name> -p ...` / `remove <name>`	管理参与人分组

--group 与 --participant 互斥；两者必须至少指定一个。申请人自己也必须包含在参与人列表中。

Auto-Login for AI Agents

info-auth check
bdkj login -p              # 读 keyring，不需要密码
bdkj group set lab -p 2200011523:张三 -p 2200011524:李四
bdkj reserve --room-id 924131235851276288 \
  --begin "2026-04-20 14:00:00" --end "2026-04-20 16:00:00" \
  --reason "课题组讨论" -g lab

Development Notes

所有文案中文
错误用 anyhow::Result + .context("中文描述")
Session 持久化 ~/.config/info/bdkj/；groups 在同目录下 groups.json
submit_apply 的成功判据是重定向后 URL path 为 /classRoom，而不是扫 layer.msg（页面模板里有无关的 layer.msg 调用会误命中）
教室/教学楼 ID 需要硬编码的 building 常量（见 api.rs）