# 谊安学助手：完整学习与答题需求

整理日期：2026-10-18。本文为开发需求基线，实施顺序和验证范围见 [实施开发方案.md](实施开发方案.md)。

## 1. 目标与范围

在现有“谊安学助手 2.0”基础上，增加任务调度，串联“学习地图 → 课程 → 视频及课中答题 → 关联考试 → 结果确认”，显示总进度、当前任务进度和预计剩余时间。

- 生效范围沿用 `http://10.119.67.7/clientcn/*`，覆盖主页面、课程、练习和考试页面。
- 将原主操、副操、班长题库合成一个统一题库，搜索、课中答题和考试共用，面板不再要求选择岗位；保留题库搜索、严格答案全文匹配、复制开关及面板拖拽与位置保存。
- “所有任务”指用户选定的学习地图或学习计划范围；网站原有岗位归属可作为任务来源信息，但不限制统一题库的检索或匹配。启动前展示任务清单，默认只处理未完成任务，避免把学习地图阶段数直接当成任务数。
- 支持一个课程包含多个章节、多个视频及关联考试。用课程、课件、考试的稳定标识区分任务，不能仅按标题去重。
- 非视频课件、未适配题型和网站未开放的任务单独列出原因，不计为完成。

## 2. 已确认规则与建议默认值

| 项目 | 规则 | 确认状态 |
|---|---|---|
| 视频倍速 | 面板可选择，最高 2X；建议提供 1X、1.25X、1.5X、2X，默认 1X | 上限已明确，档位与默认值为建议 |
| 答题间隔 | 默认 4 秒，定义为相邻两题之间的等待；多选内部选项调整不分别等待 4 秒 | 默认值来自原需求，间隔口径为补充建议 |
| 交卷计时 | 从本次实际进入试卷、开始考试起计算，默认至少 6 分钟；页面刷新或续作不重新起算 | 用户已确认 |
| 得分门槛 | 预计得分严格大于 80 分才允许自动交卷；正好 80 分或更低，等待用户操作 | 用户已确认 |
| 缺题人工确认 | “考试答题”栏提供“题目不全时手动确认交卷”开关（`manualConfirmIncomplete`），默认开启；开启时任意题库缺题或未答完提醒都由用户在网站确认，关闭时允许满足原得分、计时及全文核验条件的部分题库试卷自动交卷 | 用户最新确认，默认开启 |
| 题库结构 | 原主操、副操、班长题库统一合并使用，取消岗位选择及岗位隔离 | 用户已确认 |
| 题库对应 | 考试前检查当前考试主题与统一题库中课程/主题是否对应；没有对应题库则跳过该考试 | 用户已明确 |
| 默认任务模式 | 新安装默认“视频＋考试（含课中答题）”；升级保留已经保存的模式，不覆盖用户明确的仅视频选择 | 按本次视频完成后继续考试的需求调整 |
| 续播弹窗 | “自动继续上次播放”开关默认开启；仅识别正文及两按钮完整对应的续播弹窗，选择“继续播放” | 用户新增需求 |
| 单次答题机会 | “仅 1 次答题机会时交给我处理”开关默认开启；仅剩 1 次或总共仅允许 1 次机会时，课中题和课程考试交给用户手动答题；0 次同样不自动操作 | 用户已明确机会数含义，不是本人已答 1 次 |
| 返回续播 | “切回页面时自动恢复播放”开关默认开启；只恢复切页前正在播放的视频，手动暂停及待人工状态优先 | 用户新增需求 |
| 执行方式 | 顺序、并行可切换，默认顺序 | 用户已确认 |
| 面板布局 | 按功能分栏，桌面采用左侧功能导航、右侧内容区，窄屏改为顶部标签切换 | 按功能分栏已确认，具体排布为补充方案 |
| 并行数量 | 同时最多 1 个视频任务和 1 场考试；课中题属于视频任务 | 补充建议 |
| 故障刷新 | 仅异常停播或卡住触发；建议每任务最多自动刷新 3 次 | 刷新功能来自原需求，识别及上限为补充建议 |

当前样本满分 100 分，门槛按原始分值计算，不能把“80 分”擅自解释为其他分制的“80%”。总分或分制不明确时暂停自动交卷，显示原因。

## 3. 模式与执行方式

“任务模式”与“顺序/并行”分开设置，避免同一个开关含义不清。

