fix: resume video playback and advance linked exams with attempt controls

2026-10-18 02:12:06 +08:00
parent 2e044655bb
commit 1b497286dc
20 changed files with 1629 additions and 155 deletions
@@ -23,6 +23,10 @@
 | 缺题人工确认 | “考试答题”栏提供“题目不全时手动确认交卷”开关（`manualConfirmIncomplete`），默认开启；开启时任意题库缺题或未答完提醒都由用户在网站确认，关闭时允许满足原得分、计时及全文核验条件的部分题库试卷自动交卷 | 用户最新确认，默认开启 |
 | 题库结构 | 原主操、副操、班长题库统一合并使用，取消岗位选择及岗位隔离 | 用户已确认 |
 | 题库对应 | 考试前检查当前考试主题与统一题库中课程/主题是否对应；没有对应题库则跳过该考试 | 用户已明确 |
+| 默认任务模式 | 新安装默认“视频＋考试（含课中答题）”；升级保留已经保存的模式，不覆盖用户明确的仅视频选择 | 按本次视频完成后继续考试的需求调整 |
+| 续播弹窗 | “自动继续上次播放”开关默认开启；仅识别正文及两按钮完整对应的续播弹窗，选择“继续播放” | 用户新增需求 |
+| 单次答题机会 | “仅 1 次答题机会时交给我处理”开关默认开启；仅剩 1 次或总共仅允许 1 次机会时，课中题和课程考试交给用户手动答题；0 次同样不自动操作 | 用户已明确机会数含义，不是本人已答 1 次 |
+| 返回续播 | “切回页面时自动恢复播放”开关默认开启；只恢复切页前正在播放的视频，手动暂停及待人工状态优先 | 用户新增需求 |
 | 执行方式 | 顺序、并行可切换，默认顺序 | 用户已确认 |
 | 面板布局 | 按功能分栏，桌面采用左侧功能导航、右侧内容区，窄屏改为顶部标签切换 | 按功能分栏已确认，具体排布为补充方案 |
 | 并行数量 | 同时最多 1 个视频任务和 1 场考试；课中题属于视频任务 | 补充建议 |
@@ -41,6 +45,8 @@
 | 仅考试 | 不播放 | 不处理 | 主题预检、作答、计分和按条件交卷 |
 | 视频＋考试 | 自动播放 | 自动精确匹配并作答 | 主题预检、作答、计分和按条件交卷 |

+- 新安装默认“视频＋考试”；已有保存的模式保留，不因升级覆盖用户选择。“仅视频”“视频＋课中答题”完成视频后不会进入独立或关联考试，面板须说明如何切换到“视频＋考试”。
+- “视频＋考试”模式须在平台确认视频完成、关联考试已开放后继续进入考试；只观察到播放器 ended 不够，单次机会保护及题库主题预检仍然生效。
 - 顺序：依照任务清单完成视频及其课中题，再处理满足前置条件的关联考试。
 - 并行：一个受控标签页处理视频及课中题，另一个处理已开放的考试；两个页面共享总任务进度，不能重复领取同一任务。
 - 并行也须遵守网站的解锁顺序。需要先完成视频才能参加的考试，不能提前启动。
@@ -68,6 +74,9 @@
 - “视频＋课中答题”模式复用统一题库，以题型、完整题干、全部选项及正确答案全文严格匹配；核对所选集合并确认弹题已关闭或提交成功后继续播放。
 - 仅视频模式遇到强制弹题，或课中题无匹配、答案冲突、图片题或未适配题型时，暂停该课件并提示人工处理，保留已播放记录。
 - 课中题暂不套用考试的 6 分钟交卷规则及 80 分门槛；是否答题正确、如何继续播放以实际弹题流程为准。
+- 视频栏提供独立的“自动继续上次播放”开关（`autoContinuePlayback`），默认开启并保存。运行任务中仅在唯一可见弹窗正文对应“是否继续上次播放的位置？”且同时有“重新开始”“继续播放”两个按钮时，正常点击“继续播放”；关闭时等用户处理，不自动选择重新开始或点击其他弹窗。
+- 视频栏提供“仅 1 次答题机会时交给我处理”开关（`skipSingleAttemptQuiz`），默认开启并保存，覆盖课中题和课程考试。仅从当前弹题/考试范围内明确可见的允许、总、剩余机会数以及“还可补考 N 次”等提示取证；1 次或 0 次时停止受影响的自动进入、选项和提交，等待用户正常手动处理。
+- 单次规则不指“本人已经答过 1 次”。题干、选项、答案、隐藏节点、已答题数、已答次数、交卷人数及 Angular 私有状态不能作为机会数证据；未显示明确次数时不推断。关闭单次保护不会跳过题库全文核验、计分及交卷规则。

 ## 6. 统一题库与考试主题预检

