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

README.md

@@ -1,6 +1,6 @@
 # 谊安学助手 2.0
 
-当前发布版本 **2.1.1**。一个可直接安装的油猴脚本，集成统一题库、六栏面板、视频与考试任务、答案全文核对、复制和题库导出。题库本地保存，内置 ZIP 解析，无 CDN 依赖。
+当前发布版本 **2.1.2**。一个可直接安装的油猴脚本，集成统一题库、六栏面板、视频与考试任务、答案全文核对、复制和题库导出。题库本地保存，内置 ZIP 解析，无 CDN 依赖。
 
 ## 安装与启动
 
@@ -8,7 +8,7 @@
 2. 打开 `http://10.119.67.7/clientcn/` 下的学习地图、课程、练习或考试页面。
 3. 展开右下角面板，在“题库搜索”导入 [统一题库.csv](题库/统一题库.csv)。原 ZIP、三个岗位 CSV、CSV/JSON 仍可导入，无需选择岗位。
 4. 若考试标题与题库课程不同，在题库栏建立明确的主题关联。关联使用完整标题和完整题库课程名；相似关键词只提供候选，不授权自动答题。
-5. 在“任务总览”选择任务模式、顺序或并行，点击“开始本轮”。人工刷新或重开浏览器后默认暂停，检查清单后点击“继续上次任务”。
+5. 在“任务总览”选择任务模式、顺序或并行，点击“开始本轮”。新安装默认“视频＋考试（含课中答题）”，升级保留你已经保存的模式；若希望视频完成后进入关联考试，请确认当前模式为“视频＋考试”。人工刷新或重开浏览器后默认暂停，检查清单后点击“继续上次任务”。
 
 脚本仅在 `http://10.119.67.7/clientcn/*` 生效，含其下课程、练习及考试路径；其他主机、HTTPS、其他端口及站点目录外不会注入功能。名称继续为“谊安学助手 2.0”。
 
@@ -17,7 +17,7 @@
 | 功能栏 | 内容 |
 |---|---|
 | 任务总览 | 四种任务模式、顺序/并行、任务清单、当前任务、总进度及预计剩余时间 |
-| 视频学习 | 实际倍速、播放进度、平台学习记录、课中题、局部暂停与恢复 |
+| 视频学习 | 实际倍速、播放进度、平台学习记录、课中题、局部暂停与恢复；续播、单次答题机会保护、切回恢复三个开关 |
 | 考试答题 | 自动选择开关、缺题人工确认开关、答案核对、答题间隔、预计得分、考试计时和交卷状态；兼容原练习页 |
 | 题库搜索 | 统一题库导入、关键词搜索、课程筛选、选中文字搜索、来源及主题关联 |
 | 控制台 | 最近 500 条运行日志、级别筛选、复制、清空显示 |
@@ -40,15 +40,21 @@
 
 ## 视频、任务与后台
 
-任务模式为“仅视频、视频＋课中答题、仅考试、视频＋考试”，执行方式默认顺序，并行最多一个视频和一场考试。识别网页现有目录和入口，不猜业务接口。阶段数与课件数分别处理，非视频及未开放任务显示具体原因，已跳过或失败不计为完成。
+任务模式为“仅视频、视频＋课中答题、仅考试、视频＋考试”，新安装默认“视频＋考试”，已有保存的模式继续沿用，执行方式默认顺序，并行最多一个视频和一场考试。“仅视频”和“视频＋课中答题”均不会进入独立或关联考试；选择“视频＋考试”后，平台确认视频完成，才进入已经开放的关联考试，仍需通过单次机会保护及题库预检。视频栏根据当前模式显示后续流程。识别网页现有目录和入口，不猜业务接口。阶段数与课件数分别处理，非视频及未开放任务显示具体原因，已跳过或失败不计为完成。
 
 视频支持 1X、1.25X、1.5X、2X，显示实际播放器倍率。播放到末尾后继续等待平台学习完成标记；平台记录时长与播放器位置分别展示。没有明确学习时长要求或任务耗时依据时，预计时间显示待确认，2X 不代表整轮耗时必然减半。
 
 课中答题适配保存 JS 模板中的 `app-question-modal` 与 PC CDK portal：按完整题干及选项匹配，回读选中集合，走网站“查看答案”判分，只有明确回答正确并关闭/进入下一题后才继续。仅视频模式遇强制题、无库、冲突或未知结构时等待人工，不刷新弹题。课中题不套用考试交卷规则。
 
