AI批改结果

页面元信息

• 终端：学生端
• Astro 路由：/student/ai-grading
• 原始 HTML：s_ai_grading.html
• 来源章节：4.4.8
• 维护规则：后续以本页面 PRD 为准；若改动影响通用规则，再同步总览 / 全局规则文档。

视觉描述

• 原型引用：产出文档/作业管理模块/原型图/s_ai_grading.html。
• 页面为学生端沉浸式结果查看页，自上而下由导航栏、卷面查看区、页级工具条、题目批改面板、底部固定操作区、提交记录底部弹层6个层级组成；卷面区为浅灰查看底，题目批改面板自底部上滑覆盖，整体保持移动端单手阅读布局。
• 顶部导航栏左侧为返回图标，中间标题按模式动态切换为未批改详情、AI批改结果、教师批改结果，右侧为小程序胶囊占位区；页面不展示作业标题、学科、教材、出版社等辅助信息，避免压缩卷面空间。
• 卷面查看区中心为白底试卷画布，画布上叠加题目热区、当前题目高亮态、左右翻页箭头和卷面内联批改标记；内联标记在 pending 模式下全部隐藏，在 ai_graded / teacher_graded 模式下显示。
• 内联批改标记按来源区分颜色：AI结果使用绿色✓、红色✗、橙色△；教师最终结果沿用正式对错颜色；学生在 AI模式下做过本地修正但尚未提交或尚未离页时，对应卷面标记切换为橙底学生修正态，用于提示“当前看到的是学生本地改判，不是最终成绩”。
• 页级工具条固定贴在卷面底部，左侧为提交记录，中部为放大 / 缩小，右侧为只读页码文本。原型默认展示 第1页，当前版本以单页示例承接，不展示页码输入或快捷跳页。
• 题目批改面板展开后约占屏幕高度 55%，上半卷面区域自动上移；面板头部标题按模式动态切换为题目答案与解析、题目批改、教师批改详情，右侧模式提示分别为未批改（仅查看）、学生修正模式、教师已批改（只读）。
• 面板正文包含题目摘要区、可折叠题干、题型信息、分题结果卡片、标准答案区、题目解析区。AI可修正模式下，每个小题额外展示AI批改恢复入口、评对错 / 打分切换器、对错按钮组或分数 Stepper；只读模式下仅展示结果标签和得分标签。
• 底部固定操作区在不同模式下动态变化：
  • pending、teacher_graded：仅展示返回单按钮，按钮横向铺满。
  • ai_graded：展示左侧返回次按钮和右侧提交修正结果主按钮。
• 提交记录底部弹层由遮罩层和底部抽屉组成；弹层头部固定标题提交记录和关闭按钮，正文按单次提交批次展示可切换记录列表，当前查看记录高亮。

功能描述

• 业务规则：R14、R15、R18、R52、R53、R73、R95。
• 页面入口与模式判定：
  • 正式列表入口来自 s_homework_list.html 的个性化作业卡片：
    • 当卡片状态为待批改（未批改阶段）时，不允许查看批改详情，卡片不展示查看批改结果按钮。
    • 当卡片状态为AI已批改时，点击查看批改结果进入 s_ai_grading.html?from=list&hwKey={hw_key}&recordId={record_id}&gradingStatus=ai_graded&homeworkTab=personal&personalStatus={当前筛选}，页面以AI批改结果模式打开。
    • 当卡片状态为已完成时，点击查看批改结果进入 s_ai_grading.html?from=list&hwKey={hw_key}&recordId={record_id}&gradingStatus=teacher_graded&homeworkTab=personal&personalStatus={当前筛选}，页面以教师批改结果模式打开。
  • 从 s_history.html 点击查看批改详情进入时，必须透传 from=history、hwKey、recordId、gradingStatus，页面据此进入未批改详情 / AI批改结果 / 教师批改结果3种模式。参见 4.4.7。
  • 本页内点击提交记录弹层中的其他记录时，直接在当前页重载目标记录，不经过 s_history.html 中转；新的 URL 需覆盖 hwKey / recordId / gradingStatus，并保持原入口来源 from 不变。即：从历史页进入后切换记录，仍按 from=history 处理返回；从列表进入后切换记录，仍按 from=list 处理返回。
  • 参数归一化规则：
    • gradingStatus 仅接受 pending / ai_graded / teacher_graded，传入其他值时默认按 ai_graded 打开。
    • homeworkTab 仅接受 personal / paper，非法值默认回落为 paper。
    • subTab 仅接受 my，其他值默认回落为 library。
    • personalStatus 未传时默认按 all 保存返回上下文，不改变当前记录查看权限范围。
  • 页面只允许查看当前登录学生本人账号有权访问的批改记录；家长/监护人仅可在学生已登录且已绑定的协助场景下代为操作，不形成独立的修正提交主体。参见 R18、R53。
  • 页面每次进入、重新进入或下拉刷新时都必须重新请求当前 recordId 对应的最新批改详情；若教师已在其他端完成最终批改，则必须以最新教师结果覆盖此前 AI结果或学生本地修正结果。参见 R52。
