SuperAPI AI 工具集

ielts-mock-review

写作与研究

查看项目

更新于 10-15 23:33

技能介绍

用途:本技能定义 IELTS Buddy 模考与练习数据的只读接口,用于获取当前账号可见的模考试卷目录、可复盘记录、已完成科目的逐题作答与批改快照,以及足迹与学习统计。它不解读模考、不生成诊断或训练优先级。

主要能力:ielts_mock_search_papers 返回试卷目录与稳定 contentRef,可传 subjects、maxDurationMinutes、limit,只读目录不创建 session;ielts_review_recent_activity 传 kind:"mock" 获取可复盘记录与已完成科目的 reviewTargets,按 nextOffset 分页;ielts_review_read_snapshot 将某个 reviewTargets 元素原样作为 target,读取逐题作答与批改快照。

使用方式:先绑定账号并检查能力,示例命令为 python3 scripts/ielts_buddy_api.py capabilities 和 python3 scripts/ielts_buddy_api.py call ielts_review_recent_activity --json '{"kind":"mock"}'。查询记录分两步:先读列表摘要,再按需读取详情;精听用 attemptId 调用 ielts_dictation_read_attempt,未提交普通练习用 sessionId 调用 ielts_practice_read_session。足迹跨产品活动用 ielts_footprints_list,统计直接读取服务端 summary 等字段。

限制:返回数据不是 IELTS 官方成绩;只读取列表已返回复盘引用的完成科目;不能从部分题目正确率推算分数;数据截断时不得声称查全;列表摘要不足以重算历史总量;两种 cursor 不可互换;统计时区为 Asia/Shanghai。