Add persistent full-course mute option

2026-10-10 17:00:50 +08:00
parent 8023a802f1
commit 281ab20018
7 changed files with 161 additions and 25 deletions
@@ -1,6 +1,6 @@
 # 学员中心 · 2倍速学习助手使用说明

-适用版本：**1.4.0**。浏览器设置核对日期：**2026-10-06**。
+适用版本：**1.4.1**。浏览器设置核对日期：**2026-10-06**。

 [仓库首页](README.md) · [脚本文件](icampus-study-helper.user.js) · [更新记录](CHANGELOG.md)

@@ -37,9 +37,9 @@ Chrome不能在无痕窗口内安装扩展，应先普通窗口安装再允许
 2. 点击文件页面的“下载”，或打开“原始文件 / Raw”后保存。文件应名为 `icampus-study-helper.user.js`，不能是仓库HTML网页或误存的 `.txt`。下载整个仓库压缩包的用户先解压。
 3. 点击篡改猴图标 →“管理面板 / Dashboard”→“实用工具 / Utilities”。
 4. 找到“从文件导入 / Import from file”文件选择按钮，选中该 `.user.js`。
-5. 在安装／导入页面核对名称“学员中心 · 2倍速学习助手”和版本 **1.4.0**，按提示确认安装或更新。仅选择文件不等于安装完成。
+5. 在安装／导入页面核对名称“学员中心 · 2倍速学习助手”和版本 **1.4.1**，按提示确认安装或更新。仅选择文件不等于安装完成。
 6. 回到“已安装脚本”，确认开关开启。
