Course (教学网)

spec: 1
id: courses
name: 教学网
description: 教学网课程公告、作业（截止时间、要求、成绩）、交作业、我的成绩、作业截止同步到待办、课程资料目录和课程回放。
version: 0.4.0
author: pkuinfo
icon: school
homepage: https://github.com/pkuinfo/pku-harness-plugins/tree/main/plugins/courses
requires: [campus-session, network]
# Blackboard Learn 教学网 (pkucli crates/course: api.rs), through the harness's blackboard session.
# Parsers live in shared.yaml. Submitting: the agent's submitAssignment only saves a draft; the
# 交作业 screen picks files (chooseFiles) and submits (submit), both userOnly. Recordings play from
# the 课程回放 screen (play, userOnly), so the signed playlist URL never reaches the model.
campus: [blackboard]
abilities: [todos, files, browser]
shared: shared.yaml
tools:
  list: tools/list.yaml
  announcements: tools/announcements.yaml
  assignments: tools/assignments.yaml
  assignment: tools/assignment.yaml
  content: tools/content.yaml
  videos: tools/videos.yaml
  grades: tools/grades.yaml
  syncDeadlines: tools/syncDeadlines.yaml
  submitAssignment: tools/submitAssignment.yaml
  submitDraft: tools/submitDraft.yaml
  editDraft: tools/editDraft.yaml
  chooseFiles: tools/chooseFiles.yaml
  submit: tools/submit.yaml
  play: tools/play.yaml
widgets:
  due: widgets/due.json
screens:
  submit: screens/submit.json
  pick: screens/pick.json
  videos: screens/videos.json
commands:
  homework: { description: 查看教学网上还没交的作业和截止时间, aliases: [作业, ddl], argHint: 课程（可选）, prompt: '看看我教学网上还有哪些没交的作业，按截止时间排好。{{input}}' }
  submit: { description: 打开交作业页面：选文件、写文字、核对后提交, aliases: [交作业], screen: submit }
  grades: { description: 查看教学网上的成绩, aliases: [成绩, 教学网成绩], argHint: 课程（可选）, prompt: '查一下我教学网上的成绩。{{input}}' }
  ddl-sync: { description: 把教学网未交作业同步成待办并提前提醒, aliases: [同步作业, 作业提醒], prompt: '把教学网上没交的作业同步到我的待办，截止前提醒我。{{input}}' }
  replay: { description: 打开课程回放, aliases: [回放], screen: videos }
i18n:
  en:
    name: Course (教学网)
    description: 'Blackboard (教学网): announcements, assignments (due dates, requirements, grades), submissions, your grades, deadlines synced to to-dos, course materials and lecture recordings.'
    tools:
      list: { title: Blackboard courses, summary: Your courses on Blackboard this semester }
      announcements: { title: Course announcements, summary: The latest announcements in each course }
      assignments: { title: Assignments and due dates, summary: 'Assignments in each course, when they’re due and whether you’ve submitted' }
      assignment: { title: Assignment details, summary: 'One assignment’s requirements, attachments, submission and grade' }
      content: { title: Course materials, summary: 'A course’s materials folders, attachments and assignments' }
      videos: { title: Lecture recordings, summary: Lecture recordings of each course }
      grades: { title: My grades, summary: Your scores in each course from My Grades on Blackboard }
      syncDeadlines: { title: Sync deadlines to to-dos, summary: Turn unsubmitted assignments into to-dos with a reminder before each deadline }
      submitAssignment: { title: Submit assignment, summary: Prepare a submission draft (you pick files and confirm in Submit assignment) }
      submitDraft: { title: Submission draft, summary: 'The assignment, text and files you’re getting ready to submit' }
      editDraft: { title: Edit submission draft, summary: Change the assignment or text, or remove the file }
      chooseFiles: { title: Choose a file to submit, summary: Pick a file on your phone for the submission draft }
      submit: { title: Confirm submission, summary: Hand in the file and text you reviewed to Blackboard }
      play: { title: Play recording, summary: Play a lecture recording in the browser }
    widgets: { due: { title: Assignments due, description: 'This semester’s unsubmitted assignments, soonest first, with their due times.' } }
    screens: { submit: { title: Submit assignment }, pick: { title: Choose an assignment }, videos: { title: Lecture recordings } }
    commands:
      homework: { prompt: 'Which Course (教学网) assignments haven’t I submitted yet? Sort them by deadline.{{input}}', description: 'Unsubmitted Blackboard assignments and when they’re due', argHint: Course (optional), aliases: [hw, assignments] }
      submit: { description: 'Submit an assignment: pick files, add text, review, then hand in', aliases: [hand-in] }
      grades: { prompt: 'Show my grades on Course (教学网).{{input}}', description: Your grades on Blackboard, argHint: Course (optional), aliases: [scores] }
      ddl-sync: { prompt: 'Sync my unsubmitted Course (教学网) assignments to my to-dos and remind me before each deadline.{{input}}', description: Turn unsubmitted assignments into to-dos with early reminders, aliases: [sync-deadlines] }
      replay: { description: Open lecture recordings, aliases: [recordings, videos] }

{
  "id": "courses",
  "name": "教学网",
  "description": "教学网课程公告、作业（截止时间、要求、成绩）、交作业、我的成绩、作业截止同步到待办、课程资料目录和课程回放。",
  "author": "pkuinfo",
  "kind": "builtin",
  "auth": "none",
  "icon": "school",
  "requires": [
    "campus-session",
    "network"
  ],
  "scopes": [
    "course.pku.edu.cn"
  ],
  "tags": [
    "official",
    "campus"
  ],
  "version": "0.4.0",
  "i18n": {
    "en": {
      "name": "Course (教学网)",
      "description": "Blackboard (教学网): announcements, assignments (due dates, requirements, grades), submissions, your grades, deadlines synced to to-dos, course materials and lecture recordings."
    }
  }
}