Wilma

🎒 芬兰家长必备学业管家

芬兰Wilma家校系统CLI工具,安全获取学生课表、作业、考试与成绩,支持家长一站式追踪多子女学业动态

收藏
6.8k
安装
2.3k
版本
1.4.1
CLS 安全性认证2026-08-10
点击查看完整报告 >

使用说明

核心功能

Wilma Skill 是专为芬兰家长设计的学校信息系统接入工具,通过 wilma CLI 非交互式调用官方Wilma API,实现学生日程、作业、考试、成绩、通知和消息的自动化获取。核心入口为 wilma summary --json,可一次性输出今日/明日课表、近期作业、考试预告、新闻与消息的综合简报。

显著优点

  • 一站式整合:单命令聚合多维度学业数据,避免家长频繁登录多个系统
  • 多子女支持--all-students 与模糊姓名匹配,方便多孩家庭统一管理
  • 本地化安全:凭证仅存本地 ~/.config/wilmai/config.json,不上传第三方服务器
  • MFA兼容:支持TOTP自动续期,兼顾安全性与自动化体验
  • 结构化输出:全量--json接口,便于AI代理二次处理与日程工具集成

潜在局限

  • 地域受限:仅覆盖芬兰Wilma系统,国际用户无法使用
  • 依赖预配置:必须手动运行一次交互式CLI完成初始认证与凭证落盘
  • 无实时推送:纯拉取模式,无Webhook或主动通知机制
  • 版本敏感:CLI更新需手动执行wilma update,存在API变更风险

适合人群

芬兰K-12学生家长、教育管理AI代理开发者、需要批量同步子女学业数据的家庭

常规风险提示

  • 凭证泄露风险:本地JSON配置文件包含会话凭证,共享设备需设置文件权限
  • TOTP秘密存储:若启用自动MFA,TOTP secret以可逆形式本地保存,属便利性与安全性的权衡
  • 数据滞留:CLI缓存学生信息,设备遗失可能导致隐私泄露,建议配合磁盘加密

安全解读

核心用法

Wilma Skill 是芬兰广泛使用的 Wilma 学校信息系统的 AI 接入层,专为家长/监护人设计。用户需先通过 npm 全局安装 @wilm-ai/wilma-cli 并完成一次性交互式登录配置,生成本地凭证文件后,即可通过非交互式命令批量获取学生数据。

核心入口命令为 wilma summary --json,可一次性返回今日/明日课程、近期作业、 upcoming 考试、学校新闻与消息,是家长每日晨间 briefing 的最佳选择。此外支持细粒度查询:课程表可按天/周/指定日期筛选,作业与考试成绩独立列出,消息系统支持收件箱浏览与单条阅读。多子女家庭可通过 --all-students 批量获取,或指定学生 ID/名称片段进行模糊匹配。

对于启用了 MFA 的账户,Skill 支持两种认证模式:交互式配置保存 TOTP 密钥实现自动登录,或单次命令行传入 --totp-secret 参数。所有输出均采用结构化 JSON,便于 AI 解析生成自然语言摘要。

显著优点

1. 功能聚焦,场景明确:精准解决芬兰家长每日查看 Wilma 的重复劳动,将分散在网页各栏目的课程、作业、考试、消息聚合为单一 JSON 输出,AI 可直接生成"今日待办"行动清单。

2. 本地化体验优化:支持芬兰语星期缩写(ma/ti/ke/to/pe/la/su),模糊匹配学生姓名,贴合本地用户习惯。

3. 安全架构合理:凭证本地化存储(~/.config/wilmai/config.json),无云端中继;数据传输通过 Wilma 官方 CLI 走 HTTPS/TLS 1.2+,符合 GDPR 数据处理合法性要求。

4. 行动导向的摘要指导:文档内置"Actionability guidance",明确教导 AI 区分"需立即处理"(表格回执、材料准备、deadline)与"纯信息通知",帮助家长优先关注真正重要的事项。

潜在缺点与局限性

1. 地域与系统锁定:仅支持芬兰 Wilma 系统,无法兼容其他国家/地区的教育平台,适用范围高度垂直。

2. 外部依赖单一:核心功能完全依赖 npm 包 @wilm-ai/wilma-cli,若该包停止维护或遭遇供应链攻击,Skill 将失效。目前为个人开发者维护,长期稳定性存疑。

3. 配置门槛存在:需用户具备基础 CLI 操作能力完成初始安装与交互式认证,对纯小白用户不够友好。

4. 无离线能力:所有数据实时拉取 Wilma 服务器,网络中断或 Wilma 服务维护时无法使用。

适合的目标群体

  • 芬兰 K-12 学生家长/监护人:需要每日跟踪多子女课业安排、考试与学校通知的双职工家庭。
  • 教育助理与特教协调员:需批量获取所负责学生的日程数据,生成周报或干预计划。
  • AI 工作流构建者:希望将家校信息自动化接入家庭智能助手(如晨间播报、日程同步日历)的技术型家长。

使用风险

性能风险:外部 CLI 调用存在进程启动开销,高频查询(如每分钟轮询)可能触发 Wilma 速率限制或导致本地资源占用上升。

凭证安全风险:本地配置文件若权限设置不当(未 chmod 600),多用户系统下可能被其他账户读取;设备丢失或被盗时会话凭证存在泄露可能。

供应链风险:依赖的 npm 包由同一个人开发者维护,无组织级代码审计,建议定期运行 npm audit 并锁定版本。

数据敏感性:处理未成年人教育数据,需确保符合家庭内部隐私共识,避免 AI 日志无意留存敏感信息。

维护可持续性:T3 来源项目,若维护者停止更新,可能出现与 Wilma API 变更不兼容的情况,建议关注 GitHub 仓库活跃度。

Wilma 内容

scripts文件夹
手动下载zip · 2.7 kB
wilma-cli.shtext/x-shellscript
请选择文件