核心用法
Wilma Skill 是专为芬兰学校信息系统 Wilma 设计的 AI 代理集成工具。通过 wilma/wilmai CLI 的非交互模式，代理可程序化获取学生数据，包括消息、新闻、考试安排、出勤记录等关键信息。
安装与配置
- 全局安装：
npm i -g @wilm-ai/wilma-cli - 需用户先运行一次交互式 CLI 创建
~/.config/wilmai/config.json配置文件 - 后续所有操作使用
--json标志确保机器可解析输出
主要功能
wilma kids list --json：列出关联的所有学生wilma news list --student <id> --json：获取指定学生的新闻公告wilma messages list --student <id> --folder inbox --json：读取收件箱消息wilma exams list --student <id> --json：获取考试日程- 支持
--all-students批量查询所有学生数据 wilma messages read <id>/wilma news read <id>：读取具体内容- 支持学生姓名片段模糊匹配
智能摘要策略
Skill 内置优先级指导原则，帮助 AI 区分紧急事项与普通通知：优先标记需家长操作的事项（表格回复、出勤确认、材料准备）、含截止时间的任务、行程变更（校外活动、主题日、考试安排）；过滤纯信息性内容。输出格式为结构化摘要，附带日期和消息 ID。
显著优点
1. 官方生态集成：由 @wilm-ai 组织维护，非第三方逆向工程，API 稳定性有保障
2. 家长场景优化：内置"可执行性"判断逻辑，减少信息噪音，直接提取"需要做什么"
3. 批量处理能力：支持多学生家庭的一键式全景概览
4. 非侵入式设计：复用用户已有的 Wilma 认证会话，无需额外账号体系
潜在局限与风险
功能性限制
- 依赖用户预配置的认证文件，无法独立完成首次登录流程
- 若认证过期，需人工重新运行交互式 CLI
- 模糊匹配学生姓名时可能产生歧义
地域与语言约束
- 仅限芬兰 Wilma 系统使用，不兼容其他国家学校平台
- 原始数据为芬兰语/瑞典语，AI 摘要质量取决于模型多语言处理能力
隐私合规考量
- 处理未成年人教育数据，需确保符合 GDPR 及芬兰《数据保护法》
- 本地配置文件含敏感会话令牌，需妥善保护文件权限（建议 600）
可用性风险
- 若 Wilma 官方 API 变更，CLI 可能需紧急更新
- 学校级定制字段可能无法被通用 schema 完整解析
适合人群
- 多子女家庭家长：需要同时追踪多个孩子学校动态的忙碌父母
- 日程管理重度用户：希望将学校通知自动同步至个人日历/待办系统的用户
- 芬兰新移民家长：借助 AI 翻译和理解复杂的学校行政沟通
- 特殊教育需求家庭：需精细监控出勤、考试调整等关键变动的监护人
常规风险提示
| 风险类别 | 具体说明 | 缓解建议 |
|---------|---------|---------|
| 认证泄露 | `config.json` 含会话密钥 | 设置文件权限 600，避免同步至云盘 |
| 数据残留 | CLI 日志可能缓存敏感信息 | 定期清理 `~/.cache/wilmai/` |
| 误读紧急通知 | AI 优先级判断可能与人工判断有偏差 | 关键事项建议人工二次确认 |
| 服务中断 | 学校系统维护或 API 变更 | 保留 Wilma 网页端作为备用通道 |