cwfw

cwfw - 北大财务综合信息门户 CLI

A CLI client for PKU's financial information portal at cwfw.pku.edu.cn (WF_CWBS subsystem).

Architecture

• Crate location: crates/cwfw/
• Auth flow: IAAA SSO (app_id="IIPF") → cwfw.pku.edu.cn/WFManager/home2.jsp → findpages_postData.action → home3.jsp → WF_CWBS 子系统 entry（3 步 bootstrap 缺一不可）
• API: HTML 抓取 + 加密的 form 字段

Key Source Files

• src/main.rs — tokio::main 调用 pku_cwfw::run()
• src/lib.rs — Clap CLI 定义
• src/client.rs — reqwest client
• src/login.rs — IAAA → multi-step bootstrap → WF_CWBS session
• src/context.rs — 会话上下文（子系统 URL 等）
• src/encrypt.rs — 表单字段加密（用于某些查询请求）
• src/api.rs — 各查询 API
• src/commands.rs — 子命令实现
• src/display.rs — 终端渲染

CLI Commands

Command	用途
login -p	IAAA 登录 + cwfw 多步 bootstrap
status / logout	会话管理
个人酬金 / 工资 / 报销查询	详见 --help

Auto-Login for AI Agents

info-auth check
cwfw login -p
cwfw <query-cmd>

Development Notes

• 多步 bootstrap 必须严格顺序执行，否则后续子系统访问会返回登录页
• Session 持久化 ~/.config/info/cwfw/
• 所有文案中文，anyhow::Result + .context("中文描述")
• 某些表单字段需要加密（见 encrypt.rs），算法直接抄自网页 JS