核心功能
WebUntis skill 提供对学校 Untis/WebUntis 教务系统的只读访问,用于获取学生课程表信息。通过封装好的 Python 脚本,支持查询今日课程、指定日期范围或本周课表,输出包含科目、教室、任课教师及代课安排的结构化数据。
显著优点
1. 操作便捷:单行命令即可获取格式化课表,无需手动登录网页
2. 信息完整:自动整合科目、教室、教师、代课(substitutions)等关键信息
3. 灵活查询:支持 today/range 等多种查询模式,适应不同场景
4. 安全设计:明确要求凭证通过环境变量注入,禁止聊天中输入密码
潜在局限
1. 依赖学校系统:需学校部署 WebUntis 并开放接口,部分学校可能限制 API 访问
2. 配置门槛:首次使用需正确配置 WEBUNTIS_BASE_URL、WEBUNTIS_SCHOOL 等 4-5 个环境变量,element_id 自动检测失败时需手动查找
3. 只读限制:无法修改课程、申请调课或进行其他写操作
4. 单用户视角:默认以学生身份查询,查看其他类型(教师/教室)课表需调整 element_type
适合人群
- 需要快速查看今日/本周课程的学生
- 希望自动化课表提醒或集成的开发者
- 家长协助管理子女学习计划
常规风险提示
- 凭证泄露风险:环境变量配置不当可能导致账号信息暴露
- 建议优先使用学校提供的只读学生账号,降低权限滥用风险
- 频繁查询可能触发学校接口限流