核心用法
wilma-triage 是专为芬兰学生家长设计的 Wilma 学校信息系统自动化分拣工具。它每日定时抓取孩子的考试、作业、课表、消息、校务公告及课堂备注(merkinnät),通过多层级过滤规则识别真正需要家长关注的事项,并自动将考试同步到 Google Calendar。
典型工作流:
1. 数据采集 — 调用 wilma summary --all-students 获取全景概览,按需深入 exams、schedule、homework、messages、news 等子命令
2. 智能分拣 — 应用内置规则(必读周报 viikkoviesti、识别权限表/截止日期/日程变更/需带物品等 actionable 项)结合 MEMORY.md 中的个性化偏好
3. 日历同步 — 通过 gog CLI 检查重复后,将考试写入 Google Calendar,移除已取消活动
4. 报告输出 — 以简洁格式呈现各孩子的待办事项,无 actionable 内容时保持静默
显著优点
- 深度本土化:专门针对芬兰 Wilma 系统设计,理解 viikkoviesti、merkinnät、kulttuuripäivä 等特有概念
- 信号降噪机制:区分班级教师/学科教师/校务办公室/市级公告的不同优先级,自动识别隐藏 actionable 的周报内容
- 防重复同步:严格的 NO DUPLICATES 规则,避免日历事件堆积
- 渐进式学习:通过 MEMORY.md 记录用户反馈,持续优化过滤偏好
- 操作细节捕获:不仅同步事件本身,还提取前一天/当天的关键后勤信息(改时间、带什么、哪节课取消)
潜在缺点与局限性
- 地域锁定:仅适用于芬兰 Wilma 系统,其他国家学校平台无法兼容
- 依赖链复杂:需同时安装
wilmaskill、gogCLI,并分别配置 Wilma 凭据与 Google OAuth - 隐私敏感:需要本地存储学校系统登录凭证,依赖用户自行安全配置
- 语言门槛:输出保留芬兰语术语(如 "yhtälöt, kpl 1-8"),非芬兰语家长可能需额外解释
- 无主动推送:需配合 cron/agentTurn 定时触发,无内置实时通知机制
适合人群
- 有孩子就读于使用 Wilma 系统的芬兰学校的家长
- 希望减少手动检查学校通知、避免遗漏关键事项的效率型用户
- 已使用 Google Calendar 管理家庭日程的用户
- 能接受初期配置复杂度以换取长期自动化回报的技术 comfortable 用户
常规风险
- 凭据泄露风险:Wilma 与 Google 凭据均以本地文件形式存储,需确保
~/.config/wilmai/和 gog CLI 配置目录的权限安全 - 日历数据污染:若去重逻辑失效或命名规则冲突,可能导致重复或错误事件
- 信息遗漏:过度激进的过滤规则或 MEMORY.md 配置不当可能导致重要通知被静默跳过
- API 限流:频繁调用 Wilma 或 Google Calendar API 可能触发 rate limit,建议按文档错峰调度