Python自动化实战：Selenium与Requests结合实现雨课堂学习辅助工具

简介：本资源是一款面向高校学生与教育技术开发者的毕业设计级Python工具，旨在辅助雨课堂（RainClassroom）在线学习场景中的自动化操作与信息管理。针对课程签到监控、课件下载、通知提醒等高频需求，提供轻量级桌面端解决方案，适合具备基础Python编程能力的学习者二次开发或教学实践参考。压缩包共12个文件，含7个核心Python模块（涵盖UI界面、后台监控、工具函数、配置管理等）、1个依赖说明文件（requirements.txt）、1个README文档、1张界面示意图（jpg）及图标资源（ico），整体仅111KB，结构紧凑、开箱即用。目前已有69人学习下载，资源包含完整可运行的主程序入口（RainClassroomAssistant.py）、模块化类封装（Classes.py）、实时行为监听逻辑（Monitor.py）以及清晰的启动流程（Login.py → MainWindow.py），便于理解在线教育平台交互机制与桌面应用开发范式。

1. 项目概述与核心价值

最近在整理项目仓库，翻出来一个几年前写的“雨课堂在线学习辅助工具”，用Python写的，打包成了zip。当时写这个工具，纯粹是为了解决自己作为学生时遇到的一些痛点：雨课堂的课程回放没有倍速播放、签到提醒不及时、课件批量下载麻烦等等。这个工具本质上是一个本地运行的脚本集合，通过模拟浏览器操作和调用雨课堂的网页接口，实现了一些自动化功能，比如自动签到、课件抓取、视频倍速播放辅助等。它不是外挂，不修改服务器数据，也不涉及任何破解或付费内容绕过，只是将一些手动操作自动化，提升学习效率。如果你也经常使用雨课堂进行在线学习，并且对Python自动化有点兴趣，那么这个工具的思路和实现细节或许能给你带来一些启发。接下来，我会把这个项目的核心设计、技术实现、踩过的坑以及一些实用的扩展思路，毫无保留地分享出来。

2. 工具整体设计与技术选型

2.1 核心需求与功能拆解

当初设计这个工具，主要瞄准了雨课堂网页版使用中的几个高频且繁琐的操作：

1. 自动签到与状态监控：有些课程是定时签到，手动操作容易错过。工具需要能定时检测页面上的签到按钮，并在出现时自动点击。
2. 课件与资料批量下载：老师发布的PPT、PDF、Word等资料，一个一个点开再下载非常耗时。需要能一键遍历课程章节，批量下载所有附件。
3. 视频播放辅助：雨课堂早期的网页播放器不支持倍速播放（或倍速选项隐藏），对于复习需要快速浏览的同学很不友好。工具需要能干预播放器，实现自定义播放速率。
4. 课程动态提醒：新发布的公告、作业、预习材料，希望能在第一时间得到通知，而不是被动地刷新页面。

基于这些需求，工具被设计成几个相对独立的模块，通过一个主控脚本来调度。这样做的好处是结构清晰，每个模块功能单一，也方便后期维护和扩展。

2.2 技术栈与工具选型解析

为什么选择Python？因为对于这类需要与网页交互、处理HTTP请求、解析数据的任务，Python的生态库实在是太强大了，开发效率极高。

• 核心库：Selenium + WebDriver

  • 为什么是Selenium？雨课堂的很多交互（如点击签到、翻页）以及部分动态加载的内容，单纯靠HTTP请求模拟比较困难，特别是涉及到复杂的JavaScript渲染和用户行为验证时。Selenium可以驱动一个真实的浏览器（如Chrome），完全模拟人的操作，绕过前端的一些检测逻辑，是最稳妥的方案。
  • 选型考量：对比过requests+BeautifulSoup的纯爬虫方案，但对于需要保持登录状态、执行点击操作的场景，Selenium更省心。虽然速度慢一些，但稳定性和成功率是首要的。
  • 注意事项：使用Selenium需要下载对应浏览器的WebDriver（如ChromeDriver），并确保其版本与本地浏览器版本匹配，这是第一个容易踩坑的地方。

• 辅助库：Requests & BeautifulSoup4

  • 分工明确：对于静态页面的内容抓取，比如课程列表、课件链接，直接使用requests发起HTTP请求，然后用BeautifulSoup4解析HTML，速度远快于Selenium。我们将两者结合：Selenium负责登录和打开复杂页面，获取到页面源码后，再用BeautifulSoup4进行高效解析和链接提取。
  • 性能优化：在批量下载课件时，这种“混合模式”能显著减少工具运行时间。

