Back to Details

wilma

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Wilma Skill

Wilma Skill

Overview

概述

Wilma is the Finnish school information system used by schools and municipalities to share messages, news, exams, schedules, homework, and other student-related updates with parents/guardians.
Use the 
wilma
/ 
wilmai
CLI in non-interactive mode to retrieve Wilma data for AI agents. Prefer 
--json
outputs and avoid interactive prompts.
Wilma是芬兰的学校信息系统，学校和市政机构使用它向家长/监护人发送消息、资讯、考试安排、课程表、作业以及其他与学生相关的更新。
在非交互模式下使用
wilma
/
wilmai
CLI为AI Agent检索Wilma数据。优先使用
--json
输出，避免交互提示。

Quick start

快速开始

Install

安装

bash
npm i -g @wilm-ai/wilma-cli
  1. Ensure the user has run the interactive CLI once to create 
    ~/.config/wilmai/config.json
    .
  2. Use non-interactive commands with 
    --json
    .
bash
npm i -g @wilm-ai/wilma-cli
  1. 确保用户已运行过一次交互式CLI以创建
    ~/.config/wilmai/config.json
    。
  2. 使用带
    --json
    参数的非交互命令。

Core tasks

核心任务

Daily briefing (start here)

每日简报（从这里开始）

bash
wilma summary --student <id|name> --json
wilma summary --all-students --json
Returns today's and tomorrow's schedule, upcoming exams, recent homework, recent news, and recent messages in one call. This is the best starting point for any parent-facing summary.
bash
wilma summary --student <id|name> --json
wilma summary --all-students --json
一次调用即可返回今日和明日的课程表、即将到来的考试、近期作业、近期资讯和近期消息。这是面向家长的摘要的最佳起点。

Schedule

课程表

bash
wilma schedule list --when today --student <id|name> --json
wilma schedule list --when tomorrow --student <id|name> --json
wilma schedule list --when week --student <id|name> --json
bash
wilma schedule list --when today --student <id|name> --json
wilma schedule list --when tomorrow --student <id|name> --json
wilma schedule list --when week --student <id|name> --json

Homework

作业

bash
wilma homework list --student <id|name> --json
bash
wilma homework list --student <id|name> --json

Upcoming exams

即将到来的考试

bash
wilma exams list --student <id|name> --json
bash
wilma exams list --student <id|name> --json

Exam grades

考试成绩

bash
wilma grades list --student <id|name> --json
bash
wilma grades list --student <id|name> --json

List students

学生列表

bash
wilma kids list --json
bash
wilma kids list --json

News and messages

资讯与消息

bash
wilma news list --student <id|name> --json
wilma news read <id> --student <id|name> --json
wilma messages list --student <id|name> --folder inbox --json
wilma messages read <id> --student <id|name> --json
bash
wilma news list --student <id|name> --json
wilma news read <id> --student <id|name> --json
wilma messages list --student <id|name> --folder inbox --json
wilma messages read <id> --student <id|name> --json

Fetch data for all students

获取所有学生的数据

All list commands support 
--all-students
:
bash
wilma summary --all-students --json
wilma homework list --all-students --json
wilma exams list --all-students --json
You can also pass a name fragment for 
--student
(fuzzy match).
所有列表命令均支持
--all-students
参数：
bash
wilma summary --all-students --json
wilma homework list --all-students --json
wilma exams list --all-students --json
你也可以为
--student
参数传入名称片段（模糊匹配）。

Notes

注意事项

  • If no 
    --student
    is provided, the CLI uses the last selected student from 
    ~/.config/wilmai/config.json
    (or 
    $XDG_CONFIG_HOME/wilmai/config.json
    ).
  • If multiple students exist and no default is set, the CLI will print a helpful error with the list of students.
  • When the account has multiple students, 
    --student
    is required for read commands.
  • If auth expires or the CLI says no saved profile, re-run 
    wilma
    interactively or use 
    wilma config clear
    to reset.
  • Run 
    wilma update
    to update the CLI to the latest version.
  • 如果未提供
    --student
    参数，CLI将使用
    ~/.config/wilmai/config.json
    （或
    $XDG_CONFIG_HOME/wilmai/config.json
    ）中最后选择的学生。
  • 如果存在多个学生且未设置默认值，CLI将打印包含学生列表的友好错误提示。
  • 当账户下有多个学生时，读取类命令必须指定
    --student
    参数。
  • 如果授权过期或CLI提示无已保存配置文件，重新以交互模式运行
    wilma
    或使用
    wilma config clear
    重置。
  • 运行
    wilma update
    将CLI更新至最新版本。

Actionability guidance (for parents)

面向家长的优先级指导

Wilma contains a mix of urgent items and general info. When summarizing for parents, prioritize actionable items:
Include items that:
  • Require action or preparation (forms, replies, permissions, materials to bring).
  • Announce a deadline or time-specific requirement.
  • Describe a schedule deviation or noteworthy event (trips, themed days, school closures, exams).
  • Mention homework, exams, or upcoming deadlines.
De-prioritize items that:
  • Are purely informational with no action, deadline, or schedule impact.
  • Are generic announcements unrelated to the target period.
When in doubt, include and let the parent decide. Prefer a short, structured summary with dates and IDs.
Wilma包含紧急事项和常规信息。为家长生成摘要时，优先展示可执行的内容：
需包含的内容：
  • 需要行动或准备的事项（表格填写、回复、权限申请、需携带的材料）。
  • 宣布截止日期或特定时间要求的事项。
  • 涉及课程变动或重要事件的内容（旅行、主题日、学校停课、考试）。
  • 提及作业、考试或即将到来的截止日期的内容。
可弱化的内容：
  • 纯资讯类、无需行动、无截止日期或不影响课程安排的内容。
  • 与目标时间段无关的通用公告。
如有疑问，优先包含内容并让家长自行判断。建议生成简短、结构化的摘要，包含日期和ID。

Scripts

脚本

Use 
scripts/wilma-cli.sh
for a stable wrapper around the CLI.
使用
scripts/wilma-cli.sh
作为CLI的稳定包装器。

Links

链接