| 任务模式 | 视频 | 课中答题 | 独立或关联考试 |
|---|---|---|---|
| 仅视频 | 自动播放 | 遇到强制题时等待人工处理 | 不进入 |
| 视频＋课中答题 | 自动播放 | 自动精确匹配并作答 | 不进入 |
| 仅考试 | 不播放 | 不处理 | 主题预检、作答、计分和按条件交卷 |
| 视频＋考试 | 自动播放 | 自动精确匹配并作答 | 主题预检、作答、计分和按条件交卷 |

- 新安装默认“视频＋考试”；已有保存的模式保留，不因升级覆盖用户选择。“仅视频”“视频＋课中答题”完成视频后不会进入独立或关联考试，面板须说明如何切换到“视频＋考试”。
- “视频＋考试”模式须在平台确认视频完成、关联考试已开放后继续进入考试；只观察到播放器 ended 不够，单次机会保护及题库主题预检仍然生效。
- 顺序：依照任务清单完成视频及其课中题，再处理满足前置条件的关联考试。
- 并行：一个受控标签页处理视频及课中题，另一个处理已开放的考试；两个页面共享总任务进度，不能重复领取同一任务。
- 并行也须遵守网站的解锁顺序。需要先完成视频才能参加的考试，不能提前启动。
- 全局暂停应同时暂停两个执行任务；单个任务进入“等待人工”时，其他没有依赖关系的任务可以继续。
- 切换模式或执行方式时先停止当前调度并保留检查点，重新核对任务状态后继续，不能遗留旧页面继续点击或交卷。

## 4. 任务清单、进度和预计时间

- 任务状态区分：待开始、加载中、播放中、课中答题、考试答题、等待交卷、等待人工、重试中、已完成、已跳过、失败。
- 显示课程名、当前课件或考试、完成数/总数、跳过数、失败数、等待人工数；跳过与失败不能计入完成率。
- 视频分别显示播放位置/总时长、实际生效倍速、平台已记录学习时长及平台完成状态。
- 考试显示总题数、已核验题数、未匹配/冲突题数、预计得分、交卷门槛、进入试卷后的经过时间、最早交卷倒计时及网站剩余考试时间。
- 预计剩余时间根据剩余视频播放时间、网站要求的剩余学习时长、剩余题数与答题间隔、交卷等待时间综合估算，不能只用视频长度除以 2。
- 顺序执行累加剩余任务时间；并行根据两条执行队列及前置依赖估算，不能把两边耗时直接相加。
- 人工等待、缺少视频时长或未知完成条件应标注“暂无法准确估算”；不能输出虚假的精确完成时间。
- 倍速、进度、暂停、卡顿或队列变化后更新估算。只有平台确认的完成任务才能计入已完成。
- 任务结束展示完成、跳过、失败及需人工处理清单。存在未完成项目时不能显示“全部完成”。

## 5. 视频播放与课中答题

- 自动进入所选任务的课程，读取完整章节与课件目录，继续尚未完成的视频，已完成的视频默认跳过。
- 倍速设置应应用到实际播放器，并在面板显示实际生效值。网站不允许所选倍率时提示并使用可用倍率，不能面板显示 2X 而播放器仍是 1X。
- 播放到末尾后，继续检查平台学习时长与完成条件；视频结束不等于任务完成。
- 课中弹题出现时记录当前课件与播放位置，进入答题状态，不能当作卡顿刷新页面。
- “视频＋课中答题”模式复用统一题库，以题型、完整题干、全部选项及正确答案全文严格匹配；核对所选集合并确认弹题已关闭或提交成功后继续播放。
- 仅视频模式遇到强制弹题，或课中题无匹配、答案冲突、图片题或未适配题型时，暂停该课件并提示人工处理，保留已播放记录。
- 课中题暂不套用考试的 6 分钟交卷规则及 80 分门槛；是否答题正确、如何继续播放以实际弹题流程为准。
- 视频栏提供独立的“自动继续上次播放”开关（`autoContinuePlayback`），默认开启并保存。运行任务中仅在唯一可见弹窗正文对应“是否继续上次播放的位置？”且同时有“重新开始”“继续播放”两个按钮时，正常点击“继续播放”；关闭时等用户处理，不自动选择重新开始或点击其他弹窗。
- 视频栏提供“仅 1 次答题机会时交给我处理”开关（`skipSingleAttemptQuiz`），默认开启并保存，覆盖课中题和课程考试。仅从当前弹题/考试范围内明确可见的允许、总、剩余机会数以及“还可补考 N 次”等提示取证；1 次或 0 次时停止受影响的自动进入、选项和提交，等待用户正常手动处理。
- 单次规则不指“本人已经答过 1 次”。题干、选项、答案、隐藏节点、已答题数、已答次数、交卷人数及 Angular 私有状态不能作为机会数证据；未显示明确次数时不推断。关闭单次保护不会跳过题库全文核验、计分及交卷规则。

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

