xhh678876/openclaw-sjtu/sjtu-deadlines

SJTU 跨平台 DDL 聚合

把分散在 Canvas / phycai / icourse163 / lcme 几家平台的截止任务收成一张统一表,支持文本/JSON 两种输出与系统通知。

When to Invoke

• 用户问"我未来有什么 DDL / 作业 / 实验"
• "下次实验/测验是什么时候"
• 跨平台对比"哪些截止已过 vs 即将到来"
• 跟 launchd 定时任务对接(--remind-check)

不该用本 skill 的情形:

• 只关心 Canvas → 用 scripts/canvas_api.py ddls(老 skill,更细)
• 要登录刷新 cookies + 抓全部内容(课表/校历/...) → 用 sjtu-oneshot

Architecture

scripts/unified_ddl.py        ← CLI 入口
   └─ scripts/platforms/      ← 每平台一个适配器
       ├─ base.py             (DDLItem dataclass + BasePlatform abc)
       ├─ phycai.py           (物理实验排课;校内域名,需 VPN)
       ├─ icourse163.py       (中国大学 MOOC;互联网公网可达)
       ├─ lcme.py             (机动学院 openlab;校内域名,需 VPN)
       └─ calendar_sjtu.py    (校历;互联网公网可达)

每个适配器实现 login() + list_ddls() -> list[DDLItem]。unified_ddl 惰性导入,某家挂掉不拖累其他。

Usage

# 文本表(默认)
python3 -m scripts.unified_ddl
 
# JSON(给程序用)
python3 -m scripts.unified_ddl --json
 
# 跳过某家
python3 -m scripts.unified_ddl --skip phycai lcme
 
# 检查 70 分钟内即将到期 + macOS 通知(launchd 调这个)
python3 -m scripts.unified_ddl --remind-check

凭据 / Cookies

• 走 config.json 里各平台的 *_cookies。若过期,先跑 sjtu-oneshot 刷新
• icourse163 需要 .env 设 MOOC_USERNAME / MOOC_PASSWORD + config.json 里 icourse_courses 数组
• lcme 默认用 jAccount 同账号密码;不同时单独填 lcme_username / lcme_password

已知限制(校外网)

校外网跑会出现 ERR_NAME_NOT_RESOLVED,不是 bug,是网络环境限制。可以 --skip phycai lcme。

launchd 集成

python3 -m scripts.scheduler.launchd install daily-report
python3 -m scripts.scheduler.launchd install remind-check

• daily-report 每天 22:00 跑 unified_ddl --notify
• remind-check 每分钟跑 --remind-check 检测 70min 内即将到期

Safety

• macOS 通知里课程/作业名走 _applescript_escape 转义,避免被注入 do shell script
• 凭据不上 CLI argv;--pass 已加 ps-aux 警告,缺密码时 getpass 交互式询问

测试

.venv/bin/python -m pytest tests/test_platform_parsers.py -v