Campuscard - 北大校园卡 CLI#

A CLI client for PKU's campus card system (Synjones platform at bdcard.pku.edu.cn).

Architecture#

• Crate location: crates/campuscard/
• Auth flow: IAAA SSO ( app_id="portal2017") → portal → berserker-auth → JWT
• API: JSON REST with synjones-auth header
• Constraints: Requires mobile UA ( PKUANDROID) and http1_only() (server rejects HTTP/2)

Key Source Files#

• src/main.rs — Clap CLI with subcommands
• src/commands.rs — Command implementations
• src/api.rs — API client with synjones-auth header injection
• src/display.rs — Terminal output, QR code rendering
• src/client.rs — reqwest client with mobile UA and HTTP/1.1 enforcement

CLI Commands#

CommandAliasFunctionlogin / logout / statusIAAA → portal → berserker → JWTinfoCard balance and detailspayDisplay payment QR code in terminalrechargeTop up card balancebills``lsTransaction history (pagination, monthly filter)statsMonthly spending statisticsotpTOTP 2FA management

Auto-Login for AI Agents#

bash

# Check session status
info-auth check

# Auto-login (reads credentials from OS keyring, no password needed)
campuscard login -p

Development Notes#

• The auth chain is the most complex: IAAA → portal → berserker-auth → JWT token
• Must use mobile User-Agent ( PKUANDROID) or requests will be rejected
• Must use http1_only() — the Synjones server does not support HTTP/2
• QR code for payment displayed via info_common::qr (viuer or system viewer)
• All user-facing strings in Chinese
• Error handling: anyhow::Result with .context("中文描述")
• Session persisted to ~/.config/info/campuscard/
• Credentials resolved via info_common::credential (keyring → env → interactive)