### 6.1 统一题库与旧数据迁移

- 仓库提供一个可直接导入的 `题库/统一题库.csv`，汇总原主操、副操、班长三个题库。现有三个文件合计 5520 条来源记录，合并时完整保留题型、题干、选项、答案、课程/主题、原题号及来源信息。
- 不再按岗位分库、建立岗位匹配索引或显示岗位选择按钮。旧文件中的“岗位”字段仅作为原始来源信息保留，不作为搜索或自动答题的筛选条件，也不作为答案冲突的裁决依据。
- 搜索默认覆盖全部统一题库，可按课程/主题筛选。只有在题型、题干、全部选项和正确答案全文集合一致时，才可将重复题聚合为一条结果，并保留其全部来源；选项字母不同但答案文字一致不算冲突。
- 同题干、同选项但正确答案文字不同的记录必须保留并标记冲突，不能按多数答案、导入顺序或原岗位覆盖。只有当前课程/来源的明确对应能够消除歧义时才允许自动作答，否则等待人工处理且不计入可核验得分。
- 同题干但题型或选项不同的记录分别保留，不能仅按题干去重。显示原始来源记录数、合并后的题目数及冲突数，避免把 5520 条来源记录误称为 5520 道不重复题。
- 升级时将浏览器已保存的三个岗位题库自动迁入统一题库，核验成功后再启用新数据；迁移失败保留旧数据并说明原因，不要求用户手动重新导入。旧岗位选择设置不再影响结果。
- 兼容导入原三个岗位 CSV、原题库 ZIP 及新统一 CSV/JSON；缺少岗位字段也能导入。迁移或重复导入同一来源不应重复增加记录，新增题库须先完整校验再合入。

### 6.2 考试主题预检

1. 在考试详情页读取考试主题、课程所属阶段/科目、考试标识及可见限制，从统一题库显示候选课程/主题和对应依据。
2. 支持课程与题库名称不同的明确关联，例如“1-1安全生产方针和目标”可以对应“安全领导力”主题下的题库；可关联统一题库中的多个主题，不要求岗位一致。
3. 已有明确来源、所属主题或用户确认的关联时可继续。仅有相似关键词时只显示候选，不能把相似主题当成正确答案依据。
4. 统一题库中没有对应课程/主题，或主题不对应时，跳过自动进入该考试并记录原因；无法确认关联时等待用户确认。
5. 进入试卷后等待题目和答题卡总数完整，在首次自动点击答案之前，对整卷逐题执行严格匹配、读取各题分值并估算可核验得分。

考试详情页通常没有题干，因此开考前只能做主题与候选题库预检，完整逐题预检须在试卷加载后进行。进入试卷后可能已经产生考试记录并启动网站倒计时；此时发现缺题不能声称“未开考”或“已经撤销考试”。

## 7. 答题、预计得分与交卷

### 7.1 答案准确性

- 在统一题库中使用题型、完整题干和全部选项文字精确匹配，结合明确的课程/来源信息消歧，以题库正确答案全文重新定位网页当前选项，字母只表示当前页面位置。
- 分值、难度和显示题号与真实题干分开读取，不能混入匹配文字；题目本身的括号、数字、否定词、单位、大小写、指数及标点保持原意。
- 无匹配、答案冲突或无法唯一映射的题目不猜答，保持原作答并列入未处理清单。
- 默认每两题之间等待 4 秒；单题多选按集合差异串行调整并回读核对。修改间隔从下一道题生效。

### 7.2 预计得分