@@ -141,8 +150,9 @@
 - 登录失效、自动播放被浏览器拒绝、验证弹窗、提交结果不明或达到重试上限时，暂停受影响任务并提示人工处理。
 - 全局“暂停”停止后续选择、交卷、任务跳转及自动刷新；“停止本轮”退出调度但保留已发生的学习与作答记录，两者不能假装撤销网站操作。
 - 脚本自己发起的恢复刷新可继续同一已授权任务；人工刷新、重新打开浏览器时恢复任务清单但默认暂停，提供“继续上次任务”。恢复前核对账号、学习计划、任务、题库版本和网站状态。
- 后台指切换标签页或窗口最小化后尽量继续播放和执行；计时与进度要在恢复前台时校准，不能靠定时器回调次数虚增学习时长。
- 不承诺关闭浏览器、设备休眠或标签被浏览器冻结期间仍持续执行。后台被网站或浏览器中断时，显示真实状态并走受限恢复流程，不能显示“正常学习”却没有平台记录。
+- 保存站点脚本显示，网站在切到后台时主动暂停播放器，返回前台没有对应恢复逻辑。本版提供“切回页面时自动恢复播放”开关（`resumePlaybackOnReturn`），默认开启并保存；记录切页前正在播放的当前视频，在返回后尝试正常续播，后台暂停显示“后台暂停，等待返回”，不误判为长时间卡顿并刷新。
+- 手动暂停播放器、全局或视频任务暂停、课中题及其他待人工状态优先，不能因为返回前台覆盖用户暂停。关闭恢复开关后不因切回页面自动播放。进度及计时只用真实播放器和平台记录校准，不靠回调次数虚增时长。
+- 不承诺后台持续播放，也不承诺关闭浏览器、设备休眠或标签被冻结期间持续执行。后台被网站或浏览器中断时显示真实状态，不能显示“正常学习”却没有平台记录。

 ## 9. 面板、控制台与其他设置

@@ -153,7 +163,7 @@
 | 功能栏 | 主要内容与操作 |
 |---|---|
 | 任务总览 | 学习计划与任务清单、四种任务模式、顺序/并行、开始/停止本轮、总进度、完成/跳过/失败/等待人工统计、预计剩余时间；显示当前视频与考试摘要，点击可进入对应功能栏 |
-| 视频学习 | 当前课程和课件、播放位置/总时长、平台已记录学习时长与完成状态、最高 2X 的倍速设置、视频任务暂停/继续、课中题匹配及处理状态、卡顿恢复状态 |
+| 视频学习 | 当前课程和课件、播放位置/总时长、平台已记录学习时长与完成状态、最高 2X 的倍速设置、视频任务暂停/继续、课中题匹配及处理状态、卡顿恢复状态；默认开启的续播、单次机会保护、切回恢复开关及当前模式后续流程说明 |
 | 考试答题 | 当前考试主题与题库预检结果、自动选择答案开关、默认开启的“题目不全时手动确认交卷”开关、默认 4 秒的答题间隔、默认 6 分钟的最早交卷时长、网站剩余时间、预计得分与严格大于 80 分的门槛、交卷等待原因、答案全文核对与未处理题清单 |
 | 题库搜索 | 统一题库导入与状态、来源记录数/题目数/冲突数、关键词搜索、课程/主题筛选、选中文字搜索、答案全文与来源、主题关联查看和维护；不显示岗位选择 |
 | 控制台 | 带时间和任务名称的运行日志、状态/警告/错误筛选、复制日志、清空显示、恢复次数及交卷结果 |
@@ -186,6 +196,7 @@
 |---|---|
 | 启动学习计划 | 列出实际课程/课件/考试任务，已完成项目不重复执行，阶段数与任务数不混算 |
 | 四种模式 | 视频、课中题、独立考试按所选模式执行；仅视频遇强制题等待人工 |
+| 新旧默认及视频后续 | 新安装默认“视频＋考试”，升级保留已选模式；平台确认视频完成后才进入已开放关联考试；仅视频及视频＋课中答题模式明确提示不会进入考试 |
 | 顺序与并行 | 默认顺序；并行最多一个视频和一场考试，不重复任务且遵守前置条件 |
 | 最高 2X | 面板与播放器实际倍率一致；网站学习时长和完成状态独立核对 |
 | 主题预检 | 显示考试与题库对应关系，无库不自动开考；名称不同的明确关联可用 |
