超星学习通智能阅读增强工具 📚，支持逐段 / 整页双模式自动阅读 ⏩，结合实时监听与定时检查实现 URL 变化精准检测 🔍，自动识别并跳转下一章节 ➡️，提供全键盘控制（K 开始 / Z 暂停 / S 设置 / R 跳转）⌨️ 及个性化配置中心 ⚙️，适配超星全平台课程页面，提升阅读效率与学习体验 ✨
# ✨ 超星学习通智能阅读助手 | 自动阅读增强版 ✨
#✨ 智能自动阅读（逐段/整页）| URL实时检测 | 章节自动跳转 | 全键盘控制 | 个性化配置中心 ✨
### 访客人数：
## 🚀 核心功能
### 1. 双模式自动阅读
- **逐段阅读（段落模式）**：智能识别文档段落（p、h1-h6等标签），自动滚动至中心并高亮，支持图片/视频等元素延长停留时间
- **整页阅读（页面模式）**：按自定义速度平滑滚动整页内容，自动计算总高度并匀速推进，适配长文档阅读
### 2. 智能URL与章节管理
- **双引擎URL检测**：实时监听（hashchange/popstate事件）+定时检查（可自定义间隔），精准捕捉章节切换
- **自动章节跳转**：读完当前章节后自动识别“下一章”按钮（支持10+种常见选择器），点击失败时触发重试机制
- **循环阅读模式**：支持读完最后一章自动跳转至第一章，适合课程内容反复学习
### 3. 深度个性化配置
- **阅读参数自定义**：滚动速度（0.1-30秒/单位）、模式切换、自动启动开关、调试模式等
- **界面控制选项**：悬浮提示开关、弹窗显示时长、下一章按钮检测深度（iframe嵌套支持）
- **操作习惯适配**：快捷键自定义、自动跳转开关、URL变化防抖时间调节
### 4. 全场景交互支持
- **键盘快捷键**：K（开始/继续）、Z（暂停）、S（打开设置）、R（切换自动跳转）
- **右键菜单集成**：浏览器右键直接调用“开始自动阅读”“显示设置”功能
- **状态实时反馈**：操作通知（成功/警告/错误）、阅读进度弹窗（当前章节/总章节）
## 📌 使用指南
### 1. 快速操作入口
- **悬浮提示框**：页面右下角显示快捷键说明（可在设置中隐藏），包含当前模式与操作指引
- **右键菜单**：浏览器右键选择「超星学习通智能阅读助手」，直接触发核心功能
- **键盘控制**：在阅读页面（含章节内容页）直接按快捷键操作，无需打开菜单
### 2. 高级设置说明
1. **参数调整路径**：
`右键菜单 → ⚙️ 显示设置` → 图形化界面调节以下参数：
- 阅读基础：速度、模式、自动开始/循环阅读
- 检测配置：URL检查间隔、iframe深度、下一章按钮选择器
- 交互控制：提示显示、调试模式、自动跳转开关
2. **章节跳转配置**：
- 自动跳转触发：在「设置→自动跳转」中开启后，脚本会自动检测“去阅读”“开始阅读”等按钮并点击
- 章节识别优化：若检测章节失败，可在设置中修改“下一章按钮选择器”（默认#right1）
## ⚠️ 注意事项
### 1. 兼容性说明
- **支持域名范围**：*.chaoxing.com、mooc1-*.chaoxing.com（其他超星子域名可能需要手动添加匹配）
- **iframe限制**：部分课程内容嵌套在iframe中时，需在设置中提高“maxIframeDepth”（建议5-10）
- **按钮识别问题**：若“下一章”按钮无文本（仅图标），需手动配置其CSS选择器至“nextButtonSelector”
### 2. 性能优化建议
- **低配置设备**：关闭“调试模式”（减少日志输出）、提高URL检查间隔（建议1000ms以上）
- **视频/图片密集页**：切换至“整页模式”并排除媒体元素（设置中添加选择器），减少滚动卡顿
- **多标签页使用**：同时打开多个课程页面时，建议关闭“自动启动”，避免资源竞争
## 🛠️ 技术架构
### 核心依赖
- **油猴API集成**：GM_registerMenuCommand（菜单）、GM_notification（通知）、GM_xmlhttpRequest（数据存储）
- **DOM操作引擎**：MutationObserver（实时监听DOM变化）、waitForElement（元素加载等待）
- **事件处理机制**：防抖（URL变化）、节流（滚动触发）、Promise链式调用（异步操作）
### 存储方案
- 配置数据：通过GM_getValue/GM_setValue持久化保存用户设置（速度、模式、开关状态等）
- 状态管理：内存实时维护阅读状态（运行/暂停、当前章节索引、内容元素列表）
## 📦 更新日志
### v1.0.0
- 基础功能上线：双模式自动阅读、URL智能检测、章节自动跳转、全键盘控制
- 交互优化：操作通知分级（info/success/warning/error）、设置界面图形化、快捷键提示悬浮框
- 兼容性支持：10+种下一章按钮选择器、iframe嵌套检测（最大深度10层）、多域名匹配（超星主域及mooc子域）