- 预计得分是按本地题库和网页分值计算的估算，不能标为网站官方成绩或保证得分。
- 只累计“答案精确唯一匹配，且网页当前选中内容已回读核验一致”的题目分值。
- 未匹配、冲突、未核验、无效分值及无法识别的题目暂计 0 分并标注原因，不把用户原来随意选中的选项算成正确。
- 各题分值优先读取网页明确标注，不能简单按总分除以题数，单选、多选、判断可能分值不同。
- 多选只有整个选中集合与题库答案一致时才累计该题分值；不能假设漏选或部分选对一定有部分分。
- 无法核对试卷总分、题数或分值合理性时暂停自动交卷，等待人工检查。
- 展示得分构成：哪些题已核验并计分，哪些题未计分及原因，便于用户检查。

### 7.3 自动交卷条件与缺题人工确认开关

以下条件在开关开启或关闭时都必须满足：

1. 考试主题与题库对应关系已确认，网页题目及答题卡总数完整，整卷加载和预检完成，各题分值与试卷分制可核对。
2. 所有可自动匹配的题目均已唯一精确匹配、完成作答，并通过当前选中答案全文集合的回读核对；可匹配题尚未处理或核验失败时不能交卷。
3. 可核验预计得分严格大于 80 分；正好 80 分不自动提交。
4. 从本次实际进入试卷起至少经过 6 分钟，或达到用户设置的其他最早交卷时长。
5. 当前试卷仍有效、未提交、未结束，且本任务没有暂停或等待人工操作。

- **开关开启（默认）：** 还要求整卷每一道题均唯一精确匹配且当前选中全文核验通过。存在未匹配、冲突、未核验、无法唯一映射或不支持的题目时，进入“等待人工”；即使预计得分严格大于 80 分且已满 6 分钟，也不得自动点击交卷或确认，由用户在网站正常流程中手动确认交卷。网站显示未答完提醒时停止自动确认。
- **开关关闭：** 恢复部分题库的自动交卷规则。网页整卷已完整加载、全部可匹配题已处理并全文核验、已核验预计得分严格大于 80 分且达到最早交卷时长后，可保留未匹配、冲突或不支持的未知题并自动交卷；未知题仍不猜答、不计正分。允许确认本场正常的未答完提醒。
- 开关只决定题库缺题及正常未答完提醒是否由人工确认，不能放行网页题目或答题卡加载不全、分值或分制不明、主题关联不明确、得分小于或等于 80 分、计时未到等情况。题目或答题卡加载不全时始终不得自动交卷。
- 用户补选的未知答案仍不自动计为正确。开关开启时，须题库补全或消歧并重新核验整卷，才可重新评估自动交卷条件；也可由用户自行在网站确认交卷。
- 预计得分小于或等于 80 分时进入“等待人工”，即使已满 6 分钟也不自动提交、不自动刷新。用户处理后须重新核验；不确定的人工答案仍不能自动计为正确。
- 自动交卷只操作通过当前开关规则及全部通用条件的当前场次正常交卷及确认流程；异常、身份验证或结果不明确时始终停止并提示人工处理，不能盲目重复确认。
- 以网站显示提交成功或成绩结果确认完成，不能仅凭点击交卷按钮就标记完成。提交结果不明时先检查状态，避免重复提交。
- 用户取消交卷、手动修改答案、暂停任务或切换缺题人工确认开关时，取消原自动交卷计划，并使相应旧核验结果失效。切换开关同时暂停当前答题流程，不能直接触发交卷；须用户明确继续后重新预检和核验。
- 脚本暂停不会暂停网站考试倒计时；若脚本最早交卷时长与网站截止时间冲突，提前提示并等待用户处理。网站自身到时自动交卷仍可能生效。

示例：满分 100 分且网页整卷完整时，已核验 84 分但仍有 4 题未匹配，开关开启则满 6 分钟仍等待人工，关闭则可在全部可匹配题核验、满 6 分钟并满足其他条件后自动交卷及确认正常未答完提醒。整卷全部题目核验通过、预计 100 分时，经过 4 分钟应继续等待，满 6 分钟且其他条件满足才可自动交卷；预计 80 分或 78 分，以及网页题目/答题卡未加载完整，在任何开关状态下都不自动交卷。

## 8. 异常恢复、刷新和后台运行

