# 更新日志 (Changelog)

本文件记录「学习通AI答题小助手（Region改良款）」的所有重要改动。

> 本脚本基于 [ScriptCat #711《🥇超星学习通｜知到智慧树——网课小助手》](https://scriptcat.org/zh-CN/script-show-page/711)（原版 v0.2.7）改良而来，在此向原作者致敬。

格式参考 [Keep a Changelog](https://keepachangelog.com/)，版本号遵循语义化版本。

---

## [1.43] - 2026-11-22

### 🧹 清理 (Removed) - 2026-11-22
- **移除头部遗留的反特性声明**：`@antifeature ads 公众号或者app辅助答题` 与 `@antifeature payment 付费答题` 是从原版 ScriptCat #711 原样继承的残留，改良版**并不存在**这两项功能（全脚本仅接入 6 个 OpenAI 兼容 AI 接口域名，无任何公众号 / App / 支付相关代码）。保留会让 GreasyFork 等脚本站把脚本误标为「含广告 / 含付费」，与公开说明矛盾。
- `@description` 末尾补充真实声明：本改良版无广告、无付费、无公众号 / App 辅助答题，答题完全由你自己的 AI 接口完成。
- 同步在说明页「免责声明」前新增一段无广告 / 无付费声明，README 特性列表补一条。

## [1.42] - 2026-11-22

### 🐛 修复 (Fixed) - 2026-11-22
- **倍速设置后播放器菜单仍显示旧档位（如日志已设 2x、菜单高亮 1x）**：此前脚本直接写 `video.playbackRate`，实际速率已生效，但播放器菜单高亮由它自己的内部状态驱动，不会跟着 DOM 属性变，造成「显示已设置倍速、界面却像没生效」的误解。
  - 设速后新增 `clickMenuRate()`：从页面真实倍速菜单收集各项（含 `[data-rate]` / `data-speed` 属性和菜单项文案），点击与目标倍速一致的项，让菜单高亮与实际速率同步。
  - 优先点击当前视频所在文档里的菜单项，避免同页多个播放器时误伤；找不到菜单项时回退为「直接写入」并在日志明确说明「菜单高亮可能仍显示旧值，不影响实际播放」。
  - 延迟上调倍速时同样同步点击菜单。
- 冒烟测试新增 5 项静态断言（共 **90 项通过**）：菜单点击函数、菜单项收集、优先当前文档、两处调用、日志双分支。

## [1.41] - 2026-11-22

### ✨ 新增 (Added) - 2026-11-22
- **「视频自动跳到结尾」改为设置页可切换开关**：此前只能改脚本内 `ENABLE_AUTO_SEEK` 常量才能开关，现已在「设置 → 章节设置」新增勾选框「视频自动跳到结尾」，默认开启（保持原有极速刷完体验），可随时取消勾选改为按倍速正常播完。
  - 播放逻辑改为每次运行时读取该设置项，切换后立即生效，无需刷新页面；设置本身会持久化，刷新后仍保留你的选择。
  - 旧配置迁移：按参数名合并，已有配置会自动补上该开关并默认开启，不会丢失原有设置。
- 冒烟测试新增 8 项（共 **85 项通过**）：设置页开关存在 / 默认开启 / 关闭与开启的即时状态 / 两种状态的持久化 / 无残留硬编码常量 / 播放逻辑确实读取设置项。

## [1.40] - 2026-11-22

### 🐛 修复 (Fixed) - 2026-11-22
- **预设下拉框不再错误回退到 OpenAI**：用户反馈填好 DeepSeek 的地址 / 密钥 / 模型并测试连接成功后，再进入「答题」页时预设下拉框显示为 OpenAI（地址、密钥、模型都还在，只有下拉框错了）。根因是下拉框状态写死为 `vue.ref("openai")`，而「答题」页是动态组件，切标签 / 重开面板时组件重建就重置了。
  - 改为 `vue.computed(() => presetByBaseUrl(configStore.aiConfig.baseUrl))`：按已保存的接口地址反推预设（忽略尾部 `/` 与大小写），地址匹配不到任何预设时显示「空白（自定义）」。地址是真正生效的唯一来源，不再额外存一个会不同步的字段。
  - 补上 `patchFlag = 8, dynamicProps = ["value", "onChange"]`，确保地址变化时下拉框选中项真的重新渲染。
- 冒烟测试新增 6 项（共 **77 项通过**）：选中 DeepSeek → 切走再切回 → 下拉框仍是 DeepSeek；手改自定义地址落到「空白（自定义）」；改回官方地址恢复 DeepSeek。

## [1.39] - 2026-11-16

### 🔄 变更 (Changed) - 2026-11-16
- **「—」改回两步收起**（按用户澄清的真实需求）：1.38 把点「—」直接做成彻底收起，跳过了「已最小化」小卡片这一步。现在恢复为：
  1. 完整面板 → 点「—」→ **「已最小化，点击上方按钮恢复」小卡片**（面板仍在，AI 圆钮不出现）；
  2. 在小卡片上再点一次「—」→ 面板才彻底消失，只留右下角 AI 圆钮；
  3. 点 AI 圆钮 → 重新展开完整面板。
  - 「⛶」仍可从最小化状态直接展开。
- 冒烟测试更新为两步流程断言（第一步 / 第二步 / 圆钮恢复 / ⛶ 展开 / 反复操作），共 71 项通过。

---

## [1.38] - 2026-11-16

### ✨ 新增 (Added) - 2026-11-16
- **面板「—」改为「彻底收起」**：按用户要求，点标题栏的「—」现在会把**整个面板隐藏**，只留下右下角蓝色「AI」圆钮（而不是留在页面上的「已最小化」小卡片）；再点「AI」圆钮即可重新展开完整面板。
  - 通过 layout 注册 `restorePanelFn` 实现：面板 DOM 一直在 shadow root 里，只是 `display:none`，恢复时不重复挂载 Vue 应用，避免卡顿。
  - 收起时重新显示 AI 圆钮（`showLauncher`），恢复 / 首次挂载时隐藏圆钮（`hideLauncher`）。
  - 标题栏旁的「⛶」仍用于把最小化状态展开回来。
- 冒烟测试新增「— → 圆钮恢复」闭环断言（隐藏 / 显示 / 反复操作 / 无 console.error）。

---

## [1.37] - 2026-11-16

### 🔧 变更 (Changed) - 2026-11-16
- **移除 `*.edu.cn` 生效域名**：按用户要求，脚本不再通过 `@match` 在 `*.edu.cn` 域名下注入，避免在非超星的学校网站触发。
  - 同步更新在线文档「生效域名」与 README 的域名列表。
  - 注意：若有学校的课程平台部署在 `xxx.edu.cn` 域名下且需要脚本，需在脚本头手动加回 `@match *://*.edu.cn/*`。

---

## [1.36] - 2026-11-16

### 🔧 变更 (Changed) - 2026-11-16
- **DeepSeek 模型名与接口地址同步官方最新文档**：官方「首次调用 API」/「Models & Pricing」目前只列出 `deepseek-flash`（DeepSeek-V4.1-Flash）与 `deepseek-v4-pro`（DeepSeek-V4-Pro），旧版 chat 模型名已下线，继续填写会被判「模型不存在」。
  - 面板模型框占位提示改为 `AI 模型，如 gpt-4o-mini / deepseek-flash`；**选中 DeepSeek 预设时**动态显示 `DeepSeek 模型：deepseek-flash / deepseek-v4-pro`，直接告诉用户可用模型名（该 props 已加入编译更新的动态属性列表，切换预设会实时刷新）。
  - 地址框占位提示补充 `https://api.deepseek.com` 写法；README 与在线说明文档中的示例、字段说明、内置预设表全部同步。
- **预设地址改为官方写法**：`DeepSeek (深度求索)` 由 `https://api.deepseek.com/v1` 改为 `https://api.deepseek.com`（不带 `/v1`）。脚本内部会拼接 `/chat/completions`，与官方 curl 示例 `https://api.deepseek.com/chat/completions` 一致；其余预设不变。

### 🛠 修复 (Fixed) - 2026-11-16
- **修复「选了 DeepSeek 预设后测试连接 / 答题提示模型不存在」**：v1.13 起预设只填地址、会把模型字段清空，而「测试连接」与 AI 答题请求在模型为空时都硬兜底成 `gpt-4o-mini`，等于把 OpenAI 的模型名发给 DeepSeek。
  - 新增 `defaultModelFor(baseUrl)`：命中 `api.deepseek.com` 时兜底 `deepseek-flash`，其余服务仍兜底 `gpt-4o-mini`，不改变其他服务商行为。
  - 显式填写模型名时完全以用户填写为准。

---

## [1.35] - 2026-11-02

### 🩺 诊断 (Diagnostics) - 2026-11-02
- 卡片切换失败时输出**当前页面所有「激活态」元素的文案**（最多 8 个），例如「2 Case 2」，便于确认新版导航的标签结构、快速补上匹配规则。
- 无行为变更，仅为定位问题提供线索。

---

## [1.34] - 2026-11-02

### 🛠 修复 (Fixed) - 2026-11-02
- **修复「视频播完不进入下一个视频」**：日志显示「已触发『下一节』（选择器）」之后，页面 iframe 列表**完全没变**（`knowledgeid` 仍是同一个），说明点到的是一个无效元素；随后又在同一页反复重播视频。
  - 原因是新版学习通把同一章拆成 **`1 Case 1 / 2 Case 2 / 3 Case 3` 这类卡片标签**，并非「下一节」按钮。
  - **点完要校验**：点击「下一节」后记录页面签名（`location.href + 顶层 iframe.src`），等待 1.6 秒对比；**页面没变化就说明没点对**，转为点击「下一个卡片标签」。
  - 卡片识别规则：找带 `active / is-active / cur / current / selected / aria-selected=true` 的元素，要求其文本**以数字开头**（如 `2 Case 2`），点它同一父级里的下一个同级元素；顶层文档找不到时会进入同源 iframe 内继续找。
  - 仍找不到时，2.5 秒后再走一轮原有选择器/文本兜底。
- **修复「同一视频反复重播」**：新增 `completedVideoSrcs`（按章节重置）记录本页已自然播放完成的视频 `src`；播放器复位后再次被处理时直接跳过，日志「该视频本页已播放完成，跳过重播」，不再从头再播一遍。

---

## [1.33] - 2026-11-02

### 🔄 回滚 (Reverted) - 2026-11-02
- **恢复「自动拖到结尾前 5 秒」**：1.32 曾默认关闭该功能（`ENABLE_AUTO_SEEK = false`）以避免重播，但按用户要求改回默认开启（`true`），保持原有的极速刷完体验。
  - 保留 1.32 新增的「同一视频在本次章节内只跳一次」（`seekedVideoSrcs`），因此不会出现反复跳到末尾的循环。
  - 若某门课因「观看时长 ≥ 90%」限制导致跳转后重播，仍可把 `ENABLE_AUTO_SEEK` 手动改为 `false`，退回纯倍速播完。
  - README 与在线文档同步恢复说明。

---

## [1.32] - 2026-11-02

### 🔧 变更 (Changed) - 2026-11-02
- **默认关闭「自动拖到结尾前 5 秒」，修复「播完又从头播一遍、再跳到末尾」的重复现象**：超星多数任务点要求「观看时长 ≥ 90%」，脚本把进度条跳到末尾会被判为未完成，播放器随后把视频复位重播；再叠加脚本下一次处理又跳一次，就形成了「播完 → 重播 → 跳到末尾 → 才进下一个」的循环。
  - 新增常量 `ENABLE_AUTO_SEEK = false`（在 `useCxChapterLogic` 顶部），默认**只按倍速正常播完**，不再 seek。
  - 若你的课程确实允许跳转、想快速刷长视频，把该常量改为 `true` 即可恢复。
  - 顺带：同一视频的 `src` 在本次章节内最多只跳一次（`seekedVideoSrcs` 记录），即使开启该功能也不会反复跳；被播放器复位过的视频不会再尝试跳转。

---

## [1.31] - 2026-11-02

### 🛠 修复 (Fixed) - 2026-11-02
- **修复「播放成功后不显示『播放成功』、后续流程卡死」**：这是一个**单位错误**。项目内的 `sleep(second)` 参数单位是**秒**（内部 `second * 1000`），而 v1.28 / v1.29 新增的重试逻辑误用了毫秒：`await sleep(1200)` 实际等于 **1200 秒（20 分钟）**，`await sleep(2500)` 等于 **2500 秒（约 42 分钟）**。于是播放确认循环在第一次 `play()` 后就卡住 20 分钟，既到不了「播放成功」日志，也不会继续后面的倍速 / 拖拽 / 下一节。
  - `sleep(1200)` → `sleep(1.2)`（播放进度校验间隔 1.2 秒）
  - `sleep(2500)` → `sleep(2.5)`（下一节首次未命中后的重试间隔 2.5 秒）
  - 在 `sleep` 定义处补注释，明确单位是「秒」。
- **播放相关日志补全**：之前只有成功/失败两种结果，现在会说明卡在哪一步——「播放流程已结束（settled）」「页面已切换，结束本任务点」「任务点已完成，结束本任务点」「检测到视频弹题，暂缓自动播放」，并新增一条「播放状态：paused / currentTime / readyState / rate」诊断。
- **移除播放前的强制 `pause()`**：若播放器已自行开始播放，`pause()` 再 `play()` 容易与其状态机冲突（`AbortError` 的常见来源），现在只做静音，不再打断已有播放。

---

## [1.30] - 2026-11-02

### 🛠 修复 (Fixed) - 2026-11-02
- **修复「视频还没开始播放就设倍速 / 拖进度条，导致播放失败」**：原流程在 `pause()` 之后、`play()` 之前就调用 `applyMediaOptimizations()`，等于在播放器还没播起来时就去改速度和 seek。日志表现为「已设置倍速：2x」之后没有「播放成功」，然后画面动一下就停。
  - **调整顺序**：先播放并确认真的在推进（`currentTime` 前进），**确认播起来之后**才设置倍速、才尝试拖拽。
  - **拖拽加前置条件**：`video.paused` 为真时直接跳过，并记录「视频尚未开始播放，暂不拖拽进度条」，不再做无效 seek。
  - **设速后加保护**：若设置倍速后 1.8 秒内播放被中断（被暂停且进度 < 1.5 秒），自动回退到 1x 并继续播放，日志写明「设置 Nx 后播放被中断，已回退到 1x」。

---

## [1.29] - 2026-11-02

### 🛠 修复 (Fixed) - 2026-11-02
- **修复「视频播完 / 文档滑完后不自动进入下一个任务或章节」**：原来进入下一节只依赖 5 个固定选择器（`#prevNextFocusNext`、`.nextChapter` 等）且在**顶层文档**里查找；2026 版学习通的按钮结构与类名已变化，全部命中失败，直接落到「未找到可用的下一节按钮」。
  - 改为**三级兜底**：① 原有 5 个选择器 → ② 顶层文档按**可见文本**匹配（下一节 / 下一小节 / 下一个 / 下一任务 / 下一章 / 继续学习 / 继续）并点击最近的 `a/button/li/div` → ③ 再逐个进入同源 iframe 内做同样的文本匹配。
  - 增加**可见性判断**（`display` / `visibility` / `pointerEvents` / 尺寸 > 4px），避免点到隐藏按钮；扫描节点设有上限，不会拖慢页面。
  - 首次未命中会**等待 2.5 秒再重试一次**（任务点完成状态有时是延迟刷新的）。
  - 命中后日志会写明命中方式（选择器 / 文本 / iframe 内文本），便于确认；仍失败时会输出页面上「下 / 继续 / 完成」相关的可见文案，便于快速定位新版按钮文案。

---

## [1.28] - 2026-11-02

### 🛠 修复 (Fixed) - 2026-11-02
- **修复「视频无法自动播放 / 手动点播放后动一下就停」**：部分课程任务点标注「观看时长需 ≥ 总时长的 90%（未观看任务点当前视频不可倍速、不可拖拽）」，播放器会主动禁用倍速与拖拽。此前脚本一上来就强设 2x（日志「已设置倍速：2x」），播放器检测到后会把速度打回 1x 甚至暂停，表现为「画面动一下就不动了」；同时 `play()` 在播放器尚未初始化（`duration` 都还没拿到）时就被调用，抛 `AbortError`。
  - **检测到限制就不强来**：扫描页面文本中的「不可倍速 / 不可拖拽 / 无法拖动进度条 / 禁止拖动 / 禁止倍速」，命中则保持 1x 正常播放，不设倍速、不 seek，并记录日志说明原因。
  - **播放改为「等就绪 + 校验 + 重试」**：先等 `readyState ≥ 2`（`loadeddata` / `canplay`，最多等 3 秒）再调用 `play()`；每次播放后校验 1.2 秒内 `currentTime` 是否真的推进，未推进则点击播放器按钮并重试，最多 4 次，避免「点一次就算成功」的假象。
  - **恢复播放不再一次失败就放弃**：`pause` 后恢复播放若被拒绝（如播放器重新加载），改为最多重试 8 次并记录日志，而不是直接判任务失败。
  - **避免与播放器抢速度**：速度被播放器改回时，最多纠正 3 次即放弃，防止来回拉锯造成抖动或暂停。

---

## [1.27] - 2026-10-28

### 🔧 变更 (Changed) - 2026-10-28
- **更新地址从 jsDelivr 改为 GitHub Pages**：`@downloadURL` / `@updateURL` 改为 `https://regionnor.github.io/xue-xi-tong/chaoxing-ai-answer-assistant.user.js`，避免 jsDelivr 对 `@main` 长达约 12 小时的缓存，更新后基本 10 分钟内即可生效。
  - 注意：需在仓库 Settings → Pages 中选择 **Deploy from a branch → main → / (root)** 开启一次；开启后该地址即可直接安装与自动更新。

---

## [1.26] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **修复「点协议/设置等标签后，内容已切换但高亮仍停在首页」**：标签按钮是我手写的编译式渲染，给了 `patchFlag=9`（TEXT + PROPS）且 `dynamicProps=["onClick"]`——**缺少 class 的更新位**。Vue 复用节点更新时只按 `dynamicProps` 补 `onClick`，不会重算 `class`，于是 `.active` 高亮一直停在初始的「首页」，而内容却正常换了。
  - 把标签按钮的 `patchFlag` 改为 `10`（CLASS + PROPS），class 由 CLASS 位正确重算；点击哪个标签，高亮就跟着走。
  - 运行日志条目的 `class`（按日志类型着色）同样存在该隐患，一并改为 `patchFlag=10`。

---

## [1.25] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **修复「在答题页，面板却仍显示首页」**：v1.24 只在「URL 未匹配三个关键词」时把标签重置为首页，但超星其实有大量答题/任务页 URL 不在这三个关键词里（如 `mooc-ans/...`、`/work/...`、考试页等）；同时脚本原有逻辑在进入章节 / 处理非作业任务点时**会主动把标签切回首页**，于是刚跳到的答题页又被压回首页。
  - 改为**按页面 URL 类型决定初始标签**：`studentstudy` / `dowork` / `homework` / `/work` / `exam` / `mooc-ans` → 「答题」，其余（门户首页、课程详情等）→ 「首页」。
  - 去掉了三处会强制切回首页的赋值（章节切换、已完成的非作业任务点、文档/PPT 路由），标签不再被自动压回首页；**发现作业 / 发布题目时仍会自动切到「答题」**。
  - 新增 **SPA 地址变化监听**（每 1.5s 比对一次 `location.href`），超星部分跳转不整页刷新时，标签也会跟着新地址更新。

---

## [1.24] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **修复出现两个「AI」按钮、只有一个能打开**：脚本会注入到所有匹配 `*.chaoxing.com` 的 iframe，此前每个 frame 都各自创建了一个悬浮启动按钮，页面上就出现了多个圆钮，且只有顶层那个能打开（指向顶层全屏面板），iframe 内的那个点了只会把面板挂进 iframe（看起来没反应）。
  - 现在 `createLauncher()` / `mountPanelOnce()` 增加顶层文档判断（`window.top !== window.self` 直接返回），**仅在顶层页面创建按钮与面板**；iframe 内的核心扫描 / 答题逻辑不受影响。
- **修复页面跳转到首页后面板仍停在「答题」标签**：`menuIndex` 会被持久化，进入新页面时沿用了上次的标签。现在 `executeLogicByUrl` 在**未匹配到章节/作业/考试等任务页**时把面板重置回「首页」，与当前所在页面一致；命中任务页时仍自动切到「答题」。
- **修复设置页「其他参数」文字显示不全**：设置里的数字项标签较长（如「切换、答题间隔，单位秒」「正确率达到多少自动提交」「答案相似度超过多少选择」），原先用 48px 固定标签列导致被输入框压住截断。
  - 改为**标签在上、输入框在下**的堆叠布局（`.mp-field.mp-col`），长标签可完整换行显示；答题页的短标签（地址/密钥/模型/要求）仍保持左标签右输入的紧凑布局。
  - 同时给面板内容区加高度上限（`max-height: calc(100vh - 110px)`）并让标签栏吸顶，堆叠后设置页变高也不会溢出屏幕。

---

## [1.23] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **修复「点 AI 按钮无法打开面板」**：v1.22 原生化后，答题组件（`QuestionTable`）的渲染里，测试结果那一段用了 `条件 ? 节点 : null`，把 `null` 直接塞进编译优化模式（STABLE_FRAGMENT）的子节点数组。编译优化下 `mountChildren` 不会过滤 `null`，会执行 `cloneIfMounted(null)` → 读取 `null.el` 抛 `TypeError`，导致整个面板渲染中断。
  - 由于面板默认会恢复上次所在的标签页（用户此前停在「答题」），所以一打开就崩、看起来「按钮点了没反应」。
  - 将所有 `: null` 分支改为 `vue.createCommentVNode("v-if", true)`（与 Vue 编译器 `v-if` 的占位一致），避免 null 进入子节点数组。
- **修复运行日志文字不显示**：日志条目的 `innerHTML` 被误传成了「子节点」而非「属性」，导致消息文本不渲染；改为放在 props 上（`createElementVNode("span", { innerHTML: item.message }, null, 8, ["innerHTML"])`）。
- **新增挂载失败兜底提示**：若面板初始化仍抛错，会在左下角显示 8 秒红色错误条（含错误信息），便于快速定位，而不是静默无反应。
- 已用 jsdom + Vue 3 真实挂载测试：依次点击「首页 / 答题 / 设置 / 教程 / 协议」5 个标签，**0 报错**，答题页正确显示 AI 接口/测试连接/预设下拉/题目表格，设置页正常显示开关与数字输入。

---

## [1.22] - 2026-10-28

### 🚀 优化 (Changed) - 2026-10-28
- **彻底移除 ElementPlus，面板改为纯原生实现（彻底告别卡顿）**：此前 v1.21 虽改为「点击悬浮按钮才挂载面板」，但用户实测**点一下 AI 按钮依旧卡死**——根因由此 100% 锁定为 `app.use(ElementPlus)` 在重型超星 DOM 上同步初始化 + 往 shadow DOM 注入大段 EP 样式，单次耗时数秒、阻塞主线程。
  - 本次将面板内**所有 ElementPlus 组件**（`el-card` / `el-tabs` / `el-tab-pane` / `el-icon` / `el-tooltip` / `el-text` / `el-divider` / `el-button` / `el-input` / `el-input-number` / `el-checkbox` / `el-table` / `el-table-column` / `el-empty` / `el-form-item`）全部重写为**原生 HTML + 紧凑 CSS 类名**（`.mp-card` / `.mp-header` / `.mp-tabs` / `.mp-tab` / `.mp-body` / `.mp-field` / `.mp-input` / `.mp-select` / `.mp-textarea` / `.mp-btn` / `.mp-checkbox` / `.mp-log*` / `.mp-q-table` / `.mp-empty` 等）。
  - **保留全部功能**：AI 接口预设下拉、地址/密钥/模型/要求输入、测试连接、运行日志导出、题目表格（含状态图例）、多标签页切换、拖拽、最小化/恢复、教程/协议静态页均不受影响。
  - 移除 `@require` 的 `element-plus` JS 与两个 EP `@resource` 样式，IIFE 不再接收 `ElementPlus` 参数；`layoutCss` 由「引用 EP 大样式」改为内联紧凑原生样式（仅 ~7.6KB，原 EP 样式数十 KB）。
  - 结果：**页面打开不卡**（悬浮按钮本就是原生 DOM），**点击 AI 按钮也不卡**（不再初始化 ElementPlus）。界面观感更朴素，但交互、功能、答题能力完全不变。

---

## [1.21] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **根本性解决「任意 chaoxing 子域打开就卡」**：此前几版用「黑名单逐个跳过挂载」的方式（跳过 `/manage`、登录页、`vN` 门户首页），但用户又遇到 `i.chaoxing.com/base?t=...` 等新页面卡顿——本质原因是只要页面加载即同步执行 `app.use(ElementPlus)` + 往 shadow DOM 注入大段 EP 样式（在重 DOM 上耗时数秒），且超星子域层出不穷，黑名单永远补不完。
  - **改为「按需挂载」架构**：页面加载时只创建一个**极轻量的原生 DOM 悬浮启动按钮**（右下角蓝色「AI」圆钮，纯 `document.createElement`，不触碰 Vue / ElementPlus）；只有用户**点击该按钮**时才用 `requestIdleCallback` 创建完整 Vue + ElementPlus 面板。
  - 这样**任何** `i.` / `v8` / `v1` / `manage` / 任意子域，打开瞬间都不会被面板初始化阻塞，彻底告别卡顿；需要面板时点一下即可，功能完全不变。
  - 配套：面板挂载后默认可见（`layout` 的 `isShow` 初值改 `true`），并在 `_sfc_main$3` 未匹配到具体任务页时不再自动隐藏面板（因面板现由用户显式展开）。
  - 移除此前的 `shouldSkipMount` 黑名单与自动挂载 `timer`，改用 `createLauncher` + `mountPanelOnce`（防重复挂载）。

---

## [1.20] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **修复 `/manage?ws=` 无尾斜杠漏判，导致教师后台仍挂载面板卡顿**：v1.19 的 `shouldSkipMount` 用 `href.includes("/manage/")`（带尾斜杠）判断，但用户实际跳转的地址是 `v1.chaoxing.com/manage?ws=`（**无尾斜杠**），未命中跳过规则，面板又被挂载，再次卡死。
  - 改用 `path.startsWith("/manage")`、`path.startsWith("/auth/")`（基于 `URL` 解析的 pathname，无视尾斜杠与 query），并统一用 `new URL()` 解析，避免大小写 / 斜杠差异漏判。
- **卡顿根因已 100% 锁定为「面板挂载」**：用户验证「`v8.chaoxing.com` 很顺 → 跳 `/manage?ws=` 卡」——只要跳过挂载就不卡，说明问题完全出在浮动面板的初始化（`ElementPlus` 全局注册 + shadow DOM 注入大段 EP 样式在重 DOM 上耗时数秒），与核心扫描/答题逻辑无关。
  - 后续若需在教师后台也用面板，将改为「首次点击悬浮按钮才创建面板」或「不全局 `app.use(ElementPlus)`、仅局部注册所需组件」以彻底轻量化；当前策略为「用不到的页面直接不挂」，对用户体验零损失。

---

## [1.19] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **继续缩小面板挂载范围（验证卡顿来自面板挂载本身）**：v1.18 仅跳过了教师后台 `/manage/` 与登录页，但用户反馈 `https://v8.chaoxing.com/`（各类门户/首页）仍然要等几秒才能点。由于 v1.18 已把挂载延迟到 `requestIdleCallback`，仍卡说明**面板挂载本身在这些门户首页上即耗时数秒**（最可能是 `ElementPlus` 全局注册 + shadow DOM 内注入大段 EP 样式在这类重 DOM 上慢）。
  - 扩展 `shouldSkipMount()`：对 `vN.chaoxing.com`（`v1`/`v8`…）的**根路径 / 首页 / `/home` / `/index`** 也跳过挂载。这些门户页无视频/答题可处理，跳过零功能损失。
  - 若升级后 `v8.chaoxing.com/` 立即变流畅，即可确认**卡顿 100% 来自面板挂载**，下一步将把面板改为「用户首次点击悬浮按钮才创建」或「不做 `app.use(ElementPlus)` 全局注册、仅局部注册所需组件」以彻底轻量化。

---

## [1.18] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **彻底消除「页面加载要等一会才能点」的卡顿**：前几版（1.15~1.17）已确认 1.11→1.12 的唯一改动仅是 AI 配置 UI，并将其 Element Plus 组件全数替换为原生控件，但用户反馈在 `v1.chaoxing.com/manage/` 等页面仍有数秒加载阻塞。进一步定位：脚本对 `*.chaoxing.com/*` **全站无差别挂载** `ElementPlus` 全局注册 + 完整浮动面板，而教师后台 `/manage/`、登录页等页面无视频/答题可处理，挂载它们既无收益又会拖累首屏。
  - 新增 `shouldSkipMount()`：**对 `/manage/`、`passport`/`login`/`/auth/` 等脚本用不到的页面直接跳过挂载**，零功能损失。
  - 其余页面改用 **`requestIdleCallback`（退化 `setTimeout 200ms`）** 挂载面板：页面 `readyState=complete` 后不立即同步挂载，而是等浏览器空闲再挂，确保**首屏立即可交互**，面板稍后浮现，绝不阻塞首次点击。
  - 挂载包 `try/catch`，单面板异常不影响页面。

---

## [1.17] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **继续消除面板内 Element Plus 组件导致的卡死（AI 配置区）**：经比对，1.11→1.12 的**唯一改动**就是给「答题」设置新增了 AI 预设 / 测试连接 UI；1.11 及以前完全正常，1.14 以后全页面卡死。因此卡死根因 100% 落在这些新增的 Element Plus 组件上（在 closed shadow DOM 内样式缺失、组件度量失稳引发主线程阻塞 / ResizeObserver 死循环）。
  - 1.15 已将 `el-select` 换成原生 `<select>`；本次进一步把「测试连接」按钮的 `el-button` 也换成**原生 `<button>`**（内联样式，保留「测试中…」禁用态），使 1.12 新增的 UI 中**不再遗留任何 Element Plus 组件**，与 1.11 的组件集完全一致。
  - 现状：AI 配置区现仅使用原生 `<select>` / 原生 `<button>`，以及 1.11 已稳定使用的 `el-divider` / `el-checkbox` / `el-input` / `el-table`。
- **重要排查提示**：若升级到 1.16/1.17 后仍卡死，极大概率是**未真正装上新版**（jsDelivr CDN 约 12h 缓存，或仍在用 1.14 缓存）。请务必：① 在管理器里删除旧脚本后重新拖入本文件；② 或到 jsDelivr 对应文件页 Purge 缓存后「检查更新」；③ 硬刷新（Ctrl+F5）。确认 `@version` 已变为 1.17 再验证。

---

## [1.16] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **彻底解决「启用脚本后所有超星页面卡死」**：根因有两层——
  1. v1.12 引入的 AI 预设下拉使用了 `el-select`，在 closed shadow DOM 内触发 ResizeObserver 死循环（已在 1.15 改为原生 `<select>` 修复）；
  2. 脚本浮动面板在**每个超星页面都会挂载**，而根组件的 `el-tabs` 会**急切渲染所有 `el-tab-pane`**（仅用 `v-show` 隐藏），导致「答题」标签页（含上述 `el-select`）在页面加载时就被挂载、即便未切换到该标签页也会转起来 —— 表现为「任意超星页面一启用脚本就卡死」。
- **本次加固**：把各 `el-tab-pane` 的内容改为**懒挂载**——仅当 `configStore.menuIndex === tab.name`（即该标签页被选中）时才渲染对应组件，未选中的标签页内容渲染为 `null` 不挂载。这样页面加载时只挂载默认「首页」标签页；即便停留在旧版本，非默认标签页也不会在加载期被挂起空转。
- 注意：若你仍停留在 1.14 或更早，请务必升级到 1.16（含 1.15 的原生 select 修复 + 本次懒挂载）。升级后建议硬刷新（Ctrl+F5）或重新拖入脚本以绕过 jsDelivr ~12h 缓存。

---

## [1.15] - 2026-10-28

### 🛠 修复 (Fixed) - 2026-10-28
- **修复安装 v1.12+ 后「答题」设置页卡死、CPU 飙高（风扇狂转）**：v1.12 新增的 AI 预设下拉使用了 Element Plus 的 `el-select`。该组件内部依赖 **teleport + popper 弹层 + ResizeObserver 尺寸测量**，而整个面板挂载在 **closed shadow DOM** 内、Element Plus 样式无法穿透，导致 `el-select` 的尺寸测量失稳、触发 **ResizeObserver 死循环**，表现为页面卡死、CPU 占满。
  - 改为使用 **原生 `<select>` + `<option>`**（内联样式，在 shadow DOM 内始终生效，无 teleport/popper/ResizeObserver 负担），与之前把 `el-scrollbar` 换成原生 `<div>` 是同一思路。
  - 「测试连接」按钮继续沿用安全的 `el-button`（自 v1.11 导出按钮起已在 shadow DOM 内稳定使用），未改动。
  - 若此前在 1.12~1.14 上遇到卡死，升级到 1.15 后应恢复正常。

---

## [1.14] - 2026-10-28

### 🔧 修正 (Fixed) - 2026-10-28
- **修正小米 MiMo 预设端点**：将预设「小米 MiMo」的接口地址由社区流传值 `https://api.miwifi.com/v1` 更正为官方 OpenAI 兼容地址 `https://api.xiaomimimo.com/v1`（官方同时提供 Anthropic 兼容路径 `https://api.xiaomimimo.com/anthropic`，本预设采用 OpenAI 兼容）。API Key 格式为 `sk-xxxxx`（于官方 API Keys 页面创建）。现已移除「端点请核实」提示。模型字段仍留空，由用户按账户实际可用模型填写。

---

## [1.13] - 2026-10-28

### 🔧 调整 (Changed) - 2026-10-28
- **预设接口源不再预填「模型」，仅填「地址」**：根据反馈，各厂商 / 账户可用的模型名差异较大，预设下拉（OpenAI / DeepSeek / 通义千问 / 豆包 / Kimi / 小米 MiMo / 空白）现只一键填好接口地址，模型字段留空由用户自行填写（占位提示：`AI 模型，如 gpt-4o-mini / deepseek-chat`——此为当时的示例，该模型名现已下线，见 [1.36]）。选任一项会同步清空模型框，避免沿用旧模型导致不匹配。

---

## [1.12] - 2026-10-17

### ✨ 新增 (Added) - 2026-10-17
- **AI 接口「预设接口源」下拉框**：在「答题」设置 → AI 接口答题区，地址输入框上方新增一个 `el-select` 预设源，选一项即可一键填好「地址」与「模型」：
  - `OpenAI (GPT)` → `https://api.openai.com/v1` / `gpt-4o-mini`
  - `DeepSeek (深度求索)` → `https://api.deepseek.com/v1` / `deepseek-chat`（历史记录；地址与模型名已于 [1.36] 更新）
  - `通义千问 (Qwen)` → `https://dashscope.aliyuncs.com/compatible-mode/v1` / `qwen-plus`
  - `豆包 (火山方舟)` → `https://ark.cn-beijing.volces.com/api/v3` / `doubao-seed-1-6-250615`
  - `Kimi (月之暗面)` → `https://api.moonshot.cn/v1` / `moonshot-v1-8k`
  - `小米 MiMo（端点请核实）` → `https://api.miwifi.com/v1` / `mimo`（⚠️ 该端点为社区流传值，如不通请自行核对官方地址后修改）
  - `空白（自定义）` → 清空地址与模型，手动填写自有接口
- **AI 接口「测试连接」按钮**：在自定义要求输入框下方新增「测试连接」按钮。点击后用当前「地址 / 密钥 / 模型」向 `/chat/completions` 发送一条极简 `ping` 请求（`max_tokens:5`），并在按钮右侧实时显示结果：
  - 成功（HTTP 2xx 且返回 `choices`）→ 绿色「连接成功（HTTP xxx）」
  - 失败 → 红色提示，区分「HTTP 非 2xx + 响应片段」「返回异常（非标准 JSON）」「请求出错（地址/网络/跨域）」「请求超时（20s）」「请先填写 API Key / 接口地址」等情形。

---

## [1.11] - 2026-10-16

### 🛠 修复 (Fixed) - 2026-10-16
- **修复首页日志区「往下拉的条拉不动」（滚动失效）**：首页 `首页` 标签页原本用 Element Plus 的 `<el-scrollbar>` 包裹日志列表。由于整个面板挂载在 **closed shadow DOM**（`attachShadow({mode:"closed"})`）内，而 Element Plus 样式只通过 `GM_addStyle` 注入到页面 `document`，**不会穿透 shadow 边界**，导致 `el-scrollbar` 的滚动条/滑块样式缺失、无法拖拽。
  - 改为使用**原生可滚动 `<div class="log">`**（通过内联 `style` 设置 `max-height:230px; overflow-y:auto`，内联样式在 shadow DOM 内始终生效），彻底摆脱对 `el-scrollbar` 样式的依赖，日志现在可正常上下滚动。

### ✨ 新增 (Added) - 2026-10-16
- **首页日志「导出」功能**：在日志区顶部新增工具栏（左侧「运行日志」标题，右侧「导出」按钮）。点击「导出」将当前 `logList` 逐条格式化为 `时间  类型  内容`（自动剔除 HTML 标签），以 UTF-8 文本 Blob 触发浏览器下载为 `chaoxing-log-<时间戳>.txt`。导出逻辑在脚本页面上下文内执行，无需额外 `@grant` 权限。

---

## [1.10] - 2026-10-15

### 🛠 修复 (Fixed) - 2026-10-15
- **修正「最高倍速」被错误地设为 16x 导致播放失败**：超星播放器速度菜单默认上限为 **2x**（个别课程更高），原本按 `[16,8,4,3,2,…]` 由高到低试设会越界，超出播放器允许范围而播放异常。
  - 改为**优先读取播放器速度菜单里可选的最高项**（解析 `.vjs-playback-rate`/`.speedMenu` 等节点中 `Nx` 标签或 `data-rate` 属性，取最大值），默认即 2x，课程若开放更高则自动取更高。
  - 若菜单尚未加载（刚定位到视频时），**退回「不超过 2x」的安全范围** `[2,1.75,1.5,1.25]` 由高到低试设，绝不越界。
  - 定位到视频约 2.5s 后**再次探测菜单**（此时菜单通常已就绪），若发现更高可选项则上调倍速。
  - `ratechange` 重设逻辑改为「仅在播放器把倍速**调低**到低于目标值时，才重新设回目标值」，不再强行反复写 16x，避免与播放器互相打架。
  - 日志由「已设置最高倍速：Nx」改为「已设置倍速：Nx（取播放器可选上限，避免超出导致播放失败）」，语义更准确。

---

## [1.9] - 2026-10-13

### ✨ 新增 (Added) - 2026-10-13
- **视频加速与智能跳播（四项优化，均在 `processMedia` 中处理视频任务时生效）**：
  1. **「任务已完成」不再重复点击播放**：无论是轮询开始时、播放前还是播放后的检查，只要 `isFinishedTask(iframe)` 判定任务点已标记完成（`.ans-job-finished`），立即 `finish()` 跳过并放行下一节，避免无意义的反复点击、浪费时间。
  2. **自动最高倍速**：定位到 `<video>` 后，按 `[16,8,4,3,2,1.75,1.5,1.25]` 由高到低尝试设置 `playbackRate`，取浏览器接受的最高值（通常为 16x）并持续在 `ratechange` 事件上重新声明，对抗播放器强行复原，日志打印 `已设置最高倍速：Nx`。
  3. **支持拖拽时跳到结尾前几秒**：若视频时长可用，将 `currentTime` 设置为 `duration - 5s` 实现「拖到结尾前」以极速过完。约 1.5s 后校验实际跳转结果：成功则提示「已拖拽进度条至结束前约 5s」；若被复位则提示「进度条无法拖动，转为正常高倍速播放」。
  4. **「教师设置无法拖动进度条」提示识别**：拖拽后若页面/任务 iframe 内出现该文本（轮询检测），按用户设定**视为已接近结尾**，不再重试拖拽，转为正常高倍速播放直至 `ended` 自然完成，避免无谓报错与卡顿。
- ⚠️ 说明：第 3/4 项属于「能拖就拖、不能拖就倍速播完」的兼容策略；当教师禁止拖动时，脚本会自动回退到最高倍速正常播放，不会卡死也不会反复报错。

---

## [1.8] - 2026-10-13

### 🔧 优化 (Changed) - 2026-10-13
- **启动日志带上版本号**：`脚本加载成功，正在解析网页（当前版本 vX.X）`，便于一眼确认当前运行的是哪一版，避免「刷新页面以为更新了、其实还是旧版」的误判（问题排查时特别有用）。
- 版本号取自 `GM_info.script.version`，与脚本头 `@version` 保持一致。

---

## [1.7] - 2026-10-13

### 🛠 修复 (Fixed) - 2026-10-13
- **在 v1.6 基础上进一步强化视频定位**（应对「播放器不在任务 iframe 内」的情况）：
  - 新增**整页兜底查找**：若本 iframe（含其所有嵌套 iframe）仍找不到 `<video>/<audio>`，则**在本 iframe 之外、遍历整页所有 iframe** 定位真正带 `src` 的播放器（约 5s 后触发一次），覆盖播放器与任务 iframe 不同层/不同源的情况。
  - 找不到媒体元素时的「放弃等待」时间由约 30s 缩短到**约 12s**（避免长时间卡住），届时打印 `[诊断] 仍未找到 …` 并结束本任务点，保证后续章节仍能切换。
  - `[诊断]` 日志更明确：区分「本 iframe 内找到」与「本 iframe 之外找到」。
- ⚠️ 说明：v1.5 及更早版本在找不到 `<video>` 时会**永久挂起**，导致视频不播放且**不切下一节**；v1.6/v1.7 已修复。请务必**重新导入本脚本**（仅刷新页面不会更新已安装的旧版本）。

---

## [1.6] - 2026-10-13

### 🛠 修复 (Fixed) - 2026-10-13
- **修复「视频不再自动播放」且「看完不自动切下一节」两个问题（同一根因）**：
  - 根因：`processMedia` 只在 `iframe` 的 `documentElement` 直接层 `querySelector("video")` 找播放器。超星当前页面里 `<video>` 常嵌套在更深的 iframe（或播放器另起一层）中，导致 `mediaElement` 一直为 `null`——于是 **播放逻辑从未执行（日志停在「正在尝试播放」、无「播放成功」、无报错）**，并且 `processMedia` 因找不到元素而**永久挂起不 resolve**，导致 `watchIframe` 整批任务无法「完成」，下一节切换（仅在整批完成后触发）也一并失效。
  - 媒体元素查找改为 `findMediaDeep`：**先查当前 iframe 文档，查不到则递归进入嵌套 iframe（深度 ≤ 4）**，覆盖播放器被包一层 iframe 的情况（原有直接查找作为第一优先，无回归风险）。
  - **防挂起**：连续 12 次（约 30s）仍未找到媒体元素则主动结束本任务点，避免卡住后续章节切换。
  - `play()` 失败（如被浏览器自动播放策略 `NotAllowedError` 拒绝）时不再直接判失败，而是**再尝试点击 `.vjs-big-play-button` 等播放按钮**兜底；并新增诊断日志明确提示「若仍被拦截，请先在页面/视频上点一下授权后刷新」。
  - 找到媒体元素时打印其 `src` 便于确认是否定位到正确的播放器。
- **下一节切换更稳**：「自动下一章节」触发时不再只认单一 `.jb_btn…nextChapter` 选择器，改为**依次尝试多种选择器**（`#prevNextFocusNext` / `.jb_btn…nextChapter` / `.nextChapter` 等），并补上「任务未完成」确认弹窗（`.jobFinishTip .nextChapter`）的自动确认，降低因超星改版导致按钮点不到、切不了节的概率。
- 诊断日志前缀统一为 `[诊断]`。

---

## [1.5] - 2026-10-13

### ✨ 新增 (Added) - 2026-10-13
- **脚本自动检查更新能力**：在脚本头部新增 `@downloadURL` / `@updateURL`（均指向 jsDelivr 的 `@main` 分支稳定链接 `https://cdn.jsdelivr.net/gh/Regionnor/xue-xi-tong@main/chaoxing-ai-answer-assistant.user.js`）。
  - 启用后，Tampermonkey / ScriptCat 会在打开超星页面时自动比对版本号，有新版本则提示更新，无需手动重新安装。
  - ⚠️ 自动更新依赖本仓库 `main` 分支保持最新：每次改完脚本请 `git push origin main`，jsDelivr 才会同步到最新内容（jsDelivr 对 GitHub 文件默认有约 12 小时 CDN 缓存，紧急更新可手动在 jsDelivr 链接后加 `?_=时间戳` 或前往 jsDelivr 后台 Purge 刷新）。

---

## [1.4] - 2026-10-13

### 🛠 修复 (Fixed) - 2026-10-13
- **真正修复文档/PPT 自动下滑但页面不移动的问题**：此前 `processPpt` 只 `scrollTo(window)`，而超星 PDF 阅读器内容实际渲染在嵌套的 `mooc-ans/screen/file` iframe（或 #panView）中，window 无溢出故滚动无效。
  - `processPpt` 的滚动改为 `scrollDeep`：**滚动 window / scrollingElement / body + 文档内所有可滚动容器 + 递归进入全部嵌套 iframe**（深度上限 8），确保滑到真正的内容渲染层。
  - 文档识别新增 `screen/file` 来源，避免漏判该渲染层 iframe。
  - 新增诊断日志：`[诊断] 文档滚动：本次尝试滚动 N 个可滚动容器`，便于确认是否真的滚到了内容。

## [1.3] - 2026-10-13

### 🔧 优化 (Changed) - 2026-10-13
- 抑制对**明显非任务 iframe**（章节容器页 `knowledge/cards` / `mycourse/studentstudy`、空 src、`about:blank`、`javascript:`）的「未识别到可处理任务点」告警，避免误导用户以为功能异常；仅在真正无法判定、且非上述已知容器的 iframe 上才保留诊断日志。

### ✅ 验证 (Verified)
- 用户实测日志确认 v1.2 的识别升级已生效：章节内 `ananas/modules/pdf/index.html` 文档被识别为阅读器，触发 `processPpt`（「发现一个文档，正在解析」→「阅读完成」），视频任务也正常播放。

## [1.2] - 2026-10-13

### 🛠 修复 (Fixed) - 2026-10-13
- **继续修复 PPT / 文档任务点不自动下滑阅读的问题**：v1.1 仅按 iframe 来源类型（`modules/xxx`）判定仍不足以命中部分超星页面。
  - 任务点识别升级为**三重兜底**：①来源类型（放宽为 `modules/ppt|doc|pdf|...` 或 `/{type}/index.html`）；②**按 iframe 内部内容识别**（含 `#panView` 阅读器容器或 `embed/object[type*=pdf]` 即视为文档/PPT 阅读器）；③沿祖先链（最多 6 层）查找 `.ans-job-icon`。
  - 当三条都不命中时，日志会**打印该 iframe 的真实 `src` 与 `.ans-job-icon` 有无**，便于精确适配页面结构。
  - 新增顶层诊断日志：每次枚举到新的 iframe 组合时，打印本页实际枚举到的**全部 iframe 地址**（去重），用于判断目标 iframe 是否因 `contentDocument` 为空被丢弃。

## [1.1] - 2026-10-13

### 🛠 修复 (Fixed) - 2026-10-13
- **修复网页上的 PPT / 文档任务点不再自动下滑阅读、且提前报「任务完成」的问题**：
  - 根因：`processIframeBody` 的任务点路由**强依赖**在 `iframe.parentElement` 中查找 `.ans-job-icon` 元素，超星改版后该元素位置/类名变化即导致匹配不到，从而跳过 `processPpt`/`processBook` 的下滑逻辑，最终章节循环结束误报完成。
  - 改为**优先按 iframe 来源类型（`modules/ppt`、`modules/doc`、`modules/pptx`、`modules/docx`、`modules/pdf`、`modules/innerbook` 等）判定**任务点类型并触发对应处理，不再被 `.ans-job-icon` 的 DOM 位置卡住；`.ans-job-icon` 仅作为来源无法识别时的兜底诊断。
  - 补充更清晰的跳过原因日志：明确提示「只答题，不做其他」开关开启会跳过自动阅读，以及来源不匹配且找不到 `.ans-job-icon` 时的诊断信息，便于后续排查。

---

## [1.0] - 2026-10-13

首个改良版本，基于 ScriptCat #711（v0.2.7）重构答题逻辑。

### ✨ 新增 (Added)
- **AI 答题能力**：答题模块对接**任意 OpenAI 兼容 AI 接口**（OpenAI / DeepSeek / 通义千问 / 本地 Ollama 等）。在脚本面板「答题」设置中填写接口地址、API Key、模型即可自动作答。
- 新增 `aiConfig` 配置项（启用开关 / 接口地址 / API Key / 模型 / 温度 / 自定义提示词），随脚本配置自动持久化。
- 支持调用 AI 自动完成**视频弹题、章节测试、作业与考试**作答；解析逻辑兼容单选、多选、判断、填空、简答题型。

### 🗑 移除 (Removed)
- **第三方题库与题库密钥**：不再依赖任何第三方题库接口与 token，仅保留 AI 答题。
- **知到智慧树（zhihuishu）相关代码**：移除 `ZhsQuestionHandler`、`useZhsAnswerLogic`、`hookWebpack`、`hookError`、`XMLHttpRequestInterceptor` 及对应配置 / 分发 / 平台匹配，仅专注**超星学习通**。
- **远程公告 / 版本更新功能**及其相关拉取逻辑。
- 头部过期题库域名 `@connect`（tikuhai / icodef / 62.234.36.191），仅保留 `@connect *` 以支持任意 AI 域名。

### 🔧 变更 (Changed)
- 元信息：`@name` → 学习通AI答题小助手--Region改良款；`@author` → Region；`@namespace` → `https://github.com/Region`；`@version` → `1.0`。
- `@description` 重写，强调 AI 接口兼容性与改良来源。

### 🛠 修复 (Fixed) - 2026-10-13
- 修复章节任务点处理时读取 `contentWindow` 报 `TypeError: Cannot read properties of null` 导致整批任务「任务处理失败」的问题：
  - `IframeUtils.getIframes` / `getAllNestedIframes`：元素、iframe、`documentElement` 空值判空，`contentDocument` 读取加 try/catch。
  - `processIframe`：iframe 为空或已从文档分离时直接跳过，`src` 读取容错。
  - `processPpt` / `processBook`：`iframeWindow` 与页面函数（`onchangepage` / `getFrameAttr`）判空并 try/catch。
  - `processMedia`：入参判空，`documentElement` 查询容错。
- 单个 iframe 任务点处理异常不再中断整批任务：改为记录警告日志后继续处理下一个任务点。

### 🌐 兼容性 (Compatibility)
- `@match` 覆盖超星学习通相关域名：`*.chaoxing.com`、`*.nbdlib.cn`、`*.hnsyu.net`、`*.gdhkmooc.com`（`*.edu.cn` 已于 [1.37] 移除）。
- 适用环境：Tampermonkey / ScriptCat 等支持 `@require`、`@connect` 的 userscript 管理器。

---

## 使用提示
1. 在 userscript 管理器（Tampermonkey / ScriptCat）中安装本脚本。
2. 进入超星学习通对应页面，打开脚本面板「答题」页。
3. **勾选启用 AI 接口答题**，并填写你的 AI 接口地址与 API Key。
4. 进入视频、章节测试、作业或考试页面即可自动调用 AI 作答。

> ⚠️ 本脚本仅用于学习辅助，请遵守所在平台的使用条款与学校/机构的考试纪律要求。
