终端里使用 Life@USTC 的命令行客户端
（life-ustc）。数据与权限来自
server；域与能力名与 Web / Bot / MCP 同一棵树
（interface hierarchy）。
- 习惯 shell 管理课表、待办、作业与订阅的同学
- 需要脚本化调用 REST、或从官方教务站同步数据的用户
- 做内容治理的管理员
| 域 | 能做什么 |
|---|---|
catalog |
公开事实：学期、课程、教学班、教师、课表、校车、校园链接、元数据、第二课堂活动与主办方、天气、教室地图、新闻公告 |
workspace |
个人概览、完整个人日历 / iCal、课表、考试、待办 CRUD、作业完成态、教学班订阅、第二课堂活动与主办方订阅、提醒通知、校车偏好、链接置顶、上传 |
workspace school |
直连校方站点：本科/研究生学期、课表、考试、成绩、作业，并可 sync 回 Life@USTC 订阅 |
community |
评论（含反应）、描述、教学班作业、公开用户资料 |
account |
登录 / 登出、session、token、资料、语言、当前客户端活动 |
api |
对任意 REST 路径的逃生舱（适合脚本） |
config / completion |
默认 server、教务程序偏好、shell 补全 |
交互终端下，裸的 course / section / teacher 列表会打开 TUI；加过滤或
--no-interactive 则输出表格。机器可读输出：--json / --format json，可用 --jq。
登录支持浏览器 OAuth（PKCE）与设备码；默认 server 为生产站点，也可用
--server / LIFE_USTC_SERVER 指向其它实例。
常用公开与账户命令示例：
life-ustc catalog young-event --active true --limit 20
life-ustc catalog young-organizer list --search 学生会
life-ustc catalog young-event date week 2026-09-15
life-ustc workspace calendar events --date-from 2026-09-01 --date-to 2026-09-30
life-ustc workspace exam --date-from 2026-09-01 --date-to 2026-09-30
life-ustc workspace young-event-subscription set <young-id> --subscribed true --remind-start true
life-ustc catalog weather --location-key ustc-main
life-ustc catalog room map <room-code>
life-ustc catalog publication --type notice --limit 20
life-ustc workspace subscription kind <section-jw-id> teaching_assistant
life-ustc account client activity --limit 20
life-ustc community user get <username-or-id>客户端活动需要 account.client-activity:read，考试列表需要 workspace.exam:read。旧版本登录的用户需运行
life-ustc account login 重新授权，刷新旧 token 不会增加权限。
workspace calendar events 使用完整个人日历 REST 接口，默认读取当前上海日期起的
七天窗口；使用成对的 --date-from / --date-to 查询其它包含端点的日期范围。
workspace exam 默认遍历所有分页，包含已订阅教学班的历史、跨学期及日期未知考试；
可用 --semester-id、--date-from、--date-to 筛选，或用
--include-date-unknown=false 排除日期未知考试。显式传入 --page 或 --limit 只取一页。
Young 活动的 catalog young-event date day|week|month 会遍历该范围的所有分页。
要订阅 iCal 日历，请使用 workspace calendar feed，并将返回的 URL 导入日历应用。
CLI 从仓库内的 api/openapi.json 生成。api/openapi.provenance.json 记录
对应的 server 提交和 SHA-256；make build 会先验证来源并重新生成客户端，
再开始编译。
更新契约时，先检出确定的 Life-USTC/server 提交，再运行：
make sync-openapi OPENAPI_SERVER_DIR=/path/to/server SERVER_COMMIT=<40-character-sha>
make generateCI 会核对固定的 server 提交，不再猜测同名分支。定时同步工作流也会在 server 契约发生变化时创建更新 PR。
docs/specifications/contracts.json 是 CLI 需求的结构化入口；
contracts.schema.json 使用 JSON Schema 2020-12 校验封闭的场景与期望结构。
每条需求绑定一个唯一的原生 Go canonical 测试，测试下的场景由需求文档驱动。
新增或删除需求、场景时，需要同时更新 schema 的完整清单和对应执行适配器。
rationale 解释需求原因；可执行约束放在带类型的 expectations 中。
场景引用固定 OpenAPI 的 operationId；真实请求、成功及失败响应的 fixture
均对该来源校验。字段保留使用标准 JSON Pointer。适配器只执行生产代码并返回
观察结果，公共检查器逐项消费输入和期望，未消费字段直接失败。
outputEmpty 表示既没有标准输出，也没有适配器返回的数据。
运行完整验收：
make test
# 提交后，使用 CI 相同的干净工作区要求：
make test SPEC_EVIDENCE_ARGS=--require-clean该命令运行未缓存的 go test -race -count=1 -json ./...，将原生通过事件与
每个场景的消费回执交叉核对。缺失、跳过、重复、未知场景、遗漏字段或过期来源
均无法通过。artifacts/specifications/native-go.jsonl 保存原始事件，
coverage.json 保存逐场景回执及本次运行 ID、代码提交、需求/schema/OpenAPI
哈希和上游提交。CI 上传这两个文件，并要求工作区干净；本地未提交验证会明确
记录 workingTreeClean: false，不能替代提交后的 CI 证据。
JSON Schema 校验使用 santhosh-tekuri/jsonschema/v6；OpenAPI 校验复用
kin-openapi，JSON Pointer 复用 go-openapi/jsonpointer。
发布包：GitHub Releases。或：
go install github.com/Life-USTC/CLI/cmd/life-ustc@latest子命令细节以 life-ustc <cmd> --help 为准。License: MIT。
管理功能仅支持站点管理员浏览器会话，请在 Web 管理页面操作。CLI 的 OAuth 授权不授予管理接口访问权。
公开考试数据中的 monitors.jwId 是监考人员的校方标识，用于关联和区分同名人员；CLI JSON 输出保留该标识。Young 活动详情保留报名范围、附件要求、联系人、线上会议信息和上游标识，供参与者判断报名条件、准备材料和联系主办方；rawJson 保留上游详情，供核对来源。使用 --json 或 --jq 可读取这些完整字段。