- “暂停自动刷新”解释为意外停播的恢复；用户主动暂停、课中弹题、等待平台完成确认、等待交卷及等待人工不能被识别为故障。
- 建议连续 60 秒没有播放进度变化时先检查原因并尝试续播，15 秒后仍失败才刷新；单任务最多自动刷新 3 次，两次刷新至少间隔 30 秒，次数跨刷新保存。
- 刷新前保存任务标识、播放/学习记录、执行模式、倍率、已核验题目、考试原始开始时间和重试次数；恢复后以网站实际状态重新核对。
- 视频故障刷新应限制在对应视频页面。并行运行时，不能刷新另一场正在答题或等待交卷的考试。
- 登录失效、自动播放被浏览器拒绝、验证弹窗、提交结果不明或达到重试上限时，暂停受影响任务并提示人工处理。
- 全局“暂停”停止后续选择、交卷、任务跳转及自动刷新；“停止本轮”退出调度但保留已发生的学习与作答记录，两者不能假装撤销网站操作。
- 脚本自己发起的恢复刷新可继续同一已授权任务；人工刷新、重新打开浏览器时恢复任务清单但默认暂停，提供“继续上次任务”。恢复前核对账号、学习计划、任务、题库版本和网站状态。
- 保存站点脚本显示，网站在切到后台时主动暂停播放器，返回前台没有对应恢复逻辑。本版提供“切回页面时自动恢复播放”开关（`resumePlaybackOnReturn`），默认开启并保存；记录切页前正在播放的当前视频，在返回后尝试正常续播，后台暂停显示“后台暂停，等待返回”，不误判为长时间卡顿并刷新。
- 手动暂停播放器、全局或视频任务暂停、课中题及其他待人工状态优先，不能因为返回前台覆盖用户暂停。关闭恢复开关后不因切回页面自动播放。进度及计时只用真实播放器和平台记录校准，不靠回调次数虚增时长。
- 不承诺后台持续播放，也不承诺关闭浏览器、设备休眠或标签被冻结期间持续执行。后台被网站或浏览器中断时显示真实状态，不能显示“正常学习”却没有平台记录。

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

### 9.1 按功能分栏

面板采用一个窗口、六个功能栏。桌面左侧为功能导航，右侧只显示当前栏内容；窄屏改为顶部可横向滚动的标签栏，避免把所有功能挤在一页。

| 功能栏 | 主要内容与操作 |
|---|---|
| 任务总览 | 学习计划与任务清单、四种任务模式、顺序/并行、开始/停止本轮、总进度、完成/跳过/失败/等待人工统计、预计剩余时间；显示当前视频与考试摘要，点击可进入对应功能栏 |
| 视频学习 | 当前课程和课件、播放位置/总时长、平台已记录学习时长与完成状态、最高 2X 的倍速设置、视频任务暂停/继续、课中题匹配及处理状态、卡顿恢复状态；默认开启的续播、单次机会保护、切回恢复开关及当前模式后续流程说明 |
| 考试答题 | 当前考试主题与题库预检结果、自动选择答案开关、默认开启的“题目不全时手动确认交卷”开关、默认 4 秒的答题间隔、默认 6 分钟的最早交卷时长、网站剩余时间、预计得分与严格大于 80 分的门槛、交卷等待原因、答案全文核对与未处理题清单 |
| 题库搜索 | 统一题库导入与状态、来源记录数/题目数/冲突数、关键词搜索、课程/主题筛选、选中文字搜索、答案全文与来源、主题关联查看和维护；不显示岗位选择 |
| 控制台 | 带时间和任务名称的运行日志、状态/警告/错误筛选、复制日志、清空显示、恢复次数及交卷结果 |
| 其他设置 | 允许复制开关、默认关闭的题库导出开关及折叠区、异常恢复参数、后台运行状态说明 |

### 9.2 常驻区域与切换规则