• 其他实用库：

  • schedule/APScheduler: 用于实现定时任务，比如定时检查签到。
  • pyautogui: 作为Selenium的补充，在极少数Selenium无法直接操控浏览器播放器控件时，可以用它来模拟键盘快捷键（如K键暂停/播放，J/L键减速/加速）。
  • configparser: 用于管理配置文件，存放账号、密码、课程ID、定时规则等，避免硬编码。
  • logging: 完善的日志记录，方便追踪工具运行状态和排查问题。

注意：任何自动化工具的使用都必须遵守平台的服务条款。本工具的设计初衷是辅助个人学习，提升效率，严禁用于刷课、挂机、干扰平台正常运行或其他任何不当用途。请合理使用。

3. 核心模块实现细节与实操

3.1 环境准备与依赖安装

工欲善其事，必先利其器。第一步是搭建一个干净的Python环境并安装所有依赖。我强烈建议使用virtualenv或conda创建虚拟环境，避免包版本冲突。

# 1. 创建并激活虚拟环境 (以virtualenv为例) python -m venv yuketang_helper_env # Windows: yuketang_helper_env\Scripts\activate # Linux/Mac: source yuketang_helper_env/bin/activate # 2. 安装核心依赖 pip install selenium beautifulsoup4 requests pip install schedule # 轻量级定时库 pip install pyautogui # 可选，用于高级播放控制 pip install configparser # 通常Python标准库已有，确保一下 # 3. 下载WebDriver # 访问 https://chromedriver.chromium.org/ 下载与你的Chrome浏览器版本匹配的ChromeDriver。 # 将下载的 chromedriver.exe (Windows) 或 chromedriver (Mac/Linux) 放在项目目录下，或将其路径添加到系统环境变量中。

实操心得：ChromeDriver版本一定要匹配！最好让工具在启动时自动检查本地Chrome版本并提示下载对应的Driver，可以极大提升用户体验。我们可以写一个小函数来实现这个功能。

3.2 登录状态维持与会话管理

雨课堂采用常见的Cookie/Session机制维持登录状态。我们的目标是获取一次有效的登录状态，并在后续所有请求中复用。

方案一：Selenium模拟登录（推荐用于首次获取Cookie）这是最通用的方法，可以处理图形验证码（虽然雨课堂一般没有）。

from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC import time import json def login_with_selenium(username, password): driver = webdriver.Chrome(executable_path='./chromedriver') # 指定driver路径 driver.get("https://www.yuketang.cn/") # 雨课堂登录页 try: # 等待并点击“登录”按钮，跳转到登录框 login_button = WebDriverWait(driver, 10).until( EC.element_to_be_clickable((By.CLASS_NAME, "login-button-class")) # 需替换为实际类名 ) login_button.click() # 切换到账号密码登录标签（如果需要） # ... # 输入账号密码 user_input = driver.find_element(By.NAME, "account") # 需替换为实际元素选择器 pwd_input = driver.find_element(By.NAME, "password") user_input.send_keys(username) pwd_input.send_keys(password) # 点击登录按钮 submit_btn = driver.find_element(By.CLASS_NAME, "submit-btn-class") # 需替换 submit_btn.click() # 等待登录成功，通常页面会跳转或出现用户头像 WebDriverWait(driver, 15).until( EC.presence_of_element_located((By.CLASS_NAME, "user-avatar-class")) # 需替换 ) print("登录成功！") # **关键步骤：获取Cookies并保存** cookies = driver.get_cookies() with open('yuketang_cookies.json', 'w') as f: json.dump(cookies, f) print("Cookies已保存。") # 保留driver用于后续操作，或者关闭 # driver.quit() # 如果后续用requests，可以先关闭 return driver, cookies except Exception as e: print(f"登录过程出错: {e}") driver.quit() return None, None

方案二：使用保存的Cookie驱动Requests会话一旦通过Selenium登录并保存了Cookie，后续操作可以优先使用更快的requests库。