-7. 刷新课程页，确认左下角版本为 **1.4.0**。
+7. 刷新课程页，确认左下角版本为 **1.4.1**。

 篡改猴导入入口见 [官方导入导出说明](https://www.tampermonkey.net/faq.php?locale=zh&q=Q106)。界面文字可能因版本不同而变化；若该入口不接受 `.user.js`，直接用下一节复制方式，无需将脚本改成JSON。

@@ -63,7 +63,7 @@ Chrome不能在无痕窗口内安装扩展，应先普通窗口安装再允许
 1. 停用旧诊断脚本、倍速实验脚本和重复助手。
 2. 登录网站，打开“我的课程”，展开要学习的分组，清除不需要的筛选，确认目标课程已显示。
 3. 选择“按列表顺序继续课程”，或进入具体课程选择“仅当前课程”。
-4. 默认保留自动测验、后台播放和受限时尝试静音三个勾选，点击“开始”。
+4. 默认保留自动测验、后台播放和受限时尝试静音三个勾选；需要全程无声音时，再勾选“全过程静音”，点击“开始”。
 5. 需要停止时点击“人工取消”，之后刷新不会自动开始。

 | 控件／状态 | 含义 |
@@ -73,6 +73,7 @@ Chrome不能在无痕窗口内安装扩展，应先普通窗口安装再允许
 | 只做本门测验 | 先进入课程再点击，只处理该课程测验 |
 | 自动测验，按平台合格线通过 | 自动答题、交卷和未合格重试；关闭后未合格测验需手动处理 |
 | 切标签页继续播放 | 运行期间保留网站正常后台播放与保存流程 |
+| 全过程静音 | 默认关闭；勾选后立即静音课程播放器，切换视频／课程、后台和刷新后继续保持 |
 | 播放受限时尝试静音 | 有声自动播放被拒绝时尝试一次静音；成功后面板显示“静音” |
 | 已启动 · 等待恢复 | 仍启用，查看提示；普通等待会定期检查或随页面变化接续 |
 | 人工取消 | 关闭自动运行并暂停助手控制的视频 |
@@ -80,6 +81,14 @@ Chrome不能在无痕窗口内安装扩展，应先普通窗口安装再允许

 更换运行范围或“只做本门测验”前，先人工取消。启动状态保存在当前标签页会话中，同一页普通刷新和自动恢复刷新都可接续。新标签页、浏览器重启、结束无痕会话不保证保留。手动暂停视频时，助手等待手动播放，不抢占暂停操作。

+### 全过程静音
+
+勾选 **“全过程静音”** 后，当前课程播放器立即静音，不用等待点击开始；每次启动、加载新视频或更换课程播放器都会应用静音，网页或用户在播放器中取消静音时也会重新静音。播放位置、音量滑块和播放速度不因该开关改变。
+
+开关开启期间，等待、后台和人工取消后仍保持静音。要恢复声音，应先取消勾选“全过程静音”；播放器将恢复开启前的静音状态，原本已静音的播放器不会被强行打开声音。必要时再用播放器声音按钮取消静音。
+
+偏好保存在课程站点本地存储，刷新后自动恢复；普通和无痕环境分别保存，无痕会话结束后可能丢失。该开关控制课程播放器，不影响其他网站或系统声音。“播放受限时尝试静音”仍是独立的自动播放恢复选项：无论该选项是否开启，全过程静音开启时都会保持静音。
+
 ## 5. 完成条件与检查范围

 换课条件为 **学习进度完成，且需要测验的课程已由平台判定合格**。有明确学习进度时检查100%；没有该字段才参考平台课程完成标记。合格线由平台判断，脚本不根据分数猜测或写死阈值。
@@ -158,7 +167,7 @@ Chrome经常回收课程页时，可在“设置 → 性能 → 始终保持活

 | 保存位置 | 内容 |
 | --- | --- |
-| 网站本地存储 | 答案记忆、最近提交快照、后台和静音回退偏好、标签页运行锁 |
+| 网站本地存储 | 答案记忆、最近提交快照、后台、全过程静音和静音回退偏好、标签页运行锁 |
 | 当前标签页会话存储 | 启用状态、运行范围和刷新恢复记录 |
 | 当前页内存 | 运行记录、已读取课程列表和时长样本 |

@@ -183,14 +192,14 @@ Chrome经常回收课程页时，可在“设置 → 性能 → 始终保持活
 | 另一个学习页运行 | 在另一个页面人工取消或关闭，等待运行锁释放 |
 | 课程重名 | 手动进入目标课程，选仅当前课程 |
 | 登录、前置限制、无保存确认 | 按平台提示处理后刷新，同一标签页可接续 |
-| 视频没有声音 | 查看是否标记静音，可在播放器恢复声音或关闭静音回退选项 |
+| 视频没有声音 | 如勾选了全过程静音，先关闭该开关；再检查播放器原有静音状态或受限播放的静音回退 |

 反馈时展开“运行记录”并点“更新记录”，提供脚本版本、普通／无痕模式、运行范围、面板文字和必要记录，不要附凭据或完整敏感抓包。

 ## 12. 验证与恢复边界

-81项本地行为测试：16播放／进度、13测验、13媒体恢复、12后台、10持续运行／完成条件、17统计／自动播放回退。覆盖低于100分但已合格换课、刷新接续、缺失时长、暂停预测、静音成功和仍被拒绝等情况。
+91项本地行为测试：16播放／进度、13测验、13媒体恢复、12后台、10持续运行／完成条件、17统计／自动播放回退、10全过程静音。覆盖低于100分但已合格换课、刷新接续、缺失时长、暂停预测、静音成功和仍被拒绝，以及静音开关、播放器更换、声音重置、后台与原始状态恢复等情况。

-现场已观察到网页原生2倍速、平台保存响应，以及本次点击播放后恢复。新版整体统计、估算和静音回退经过模拟测试，尚未完成所有真实课程和长时间后台端到端验证，不能保证最终学分或全部课程结构兼容。
+现场此前已观察到网页原生2倍速、平台保存响应及点击播放后恢复。全过程静音经过本地模拟测试，尚未在真实课程上验证。整体统计、估算和静音回退也尚未完成所有真实课程和长时间后台端到端验证，不能保证最终学分或全部课程结构兼容。

 前台视频加载90秒未就绪、启动20秒未推进或播放停滞60秒时，会尝试一次刷新恢复，每段视频在一次运行内共享该额度。临时播放中断有界重试；播放权限拒绝不进入刷新循环。前台视频结束25秒仍无平台完成确认会等待，后台窗口更长。这些恢复不会伪造完成状态。