| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513 |
- // 广州华立学院(jw.hualixy.edu.cn) 拾光课程表适配脚本
- // 基于正方新一代教务系统接口适配
- // 维护者:小漫君(xiaomanjun233)
- // 出现问题请提issues或者提交pr更改,这更加快速
- //
- // 通过正方接口 xskbcx_cxXsgrkb 拉取个人课表 JSON(kbList),解析课程名、教师、教室、
- // 星期、节次和周次(含单双周)。集中实践课(军训、毕业设计等)无星期节次,直接忽略不导入。
- // 交互上自动读取教务系统的学年/学期下拉列表,用户只需依次点选即可,无需手动输入。
- // 通过 xskbcx_cxXskbcxIndex 读取学年学期选项、xskbcxZccx_cxZcByXnxq 取所选学期开学日期,
- // 并优先从 xskbcx_cxRjc 动态读取该校真实节次作息时间,读取失败时跳过作息导入。
- //
- // 使用方式:通过统一认证(https://jw.hualixy.edu.cn/sso/ddlogin)或正方直登
- // (https://jw.hualixy.edu.cn/jwglxt/xtgl/login_slogin.html)登录后,
- // 在教务系统(jw.hualixy.edu.cn/jwglxt)任意页面(如首页)直接执行导入即可,
- // 无需进入课表查询页面。脚本通过接口自动读取学年学期并获取课表与节次作息。
- // 正方新一代教务部分学校接口模块号可能不同,依次尝试常见模块号
- const GNMKDMS = ["N2151", "N253508"];
- /**
- * 拼接教务系统接口地址。
- * 正方新一代部署在 /jwglxt 子路径下,接口路径必须带上该前缀;
- * 校外经 WebVPN 访问时路径还带有 /http/<hex> 前缀,需保留。
- */
- function buildApiUrl(modulePath, gnmkdm) {
- const prefixMatch = window.location.pathname.match(/^\/http\/[0-9a-f]+/i);
- const webvpnPrefix = prefixMatch ? prefixMatch[0] : "";
- const gnmkdmQuery = gnmkdm ? "?gnmkdm=" + gnmkdm : "";
- return window.location.origin + webvpnPrefix + "/jwglxt" + modulePath + gnmkdmQuery;
- }
- /**
- * 解析周次字符串,处理单双周和周次范围。
- */
- function parseWeeks(weekStr) {
- if (!weekStr) return [];
- const weekSets = weekStr.split(',');
- let weeks = [];
- for (const set of weekSets) {
- const trimmedSet = set.trim();
- const rangeMatch = trimmedSet.match(/(\d+)-(\d+)周/);
- const singleMatch = trimmedSet.match(/^(\d+)周/);
- let start = 0;
- let end = 0;
- let processed = false;
- if (rangeMatch) {
- start = Number(rangeMatch[1]);
- end = Number(rangeMatch[2]);
- processed = true;
- } else if (singleMatch) {
- start = end = Number(singleMatch[1]);
- processed = true;
- }
- if (processed) {
- const isSingle = trimmedSet.includes('(单)');
- const isDouble = trimmedSet.includes('(双)');
- for (let w = start; w <= end; w++) {
- if (isSingle && w % 2 === 0) continue;
- if (isDouble && w % 2 !== 0) continue;
- weeks.push(w);
- }
- }
- }
- return [...new Set(weeks)].sort((a, b) => a - b);
- }
- /**
- * 解析 API 返回的 JSON 数据。
- */
- function parseJsonData(jsonData) {
- console.log("JS: parseJsonData 正在解析 JSON 数据...");
- if (!jsonData || !Array.isArray(jsonData.kbList)) {
- console.warn("JS: JSON 数据结构错误或缺少 kbList 字段。");
- return [];
- }
- const rawCourseList = jsonData.kbList;
- const finalCourseList = [];
- for (const rawCourse of rawCourseList) {
- if (!rawCourse.kcmc || !rawCourse.xqj || !rawCourse.jcs || !rawCourse.zcd) {
- continue;
- }
- const weeksArray = parseWeeks(rawCourse.zcd);
- if (weeksArray.length === 0) {
- continue;
- }
- const sectionParts = rawCourse.jcs.split('-');
- const startSection = Number(sectionParts[0]);
- const endSection = Number(sectionParts[sectionParts.length - 1]);
- const day = Number(rawCourse.xqj);
- if (isNaN(day) || isNaN(startSection) || isNaN(endSection) || day < 1 || day > 7 || startSection > endSection) {
- continue;
- }
- const course = {
- name: String(rawCourse.kcmc).trim(),
- teacher: String(rawCourse.xm || "").trim(),
- position: String(rawCourse.cdmc || "").trim(),
- day: day,
- startSection: startSection,
- endSection: endSection,
- weeks: weeksArray
- };
- finalCourseList.push(course);
- }
- finalCourseList.sort((a, b) =>
- a.day - b.day ||
- a.startSection - b.startSection ||
- a.name.localeCompare(b.name)
- );
- console.log(`JS: JSON 数据解析完成,共找到 ${finalCourseList.length} 门课程。`);
- return finalCourseList;
- }
- async function promptUserToStart() {
- return await window.shiguangBridgePromise.showAlert(
- "广州华立学院课表导入",
- "导入前请确保您已通过统一认证(jw.hualixy.edu.cn/sso/ddlogin)或正方直登登录教务系统;在任意页面直接执行导入即可,无需进入课表查询页面。",
- "好的,开始导入"
- );
- }
- /**
- * 从教务系统课表查询页读取学年与学期下拉选项(多个模块号依次尝试)。
- */
- async function fetchAcademicOptions() {
- for (const gnmkdm of GNMKDMS) {
- const url = buildApiUrl("/kbcx/xskbcx_cxXskbcxIndex.html", gnmkdm);
- try {
- const response = await fetch(url, { method: "GET", credentials: "include" });
- if (!response.ok) continue;
- const htmlText = await response.text();
- const doc = new DOMParser().parseFromString(htmlText, "text/html");
- const allYearOptions = Array.from(doc.querySelectorAll("#xnm option"))
- .filter((opt) => opt.value !== "")
- .map((opt) => ({
- value: opt.value,
- text: opt.textContent.trim(),
- selected: opt.selected
- }));
- const semesterOptions = Array.from(doc.querySelectorAll("#xqm option"))
- .filter((opt) => opt.value !== "")
- .map((opt) => ({
- value: opt.value,
- text: opt.textContent.trim(),
- selected: opt.selected
- }));
- if (allYearOptions.length === 0 || semesterOptions.length === 0) continue;
- const defaultSemesterIndex = (() => {
- const i = semesterOptions.findIndex((opt) => opt.selected);
- return i !== -1 ? i : 0;
- })();
- const selectedIndex = allYearOptions.findIndex((opt) => opt.selected);
- if (selectedIndex === -1) {
- return {
- yearOptions: allYearOptions.slice(0, 5),
- semesterOptions,
- defaultYearIndex: 0,
- defaultSemesterIndex
- };
- }
- const start = Math.max(0, selectedIndex - 2);
- const end = Math.min(allYearOptions.length, selectedIndex + 3);
- return {
- yearOptions: allYearOptions.slice(start, end),
- semesterOptions,
- defaultYearIndex: selectedIndex - start,
- defaultSemesterIndex
- };
- } catch (e) {
- console.warn(`JS: 读取学年学期失败(gnmkdm=${gnmkdm}):`, e);
- }
- }
- return null;
- }
- async function selectAcademicYearAndSemester() {
- const optionsData = await fetchAcademicOptions();
- if (!optionsData) {
- window.shiguangBridge.showToast("从教务系统读取学年学期失败,请确认登录状态有效。");
- return null;
- }
- const { yearOptions, semesterOptions, defaultYearIndex, defaultSemesterIndex } = optionsData;
- const yearIndex = await window.shiguangBridgePromise.showSingleSelection(
- "选择学年",
- JSON.stringify(yearOptions.map((item) => item.text)),
- defaultYearIndex
- );
- if (yearIndex === null || yearIndex === -1) return null;
- const academicYear = yearOptions[yearIndex].value;
- const semesterIndex = await window.shiguangBridgePromise.showSingleSelection(
- "选择学期",
- JSON.stringify(semesterOptions.map((item) => item.text)),
- defaultSemesterIndex
- );
- if (semesterIndex === null || semesterIndex === -1) return null;
- return {
- academicYear,
- semesterCode: semesterOptions[semesterIndex].value
- };
- }
- /**
- * 获取所选学期的开学日期(第 1 周的日期)。
- */
- async function fetchSemesterStartDate(academicYear, semesterCode) {
- for (const gnmkdm of GNMKDMS) {
- const url = buildApiUrl("/kbcx/xskbcxZccx_cxZcByXnxq.html", gnmkdm);
- try {
- const response = await fetch(url, {
- method: "POST",
- headers: { "content-type": "application/x-www-form-urlencoded;charset=UTF-8" },
- body: `xnm=${academicYear}&xqm=${semesterCode}`,
- credentials: "include"
- });
- if (response.ok) {
- const json = await response.json();
- if (Array.isArray(json) && json.length > 0) {
- const firstWeekObj = json.find((item) => String(item.zs) === "1" || String(item.zsmc) === "1") || json[0];
- const matchStr = String(firstWeekObj.rq || firstWeekObj.zcrq || firstWeekObj.ksrq || "").match(/(\d{4}-\d{2}-\d{2})/);
- if (matchStr) return matchStr[1];
- }
- }
- } catch (e) {
- console.warn(`JS: 获取开学日期失败(gnmkdm=${gnmkdm}):`, e);
- }
- }
- return null;
- }
- /**
- * 从正方系统动态获取该学期真实节次作息时间。
- * 读取失败返回 null,由调用方跳过作息导入(不写死未知作息)。
- */
- async function fetchAndParseTimeSlots(academicYear, semesterCode) {
- const requestBody = "xnm=" + encodeURIComponent(academicYear) +
- "&xqm=" + encodeURIComponent(semesterCode) +
- "&kzlx=ck&xsdm=&kclbdm=&kclxdm=";
- let lastError = null;
- for (const gnmkdm of GNMKDMS) {
- const url = buildApiUrl("/kbcx/xskbcx_cxRjc.html", gnmkdm);
- try {
- const response = await fetch(url, {
- headers: {
- "content-type": "application/x-www-form-urlencoded;charset=UTF-8",
- "X-Requested-With": "XMLHttpRequest",
- },
- body: requestBody,
- method: "POST",
- credentials: "include"
- });
- if (!response.ok) {
- lastError = "HTTP " + response.status;
- console.warn(`JS: 节次时间接口请求失败(gnmkdm=${gnmkdm}):HTTP ${response.status}`);
- continue;
- }
- const responseText = await response.text();
- const responsePreview = responseText.replace(/\s+/g, " ").trim().slice(0, 200) || "<空响应>";
- let data;
- try {
- data = JSON.parse(responseText);
- } catch (e) {
- lastError = "非 JSON:响应=" + responsePreview;
- console.warn(`JS: 节次时间接口未返回 JSON(gnmkdm=${gnmkdm}):`, e);
- continue;
- }
- if (data && !Array.isArray(data) && Array.isArray(data.data)) {
- data = data.data;
- }
- if (!Array.isArray(data)) {
- lastError = "格式异常:响应=" + responsePreview;
- console.warn(`JS: 节次时间接口返回格式异常(gnmkdm=${gnmkdm}): ${responsePreview}`);
- continue;
- }
- const timeSlots = [];
- for (const item of data) {
- if (!item || typeof item !== "object") continue;
- const number = Number(item.jcdm != null ? item.jcdm : item.jcmc);
- let startTime = "";
- let endTime = "";
- if (item.qssj != null && item.jssj != null) {
- startTime = String(item.qssj).trim();
- endTime = String(item.jssj).trim();
- } else if (item.sksj) {
- const sksjParts = String(item.sksj).split(/[~\-—至到]/);
- if (sksjParts.length >= 2) {
- startTime = sksjParts[0].trim();
- endTime = sksjParts[1].trim();
- }
- }
- startTime = startTime.slice(0, 5);
- endTime = endTime.slice(0, 5);
- if (!(number > 0) || !startTime || !endTime) continue;
- timeSlots.push({ number, startTime, endTime });
- }
- timeSlots.sort((a, b) => a.number - b.number);
- if (timeSlots.length === 0) {
- lastError = "无有效数据:响应=" + responsePreview;
- console.warn(`JS: 节次时间接口未返回有效作息时间(gnmkdm=${gnmkdm}): ${responsePreview}`);
- continue;
- }
- console.log(`JS: 获取到真实节次作息 ${timeSlots.length} 条(gnmkdm=${gnmkdm}),第1节 ${timeSlots[0].startTime}-${timeSlots[0].endTime}`);
- return timeSlots;
- } catch (error) {
- lastError = error.message || String(error);
- console.warn(`JS: 获取节次作息时间失败(gnmkdm=${gnmkdm}):`, error);
- }
- }
- console.warn("JS: 所有节次时间接口尝试均失败,最后原因:" + lastError);
- return null;
- }
- /**
- * 计算课表配置。只在能拿到真实开学日期时返回配置,否则返回 null 由调用方跳过。
- */
- function buildCourseConfig(courses, startDate, firstDayOfWeek) {
- if (!startDate) return null;
- let maxWeek = 0;
- for (const course of courses) {
- for (const week of course.weeks) {
- if (week > maxWeek) maxWeek = week;
- }
- }
- return {
- semesterStartDate: startDate,
- semesterTotalWeeks: Math.max(maxWeek, 20),
- firstDayOfWeek: firstDayOfWeek
- };
- }
- /**
- * 请求和解析课程数据。并行拉取课表 JSON 与所选学期开学日期。
- */
- async function fetchAndParseCourses(academicYear, semesterCode) {
- window.shiguangBridge.showToast("正在请求课表数据...");
- const body = `xnm=${academicYear}&xqm=${semesterCode}&kzlx=ck&xsdm=&kclbdm=`;
- let lastError = null;
- for (const gnmkdm of GNMKDMS) {
- const url = buildApiUrl("/kbcx/xskbcx_cxXsgrkb.html", gnmkdm);
- try {
- const [courseResponse, startDate] = await Promise.all([
- fetch(url, {
- method: "POST",
- headers: { "content-type": "application/x-www-form-urlencoded;charset=UTF-8" },
- body,
- credentials: "include"
- }),
- fetchSemesterStartDate(academicYear, semesterCode)
- ]);
- if (!courseResponse.ok) {
- lastError = `网络请求失败。状态码: ${courseResponse.status} (${courseResponse.statusText})`;
- console.warn(`JS: 课程请求失败(gnmkdm=${gnmkdm}):${lastError}`);
- continue;
- }
- const jsonText = await courseResponse.text();
- if (jsonText.indexOf("登录") !== -1 && jsonText.indexOf("密码") !== -1) {
- lastError = "课表接口返回了登录页面,登录会话已失效";
- console.warn(`JS: ${lastError}(gnmkdm=${gnmkdm})`);
- continue;
- }
- let jsonData;
- try {
- jsonData = JSON.parse(jsonText);
- } catch (e) {
- lastError = "数据返回格式错误";
- console.warn(`JS: JSON 解析失败(gnmkdm=${gnmkdm}):`, e);
- continue;
- }
- const courses = parseJsonData(jsonData);
- if (courses.length === 0) {
- window.shiguangBridge.showToast("未找到任何课程数据,请确认登录状态有效(非停留在登录页)、所选学年学期正确,或本学期无课。");
- return null;
- }
- console.log(`JS: 课程数据解析成功,共找到 ${courses.length} 门课程(gnmkdm=${gnmkdm})。`);
- const rawFirstDay = Number(jsonData.qsxqj);
- const firstDayOfWeek = (rawFirstDay >= 1 && rawFirstDay <= 7) ? rawFirstDay : 1;
- return { courses, startDate, firstDayOfWeek };
- } catch (error) {
- lastError = error.message;
- console.warn(`JS: Fetch/Parse Error(gnmkdm=${gnmkdm}):`, error);
- }
- }
- window.shiguangBridge.showToast(`请求或解析失败: ${lastError}`);
- return null;
- }
- async function saveCourses(parsedCourses) {
- window.shiguangBridge.showToast(`正在保存 ${parsedCourses.length} 门课程...`);
- try {
- await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(parsedCourses, null, 2));
- return true;
- } catch (error) {
- window.shiguangBridge.showToast(`课程保存失败: ${error.message}`);
- console.error('JS: Save Courses Error:', error);
- return false;
- }
- }
- async function saveCourseConfigIfPossible(courses, startDate, firstDayOfWeek) {
- const config = buildCourseConfig(courses, startDate, firstDayOfWeek);
- if (!config) {
- window.shiguangBridge.showToast("未取到本学期开学日期,已跳过课表配置,请在应用内手动设置开学日期。");
- return;
- }
- try {
- await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
- window.shiguangBridge.showToast(`开学日期 ${config.semesterStartDate},总周数 ${config.semesterTotalWeeks} 周。`);
- } catch (error) {
- window.shiguangBridge.showToast(`课表配置保存失败: ${error.message}`);
- console.error('JS: Save Config Error:', error);
- }
- }
- async function importPresetTimeSlots(timeSlots) {
- if (!timeSlots || timeSlots.length === 0) {
- window.shiguangBridge.showToast("未能读取该校真实作息时间,已跳过作息导入,请手动设置节次时间或其他节次时段。");
- return;
- }
- window.shiguangBridge.showToast(`正在导入 ${timeSlots.length} 个预设时间段...`);
- try {
- await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(timeSlots));
- window.shiguangBridge.showToast("预设时间段导入成功!");
- } catch (error) {
- window.shiguangBridge.showToast("导入时间段失败: " + error.message);
- console.error('JS: Save Time Slots Error:', error);
- }
- }
- async function runImportFlow() {
- const alertConfirmed = await promptUserToStart();
- if (!alertConfirmed) {
- window.shiguangBridge.showToast("用户取消了导入。");
- return;
- }
- const selection = await selectAcademicYearAndSemester();
- if (selection === null) {
- window.shiguangBridge.showToast("导入已取消。");
- return;
- }
- console.log(`JS: 已选择学年学期: ${selection.academicYear}/${selection.semesterCode}`);
- const result = await fetchAndParseCourses(selection.academicYear, selection.semesterCode);
- if (result === null) {
- console.log("JS: 课程获取或解析失败,流程终止。");
- return;
- }
- const { courses, startDate, firstDayOfWeek } = result;
- const saveResult = await saveCourses(courses);
- if (!saveResult) {
- console.log("JS: 课程保存失败,流程终止。");
- return;
- }
- await saveCourseConfigIfPossible(courses, startDate, firstDayOfWeek);
- const timeSlots = await fetchAndParseTimeSlots(selection.academicYear, selection.semesterCode);
- await importPresetTimeSlots(timeSlots);
- window.shiguangBridge.showToast(`课程导入成功,共导入 ${courses.length} 门课程!`);
- console.log("JS: 整个导入流程执行完毕并成功。");
- window.shiguangBridge.notifyTaskCompletion();
- }
- runImportFlow();
|