- 标题栏常驻脚本名称“谊安学助手 2.0”，保留拖拽、面板折叠和位置保存。导航、按钮及表单操作不能误触拖拽。
- 全局运行状态、总进度及“暂停全部/继续全部”在各栏均可见；并行时显示视频与考试各自状态，不能只显示其中一个任务。
- 切换功能栏只改变可见内容，不停止或重启任务，不重新开始考试计时，不触发导出，也不改变开关。面板折叠后继续保留当前运行状态，并显示简要进度与需人工处理提示。
- 首次展开默认进入“任务总览”；同一会话内记住当前功能栏、搜索词、筛选项及滚动位置，切回来不清空内容。
- 视频与考试的局部暂停只影响对应任务，全局暂停影响所有任务。关闭“自动选择答案”应停止当前后续选项点击，并取消该场考试的自动交卷计划；切换功能栏不能再次启用。
- “题目不全时手动确认交卷”开关默认开启，设置跨页面和刷新保存。切换时暂停当前考试的答题与交卷计划，须明确继续并重新核验后才可执行，不能因关闭开关立即提交。
- 各设置仅在所属栏编辑，总览展示摘要并提供跳转，避免多处控件的值不一致。未启动或不适用的功能显示原因，不能隐藏正在等待人工处理的问题。
- 当前模式未启用的视频或考试栏仍可查看设置和记录，并显示“本模式未启用”；打开该栏不能启动对应任务。共用的答题间隔只保存一份，在课中题与考试中保持一致。
- “考试答题”栏保留现有练习页的自动选择与答案核对入口，进入练习页时显示练习状态；练习和课中题不套用考试交卷倒计时与得分门槛。
- 等待人工、题库冲突、视频恢复失败等重要事件在常驻区域提示，并给对应功能栏增加状态标记；不强制切走用户正在查看的搜索或日志内容。
- 内容区单独滚动，标题、导航与全局暂停保持可见；面板大小随视口适配，拖动或缩放窗口后仍能操作全部功能，键盘可切换功能栏并识别当前选中项。

### 9.3 日志、导出与题库变更

- 控制台是面板内可查看的运行日志，记录时间、任务名称、状态、主题对应、匹配数量、预计得分、交卷等待/结果及恢复原因和次数；保留最近 500 条，支持复制和清空显示。
- 清空控制台显示不清除任务清单或恢复检查点；日志不记录登录凭据和完整敏感接口数据。
- “持续记录诊断日志”开关默认开启，将最近 2000 条诊断记录独立持久保存，刷新后仍可查看和导出。提供“导出诊断 JSON”“导出诊断 TXT”“清空已保存诊断”；关闭开关只停止新增记录，已有记录仍可导出。诊断日志不包含完整题干、选项、答案和 URL 查询参数；清空诊断不删除任务检查点或题库。
- 题库导出移动到“其他设置”，保留独立开关与折叠区，默认关闭，开启后才允许导出；原有 CSV/JSON/TXT 格式和仅练习页导出规则不变。
- 保留题库导入、搜索正确答案、允许复制及答案全文核对功能；取消岗位切换，显示统一题库状态与课程/主题筛选。题库或主题关联变更时暂停受影响的答题任务，取消旧交卷计划并重新预检。

## 10. 验收标准

