用途:本技能让 AI 智能体访问芬兰学校信息系统 Wilma,供家长或监护人查看孩子的课表、作业、考试、成绩、课程反馈(merkinnät)、缺勤、消息与公告等。
主要能力:提供两类等价入口,返回相同 JSON 结构。MCP 工具(w ilma_* 系列,如 wilma_summary、wilma_schedule、wilma_homework、wilma_upcoming_exams、wilma_grades、wilma_gradebook、wilma_lesson_notes、wilma_list_messages、wilma_read_message、wilma_list_news、wilma_read_news、wilma_get_news_attachment、wilma_list_printouts、wilma_get_printout、wilma_account、wilma_find_school、wilma_login);或 CLI 命令 wilma / wilmai,执行即输出 JSON,可用 wilma help <command> 查看用法。默认覆盖所有孩子,可用 --student <编号|姓名> 限定。时间返回为芬兰时间含偏移(如 2026-10-02T13:37:00+03:00),按原样报告,不要换算。日期格式为 YYYY-MM-DD、today、yesterday 或 tomorrow。
典型用法:wilma summary [--since <date>] 做每日摘要;wilma schedule [today|tomorrow|week|next-week|<date>|<weekday>] 查课表;wilma homework 查作业;wilma exams 查考试;wilma grades / wilma gradebook 查成绩(含课程与成绩单);wilma notes [--date|--days N] 与 wilma notes summary 查课程反馈;wilma messages 与 wilma news 查消息和公告,附件用 wilma news <id> download <resource> 下载;wilma printouts 获取学校 PDF。
登录方式:用户在自己的电脑运行 wilma login,浏览器中选择学校并登录,登录信息保存在本机。云环境无浏览器时,先用 wilma find-school <city> 让用户选学校,再设置环境变量 WILMA_USERNAME、WILMA_PASSWORD,必要时加 WILMA_TOTP_SECRET,并设 WILMA_TENANT;也可用 wilma login --tenant <url> --username <name> --password-stdin。切勿让用户把密码输入聊天。多个 Wilma 的登录可一并保存,命令会复用最近会话。
安装:npm i -g @wilm-ai/wilma-cli。
限制与注意:需要已安装对应 CLI 2.x(wilma --version 若为 1.x 运行 wilma update);未保存登录时相关命令会返回 not_logged_in。错误以 JSON 返回,退出码 2 为用法错误,3 为未登录,1 为其他。对附件下载不预判,按 downloaded、not_a_file 或错误状态如实报告,不要循环重试。托管机器出现 TLS 证书错误时应报告提示,可按提示使用 NODE_USE_SYSTEM_CA=1,切勿建议 NODE_TLS_REJECT_UNAUTHORIZED=0。缺勤、成绩等信息依赖学校实际提供,某些部分可能 unavailable。资料未提供收费与价格信息。