+“视频学习”栏新增三个独立开关，默认开启并保存设置：
+
+- **自动继续上次播放**（`autoContinuePlayback`）：运行中的视频任务遇到正文为“是否继续上次播放的位置？”、同时有“重新开始”和“继续播放”的明确弹窗时，选择“继续播放”。关闭后由你处理；不会点击其他未知弹窗。
+- **仅 1 次答题机会时交给我处理**（`skipSingleAttemptQuiz`）：用户确认的含义是“只剩 1 次或总共仅允许 1 次答题机会”，包含课中题与课程考试。开启时停止受影响的自动进入、选项点击及提交，交给你手动操作；0 次同样不自动操作。次数只取当前题目或考试容器中明确可见的允许、总、剩余次数及“还可补考 N 次”等提示，不把本人已答 1 次、已答 1/40 题或交卷人数当成机会数。未显示明确次数时不作推断，关闭保护仍需满足原有题库和交卷条件。
+- **切回页面时自动恢复播放**（`resumePlaybackOnReturn`）：只对切页前正在播放、因网站切页逻辑而暂停的当前视频，在返回后尝试正常续播。手动暂停优先，暂停任务、课中题或其他待处理状态不会被自动播放覆盖。关闭后保持暂停，按网站或面板正常继续。
+
 默认连续 60 秒没有播放进度时尝试续播，15 秒后仍失败再刷新当前视频页面，最多 3 次，两次刷新至少间隔 30 秒，次数跨刷新保存。主动暂停、课中题、等待平台确认、等待交卷或等待人工不算故障。脚本发起的恢复及任务跳转保存一次性续作标记；人工刷新默认暂停。并行页面通过共享租约、心跳及全局控制协调，打开失败或未确认时显示等待，不假称并行成功。
 
-后台指正常切换标签页或最小化后尽量继续，恢复前台按真实时间和网站记录校准。浏览器关闭、设备休眠、标签冻结或网站强制暂停期间无法保证持续执行；中断显示真实状态，不伪造学习时长。真实账号的解锁、倍速、后台和并行规则仍需实站验收。
+保存站点脚本显示：网站切到后台会主动暂停播放器，返回前台没有相应自动恢复逻辑。本版记录切页前的真实播放状态，后台暂停时显示“后台暂停，等待返回”，开启上述恢复开关后返回再尝试续播，不把后台暂停误当成长时间卡顿而刷新。不能保证后台一直播放，也不能保证浏览器关闭、设备休眠或标签冻结期间执行；恢复后按实际播放器及平台记录校准，不伪造学习时长。真实账号的解锁、倍速、后台和并行规则仍需实站验收。
 
 ## 考试预计得分与交卷
 
@@ -87,6 +93,12 @@ npm run merge:banks
 
 测试依赖 Node.js 和 Playwright/Chrome；使用本机模拟页面及中和后的保存 DOM，所有业务 URL 由测试拦截，未访问业务服务器。验证范围包括统一题库迁移/来源/冲突、真实 40 题全文乱序、题间隔、80 分门槛与 4/6 分钟边界、缺题人工确认开关两种模式、设置保存及切换暂停、加载不全等通用门槛、整卷 100 分核验后的交卷流程、防重复、视频恢复、并行心跳、六栏及拖拽/窄屏、复制/导出/站点范围和完整任务流程；本次结果以实际测试记录为准。
 
-源代码按职责拆分：`bank-store.js`、`answer-matcher.js`、`answer-runner.js`、`exam-controller.js`、`quiz-adapter.js`、`learning-engine.js`、`assistant-panel.js`、`practice-exporter.js`。发布仅需构建后的单个 `.user.js`。
+源代码按职责拆分：`bank-store.js`、`answer-matcher.js`、`answer-runner.js`、`attempt-policy.js`、`exam-controller.js`、`quiz-adapter.js`、`learning-engine.js`、`assistant-panel.js`、`practice-exporter.js`。发布仅需构建后的单个 `.user.js`。
+
+## 2.1.2 更新记录
+
+新增默认开启的三个视频栏开关，统一课中题及课程考试的单次机会判断，修复切页后网站暂停而返回不能及时续播的问题。新安装默认选择“视频＋考试”，升级保留原模式，并显示视频完成后是否进入考试的具体说明。
+
+本次提供的 `08.zip` 仅包含 Angular 页面外壳，没有播放器、续播弹窗或次数提示的实际 DOM，也没有业务 JS 资源。适配依据旧完整归档的静态模板和脚本片段，未执行原站代码。`npm test` 的 15 套回归全部通过，学习引擎另完成 52 项检查，覆盖共享设置、暂停保存竞争和关联考试完整导航；桌面及 390px 窄屏无相关控制台错误，所有业务请求均在本地拦截。本地模拟通过仍需结合真实账号验收。
 
 开发依据与实施顺序见 [需求.md](需求.md) 和 [实施开发方案.md](实施开发方案.md)。真实课中弹题交互、课程完成条件、账号登录后的并发限制与正式提交结果需在实际环境核实；识别不明时脚本等待人工，不把本地模拟通过等同于全站验收完成。