智能课程表一键速查助手

基于 WebUntis 官方 API 的学生课程表只读查询工具，支持多账户配置，帮助师生快速获取日程、教室及代课信息。

基本信息

• 技能名称?webuntis
• 中文名称?智能课程表一键速查助手
• 作者?finnbusse
• 分类?效率
• 版本?v1.0.1
• 标签?education-research, productivity, api, automation

使用方法

使用说明
核心用法
webuntis skill 通过调用 WebUntis 官方 JSON-RPC API，为用户提供学生课程表的只读查询能力。用户需通过环境变量配置学校服务器地址、校名、账号密码等凭证，即可使用 today 命令查询当日课表，或使用 range 命令指定日期范围获取完整日程。该 skill 支持多账户并行配置，通过 --profile 参数切换不同学生档案，适合管理多个学生账户的家庭或教育机构场景。
显著优点

1. 功能聚焦单一 ：仅执行只读查询，无写入操作，从根本上降低数据损坏风险。
2. 凭证管理规范 ：强制使用环境变量传递敏感信息，避免密码硬编码或命令行泄露。
3. 多账户支持 ：内置 profile 机制，可并行管理多个学生账户，扩展性强。
4. 输出简洁直观 ：每行课程信息包含日期时间、科目、教室、教师，便于快速浏览和二次处理。
5. 自动 ID 推断 ：支持自动检测 element-id，降低配置门槛。
   潜在缺点与局限性
   依赖外部服务 ：完全依赖学校 WebUntis 实例的可用性和网络连通性，若学校服务器故障则无法使用。
   仅支持学生视角 ：默认 element_type 为 5（学生），教师或教室视角需手动配置，文档说明有限。
   无缓存机制 ：每次查询均实时请求 API，高频调用可能触发学校端限流。
   错误处理较基础 ：自动检测失败时需用户手动查找 element-id，对非技术用户不够友好。
   适合的目标群体
   需要定期查看孩子课程表的家长
   希望自动化日程提醒的学生
   教育机构 IT 管理员集成至内部系统
   开发教育类应用的工程师作为数据层组件
   使用风险
   凭证安全 ：虽使用环境变量，但若部署环境日志配置不当，仍可能泄露敏感信息。
   网络稳定性 ：HTTPS 依赖学校证书有效性，证书过期或配置错误将导致连接失败。
   API 变更风险 ：WebUntis 官方 API 若发生不兼容更新，skill 可能需同步维护。
   性能瓶颈 ：大规模并发查询可能受限于学校服务器响应能力，不适合高并发场景。