SuperAPI AI 工具集

iblai-api-studio-grading

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 Studio API 读取和设置 Open edX 课程的评分策略。每门课程的评分策略是一个 JSON 对象,包含 grader(作业类型)列表和等级切分 grade_cutoffs。子节通过 graderType 引用 grader,grader 的 weight 决定其占最终成绩的比例,可整体替换或按索引修改单个 grader。

主要能力:GET /settings/grading/{COURSE} 读取完整策略;GET /settings/grading/{COURSE}/{index} 读取单个 grader;POST 同路径可整体替换策略或创建/更新单个 grader;DELETE /settings/grading/{COURSE}/{index} 删除某个 grader(删除前需与用户确认,否则该类型子节将变为不计分)。grader 字段包括 type、min_count、drop_count、short_label、weight;grade_cutoffs 为等级到最低比例的映射,及格/不及格课程用 {"Pass": 0.5},字母等级用 A、B、C…(最低字母为及格线),数值需降序且介于 0 和 1。

使用方式:先执行预检 node .claude/skills/iblai-api-studio-auth/scripts/studio-login.mjs --check,打印两个 ok 后再进行调用,否则先运行 /iblai-api-studio-auth。需要来自 /iblai-api-studio-course-create 的课程 key。通过 set -a; . ./studio.env; set +a 载入 Studio 会话,请求头带 X-CSRFToken、Origin、Referer、Accept 与 Content-Type。权重为百分比,应合计 100,但 Studio 不强制校验,写入前需自行检查。建议在创建计分子节和首次发布之前设置好策略。

限制与注意:新课程自带四个默认 grader(Homework 15 / Lab 15 / Midterm Exam 30 / Final Exam 40)和 {"Pass": 0.5},应替换而非追加。min_count 大于实际子节数量会拉低平均分(缺失作业计 0 分)。没有计分子节的类型其 weight 仍会计入(作为 0),应删除未使用的类型。修改 grader 的 type 会使引用旧名称的子节变为不计分,重命名需谨慎。studio.env 的值带单引号,解析时须去除,否则 Studio 返回 500。文档未提供更细的版本、权限或收费信息。