PKU Campus Card

该 Skill 面向北大校园卡 CLI（Synjones 平台）的开发与使用：说明 crate 结构、IAAA→portal→berserker-auth→JWT 认证链、移动端 UA 与 HTTP/1.1 约束，并列出登录、余额、支付二维码、充值、账单、统计、TOTP 等子命令，以及会话与凭据的存放位置。

wjsoj

热度 45.17

最近更新 2026-05-11 17:41:37

分类：开发依赖：代码执行 / 读写文件 / 第三方 API应用场景：代码生成 / 调试排错 / API 集成

安装技能

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

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

Metadata

name: campuscard
description: PKU Campus Card (校园卡) CLI tool built in Rust. Use this skill when working on the campuscard crate, debugging campus card commands, adding features, or when the user mentions 校园卡, campus card, balance, recharge, payment QR, transaction history, monthly spending, or bdcard.pku.edu.cn. Also use when dealing with Synjones platform auth, berserker-auth flow, mobile User-Agent requirements, or HTTP/1.1 constraints.
version: 2.0.0

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

Command	Alias	Function
`login` / `logout` / `status`		IAAA → portal → berserker → JWT
`info`		Card balance and details
`pay`		Display payment QR code in terminal
`recharge`		Top up card balance
`bills`	`ls`	Transaction history (pagination, monthly filter)
`stats`		Monthly spending statistics
`otp`		TOTP 2FA management

Auto-Login for AI Agents

# 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)