xuyueandClaude Opus 5.5
90b739a2c7
- 每个实验一份 task.md（任务目标、控件名表格、实现步骤、和书上不一样的地方、在平台上怎么试） - 工具栏"评价项"改成"任务"：上面是任务说明，下面是评价项和自己检查；不遮挡页面，第一次打开实验时自动打开 - 自己写的 Markdown 子集渲染，先转义全部 HTML（老师可以改写说明） - 作业保存任务说明（新列 task），以前布置的作业用实验现在的说明 - 测试：任务说明表格里的控件名都在示例的 Designer.cs 里 - 修改作业时实验下拉框显示标题而不是编号 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
96 lines
3.0 KiB
TypeScript
96 lines
3.0 KiB
TypeScript
// 自动评分的结果：服务器给学生程序逐项检查后返回，学生提交后立即能看到。
|
||
|
||
export interface CheckResult {
|
||
/** 检查项名称，对应书上评价表的功能项，如"能实时显示入侵数据" */
|
||
title: string
|
||
passed: boolean
|
||
/** 不通过的原因：期望看到什么、实际是什么 */
|
||
message?: string
|
||
}
|
||
|
||
export interface GradeResult {
|
||
/** 编译没通过时所有项都不通过 */
|
||
compiled: boolean
|
||
results: CheckResult[]
|
||
/** 评分用时（毫秒） */
|
||
ms: number
|
||
}
|
||
|
||
/** 自测（提交前自己跑一遍评分，不计分、不留记录）：每人同时一次，结果保留到下一次自测 */
|
||
export interface SelfCheck {
|
||
status: 'running' | 'done' | 'error'
|
||
/** 检查的是哪个实验或作业（结果只对同一个显示） */
|
||
target: string
|
||
result: GradeResult | null
|
||
startedAt: number
|
||
}
|
||
|
||
// ---------- 作业 ----------
|
||
|
||
/** 学生的起点：blank 空白工程（从界面做起），ui 界面已做好（只写代码） */
|
||
export type StartMode = 'blank' | 'ui'
|
||
|
||
/** 分值：自动评分项按规则顺序各自的分值；老师评分项（界面、注释、命名等）由老师打分 */
|
||
export interface Scoring {
|
||
auto: number[]
|
||
manual: { title: string; points: number }[]
|
||
}
|
||
|
||
export interface Assignment {
|
||
id: number
|
||
classId: number
|
||
className: string
|
||
sampleId: string
|
||
title: string
|
||
startMode: StartMode
|
||
/** 截止时间（毫秒时间戳），null 表示不限 */
|
||
deadline: number | null
|
||
createdAt: number
|
||
/** 自动评分项的名称，和 scoring.auto 一一对应 */
|
||
checkTitles: string[]
|
||
scoring: Scoring
|
||
/**
|
||
* 任务说明（Markdown，见 web/src/grading/markdown.ts）：布置时从实验的 task.md 复制，老师可以改写。
|
||
* null 是加这个功能之前布置的作业，学生看到的是实验现在的说明
|
||
*/
|
||
task: string | null
|
||
}
|
||
|
||
export interface Submission {
|
||
id: number
|
||
status: 'pending' | 'done' | 'error'
|
||
result: GradeResult | null
|
||
/** 自动评分得分（通过的项的分值之和） */
|
||
autoScore: number | null
|
||
createdAt: number
|
||
/** 排队评分时前面还有几份 */
|
||
queueAhead?: number
|
||
}
|
||
|
||
/** 老师评阅：老师评分项各自的得分（null 表示还没打分，和 scoring.manual 一一对应）和评语 */
|
||
export interface Review {
|
||
scores: (number | null)[]
|
||
comment: string
|
||
updatedAt: number
|
||
}
|
||
|
||
/** 提交时浏览器截的窗体图（PNG 的 base64，不含 data: 前缀） */
|
||
export interface Screenshot {
|
||
form: string
|
||
png: string
|
||
}
|
||
|
||
/**
|
||
* AI 评阅：老师评分项的建议分（和 scoring.manual 一一对应）、理由和给学生的评语。
|
||
* 只是建议，老师采纳（或修改后保存）才成为老师评分。
|
||
* status：pending 排队中；done 已评；error 出错；skipped 学生又交了新的，这份不评了
|
||
*/
|
||
export interface AiReview {
|
||
status: 'pending' | 'done' | 'error' | 'skipped'
|
||
scores: { score: number; reason: string }[]
|
||
comment: string
|
||
error?: string
|
||
model?: string
|
||
at?: number
|
||
}
|