武汉科技大学强智教务系统 → ICS 日历，支持 Apple 日历 / Google 日历 / Outlook。
在任意国内服务器（阿里云/腾讯云/校园网主机/树莓派）上部署，完全自动化。
本来打算用 GitHub 的 workflows 自动化，结果学校的 CAS 登录页仅允许国内 IP 访问。
git clone https://github.com/xsddszrc/wust-schedule-ics.git
cd wust-schedule-ics
# 创建虚拟环境
python3 -m venv .venv
# 进入虚拟环境
source .venv/bin/activate
# 安装依赖
pip install playwright beautifulsoup4 ddddocr
# 可能需要以root权限运行下面的命令
playwright install --with-deps chromium
cp .env.example .env
编辑 .env：
WUST_USERNAME=你的学号
WUST_PASSWORD=你的密码
首次运行需要手动执行一次，完成登录：
.venv/bin/python generate_ics.py --login
自动完成 CAS 登录（验证码自动识别）→ 抓取课表 → 生成 schedule.ics。
之后脚本会自动检测 session 是否过期，过期则重新登录（同样自动识别验证码），无需再次手动 --login。
crontab -e
# 每周一早 8:00（先拉取更新，再执行）
0 8 * * 1 cd /path/to/wust-schedule-ics && git pull && .venv/bin/python generate_ics.py
git pull 用于拉取脚本的最新更新（验证码识别算法、教务系统适配等变动会持续推送）。
方式 A — 丢到现有（静态）网站目录下（最简单）：
# 假设你的网站根目录是 /var/www/html
.venv/bin/python generate_ics.py --output /var/www/html/schedule.ics
crontab -e
0 8 * * 1 cd /path/to/wust-schedule-ics && git pull && .venv/bin/python generate_ics.py --output /var/www/html/schedule.ics
推荐使用参数指定生成的文件放到静态网站目录下，而不是直接把这个仓库放到静态网站目录下（避免.env中的凭证被恶意窃取）
网站直接访问 http://yourdomain.com/schedule.ics 即可订阅。
方式 B — 独立端口（无需 Web 服务器，脚本自带 HTTP）：
# 启动 HTTP 服务（监听所有接口，如需仅本地访问可改为 127.0.0.1）
python3 -m http.server 9999 --bind 0.0.0.0 --directory /path/to/wust-schedule-ics &
# crontab
0 8 * * 1 cd /path/to/wust-schedule-ics && git pull && .venv/bin/python generate_ics.py
订阅链接：http://your-server-ip:9999/schedule.ics
注意：
&启动的后台进程在服务器重启后会消失。如需持久运行，建议用 systemd 或 supervisor 管理，或直接把--output写到已有 Web 服务的静态目录下（方式 A）。
仅支持 Linux（Windows 用户请用方案三）。在自己电脑上跑，电脑需要在周一早上开着（取决于你的 crontab 时间设置）。
安装部署同方案一，加上 crontab 即可。
安装 wust-schedule-ics.user.js → 登录教务 → 打开课表页面 → 点击”📅 导出ICS”。
零依赖（只需要浏览器安装油猴插件），适合偶尔手动导出。每次课表变化需重新操作。
| 命令 | 说明 |
|---|---|
.venv/bin/python generate_ics.py --login |
首次登录/强制重新登录 |
.venv/bin/python generate_ics.py --login --no-headless |
同上，显示浏览器窗口（调试用） |
.venv/bin/python generate_ics.py |
抓取课表，生成 ICS |
.venv/bin/python generate_ics.py --semester-start 2026-03-09 |
手动指定开学日期 |
.venv/bin/python generate_ics.py --output /path/example.ics |
指定导出目录 |
武科大 CAS 登录的验证码是简单算术加减乘除题（如 3+5=?、8×3=?）。流程：
截图验证码 → ddddocr 识别 → 后处理修正误识别 → 计算答案 → 填入
ddddocr 容易把数字误识别（如 0→o、1→l、9→g），对运算符的识别也有偏差（×→x/X、÷→?）。脚本内置了两轮修正：先修正数字字符，再将 x/X/× 归一化为 *（乘号）、÷ 归一化为 /（除号），然后根据实际运算符计算答案。单次识别准确率约 90%，配合最多 6 次重试，总体通过率接近 100%。
CAS 票据 2-8 小时过期，教务 session 更短。脚本每次运行先尝试已保存状态 → 如果过期则自动重新登录（ddddocr 识别验证码），用户无感知。
从 #kbtable 的 <div class="kbcontent"> 中提取每门课的：课程名、教师、教室、周次模式、节次范围。
周次支持 1-17、1,3-4,6-11,13,15,17 等复杂写法。节次支持 [01-02节]、[07-08-09-10节]（连堂课）等。连续周次生成 RRULE，不连续则逐周展开。
无需手动配置。脚本从课表页面读取当前是第几周，结合系统日期倒推：
第一周周一 = 今天的周一日期 − (当前周次 − 1) × 7 天
结果存到 .wust_ics_config.json，下次直接读取。换学期后自动重新检测。
默认使用黄家湖校区时间，青山校区时间在代码注释里。
| 大节 | 小节 | 时间 |
|---|---|---|
| 一 | 1-2 | 08:20-10:00 |
| 二 | 3-4 | 10:20-12:00 |
| 三 | 5-6 | 14:00-15:40 |
| 四 | 7-8 | 16:00-17:40 |
| 五 | 9-10 | 18:40-20:20 |
| 线上课 | 11-12 | 20:40-22:20 |
45 分钟/节，两小节间 10 分钟，两大节间 20 分钟。如需调整，修改 generate_ics.py 开头的 PERIOD_TIME 字典即可（key=节次号，value=开始/结束时间）。
| 文件 | 用途 |
|---|---|
generate_ics.py |
主脚本 |
wust-schedule-ics.user.js |
油猴脚本 |
.env.example |
凭证模板（参考填写） |
.env |
凭证（自己写） |
schedule.ics |
生成的日历（自己生成） |
wust_ics.log |
运行日志（每次运行追加） |
脚本每次运行都会在项目目录生成 wust_ics.log，终端输出的所有内容同步写入该文件。遇到问题请附上 wust_ics.log 文件内容，到 GitHub Issues 提交反馈。