Bladeren bron

add:广州华立学院教务适配 (#674)

xiaomanjun233 1 week geleden
bovenliggende
commit
58b7fb4239
3 gewijzigde bestanden met toevoegingen van 527 en 0 verwijderingen
  1. 5 0
      index/root_index.yaml
  2. 9 0
      resources/HUALIXY/adapters.yaml
  3. 513 0
      resources/HUALIXY/hualixy.js

+ 5 - 0
index/root_index.yaml

@@ -1017,3 +1017,8 @@ schools:
     name: "中国地质大学(武汉)"
     initial: "Z"
     resource_folder: "CUG"
+
+  - id: "HUALIXY"
+    name: "广州华立学院"
+    initial: "G"
+    resource_folder: "HUALIXY"

+ 9 - 0
resources/HUALIXY/adapters.yaml

@@ -0,0 +1,9 @@
+# resources/HUALIXY/adapters.yaml
+adapters:
+  - adapter_id: "HUALIXY_01"
+    adapter_name: "广州华立学院正方教务"
+    category: "BACHELOR_AND_ASSOCIATE"
+    asset_js_path: "hualixy.js"
+    import_url: "https://jw.hualixy.edu.cn/sso/ddlogin"
+    maintainer: "小漫君"
+    description: "广州华立学院正方新一代教务系统适配。请先通过统一认证(jw.hualixy.edu.cn/sso/ddlogin)或正方直登(jwglxt/xtgl/login_slogin.html)登录,在教务系统任意页面直接执行导入即可(无需进入课表查询页面);脚本自动读取学年学期并获取课表与真实节次作息。"

+ 513 - 0
resources/HUALIXY/hualixy.js

@@ -0,0 +1,513 @@
+// 广州华立学院(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();