szu-cli 是面向深圳大学网页服务的 agent-friendly CLI。
它把常用校园网页能力整理成稳定命令和结构化 JSON 输出，同时复用本机持久化浏览器登录态，不保存账号密码。
要求 Node.js 20 或更高版本。
安装正式版，并把随包附带的 skill 安装到 Codex：
npm install -g szu-cli && szu-cli skill install --target codex --json或者安装到 WorkBuddy 或 Claude Code：
npm install -g szu-cli && szu-cli skill install --target workbuddy --json
npm install -g szu-cli && szu-cli skill install --target claudecode --json如果已经安装过 szu-cli，也可以只安装 skill：
szu-cli skill install --target codex --json
szu-cli skill install --target workbuddy --json
szu-cli skill install --target claudecode --json生成 AI IDE 便携 skill 目录：
szu-cli skill install --target ai-ide --dest ./SZU-Campus.skill --json初始化浏览器登录态：
szu-cli auth login
szu-cli auth status --jsonauth login 会打开一个持久化浏览器 profile。你在正常网页里完成登录后，后续命令会复用 ~/.szu-cli/browser-profile/ 下的登录态。
Windows 上默认使用系统 Chrome 通道。如需使用 Edge：
$env:SZU_BROWSER_CHANNEL='msedge'
szu-cli auth login
szu-cli auth status --json| 模块 | 实现的功能 | 示例命令 |
|---|---|---|
| 环境与认证 | 检查运行环境、浏览器后端和当前登录状态 | szu-cli doctor --jsonszu-cli auth status --json |
| 公文通 | 查询公告列表、搜索公告并读取正文和附件信息 | szu-cli notice list --limit 10 --jsonszu-cli notice search 奖学金 --json |
| 个人课表 | 查询本学期课表或当天课程 | szu-cli course list --jsonszu-cli course today --json |
| 全校课表与培养方案 | 查询班级课表、培养方案及课程模块 | szu-cli timetable classes --limit 5 --jsonszu-cli program list --limit 5 --json |
| 成绩与学业进度 | 查询成绩、GPA、思政学分和培养方案完成情况 | szu-cli grade list --jsonszu-cli completion summary --json |
| 创新领航讲座 | 查询可报名讲座、讲座详情和个人学习进度 | szu-cli lecture list --jsonszu-cli lecture progress --json |
| 体育场馆 | 查询场馆和可预约时段，预览预约或取消操作 | szu-cli sports slots --campus 粤海校区 --venue 一楼重量型健身 --date 2026-07-08 --jsonszu-cli sports reserve --campus 粤海校区 --venue 一楼重量型健身 --date 2026-07-08 --slot 20:00-21:00 --field 一楼健身房 --dry-run --json |
| 宿舍电费 | 查询可用楼栋及指定房间的用电余额 | szu-cli electricity query --campus 深大新斋区 --building 红豆斋 --room 838 --json |
| 图书馆馆藏 | 搜索图书并查询馆藏位置、索书号和借阅状态 | szu-cli library search 交通设计 --jsonszu-cli library item 3706432 --json |
| 知网 | 在用户可见浏览器中检索论文元数据和详情 | szu-cli cnki search 交通设计 --headed --json |
| 万方 | 在用户可见浏览器中检索论文元数据和详情 | szu-cli wanfang search 交通设计 --headed --json |
Agent 或用户
-> szu-cli 命令契约
-> 校园事务模块
-> direct / WebVPN 网关
-> Playwright 持久化浏览器 profile
-> 深圳大学网页系统
skill 只负责告诉 agent 何时、如何安全调用 szu-cli。核心登录态、网页解析和校园业务逻辑都放在 CLI 中。
- 不收集账号密码。
- 不绕过登录、验证码、WebVPN、访问控制或频率限制。
- 默认优先实现只读能力。
- 不做高频抓取或批量下载。
- 状态变更命令必须先支持
--dry-run。sports reserve和sports cancel的真实状态变更都必须显式--confirm，不自动支付、不取消支付。 - 不把 cookies、浏览器 profile、截图、HAR、trace 等本地敏感文件提交到 Git。
MIT