// 吉利学院(GUC) 拾光课程表适配脚本 // YETHAN以专教学信息服务平台 // 该教务系统带图片验证码,需用户在页面内手动登录,脚本基于已登录会话(Cookie)拉取课表 // 桥接 API 使用 v2:window.shiguangBridge(同步) / window.shiguangBridgePromise(异步) //*****吐槽(>-<)***** // ===== YETHAN 系统特性(适配脚本为何做了这么多特判) ===== // 1. 页面标题错乱:课表页 ="学生个人信息"、重修页="选课日志"(模板没改标题) // 2. 无校历/学期开始日期字段——开学日期只能从"按周查课表"表头偷(且表头只有"03月02日"无年份,年份需页头学年/最近年份推算) // 3. 课程数据脏:编号/课名/括号挤一行(如 "B1001 高等数学(4)"),全角括号混用、教师可能缺失、地点可为 NoRoom // 4. 课表视图分裂:全部周次视图表头无日期,仅按周(weekNo=N)视图表头带日期 // 5. 学生年级/学历等字段经接口加密下发、无干净字段(故无法按学号可靠推算"大几",只显示真实学年学期) // 6. 功能集中在单 Action(CourseAction?setAction=...)按字符串分发,无 REST // ==================== 常量 ==================== // 课表页面地址(selectTableType: ThisTerm=本学期, NextTerm=下学期) const COURSE_TABLE_URL = "https://jw.guc.edu.cn/yethan/CourseAction?setAction=userCourseScheduleTable&viewType=studentCourseTableWeek&selectTableType="; // 课表表单提交地址("按周次查课表"用 POST 提交,weekNo=1 请求用于解析开学日期,复刻页面表单) const COURSE_ACTION_URL = "https://jw.guc.edu.cn/yethan/CourseAction"; // 默认导入学期(用户在选择学期弹窗中取消时回退到本学期) const SELECT_TABLE_TYPE = "ThisTerm"; // 拉取课表请求超时时间(毫秒) const FETCH_TIMEOUT_MS = 15000; // 吉利学院作息时间(第1节~第11节) const TIME_SLOTS = [ { number: 1, startTime: "08:20", endTime: "09:05" }, { number: 2, startTime: "09:10", endTime: "09:55" }, { number: 3, startTime: "10:10", endTime: "10:55" }, { number: 4, startTime: "11:00", endTime: "11:45" }, { number: 5, startTime: "11:50", endTime: "12:35" }, { number: 6, startTime: "14:20", endTime: "15:05" }, { number: 7, startTime: "15:10", endTime: "15:55" }, { number: 8, startTime: "16:10", endTime: "16:55" }, { number: 9, startTime: "17:00", endTime: "17:45" }, { number: 10, startTime: "19:00", endTime: "19:45" }, { number: 11, startTime: "19:50", endTime: "20:35" } ]; // ==================== 工具函数 ==================== /** * 将周次字符串展开为数字数组。 * 支持 "19周" -> [19],"1-5,7-9,11-16周" -> [1,2,3,4,5,7,8,9,11,12,13,14,15,16] */ function parseWeeks(weekStr) { const weeks = []; if (!weekStr) return weeks; // 去掉"周"及可能存在的(单)/(双)等标记(兼容全角/半角括号) const pureWeekData = weekStr.replace(/周/g, "").replace(/[((].*$/, ""); pureWeekData.split(",").forEach(seg => { seg = seg.trim(); if (!seg) return; if (seg.includes("-")) { const [s, e] = seg.split("-").map(Number); if (!isNaN(s) && !isNaN(e) && s >= 1 && e >= s) { for (let i = s; i <= e; i++) weeks.push(i); } } else { const w = parseInt(seg, 10); if (!isNaN(w) && w >= 1) weeks.push(w); } }); return [...new Set(weeks)].sort((a, b) => a - b); } /** * 解析一行课程文本,如 "B3001 体育与健康(4)(张睿)"(课名带版本号括号,教师为最后一个全角括号)。 * 返回 { name, teacher },无法解析时返回 null。 * 兼容情况: * - 未选课前课程可能无教师(如 "B1001 高等数学"),此时 teacher 为空串,课程保留; * - 课名带版本号括号(如 "体育与健康(4)")时,纯数字括号视为课名一部分,不会误认成教师。 */ function parseCourseLine(line) { const text = line.trim(); if (!text) return null; // 教师为最后一个全角括号内的内容;纯数字括号(如 (4))视为课名版本号而非教师 const teacherMatch = text.match(/(([^()]+))$/); let teacher = ""; let name = text; if (teacherMatch) { const candidate = teacherMatch[1].trim(); if (!/^\d+$/.test(candidate)) { teacher = candidate; name = text.substring(0, text.length - teacherMatch[0].length).trim(); } } // 去除课程编号前缀(如 B2344),仅当首词形如"字母+数字"时去除 const tokens = name.split(/\s+/); if (tokens.length > 1 && /^[A-Za-z]*\d+$/.test(tokens[0])) { tokens.shift(); } name = tokens.join(" ").trim(); if (!name) return null; return { name, teacher }; } /** * 节次与周次合并去重函数(官方参考实现,来自拾光课程表 wiki《课程合并与去重函数》) * - 节次合并:名称、教师、地点、星期、周次完全相同的连续节次(1-2 + 3-4 -> 1-4) * - 完全去重:删除完全重复的记录 * - 周次合并:同节次的单双周/分段周次合并([15] + [16] -> [15,16]) * - 周次排序去重:weeks 自动升序并去重 */ function mergeAndDistinctCourses(courses) { if (!Array.isArray(courses) || courses.length <= 1) return courses; // 1. 深拷贝并规范周次数据,过滤无效项 const list = courses.map(c => ({ ...c, name: c.name || '', teacher: c.teacher || '', position: c.position || '', weeks: Array.isArray(c.weeks) ? [...c.weeks].sort((a, b) => a - b) : [] })); // 阶段 1:合并连续节次与完全重复记录(前提:名称、教师、地点、星期、周次一致) list.sort((a, b) => { return a.name.localeCompare(b.name) || a.teacher.localeCompare(b.teacher) || a.position.localeCompare(b.position) || (a.day || 0) - (b.day || 0) || a.weeks.join(',').localeCompare(b.weeks.join(',')) || (a.startSection || 0) - (b.startSection || 0); }); const step1Merged = []; let current = list[0]; for (let i = 1; i < list.length; i++) { const next = list[i]; const isSameCourseAndWeeks = current.name === next.name && current.teacher === next.teacher && current.position === next.position && current.day === next.day && current.weeks.join(',') === next.weeks.join(','); const isContinuous = current.endSection + 1 === next.startSection; const isDuplicate = current.startSection === next.startSection && current.endSection === next.endSection; if (isSameCourseAndWeeks && isContinuous) { // 节次连续:延长结束节次 (如 1-2 节 + 3-4 节 -> 1-4 节) current.endSection = next.endSection; } else if (isSameCourseAndWeeks && isDuplicate) { // 完全重复:跳过 continue; } else { step1Merged.push(current); current = next; } } step1Merged.push(current); // 阶段 2:合并同节次的周次(前提:名称、教师、地点、星期、开始/结束节次一致) step1Merged.sort((a, b) => { return a.name.localeCompare(b.name) || a.teacher.localeCompare(b.teacher) || a.position.localeCompare(b.position) || (a.day || 0) - (b.day || 0) || (a.startSection || 0) - (b.startSection || 0) || (a.endSection || 0) - (b.endSection || 0); }); const step2Merged = []; let cur = step1Merged[0]; for (let i = 1; i < step1Merged.length; i++) { const nxt = step1Merged[i]; const isSameCourseAndSection = cur.name === nxt.name && cur.teacher === nxt.teacher && cur.position === nxt.position && cur.day === nxt.day && cur.startSection === nxt.startSection && cur.endSection === nxt.endSection; if (isSameCourseAndSection) { // 周次合并去重 (如 1-8 周 + 9-16 周 -> 1-16 周) cur.weeks = Array.from(new Set([...cur.weeks, ...nxt.weeks])).sort((a, b) => a - b); } else { step2Merged.push(cur); cur = nxt; } } step2Merged.push(cur); return step2Merged; } /** * 解析课表 HTML,返回表格的所有行(<tr> 数组)。找不到表格返回空数组。 * 供解析课程/作息/开学日期复用,统一课表表格入口。 */ function getTableRows(html) { const doc = new DOMParser().parseFromString(html, "text/html"); const table = doc.querySelector("table.table_border"); return table ? Array.from(table.querySelectorAll("tr")) : []; } /** * 解析课表 HTML 表格为课程模型数组。 */ function parseTimetableToCourses(html) { const rows = getTableRows(html); if (rows.length === 0) return []; const results = []; for (const row of rows) { const cells = Array.from(row.querySelectorAll("td")); if (cells.length < 9) continue; const section = parseInt(cells[0].textContent.trim(), 10); if (isNaN(section) || section < 1) continue; // cells[0]=节次, cells[1]=上课时间, cells[2..8]=星期一~星期日 for (let col = 2; col <= 8; col++) { const day = col - 1; // 1=周一, 7=周日 // 将单元格中的 <br> 转为换行,保留纯文本 const clone = cells[col].cloneNode(true); clone.querySelectorAll("br").forEach(br => br.replaceWith("\n")); const raw = (clone.textContent || "").replace(/\u00A0/g, " "); const segments = raw.split("\n").map(s => s.trim()).filter(s => s.length > 0); // 课程块形如 [课程行, 周次地点行] 成对出现。 // 逐段消费:仅当"本段是课程行且下一段形如 '…周 …' 的周次地点行"才配对, // 避免教务改版导致段落错位时漏课或串位 for (let j = 0; j < segments.length; j++) { const courseInfo = parseCourseLine(segments[j]); if (!courseInfo) continue; if (j + 1 >= segments.length) continue; // 周次地点行,形如 "1-5,7-9,11-16周 L255极简型智慧教室" const timePlace = segments[j + 1]; const match = timePlace.match(/^(.+?)周\s*(.*)$/); if (!match) continue; const weeks = parseWeeks(match[1]); const position = (match[2] || "").trim(); if (weeks.length === 0) continue; results.push({ name: courseInfo.name, teacher: courseInfo.teacher, position: position, day: day, startSection: section, endSection: section, weeks: weeks }); j++; // 已消费周次地点行 } } } return mergeAndDistinctCourses(results); } /** * 从课表 HTML 动态提取作息时间(节次 + 上课时间列,如 "08:20-09:05")。 * 返回 [{ number, startTime, endTime }];无有效节次时返回 null(由调用方回退写死常量)。 * 表头行(节次为"节"字)与 rowspan 跨节的空节次行经 parseInt 后自然跳过。 */ function parseTimeSlots(html) { try { const rows = getTableRows(html); if (rows.length === 0) return null; const slots = []; for (const row of rows) { const cells = Array.from(row.querySelectorAll("td")); if (cells.length < 2) continue; const number = parseInt(cells[0].textContent.trim(), 10); if (isNaN(number) || number < 1) continue; const timeText = (cells[1].textContent || "").trim(); const m = timeText.match(/^(\d{1,2}:\d{2})\s*-\s*(\d{1,2}:\d{2})$/); if (!m) continue; slots.push({ number: number, startTime: m[1], endTime: m[2] }); } if (slots.length === 0) return null; slots.sort((a, b) => a.number - b.number); return slots; } catch (e) { console.error("解析作息时间失败:", e); return null; } } // ==================== 网络请求 ==================== /** * 带超时的 fetch 封装:统一 AbortController 超时与登录会话 Cookie(credentials: "include")。 * 超时/网络异常由调用方 catch 处理。 */ async function fetchWithTimeout(url, options) { const controller = new AbortController(); const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS); try { return await fetch(url, Object.assign({ credentials: "include" }, options, { signal: controller.signal })); } finally { clearTimeout(timer); } } /** * 拉取本学期课表页面并检测登录状态(一次请求完成)。 * 返回: * - { loggedIn: true, html } 成功 * - { error: "not_logged_in" } 未登录(页面含验证码输入框/登录表单) * - { error: "network" } 网络异常或超时 * - { error: "request_failed" } HTTP 请求失败(非 2xx) * - { error: "no_table" } 已登录但页面无课表 */ async function fetchTimetableOnce(semesterType) { try { const resp = await fetchWithTimeout(COURSE_TABLE_URL + semesterType + "&queryType=student"); if (!resp.ok) return { error: "request_failed" }; const html = await resp.text(); if (html.includes('id="ranstring"') || html.includes("LoginForm")) return { error: "not_logged_in" }; if (!html.includes("table_border")) return { error: "no_table" }; return { loggedIn: true, html }; } catch (e) { console.error("获取课表失败:", e); return { error: "network" }; } } /** * 请求第 1 周课表(POST,复刻页面"查周课表"表单,weekNo=1)。 * 第 1 周视图的表头带日期(如 "星期一<br>03月02日"),用于解析开学日期。 * 成功返回响应 HTML;任何失败返回 null(不阻断主流程,开学日期缺失时 App 端可手动设置)。 */ async function fetchWeek1Timetable(semesterType) { try { const resp = await fetchWithTimeout(COURSE_ACTION_URL, { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8" }, body: new URLSearchParams({ setAction: "userCourseScheduleTable", viewType: "studentCourseTableWeek", selectTableType: semesterType, queryType: "student", weekNo: "1" }).toString() }); if (!resp.ok) return null; return await resp.text(); } catch (e) { console.error("获取第1周课表失败:", e); return null; } } /** * 从第 1 周课表 HTML 解析开学日期(第一周第一天 = 表头"星期一"的日期)。 * 返回 "yyyy-MM-dd"(官方 CourseConfigJsonModel 格式);解析失败返回 null。 * * 年份策略(两步): * 1) 优先页头学年解析:"2025-2026第2学期" → 第1学期取学年首年(秋季)、第2学期取学年次年(春季); * 2) 兜底:取 "MM月DD日" 距今天最近的年份(候选: 去年/今年/明年)。 * 依据:教务系统仅显示本学期,开学日必然距今天不足半年,最近年份即正确年份。 */ function parseSemesterStartDate(html) { try { const rows = getTableRows(html); if (rows.length === 0) return null; const headerRow = rows[0]; const cells = headerRow ? Array.from(headerRow.querySelectorAll("td")) : []; // 表头:[0]=节, [1]=上课时间, [2]=星期一 ... if (cells.length < 3) return null; const mondayText = cells[2].textContent || ""; // 如 "星期一03月02日" const m = mondayText.match(/(\d{1,2})月(\d{1,2})日/); if (!m) return null; const month = parseInt(m[1], 10); const day = parseInt(m[2], 10); if (month < 1 || month > 12 || day < 1 || day > 31) return null; // 年份:优先页头学年解析 let year = null; const termMatch = html.match(/(20\d{2})\s*[-—]\s*(20\d{2})第?(\d)学期/); if (termMatch) { const y1 = parseInt(termMatch[1], 10); const y2 = parseInt(termMatch[2], 10); const termNo = parseInt(termMatch[3], 10); if (y2 === y1 + 1 && (termNo === 1 || termNo === 2)) { year = termNo === 2 ? y2 : y1; // 第1学期=首年(秋季),第2学期=次年(春季) } } // 兜底:距今天最近的年份 if (!year) { const now = new Date(); const thisYear = now.getFullYear(); let best = thisYear; let bestDiff = Infinity; for (const y of [thisYear - 1, thisYear, thisYear + 1]) { const d = new Date(y, month - 1, day); const diff = Math.abs(d - now); if (diff < bestDiff) { bestDiff = diff; best = y; } } year = best; } const pad = n => String(n).padStart(2, "0"); return `${year}-${pad(month)}-${pad(day)}`; } catch (e) { console.error("解析开学日期失败:", e); return null; } } // ==================== 学期选择 ==================== /** * 从选课页 HTML 解析真实学期名(如 "2025-2026第2学期")。 * 页头 userInfo 形如 "学号 姓名 <span>2025-2026第2学期</span> 课表"。 * 解析失败返回 null(由调用方回退使用通用名)。 */ function parseSemesterLabel(html) { const m = html.match(/(\d{4}-\d{4}第\d学期)/); return m ? m[1] : null; } /** * 探测指定学期的真实学期名。请求选课页(userCourseSchedule)拿页头学期标识; * 任何失败返回 null(调用方回退用通用名"本学期/下学期")。 */ async function fetchSemesterLabel(type) { try { const resp = await fetchWithTimeout(COURSE_ACTION_URL + "?setAction=userCourseSchedule&selectTableType=" + type); if (!resp.ok) return null; return parseSemesterLabel(await resp.text()); } catch (e) { console.error("探测学期名失败(", type, "):", e); return null; } } /** * 让用户选择导入学期。用 showSingleSelection 显示两个学期的真实学期名 * (如 "2025-2026第2学期" / "2026-2027第1学期",比"本学期/下学期"更明确); * 探测不到真实名时回退显示通用名。取消返回默认本学期(ThisTerm)。 */ async function selectSemester() { const kinds = [ { value: "ThisTerm", label: "本学期" }, { value: "NextTerm", label: "下学期" } ]; const labels = await Promise.all(kinds.map(k => fetchSemesterLabel(k.value))); const names = kinds.map((k, i) => labels[i] || k.label); const idx = await window.shiguangBridgePromise.showSingleSelection("选择导入学期", JSON.stringify(names), 0); if (idx == null || idx === undefined || idx === -1) return SELECT_TABLE_TYPE; return (kinds[idx] || kinds[0]).value; } /** * 构造课表配置:学期总周数(取课程最大周)+ 开学日期(可选)。 * 开学日期:请求第 1 周课表,取表头"星期一"日期作为第一周第一天("yyyy-MM-dd",官方格式); * 请求失败或解析失败时不设置该字段(App 端可手动设置),不影响课程导入。 */ async function fetchCourseConfig(semesterType, courses) { const maxWeek = courses.reduce((max, c) => Math.max(max, Math.max(...c.weeks)), 0); const config = { semesterTotalWeeks: Math.max(maxWeek, 1) }; const week1Html = await fetchWeek1Timetable(semesterType); if (week1Html) { const semesterStartDate = parseSemesterStartDate(week1Html); if (semesterStartDate) { config.semesterStartDate = semesterStartDate; console.log("开学日期:", semesterStartDate); } } return config; } // ==================== 主流程 ==================== async function runImportFlow() { const BRIDGE = window.shiguangBridge; const BRIDGE_P = window.shiguangBridgePromise; if (!BRIDGE || !BRIDGE_P) { console.error("桥接 API 不可用(缺少 window.shiguangBridge / window.shiguangBridgePromise)"); return; } BRIDGE.showToast("正在初始化吉利学院课表导入..."); // 1. 前置提示 const confirmed = await BRIDGE_P.showAlert( "教务系统课表导入", "请确认已在当前页面成功登录教务系统(输入学号、密码及验证码)。\n登录成功后点击“好的,开始导入”。", "好的,开始导入" ); if (!confirmed) { BRIDGE.showToast("已取消导入"); return; } // 2. 选择导入学期(默认本学期),并拉取该学期课表、检测登录状态 const semesterType = await selectSemester(); BRIDGE.showToast("正在获取课表数据..."); const result = await fetchTimetableOnce(semesterType); if (result.error === "not_logged_in") { await BRIDGE_P.showAlert( "未检测到登录状态", "当前会话未登录,请先在页面中完成登录,之后重新发起导入。", "知道了" ); BRIDGE.showToast("未登录,导入中止"); return; } if (result.error === "network" || result.error === "request_failed") { BRIDGE.showToast("获取课表失败(网络异常或超时),请检查网络后重试"); return; } if (result.error === "no_table" || !result.html) { BRIDGE.showToast("未获取到课表数据,请确认登录状态后重试"); return; } const html = result.html; // 3. 解析课程(所选学期) const courses = parseTimetableToCourses(html); if (courses.length === 0) { BRIDGE.showToast("未解析到课程数据,请确认所选学期是否有课程"); return; } console.log("解析到课程记录数:", courses.length, courses); // 4. 保存课程 try { await BRIDGE_P.saveImportedCourses(JSON.stringify(courses)); BRIDGE.showToast(`成功保存 ${courses.length} 条课程记录`); } catch (e) { BRIDGE.showToast("课程保存失败: " + e.message); return; } // 5. 保存作息时间(优先从课表"上课时间"列动态提取,学校调作息后无需改代码;提取失败回退写死常量) try { const timeSlots = parseTimeSlots(html) || TIME_SLOTS; await BRIDGE_P.savePresetTimeSlots(JSON.stringify(timeSlots)); BRIDGE.showToast("作息时间保存成功"); } catch (e) { BRIDGE.showToast("作息时间保存失败: " + e.message); } // 6. 保存课表配置(学期总周数 + 开学日期) try { const config = await fetchCourseConfig(semesterType, courses); await BRIDGE_P.saveCourseConfig(JSON.stringify(config)); } catch (e) { BRIDGE.showToast("课表配置保存失败: " + e.message); } BRIDGE.showToast(`课表导入完成,共 ${courses.length} 条记录`); BRIDGE.notifyTaskCompletion(); } // 启动导入流程 runImportFlow();