• 页面上下文 s_ai_grading_context 至少保存 from、hwKey、recordId、gradingStatus、homeworkTab、subTab、personalStatus、scroll_top、current_question_id、zoom_ratio、updated_at，用于记录切换和来源页返回恢复。
• 正式入口边界：
  • 当前版本不在本页新增显式查看分析按钮，学生若需查看作业分析，仍从 s_homework_list.html 卡片入口进入 s_homework_report.html。参见 R95。
  • 若历史兼容链路通过 from=grading 打开 s_homework_report.html，仅用于保证报告页返回时可正确回到本页；该链路不计入学生端正式主流程，也不作为 UI、测试验收时必须露出的显式入口。参见 R95。

页面分区与控件交互

• 本页按导航栏、卷面查看区、页级工具条、题目批改面板、底部固定操作区、提交记录底部弹层6个交互分区展开说明。

导航栏

卷面查看区

页级工具条

• 缩放规则：
  • 本页当前版本只支持按钮缩放，不支持双指缩放、拖移卷面、长按平移等手势。
  • 切换题目、打开/关闭面板、打开/关闭提交记录弹层时，卷面缩放比例不自动重置；切换到其他记录时，zoom_ratio 恢复为该记录上次缓存值，无缓存时默认 100%。

题目批改面板

底部固定操作区

提交记录底部弹层

• 弹层规格：

弹层 1：提交记录底部弹层

文案和按钮状态变化

• 模式文案变化：
  • pending：页面标题=未批改详情，面板标题=题目答案与解析，模式提示=未批改（仅查看）。
  • ai_graded：页面标题=AI批改结果，面板标题=题目批改，模式提示=学生修正模式。
  • teacher_graded：页面标题=教师批改结果，面板标题=教师批改详情，模式提示=教师已批改（只读）。
• 底部按钮变化：
  • pending / teacher_graded：隐藏提交修正结果，返回按钮扩展为整行宽度。
  • ai_graded：返回和提交修正结果并列展示；提交修正结果默认可点击，不因“尚未修改”而提前置灰。
• 结果项文案变化：
  • pending 模式每个结果项只显示未批改标签，不显示得分、不显示学生可编辑控件。
  • teacher_graded 模式每个结果项显示教师最终判定标签，并追加教师批改、得分 X/Y标签。
  • ai_graded 模式下，当前小题一旦被学生改判，其按钮高亮、卷面标记和分数 Stepper 视觉来源都切换为学生修正态；恢复 AI结果后重新切回 AI来源样式。
• 摘要文案变化：
  • 题干折叠时按钮文案固定为∨ 展开；展开后切换为∧ 收起。
  • 题目解析缺失时，解析区展示兜底文案请结合标准答案与课堂讲解理解本题思路。
• 提交反馈文案变化：
  • 当前不是 AI可修正模式时，若通过异常链路触发提交，统一提示当前状态不可提交修正。
  • AI模式下未做任何改动直接点击提交修正结果，提示您未修改任何题目。
  • AI模式下点击AI批改恢复入口，或在评对错模式下重复点击当前已选中的同一判定按钮，提示已恢复AI批改结果。
  • AI模式下提交成功后提示修正已提交，教师确认后将更新，随后返回来源页；当前页不新增第四种“修正已提交”标题模式。

页面跳转和返回逻辑

• 从作业列表进入：
  • 入口为 s_homework_list.html 个性化作业卡片的查看批改结果。
  • 返回时必须回到 s_homework_list.html 并恢复离开前的 homeworkTab / personalStatus / subTab / scroll_top；若上下文缺失，则默认回到 s_homework_list.html?homeworkTab=paper&subTab=library。参见 R73。
• 从提交记录进入：
  • 入口为 s_history.html 卡片上的查看批改详情。
  • 返回时必须优先回到 s_history.html，并恢复 s_history_context 中的筛选条件、分页和滚动位置；不得错误跳回作业列表。参见 4.4.7。
• 在本页内打开提交记录弹层并切换记录：
  • 点击某条记录后立即重载本页为新记录；来源参数 from 保持原值不变。
  • 记录切换后，原先展开的题目面板默认关闭，题目高亮清空；新记录按默认态重新加载卷面和题目热区。
  • 若当前记录存在未提交的本地修正，切换记录时不弹确认框，直接丢弃未提交内容。
