核心用法
Wilma Skill 通过 wilma CLI 将芬兰广泛使用的 Wilma 家校信息系统与 AI 代理集成。核心工作流以 wilma summary --json 为起点,一次性获取当日/次日课表、近期作业、 upcoming 考试、新闻与消息的综合简报。支持按学生维度(--student 或 --all-students)精确查询,涵盖课表、作业、考试、成绩、新闻、消息六大模块。所有命令均输出结构化 JSON,便于 AI 解析与二次处理。
显著优点
- 一站式数据聚合:单条命令即可生成完整每日简报,显著降低家长信息获取成本
- 多学生家庭友好:原生支持
--all-students批量查询,避免重复操作 - 结构化输出:
--json模式确保机器可读,适配自动化工作流 - 模糊匹配:学生姓名片段即可定位,提升交互容错性
- 本地化优先:数据存储于
~/.config/wilmai/,符合 XDG 规范
潜在局限与风险
- 地域限制:仅覆盖芬兰 Wilma 系统,无国际扩展性
- 认证依赖:需预先运行交互式 CLI 完成登录并持久化 session,自动化场景下存在凭证刷新中断风险
- CLI 版本漂移:
wilma update需手动触发,旧版本可能面临 API 兼容性断裂 - 权限边界:依赖 Wilma 账户本身的角色权限(家长/监护人),无法突破系统级限制
- 数据敏感性:教育记录属 GDPR 特殊类别个人数据,本地存储需配合磁盘加密
适合人群
- 芬兰 K-12 学生家长/监护人
- 教育科技开发者构建家校助手场景
- 多子女家庭寻求信息聚合效率工具
常规风险
- Session 过期导致服务中断,需交互式重新授权
- 本地配置文件若未加密存储,存在凭证泄露风险
- CLI 异常返回非结构化错误文本,需健壮的 stderr 处理