@@ -201,6 +212,9 @@
 | 预计得分等于/低于 80 | 进入等待人工，不交卷、不因等待而刷新 |
 | 交卷计时与恢复 | 从同一场考试原始开始时间计时，恢复不清零，不产生重复提交 |
 | 卡顿和正常暂停 | 异常按次数上限恢复；用户暂停、课中题与等待交卷不误刷新 |
+| 继续上次播放 | 默认开启时只点击精确识别续播弹窗的“继续播放”；关闭后留给人工，未知弹窗不点击 |
+| 单次机会保护 | 明确总共或仅剩 1 次机会以及 0 次时，开启保护则课中题及考试等待人工；已答 1 次、1/40 题、交卷人数及隐藏文字不误触发；关闭仍须通过原有核验 |
+| 切回恢复 | 切页前正在播放才在返回后恢复；关闭开关、手动暂停、暂停任务及待处理弹题不自动恢复；后台暂停不误报持续播放或触发故障刷新 |
 | 后台与回到前台 | 实测切换标签页及最小化，检查网站记录；中断时显示真实状态 |
 | 结束汇总 | 完成、跳过、失败、需人工分别列出，存在未完成项目不显示全部完成 |
 | 功能分栏 | 六栏内容按功能归属展示，桌面与窄屏均可切换；状态与全局暂停常驻，切栏不重启任务或计时、不触发导出，搜索与筛选内容保留 |
@@ -209,12 +223,19 @@
 ## 11. 当前样本依据与开发前待核实内容

 - 新包 01 为学习地图，02/04 为同课程详情，03/05 为同视频的不同播放状态，06 为考试详情，07 为未加载内容的页面外壳。
+- 补充包 `08.zip` 仅为 Angular 初始外壳，没有播放器、续播弹窗、次数提示的实际 DOM 或业务 JS 资源。可参考旧完整归档的静态弹窗模板、切页暂停逻辑及补考文案，不执行原站脚本，不据空外壳推断页面交互已通过实站验证。
 - 03/05 的播放器位置与平台已记录学习时长不同；代码也区分播放百分比、已学习时长及完成标记。2X 不能直接承诺总任务耗时减半。
 - 视频页虽包含课中弹题组件，但没有保存实际弹出的题干、选项及提交状态。课中题的真实结构、题型、确认方式和题库覆盖情况需要补样本验收。
 - 需要核实课程实际完成条件、可用倍速、阶段解锁条件、当前账号的后台播放规则以及并行标签页是否被平台允许。
 - 主题对应关系需要建立明确的课程/科目到统一题库主题映射；不能要求课程名与统一题库文件名完全相同，也不能只靠关键词猜测。
 - 建议按“统一题库及旧数据迁移 → 任务清单与主题预检 → 单视频及进度 → 课中题 → 考试计分与定时交卷 → 顺序调度 → 并行与后台恢复”分阶段开发，每阶段完成对应验收。

+## 12. 2.1.2 增量确认
+
+新增默认开启并持久保存的三个开关，分别控制自动选择“继续播放”、单次答题机会人工处理、切回页面恢复播放。用户确认的单次含义为“只剩 1 次或总共仅允许 1 次答题机会时，交给我手动答题”。保护共用于课中题和课程考试，不以本人已答次数代替剩余机会数。
+
+修复网站主动后台暂停后返回不能及时续播的问题，同时保留用户暂停的优先级，真实显示后台暂停状态。新安装默认串联视频与考试，已有模式保留；面板根据实际模式说明视频完成后的走向。附件 `08.zip` 仅作静态外壳证据，真实账号的续播、平台完成条件及考试入口仍需实站核对；不能宣称后台始终播放。
+
 ## 附：用户原始需求

 根据我提供的谊安学网页压缩包以及之前的完成的刷题脚本，现在需要做一个完整的刷课答题的脚本，现在需要所有任务的一个进度，以及预测时间，看视频过程中可能也有答题，以及当前任务的进度，刷视频要求可以在面板选择倍速，最高是2X，答题的可以设置答题间隔时间（默认4秒）以及交卷的时间（默认6分钟），需要增加只刷视频以及视频的任务以及视频中的答题的模式，或者只有考试的模式。答题之前先确认有没有该题库，没有则跳过该考试。或者考试和视频同时可以进行，导出题库放到其他设置的面板中。面板增加一个控制台的功能，可以看当前进度，视频如果卡住或者暂停自动刷新页面，增加网页可以后台的功能。