• 点击提交修正结果成功：
  • 调用修正提交接口成功后，提示成功文案，并在 1 秒后执行与当前来源一致的返回逻辑。
  • 返回后来源页若再次进入本页，需以服务端最新 gradingStatus / correction_status 为准，不保留上次离页前的本地修正缓存。

批量操作范围

• 本页不支持多选多条提交记录，不支持批量切换记录、批量删除、批量导出。
• 本页不支持“全题一键认可”“全题一键恢复 AI”“批量提交多个记录修正”；学生只能在当前 recordId 范围内逐题修改。
• 提交修正结果 的“批量”仅限于：一次点击可提交当前记录内所有已修改的小题，不跨记录、不跨作业。
• 记录弹层中的点击行为只作用于被点击的单条记录；不会同时修改其他记录的批改状态、筛选状态或来源页排序。

异常描述

数据需求

• 接口：

  • 批改详情接口：
    • 入参至少包含 student_id、record_id、hw_key、source_page、from。
    • 出参至少包含 grading_status、correction_status、page_count、current_page_no、zoom_ratio_default、question_list、question_hotzones、paper_pages。
  • 题目结果数据结构：
    • 每个 question 至少包含 question_id、section_title、passage、question_type_summary、cards。
    • 每个 card 至少包含 card_id、title、type、answer、analysis、items。
    • 每个 item 至少包含 item_id、label、student_answer、max_score、ai_judge、ai_score、teacher_judge、teacher_score、editable_in_ai_mode。
  • 修正提交接口：
    • 入参至少包含 record_id、hw_key、student_id、from、corrections[]。
    • corrections[] 每项至少包含 item_id、judge、score、max_score、source=student。
    • 成功后返回最新 correction_status，至少支持 submitted，供来源页或再次进入本页时判断是否已有学生修正待教师确认。
  • 提交记录弹层接口：
    • 返回当前学生可查看的提交记录列表，字段至少包含 record_id、hw_key、homework_name、submit_time、grading_status。
    • 记录列表允许跨不同作业切换，不限制为当前 hw_key 的历史记录集合。
  • 刷新与同步：
    • 页面重新进入、下拉刷新或重新切换到前台时，必须重新拉取当前记录详情。
    • 若教师端已保存最终结果，服务端应返回 grading_status=teacher_graded，前端立即切换到教师只读模式。参见 R52。

• 状态与字段约束：

  • 页面模式只接受 pending / ai_graded / teacher_graded 三种展示模式；其中：
    • pending：只读，无批改标记，无提交修正按钮。
    • ai_graded：可编辑，可提交修正。
    • teacher_graded：只读，展示教师最终成绩与判定。
  • correction_status 与 grading_status 分开建模；至少兼容 none / submitted / confirmed / rejected 或等价状态，不得把“学生修正中”写成正式最终批改状态。
  • student_correcting 只允许作为前端本地编辑态，不得写回服务端作为最终业务状态。
  • 分数到判定的映射固定为：score <= 0 -> wrong、0 < score < max_score -> half、score >= max_score -> correct，前后端必须统一。
  • 原卷热区数据必须与 question_id 一一映射；前端点击热区时不得依赖题目在数组中的固定顺序做业务主键。
  • question_hotzones 至少需包含 question_id、page_no、x、y、width、height、display_order。
  • 页面需维护 s_ai_grading_context，用于回跳来源页和恢复当前查看态；历史来源返回时还需依赖 s_history_context 恢复历史筛选、分页和滚动。

• 埋点：

  • 页面浏览：记录 record_id、hw_key、from、grading_status、homeworkTab、subTab、personalStatus、page_no。
  • 卷面交互：记录热区点击、面板打开/关闭、当前选中 question_id、页码展示值、缩放按钮点击和最终 zoom_ratio。
  • 修正过程：记录当前小题从 ai 切换到 student、点击AI批改恢复、判定按钮点击、分数 Stepper 点击、分数输入变更、是否命中边界裁剪。
  • 内容查看：记录摘要展开/收起、标准答案曝光、题目解析曝光。
  • 提交记录弹层：记录弹层打开、关闭、记录项曝光、切换记录点击，需带 target_record_id、target_hw_key、target_grading_status。
  • 修正提交：记录点击提交修正结果、修改项数量、成功/失败结果、失败原因码、是否因“未修改任何题目”而拦截。
  • 返回行为：记录来源页类型、是否命中上下文恢复、最终回跳目标页。