import requests from bs4 import BeautifulSoup import json def create_session_from_cookies(cookie_file='yuketang_cookies.json'): session = requests.Session() headers = { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36' } session.headers.update(headers) try: with open(cookie_file, 'r') as f: cookies_list = json.load(f) # 将cookie字典转换为requests可用的格式 for cookie in cookies_list: # 注意：requests的cookies需要name和value，domain有时可选 session.cookies.set(cookie['name'], cookie['value'], domain=cookie.get('domain', '')) print("Session已从Cookie文件创建。") # 验证会话是否有效 test_rsp = session.get("https://www.yuketang.cn/web") if "个人中心" in test_rsp.text: # 简单验证 print("会话验证成功！") return session else: print("会话可能已失效，需要重新登录。") return None except FileNotFoundError: print("未找到Cookie文件，请先运行Selenium登录。") return None

为什么这样设计？“Selenium登录获取Cookie，Requests复用进行高效操作”是经典模式。Selenium解决登录这个复杂交互问题，Requests解决大量数据请求的效率问题。记得定期检查Cookie有效性，并设计重新登录的流程。

3.3 课件批量下载器实现

这是工具中最实用的功能之一。核心思路是：进入课程主页 -> 解析章节列表 -> 遍历每个章节页面 -> 提取所有课件链接（如.ppt, .pdf, .docx等） -> 使用requests会话下载。

def download_course_materials(session, course_url, save_dir="./materials"): """ 批量下载指定课程的所有课件 :param session: 已登录的requests.Session对象 :param course_url: 课程主页URL :param save_dir: 课件保存目录 """ import os from urllib.parse import urljoin os.makedirs(save_dir, exist_ok=True) # 1. 获取课程主页，解析章节 course_page = session.get(course_url) soup = BeautifulSoup(course_page.content, 'html.parser') # 假设章节链接在特定的class或结构里，这里需要根据实际页面调整 # 例如：每个章节在一个 <a class="chapter-link" href="..."> 里 chapter_links = [] for link in soup.select('a.chapter-link'): # 这是一个示例选择器，必须替换！ href = link.get('href') if href: full_url = urljoin(course_url, href) chapter_links.append((link.text.strip(), full_url)) print(f"找到 {len(chapter_links)} 个章节。") # 2. 遍历每个章节页面，查找课件链接 all_material_links = [] for chapter_name, chapter_url in chapter_links: print(f"正在扫描章节: {chapter_name}") try: chap_page = session.get(chapter_url) chap_soup = BeautifulSoup(chap_page.content, 'html.parser') # 查找课件链接，可能是直接的文件链接，或者是一个资源页面的链接 # 示例：寻找所有包含特定后缀的链接 for a_tag in chap_soup.find_all('a', href=True): href = a_tag['href'] text = a_tag.text.strip() # 简单过滤：链接指向常见文档格式 if any(href.lower().endswith(ext) for ext in ['.pdf', '.ppt', '.pptx', '.doc', '.docx', '.xls', '.xlsx', '.zip', '.rar']): full_material_url = urljoin(chapter_url, href) file_name = f"{chapter_name}_{text or os.path.basename(href)}" all_material_links.append((file_name, full_material_url)) print(f" 发现课件: {file_name}") except Exception as e: print(f" 处理章节 {chapter_name} 时出错: {e}") continue # 3. 下载所有课件 print(f"\n开始下载 {len(all_material_links)} 个课件...") for idx, (file_name, file_url) in enumerate(all_material_links, 1): try: # 清理文件名中的非法字符 safe_name = "".join(c for c in file_name if c.isalnum() or c in (' ', '-', '_', '.')).rstrip() save_path = os.path.join(save_dir, safe_name) # 流式下载大文件 r = session.get(file_url, stream=True) if r.status_code == 200: with open(save_path, 'wb') as f: for chunk in r.iter_content(chunk_size=8192): f.write(chunk) print(f" [{idx}/{len(all_material_links)}] 下载成功: {safe_name}") else: print(f" [{idx}/{len(all_material_links)}] 下载失败，HTTP状态码: {r.status_code}, URL: {file_url}") except Exception as e: print(f" [{idx}/{len(all_material_links)}] 下载 {file_name} 时发生异常: {e}")

关键点与避坑指南：

1. 选择器动态性：网页结构可能更新，a.chapter-link这样的选择器需要你使用浏览器的开发者工具（F12）实际查看雨课堂页面的HTML结构后替换。这是最需要适配和调试的部分。
2. 链接补全：一定要使用urljoin来正确处理相对路径和绝对路径，拼凑出完整的URL。
3. 异常处理：网络请求可能失败，文件可能已存在，必须用try...except包裹，保证一个文件下载失败不影响后续任务。
4. 文件名处理：从网页提取的文件名可能包含非法字符（如/:*?"<>|），需要清洗，否则保存文件时会出错。
5. 速率限制：在循环中快速发起大量请求可能触发服务器的反爬机制。建议在请求间添加随机延时（如time.sleep(random.uniform(1, 3))）。

3.4 自动签到与状态监控

自动签到的逻辑相对直接：定期打开课程页面或特定签到页面，检查是否存在签到按钮（如“签到”、“手势签到”等），如果存在则模拟点击。

方案：Selenium定时检测因为签到通常涉及动态加载的JavaScript元素，用Selenium最可靠。

import schedule import time from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC def check_in_task(driver, course_page_url): """执行一次签到检查任务""" try: driver.get(course_page_url) # 等待页面加载 time.sleep(3) # 尝试寻找签到按钮，选择器需要根据实际页面确定 # 可能是一个按钮，也可能是一个链接 sign_button_selectors = [ "button.sign-in-btn", # 示例 "a.sign-link", "div.sign-panel button", # 手势签到确认按钮 # ... 可以定义多个选择器尝试 ] for selector in sign_button_selectors: try: # 使用显式等待，提高效率 sign_btn = WebDriverWait(driver, 5).until( EC.element_to_be_clickable((By.CSS_SELECTOR, selector)) ) print(f"发现签到按钮，选择器: {selector}") sign_btn.click() print("签到点击成功！") # 可能需要处理签到后的弹窗或确认 time.sleep(2) # 例如，如果有确认弹窗 confirm_btn = driver.find_elements(By.CSS_SELECTOR, "button.confirm-btn") if confirm_btn: confirm_btn[0].click() print("已确认签到。") return True # 签到成功 except Exception: continue # 这个选择器没找到，尝试下一个 print("本次检查未发现可用的签到按钮。") return False except Exception as e: print(f"签到检查过程中发生错误: {e}") return False def run_scheduler(driver, course_url, check_interval_minutes=2): """启动定时任务调度器""" # 每X分钟检查一次 schedule.every(check_interval_minutes).minutes.do(check_in_task, driver, course_url) print(f"签到监控已启动，每{check_interval_minutes}分钟检查一次。") while True: schedule.run_pending() time.sleep(30) # 每30秒检查一次是否有任务到期，避免长时间阻塞 # 在主程序中调用 if __name__ == "__main__": driver = webdriver.Chrome() # ... 这里需要先登录，并导航到课程页面 login_driver, _ = login_with_selenium('your_user', 'your_pwd') if login_driver: # 假设我们已经知道课程页面的URL course_url = "https://www.yuketang.cn/web/course/xxxx" # 注意：run_scheduler是阻塞调用，会一直运行 run_scheduler(login_driver, course_url)

重要提醒：

• 频率设置：检查间隔(check_interval_minutes)不宜过短，避免给服务器造成不必要的压力，2-5分钟是比较合理的范围。
• 页面状态：确保driver所在的页面标签页没有被切换或关闭。最好为这个监控任务单独开一个浏览器窗口或标签页。
• 资源占用：Selenium浏览器实例会占用内存和CPU。如果长时间运行，注意监控资源使用情况。
• 不可见运行：可以考虑使用无头模式(ChromeOptions().add_argument('--headless'))，但有些网站会检测无头浏览器，可能触发反爬。

3.5 视频播放辅助（倍速播放）

早期雨课堂网页播放器基于Flash或早期HTML5，可能禁用了倍速选项。我们的思路是通过JavaScript直接控制视频播放器的播放速率(playbackRate)。

方案：Selenium执行JavaScript

def set_video_speed(driver, speed=2.0): """ 设置当前页面视频播放器的播放速率 :param driver: Selenium WebDriver 对象 :param speed: 播放速率，1.0为正常，2.0为两倍速 """ try: # 通过JavaScript找到video标签并设置playbackRate js_code = """ var videos = document.getElementsByTagName('video'); if (videos.length > 0) { for (var i = 0; i < videos.length; i++) { videos[i].playbackRate = %f; console.log('设置视频' + i + '速率为: ' + videos[i].playbackRate); } return '成功设置 ' + videos.length + ' 个视频的速率。'; } else { return '未找到video标签。'; } """ % speed result = driver.execute_script(js_code) print(f"视频倍速设置结果: {result}") return True except Exception as e: print(f"设置倍速失败: {e}") return False # 使用方法：在视频播放页面调用此函数 # driver.get("视频播放页URL") # time.sleep(3) # 等待播放器加载 # set_video_speed(driver, 1.5) # 设置为1.5倍速

更健壮的实现：视频播放器可能嵌套在iframe中，或者播放器对象不是标准的<video>标签，而是自定义的播放器库（如video.js）。这时需要先切换到iframe，或者寻找播放器对象暴露的API。

def set_video_speed_advanced(driver, speed=2.0): # 尝试处理iframe try: # 查找页面中的iframe iframes = driver.find_elements(By.TAG_NAME, 'iframe') for iframe in iframes: driver.switch_to.frame(iframe) # 尝试在iframe内设置 set_video_speed(driver, speed) driver.switch_to.default_content() # 切回主文档 except Exception as e: print(f"处理iframe时出错: {e}") driver.switch_to.default_content() # 尝试直接设置 set_video_speed(driver, speed) # 如果以上都不行，可以尝试用pyautogui发送键盘快捷键 # 但这种方法依赖窗口焦点，不推荐作为主要方法 # import pyautogui # pyautogui.hotkey('shift', '>') # 某些播放器加速快捷键

注意事项：修改播放速率属于前端行为，刷新页面后会重置。如果需要持久化，可以写一个浏览器插件（如Tampermonkey脚本）来注入JS，这比用Python+Selenium更优雅和持久。

4. 工程化与配置管理

一个实用的工具不能把账号密码、课程ID等硬编码在脚本里。我们需要一个配置文件。

config.ini示例：

[ACCOUNT] username = your_student_id@xxx.edu.cn password = your_password_here [COURSE] course_url = https://www.yuketang.cn/web/course/123456789 course_id = 123456789 save_directory = ./downloads [SCHEDULER] check_in_interval_minutes = 3 enable_auto_check_in = true [VIDEO] default_playback_speed = 1.8

Python读取配置：

import configparser import os def load_config(config_file='config.ini'): config = configparser.ConfigParser() if not os.path.exists(config_file): # 创建默认配置模板 config['ACCOUNT'] = {'username': '', 'password': ''} config['COURSE'] = {'course_url': '', 'course_id': '', 'save_directory': './materials'} config['SCHEDULER'] = {'check_in_interval_minutes': '3', 'enable_auto_check_in': 'false'} config['VIDEO'] = {'default_playback_speed': '1.5'} with open(config_file, 'w') as f: config.write(f) print(f"已创建默认配置文件 {config_file}，请填写信息。") return None else: config.read(config_file) return config

在主程序中，先加载配置，如果关键信息为空，则提示用户填写。这样工具就具备了基本的可配置性。

5. 常见问题与排查实录

在实际开发和运行中，你肯定会遇到各种各样的问题。下面是我踩过的一些坑和解决方案。

我的实操心得：

1. 选择器要“宽容”：不要写死过于精确的CSS选择器（如div.panel-body > ul.list > li:nth-child(3) > a）。尽量用类名、ID结合模糊查找（如contains）。网页结构微调是常态。
2. 日志是救星：一定要给每个关键步骤加上详细的日志输出（print或logging），记录成功、失败、获取到的URL等信息。当脚本在后台运行时，日志文件是你排查问题的唯一依据。
3. 做好异常处理：网络请求、文件IO、元素查找都可能失败。try...except要覆盖到，并给出有意义的错误提示，让脚本能够优雅地跳过错误继续执行，而不是整体崩溃。
4. 尊重robots.txt：在开发任何自动化工具前，先查看目标网站的robots.txt文件（通常在网站根目录，如https://www.yuketang.cn/robots.txt），了解哪些路径是允许或禁止爬取的，在法律和道德框架内行事。

6. 扩展思路与优化方向

这个基础工具可以沿多个方向进行扩展，使其更加强大和智能：

1. 图形用户界面(GUI)：使用PyQt5、Tkinter或PySimpleGUI为工具制作一个简单的桌面界面，方便非技术用户填写配置、点击按钮执行任务。
2. 多课程/多账号管理：改造配置文件，支持多个课程和账号的配置，用一个工具管理所有课程。
3. 智能内容识别与分类：利用python-pptx、PyPDF2等库对下载的课件进行内容初步分析，自动根据文件名或内容关键词分类归档。
4. 集成消息推送：将“新作业发布”、“签到开始”等事件，通过微信（Server酱）、钉钉或邮件自动推送给你，实现真正的提醒。
5. Docker化部署：将整个环境打包成Docker镜像，可以在服务器或树莓派上24小时运行签到监控任务，彻底解放本地电脑。
6. 浏览器插件化：将倍速播放、一键下载等功能改造成Chrome插件（使用JavaScript），这样就不需要启动Python脚本，体验更原生。

这个“雨课堂在线学习辅助工具”项目，虽然代码量不大，但涵盖了Web自动化、网络请求、定时任务、配置解析等多个实用知识点。它更像一个引子，展示了如何用Python将重复、繁琐的线上操作自动化。最重要的是，在开发和使用的过程中，你对网络协议、浏览器工作原理、反爬机制会有更深刻的理解。希望这份详细的拆解，能帮助你构建属于自己的效率工具。

本文还有配套的精品资源，点击获取