HNU智慧党校培训平台网络安全测试脚本

1. 脚本简介

这是一个用于HNU智慧党校培训平台的网络安全测试脚本，主要用于自动播放视频、跟踪学习进度并确保所有视频都能完成100%观看。

1.1 适用范围

• 适用网站：HNU智慧党校培训平台 (https://szdx.hainanu.edu.cn/videodetails/*)
• 适用场景：网络安全测试、自动学习、进度跟踪

1.2 技术栈

• 脚本类型：Tampermonkey 用户脚本
• 开发语言：JavaScript
• 兼容浏览器：Chrome、Firefox、Edge 等支持 Tampermonkey 的浏览器

2. 功能特性

2.1 核心功能

• 自动播放视频：检测并恢复视频播放，自动静音
• 视频进度跟踪：与网站原生20秒保存机制兼容，定期记录进度
• 自动视频切换：按视频序号升序查找并切换到下一个未完成的视频
• 弹窗自动处理：自动关闭各种弹窗，包括网络不稳定弹窗
• 焦点保护：防止页面失去焦点时暂停视频
• 网络状态监听：网络中断恢复后自动继续播放
• 视频加载失败重试：自动处理视频加载失败的情况

2.2 辅助功能

• 脚本状态监控：记录脚本运行状态和错误信息
• 监控面板：实时显示脚本运行状态和视频进度
• 详细日志记录：便于调试和监控脚本运行情况
• 状态锁机制：确保同一时间只能执行一次视频切换
• 冷却机制：视频切换后冷却10秒，避免频繁切换

3. 安装步骤

3.1 安装 Tampermonkey 扩展

1. 打开浏览器的扩展商店
2. 搜索 "Tampermonkey" 并安装
3. 安装完成后，浏览器右上角会出现 Tampermonkey 图标

3.2 安装脚本

1. 点击 Tampermonkey 图标，选择 "添加新脚本"
2. 复制脚本的完整代码，粘贴到编辑器中
3. 点击 "文件" -> "保存" 或使用快捷键 Ctrl+S 保存脚本
4. 脚本会自动启用，在智慧党校培训平台的视频页面自动运行

4. 使用方法

4.1 基本使用

1. 打开智慧党校培训平台的视频页面 (https://szdx.hainanu.edu.cn/videodetails/*)
2. 脚本会自动运行，无需手动操作
3. 脚本会自动播放视频、跟踪进度、切换视频
4. 监控面板会显示脚本运行状态和视频进度

4.2 监控面板

• 位置：默认显示在页面左上角
• 功能：显示视频进度、脚本状态、错误信息
• 操作：
  • 点击 "-" 按钮可以收起面板
  • 点击收起后的面板可以展开
  • 拖动标题栏可以移动面板位置

4.3 日志查看

• 打开浏览器控制台 (F12 -> Console)
• 可以查看脚本的详细日志信息
• 日志包含视频播放、进度跟踪、视频切换等信息

5. 配置选项

5.1 脚本状态对象

脚本使用 scriptStatus 对象管理运行状态，包含以下属性：

• videoLoaded：视频元素是否已加载
• autoMute：是否已自动静音
• autoResume：是否已自动恢复播放
• popupHandling：弹窗处理状态
• videoSwitching：视频切换状态
• focusProtection：焦点保护状态
• isSwitching：视频切换锁状态
• errors：错误记录数组
• panelCollapsed：监控面板折叠状态
• currentVideoProgress：当前视频进度
• lastProgressCheck：最后进度检查时间

5.2 自定义配置

可以通过修改脚本代码中的配置项来自定义脚本行为：

• 修改 closePopupsEnabled 可以禁用弹窗处理
• 修改冷却时间可以调整视频切换频率
• 修改检查频率可以调整进度监控的频率

6. 工作原理

6.1 视频播放流程

1. 脚本加载后，创建监控面板
2. 等待视频元素加载完成
3. 自动静音并恢复视频播放
4. 启动视频进度监控
5. 定期检查视频进度，当视频完成时切换到下一个未完成的视频
6. 自动处理各种弹窗
7. 监控网络状态，网络恢复后继续播放

6.2 视频切换逻辑

1. 按视频序号升序查找所有未完成的视频
2. 找到第一个未完成的视频后，模拟点击切换
3. 切换后冷却10秒，避免频繁切换
4. 使用状态锁确保同一时间只能执行一次视频切换

6.3 弹窗处理逻辑

1. 定期检查页面是否存在弹窗
2. 优先处理网络不稳定弹窗
3. 尝试点击弹窗内的按钮关闭弹窗
4. 无法关闭时提示用户手动处理

7. 注意事项

7.1 使用规范

• 本脚本仅用于网络安全测试，请勿用于非法用途
• 请遵守网站的使用条款和相关法律法规
• 合理使用脚本，避免给网站服务器造成过大压力

7.2 性能优化

• 脚本采用了防抖和节流技术，减少了DOM操作
• 定期清理错误日志，保持脚本的高效运行
• 合理设置检查频率，避免过度消耗资源

7.3 稳定性保障

• 采用了状态锁机制，确保同一时间只能执行一次视频切换
• 增加了冷却时间，避免频繁切换视频
• 完善了错误处理，确保在各种情况下都能正常运行

8. 常见问题

8.1 脚本不运行

• 检查 Tampermonkey 是否已启用
• 检查脚本是否已启用
• 检查当前页面URL是否匹配脚本的匹配规则

8.2 视频无法自动播放

• 检查浏览器是否允许自动播放
• 检查视频元素是否已正确加载
• 查看控制台日志，了解具体错误信息

8.3 弹窗无法自动关闭

• 检查弹窗类型是否为脚本支持的类型
• 查看控制台日志，了解具体错误信息
• 尝试手动关闭弹窗，观察弹窗的结构和按钮

8.4 视频切换异常

• 检查视频列表的结构是否发生变化
• 查看控制台日志，了解具体错误信息
• 尝试刷新页面，重新加载脚本

9. 技术支持

9.1 问题反馈

• 反馈渠道：通过脚本的发布社区反馈
• 反馈内容：问题描述、浏览器版本、脚本版本、控制台日志

9.2 代码结构

• 脚本采用了模块化的设计，便于维护和扩展
• 核心功能模块清晰，便于理解和修改
• 详细的日志记录，便于调试和监控

9.3 扩展建议

• 根据网站的变化，及时更新脚本的选择器和逻辑
• 增加更多的配置选项，允许用户自定义脚本行为
• 优化性能，减少资源消耗
• 增强兼容性，支持更多的网站和场景

10. 版本历史

10.1 最新版本

• 版本号：1.0.0
• 发布日期：2025-11-26
• 主要更新：
  • 修复了网络不稳定弹窗处理逻辑
  • 优化了视频切换冷却机制
  • 增强了脚本的稳定性和可靠性
  • 完善了错误处理和日志记录

10.2 历史版本

• 版本 0.9.0：初始版本，实现了基本功能
• 版本 0.9.5：优化了视频切换逻辑
• 版本 0.9.8：修复了弹窗处理问题
• 版本 1.0.0：正式发布，完善了各项功能

11. 许可证

本脚本采用 MIT 许可证，允许自由使用、修改和分发。

12. 免责声明

• 本脚本仅用于网络安全测试，请勿用于非法用途
• 使用本脚本产生的一切后果由使用者自行承担
• 脚本作者不对脚本的使用后果负责
• 请遵守相关法律法规，合理使用脚本

---

注：本脚本为网络安全测试工具，使用时请遵守相关法律法规和网站的使用条款。