尧图网页设计 
简介本资源是一款面向高校学生与教育技术开发者的毕业设计级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 核心需求与功能拆解当初设计这个工具主要瞄准了雨课堂网页版使用中的几个高频且繁琐的操作自动签到与状态监控有些课程是定时签到手动操作容易错过。工具需要能定时检测页面上的签到按钮并在出现时自动点击。课件与资料批量下载老师发布的PPT、PDF、Word等资料一个一个点开再下载非常耗时。需要能一键遍历课程章节批量下载所有附件。视频播放辅助雨课堂早期的网页播放器不支持倍速播放或倍速选项隐藏对于复习需要快速浏览的同学很不友好。工具需要能干预播放器实现自定义播放速率。课程动态提醒新发布的公告、作业、预习材料希望能在第一时间得到通知而不是被动地刷新页面。基于这些需求工具被设计成几个相对独立的模块通过一个主控脚本来调度。这样做的好处是结构清晰每个模块功能单一也方便后期维护和扩展。2.2 技术栈与工具选型解析为什么选择Python因为对于这类需要与网页交互、处理HTTP请求、解析数据的任务Python的生态库实在是太强大了开发效率极高。核心库Selenium WebDriver为什么是Selenium雨课堂的很多交互如点击签到、翻页以及部分动态加载的内容单纯靠HTTP请求模拟比较困难特别是涉及到复杂的JavaScript渲染和用户行为验证时。Selenium可以驱动一个真实的浏览器如Chrome完全模拟人的操作绕过前端的一些检测逻辑是最稳妥的方案。选型考量对比过requestsBeautifulSoup的纯爬虫方案但对于需要保持登录状态、执行点击操作的场景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_fileyuketang_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和valuedomain有时可选 session.cookies.set(cookie[name], cookie[value], domaincookie.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登录获取CookieRequests复用进行高效操作”是经典模式。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_okTrue) # 1. 获取课程主页解析章节 course_page session.get(course_url) soup BeautifulSoup(course_page.content, html.parser) # 假设章节链接在特定的class或结构里这里需要根据实际页面调整 # 例如每个章节在一个 a classchapter-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, hrefTrue): 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, streamTrue) if r.status_code 200: with open(save_path, wb) as f: for chunk in r.iter_content(chunk_size8192): 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})关键点与避坑指南选择器动态性网页结构可能更新a.chapter-link这样的选择器需要你使用浏览器的开发者工具F12实际查看雨课堂页面的HTML结构后替换。这是最需要适配和调试的部分。链接补全一定要使用urljoin来正确处理相对路径和绝对路径拼凑出完整的URL。异常处理网络请求可能失败文件可能已存在必须用try...except包裹保证一个文件下载失败不影响后续任务。文件名处理从网页提取的文件名可能包含非法字符如/:*?|需要清洗否则保存文件时会出错。速率限制在循环中快速发起大量请求可能触发服务器的反爬机制。建议在请求间添加随机延时如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_minutes2): 启动定时任务调度器 # 每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执行JavaScriptdef set_video_speed(driver, speed2.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, speed2.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这比用PythonSelenium更优雅和持久。4. 工程化与配置管理一个实用的工具不能把账号密码、课程ID等硬编码在脚本里。我们需要一个配置文件。config.ini示例[ACCOUNT] username your_student_idxxx.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.8Python读取配置import configparser import os def load_config(config_fileconfig.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. 常见问题与排查实录在实际开发和运行中你肯定会遇到各种各样的问题。下面是我踩过的一些坑和解决方案。问题现象可能原因排查与解决思路Selenium无法启动浏览器报WebDriverException1. ChromeDriver版本与Chrome浏览器不匹配。2. ChromeDriver未在PATH中或路径指定错误。1. 检查Chrome版本设置-关于Chrome去官网下载完全相同大版本的ChromeDriver。2. 将chromedriver放在项目目录或在代码中指定完整路径executable_path./chromedriver。登录成功但后续请求返回登录页或403错误Cookies失效或未正确携带。1. 检查yuketang_cookies.json文件是否存在且内容有效。2. 确保requests.Session()正确设置了所有必要的cookies特别是domain和path。3. 检查请求头User-Agent是否与之前Selenium登录时一致不一致可能导致会话无效。4.终极方案重新运行Selenium登录流程获取新的Cookies。课件下载链接找到但下载失败404或4031. 下载链接是临时的、带鉴权参数的直接请求无效。2. 服务器有反爬机制如请求频率过高。1. 使用**同一个session**去下载它保持了登录状态。2. 在下载请求中添加必要的Referer请求头通常是课程页面URL。3. 在请求间增加随机延时如time.sleep(random.uniform(2,5))模拟人工操作。4. 尝试用Selenium打开下载链接让浏览器处理下载但这会弹出保存对话框需要额外配置浏览器自动下载。无法找到签到按钮或课件链接网页HTML结构发生变化CSS选择器失效。1.这是最常见的问题。使用浏览器开发者工具F12重新检查目标元素的HTML结构。2. 尝试使用更通用的选择器如通过部分文本内容//button[contains(text(),签)]XPath。3. 增加等待时间确保动态内容加载完成使用WebDriverWait。4. 如果元素在iframe内需要先driver.switch_to.frame()。定时任务运行一次后停止脚本异常退出或schedule在循环中被阻塞。1. 确保while True循环内的schedule.run_pending()和time.sleep(30)存在。2. 用try...except包裹任务函数check_in_task避免单个任务异常导致整个调度器崩溃。3. 将调度器运行放在主线程避免与其他可能阻塞的操作冲突。设置视频倍速无效1. 播放器不是标准video标签。2. 播放器对象在iframe内。3. 播放器使用自定义JS API。1. 在浏览器控制台直接输入document.getElementsByTagName(video)查看结果。2. 检查是否有iframe并尝试切换。3. 在开发者工具的“网络”选项卡中搜索playbackRate或rate关键词看是否有相关的API调用尝试模拟。程序被识别为爬虫IP被限制请求频率过高行为过于规律。1.降低频率增加随机等待时间。2.模拟真人在Selenium操作中随机加入鼠标移动、滚动等行为。3.使用代理IP需谨慎确保合规对于requests可通过proxies参数设置。我的实操心得选择器要“宽容”不要写死过于精确的CSS选择器如div.panel-body ul.list li:nth-child(3) a。尽量用类名、ID结合模糊查找如contains。网页结构微调是常态。日志是救星一定要给每个关键步骤加上详细的日志输出print或logging记录成功、失败、获取到的URL等信息。当脚本在后台运行时日志文件是你排查问题的唯一依据。做好异常处理网络请求、文件IO、元素查找都可能失败。try...except要覆盖到并给出有意义的错误提示让脚本能够优雅地跳过错误继续执行而不是整体崩溃。尊重robots.txt在开发任何自动化工具前先查看目标网站的robots.txt文件通常在网站根目录如https://www.yuketang.cn/robots.txt了解哪些路径是允许或禁止爬取的在法律和道德框架内行事。6. 扩展思路与优化方向这个基础工具可以沿多个方向进行扩展使其更加强大和智能图形用户界面(GUI)使用PyQt5、Tkinter或PySimpleGUI为工具制作一个简单的桌面界面方便非技术用户填写配置、点击按钮执行任务。多课程/多账号管理改造配置文件支持多个课程和账号的配置用一个工具管理所有课程。智能内容识别与分类利用python-pptx、PyPDF2等库对下载的课件进行内容初步分析自动根据文件名或内容关键词分类归档。集成消息推送将“新作业发布”、“签到开始”等事件通过微信Server酱、钉钉或邮件自动推送给你实现真正的提醒。Docker化部署将整个环境打包成Docker镜像可以在服务器或树莓派上24小时运行签到监控任务彻底解放本地电脑。浏览器插件化将倍速播放、一键下载等功能改造成Chrome插件使用JavaScript这样就不需要启动Python脚本体验更原生。这个“雨课堂在线学习辅助工具”项目虽然代码量不大但涵盖了Web自动化、网络请求、定时任务、配置解析等多个实用知识点。它更像一个引子展示了如何用Python将重复、繁琐的线上操作自动化。最重要的是在开发和使用的过程中你对网络协议、浏览器工作原理、反爬机制会有更深刻的理解。希望这份详细的拆解能帮助你构建属于自己的效率工具。本文还有配套的精品资源点击获取 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 核心需求与功能拆解当初设计这个工具主要瞄准了雨课堂网页版使用中的几个高频且繁琐的操作自动签到与状态监控有些课程是定时签到手动操作容易错过。工具需要能定时检测页面上的签到按钮并在出现时自动点击。课件与资料批量下载老师发布的PPT、PDF、Word等资料一个一个点开再下载非常耗时。需要能一键遍历课程章节批量下载所有附件。视频播放辅助雨课堂早期的网页播放器不支持倍速播放或倍速选项隐藏对于复习需要快速浏览的同学很不友好。工具需要能干预播放器实现自定义播放速率。课程动态提醒新发布的公告、作业、预习材料希望能在第一时间得到通知而不是被动地刷新页面。基于这些需求工具被设计成几个相对独立的模块通过一个主控脚本来调度。这样做的好处是结构清晰每个模块功能单一也方便后期维护和扩展。2.2 技术栈与工具选型解析为什么选择Python因为对于这类需要与网页交互、处理HTTP请求、解析数据的任务Python的生态库实在是太强大了开发效率极高。核心库Selenium WebDriver为什么是Selenium雨课堂的很多交互如点击签到、翻页以及部分动态加载的内容单纯靠HTTP请求模拟比较困难特别是涉及到复杂的JavaScript渲染和用户行为验证时。Selenium可以驱动一个真实的浏览器如Chrome完全模拟人的操作绕过前端的一些检测逻辑是最稳妥的方案。选型考量对比过requestsBeautifulSoup的纯爬虫方案但对于需要保持登录状态、执行点击操作的场景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_fileyuketang_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和valuedomain有时可选 session.cookies.set(cookie[name], cookie[value], domaincookie.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登录获取CookieRequests复用进行高效操作”是经典模式。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_okTrue) # 1. 获取课程主页解析章节 course_page session.get(course_url) soup BeautifulSoup(course_page.content, html.parser) # 假设章节链接在特定的class或结构里这里需要根据实际页面调整 # 例如每个章节在一个 a classchapter-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, hrefTrue): 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, streamTrue) if r.status_code 200: with open(save_path, wb) as f: for chunk in r.iter_content(chunk_size8192): 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})关键点与避坑指南选择器动态性网页结构可能更新a.chapter-link这样的选择器需要你使用浏览器的开发者工具F12实际查看雨课堂页面的HTML结构后替换。这是最需要适配和调试的部分。链接补全一定要使用urljoin来正确处理相对路径和绝对路径拼凑出完整的URL。异常处理网络请求可能失败文件可能已存在必须用try...except包裹保证一个文件下载失败不影响后续任务。文件名处理从网页提取的文件名可能包含非法字符如/:*?|需要清洗否则保存文件时会出错。速率限制在循环中快速发起大量请求可能触发服务器的反爬机制。建议在请求间添加随机延时如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_minutes2): 启动定时任务调度器 # 每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执行JavaScriptdef set_video_speed(driver, speed2.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, speed2.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这比用PythonSelenium更优雅和持久。4. 工程化与配置管理一个实用的工具不能把账号密码、课程ID等硬编码在脚本里。我们需要一个配置文件。config.ini示例[ACCOUNT] username your_student_idxxx.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.8Python读取配置import configparser import os def load_config(config_fileconfig.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. 常见问题与排查实录在实际开发和运行中你肯定会遇到各种各样的问题。下面是我踩过的一些坑和解决方案。问题现象可能原因排查与解决思路Selenium无法启动浏览器报WebDriverException1. ChromeDriver版本与Chrome浏览器不匹配。2. ChromeDriver未在PATH中或路径指定错误。1. 检查Chrome版本设置-关于Chrome去官网下载完全相同大版本的ChromeDriver。2. 将chromedriver放在项目目录或在代码中指定完整路径executable_path./chromedriver。登录成功但后续请求返回登录页或403错误Cookies失效或未正确携带。1. 检查yuketang_cookies.json文件是否存在且内容有效。2. 确保requests.Session()正确设置了所有必要的cookies特别是domain和path。3. 检查请求头User-Agent是否与之前Selenium登录时一致不一致可能导致会话无效。4.终极方案重新运行Selenium登录流程获取新的Cookies。课件下载链接找到但下载失败404或4031. 下载链接是临时的、带鉴权参数的直接请求无效。2. 服务器有反爬机制如请求频率过高。1. 使用**同一个session**去下载它保持了登录状态。2. 在下载请求中添加必要的Referer请求头通常是课程页面URL。3. 在请求间增加随机延时如time.sleep(random.uniform(2,5))模拟人工操作。4. 尝试用Selenium打开下载链接让浏览器处理下载但这会弹出保存对话框需要额外配置浏览器自动下载。无法找到签到按钮或课件链接网页HTML结构发生变化CSS选择器失效。1.这是最常见的问题。使用浏览器开发者工具F12重新检查目标元素的HTML结构。2. 尝试使用更通用的选择器如通过部分文本内容//button[contains(text(),签)]XPath。3. 增加等待时间确保动态内容加载完成使用WebDriverWait。4. 如果元素在iframe内需要先driver.switch_to.frame()。定时任务运行一次后停止脚本异常退出或schedule在循环中被阻塞。1. 确保while True循环内的schedule.run_pending()和time.sleep(30)存在。2. 用try...except包裹任务函数check_in_task避免单个任务异常导致整个调度器崩溃。3. 将调度器运行放在主线程避免与其他可能阻塞的操作冲突。设置视频倍速无效1. 播放器不是标准video标签。2. 播放器对象在iframe内。3. 播放器使用自定义JS API。1. 在浏览器控制台直接输入document.getElementsByTagName(video)查看结果。2. 检查是否有iframe并尝试切换。3. 在开发者工具的“网络”选项卡中搜索playbackRate或rate关键词看是否有相关的API调用尝试模拟。程序被识别为爬虫IP被限制请求频率过高行为过于规律。1.降低频率增加随机等待时间。2.模拟真人在Selenium操作中随机加入鼠标移动、滚动等行为。3.使用代理IP需谨慎确保合规对于requests可通过proxies参数设置。我的实操心得选择器要“宽容”不要写死过于精确的CSS选择器如div.panel-body ul.list li:nth-child(3) a。尽量用类名、ID结合模糊查找如contains。网页结构微调是常态。日志是救星一定要给每个关键步骤加上详细的日志输出print或logging记录成功、失败、获取到的URL等信息。当脚本在后台运行时日志文件是你排查问题的唯一依据。做好异常处理网络请求、文件IO、元素查找都可能失败。try...except要覆盖到并给出有意义的错误提示让脚本能够优雅地跳过错误继续执行而不是整体崩溃。尊重robots.txt在开发任何自动化工具前先查看目标网站的robots.txt文件通常在网站根目录如https://www.yuketang.cn/robots.txt了解哪些路径是允许或禁止爬取的在法律和道德框架内行事。6. 扩展思路与优化方向这个基础工具可以沿多个方向进行扩展使其更加强大和智能图形用户界面(GUI)使用PyQt5、Tkinter或PySimpleGUI为工具制作一个简单的桌面界面方便非技术用户填写配置、点击按钮执行任务。多课程/多账号管理改造配置文件支持多个课程和账号的配置用一个工具管理所有课程。智能内容识别与分类利用python-pptx、PyPDF2等库对下载的课件进行内容初步分析自动根据文件名或内容关键词分类归档。集成消息推送将“新作业发布”、“签到开始”等事件通过微信Server酱、钉钉或邮件自动推送给你实现真正的提醒。Docker化部署将整个环境打包成Docker镜像可以在服务器或树莓派上24小时运行签到监控任务彻底解放本地电脑。浏览器插件化将倍速播放、一键下载等功能改造成Chrome插件使用JavaScript这样就不需要启动Python脚本体验更原生。这个“雨课堂在线学习辅助工具”项目虽然代码量不大但涵盖了Web自动化、网络请求、定时任务、配置解析等多个实用知识点。它更像一个引子展示了如何用Python将重复、繁琐的线上操作自动化。最重要的是在开发和使用的过程中你对网络协议、浏览器工作原理、反爬机制会有更深刻的理解。希望这份详细的拆解能帮助你构建属于自己的效率工具。本文还有配套的精品资源点击获取