| 场景 | 预期结果 |
|---|---|
| 启动学习计划 | 列出实际课程/课件/考试任务，已完成项目不重复执行，阶段数与任务数不混算 |
| 四种模式 | 视频、课中题、独立考试按所选模式执行；仅视频遇强制题等待人工 |
| 新旧默认及视频后续 | 新安装默认“视频＋考试”，升级保留已选模式；平台确认视频完成后才进入已开放关联考试；仅视频及视频＋课中答题模式明确提示不会进入考试 |
| 顺序与并行 | 默认顺序；并行最多一个视频和一场考试，不重复任务且遵守前置条件 |
| 同类任务临时占用 | 租约冲突自动等待和重试；占用失效后继续调度，成功领取后清除旧等待提示；人工确认等待不被自动恢复覆盖 |
| 日志保存与清空 | 运行日志显示最近 500 条，清空只影响显示；默认持续保存最近 2000 条诊断，刷新后可导出 JSON/TXT，关闭只停止新增；清空诊断不删除检查点或题库 |
| 最高 2X | 面板与播放器实际倍率一致；网站学习时长和完成状态独立核对 |
| 主题预检 | 显示考试与题库对应关系，无库不自动开考；名称不同的明确关联可用 |
| 统一题库 | 三岗位题库全部可检索和匹配，无岗位选择；重复题保留来源，答案冲突不盲目覆盖 |
| 旧题库迁移与兼容 | 已存题库自动迁移，原 ZIP/CSV 与无岗位字段的新题库均可导入；重复迁移或导入不增生重复记录 |
| 题目乱序和分值标记 | 按正确全文映射，不依赖旧字母；分值和难度不污染题干 |
| 不同题型分值 | 按实际分值累计，仅完整核验通过的题得分，未知题不计正分 |
| 开关开启且题库缺题 | 例如已核验 84 分、缺少 4 题，满 6 分钟后仍等待用户在网站手动确认，脚本不点击任何交卷或确认按钮；正常未答完提醒也不自动确认 |
| 开关关闭且题库缺题 | 网页整卷完整、全部可匹配题处理并核验、预计 84 分且满 6 分钟并满足其他通用条件后，可自动交卷及确认正常未答完提醒，未知题仍不猜答、不计正分 |
| 整卷完整且全部核验 | 例如 100 分，整卷及答题卡完整、每题唯一精确匹配且当前选中全文核验通过，满 6 分钟并满足其他条件后才自动提交 |
| 通用门槛不满足 | 网页题目或答题卡加载不全、分值不明、主题不明确或预计分值不超过 80 等情况，在任何开关状态下都不自动交卷 |
| 切换缺题人工确认开关 | 默认开启，跨页和刷新保存；切换暂停答题/交卷计划，明确继续后重验，关闭时不立即提交 |
| 预计得分等于/低于 80 | 进入等待人工，不交卷、不因等待而刷新 |
| 交卷计时与恢复 | 从同一场考试原始开始时间计时，恢复不清零，不产生重复提交 |
| 卡顿和正常暂停 | 异常按次数上限恢复；用户暂停、课中题与等待交卷不误刷新 |
| 继续上次播放 | 默认开启时只点击精确识别续播弹窗的“继续播放”；关闭后留给人工，未知弹窗不点击 |
| 单次机会保护 | 明确总共或仅剩 1 次机会以及 0 次时，开启保护则课中题及考试等待人工；已答 1 次、1/40 题、交卷人数及隐藏文字不误触发；关闭仍须通过原有核验 |
| 切回恢复 | 切页前正在播放才在返回后恢复；关闭开关、手动暂停、暂停任务及待处理弹题不自动恢复；后台暂停不误报持续播放或触发故障刷新 |
| 后台与回到前台 | 实测切换标签页及最小化，检查网站记录；中断时显示真实状态 |
| 结束汇总 | 完成、跳过、失败、需人工分别列出，存在未完成项目不显示全部完成 |
| 功能分栏 | 六栏内容按功能归属展示，桌面与窄屏均可切换；状态与全局暂停常驻，切栏不重启任务或计时、不触发导出，搜索与筛选内容保留 |
| 既有功能 | 统一搜索、答案全文核对、复制、拖拽、位置恢复、导出开关和站点范围回归通过 |

## 11. 当前样本依据与开发前待核实内容

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

## 12. 2.1.2 增量确认

新增默认开启并持久保存的三个开关，分别控制自动选择“继续播放”、单次答题机会人工处理、切回页面恢复播放。用户确认的单次含义为“只剩 1 次或总共仅允许 1 次答题机会时，交给我手动答题”。保护共用于课中题和课程考试，不以本人已答次数代替剩余机会数。

修复网站主动后台暂停后返回不能及时续播的问题，同时保留用户暂停的优先级，真实显示后台暂停状态。新安装默认串联视频与考试，已有模式保留；面板根据实际模式说明视频完成后的走向。附件 `08.zip` 仅作静态外壳证据，真实账号的续播、平台完成条件及考试入口仍需实站核对；不能宣称后台始终播放。

## 13. 2.1.3 调度与问题记录

用户反馈“等待同类任务租约释放，暂不操作当前页面”后没有进入考试。租约冲突属于暂时调度状态，应自动复查，不直接变成必须手动继续的等待；领取成功后必须同步实际任务及常驻提示。另一执行页面仍有效时保持互斥，不能为了跳转考试抢占其他正在进行的视频或考试。平台确认完成、当前执行模式、考试主题及单次机会保护等条件继续有效。

本地已复现租约临时冲突变为永久人工等待，以及成功领取后旧提示未清除的两项缺陷；不能据此断言用户当前存在重复标签。归档学习地图的课程和考试入口使用 Angular 当前页导航，静态证据不能代替实站验收。

控制台继续显示最近 500 条运行日志，“清空显示”仅清显示。新增默认开启的“持续记录诊断日志”，独立持久保存最近 2000 条诊断，刷新后保留，提供“导出诊断 JSON”“导出诊断 TXT”“清空已保存诊断”。关闭开关只停止新增，已存内容仍可导出；诊断不含完整题干、选项、答案和 URL 查询参数，清空诊断不删除任务检查点或题库。

## 附：用户原始需求

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