Browse Source

add:德州学院教务导入

- 登记 DZU 德州学院(正方教务 jwglxt)
- resources/DZU/:接口直取适配(含官方 Wiki 课程合并去重函数)
- index/root_index.yaml:新增 DZU 条目

按 review 意见修订:
- 移除通用 html 适配(保留单一接口直取方案)
- 采用官方 Wiki《课程合并与去重函数》替换简单去重
- 重写提交历史,修复 commit message 乱码
Oolong 2 tuần trước cách đây
mục cha
commit
da0da692ba
3 tập tin đã thay đổi với 473 bổ sung0 xóa
  1. 5 0
      index/root_index.yaml
  2. 9 0
      resources/DZU/adapters.yaml
  3. 459 0
      resources/DZU/dzu_deep.js

+ 5 - 0
index/root_index.yaml

@@ -583,6 +583,11 @@ schools:
     initial: "D"
     resource_folder: "DLUTCI"
 
+  - id: "DZU"
+    name: "德州学院"
+    initial: "D"
+    resource_folder: "DZU"
+
   - id: "ECJTU"
     name: "华东交通大学"
     initial: "H"

+ 9 - 0
resources/DZU/adapters.yaml

@@ -0,0 +1,9 @@
+# resources/DZU/adapters.yaml
+adapters:
+  - adapter_id: "DZU_01" # id加上序号
+    adapter_name: "德州学院正方教务"
+    category: "BACHELOR_AND_ASSOCIATE"
+    asset_js_path: "dzu_deep.js" #相对路径
+    import_url: "http://211.64.47.165/jwglxt/xtgl/login_slogin.html"
+    maintainer: "yvmu"
+    description: "登录后在任意页面点击执行导入,自动读取学年学期与开学日期,并写入德州学院作息时间"

+ 459 - 0
resources/DZU/dzu_deep.js

@@ -0,0 +1,459 @@
+// 德州学院(dzu.edu.cn)拾光课程表适配脚本
+// 基于正方教务 jwglxt 接口适配,已于 2026-09-04 在德州学院教务系统实测通过
+// 2026-09-06 按 review 意见修订:采用官方 Wiki《课程合并与去重函数》替换简单去重
+// 作息时间来源:德州学院官方作息时间表(sjc.dzu.edu.cn/index/zxsj.htm)
+//
+// 使用方式:进入教务系统登录后,在任意页面点击"执行导入",
+// 自动读取学年学期供选择,自动获取开学日期与总周数,自动写入德州学院作息时间。
+
+const COURSE_API_URL = "/jwglxt/kbcx/xskbcx_cxXsgrkb.html?gnmkdm=N2151";
+const WEEK_API_URL = "/jwglxt/kbcx/xskbcxZccx_cxZcByXnxq.html?gnmkdm=N2154";
+const INDEX_API_URL = "/jwglxt/kbcx/xskbcx_cxXskbcxIndex.html?gnmkdm=N2151";
+
+// 德州学院作息时间表(冬季 / 标准版,10月1日起执行:下午 14:00 上课)
+// 若需夏季作息(5月1日—9月30日,下午 14:30 上课),
+// 将第 5—8 节改为:14:30-15:15 / 15:20-16:05 / 16:25-17:10 / 17:15-18:00
+const TIME_SLOTS = [
+    { number: 1, startTime: "08:00", endTime: "08:45" },
+    { number: 2, startTime: "08:55", endTime: "09:40" },
+    { number: 3, startTime: "10:00", endTime: "10:45" },
+    { number: 4, startTime: "10:55", endTime: "11:40" },
+    { number: 5, startTime: "14:00", endTime: "14:45" },
+    { number: 6, startTime: "14:50", endTime: "15:35" },
+    { number: 7, startTime: "15:55", endTime: "16:40" },
+    { number: 8, startTime: "16:45", endTime: "17:30" },
+    { number: 9, startTime: "18:20", endTime: "19:05" },
+    { number: 10, startTime: "19:10", endTime: "19:55" },
+    { number: 11, startTime: "20:05", endTime: "20:50" },
+    { number: 12, startTime: "20:55", endTime: "21:40" }
+];
+
+function parseSections(rawText) {
+    const match = String(rawText || "").match(/(\d+)(?:\s*[-~至]\s*(\d+))?/);
+    if (!match) return [];
+
+    const start = Number(match[1]);
+    const end = Number(match[2] || match[1]);
+    if (!Number.isInteger(start) || !Number.isInteger(end) || start < 1 || start > end) {
+        return [];
+    }
+
+    return Array.from({ length: end - start + 1 }, (_, index) => start + index);
+}
+
+function parseWeeks(rawText) {
+    const weeks = new Set();
+    const normalized = String(rawText || "")
+        .replace(/周数[::]?/g, "")
+        .replace(/第/g, "")
+        .replace(/[,、;;]/g, ",")
+        .replace(/(/g, "(")
+        .replace(/)/g, ")");
+
+    normalized.split(",").forEach((segment) => {
+        const cleanSegment = segment.replace(/周/g, "").trim();
+        if (!cleanSegment) return;
+
+        const isOdd = cleanSegment.includes("单");
+        const isEven = cleanSegment.includes("双");
+        const rangeMatch = cleanSegment.match(/(\d+)(?:\s*[-~至]\s*(\d+))?/);
+        if (!rangeMatch) return;
+
+        const start = Number(rangeMatch[1]);
+        const end = Number(rangeMatch[2] || rangeMatch[1]);
+        if (!Number.isInteger(start) || !Number.isInteger(end) || start < 1 || start > end) return;
+
+        for (let week = start; week <= end; week += 1) {
+            if (isOdd && week % 2 === 0) continue;
+            if (isEven && week % 2 !== 0) continue;
+            weeks.add(week);
+        }
+    });
+
+    return Array.from(weeks).sort((left, right) => left - right);
+}
+
+/**
+ * 节次与周次合并去重函数
+ * 来源:官方 Wiki《课程合并与去重函数》
+ * https://github.com/XingHeYuZhuan/shiguangschedule/wiki/课程合并与去重函数
+ * 功能:连续节次合并(1-2节+3-4节→1-4节)、同节次周次合并(单双周→全周)、完全去重、周次排序
+ */
+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;
+}
+
+function parseApiData(jsonData) {
+    if (!jsonData || !Array.isArray(jsonData.kbList)) {
+        throw new Error("教务系统返回的数据格式发生变化,请联系适配器维护者。");
+    }
+
+    const courses = jsonData.kbList.flatMap((rawCourse) => {
+        const name = String(rawCourse.kcmc || "").trim();
+        const teacher = String(rawCourse.xm || "未知").trim() || "未知";
+        const position = String(rawCourse.cdmc || "待定").trim() || "待定";
+        const day = Number(rawCourse.xqj);
+        const sections = parseSections(rawCourse.jcs);
+        const weeks = parseWeeks(rawCourse.zcd);
+
+        if (!name || !Number.isInteger(day) || day < 1 || day > 7 || !sections.length || !weeks.length) {
+            return [];
+        }
+
+        return [{
+            name,
+            teacher,
+            position,
+            day,
+            startSection: sections[0],
+            endSection: sections[sections.length - 1],
+            weeks
+        }];
+    });
+
+    return mergeAndDistinctCourses(courses).sort((left, right) =>
+        left.day - right.day ||
+        left.startSection - right.startSection ||
+        left.name.localeCompare(right.name)
+    );
+}
+
+async function promptUserToStart() {
+    return await window.shiguangBridgePromise.showAlert(
+        "德州学院课表导入",
+        "请先登录德州学院教务系统。登录成功后可在教务系统任意页面开始导入。",
+        "开始导入"
+    );
+}
+
+/**
+ * 从教务系统读取学年学期选项(已实测:#xnm 为学年下拉框,#xqm 为学期下拉框,
+ * 学期码 3=第一学期、12=第二学期)
+ */
+async function fetchAcademicOptions() {
+    try {
+        const response = await fetch(INDEX_API_URL, { method: "GET", credentials: "include" });
+        if (!response.ok) return null;
+
+        const htmlText = await response.text();
+        const parser = new DOMParser();
+        const doc = parser.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) return null;
+
+        // 默认选中项:优先教务系统自带的 selected,否则按当前日期推算
+        const now = new Date();
+        const defaultYear = String(now.getMonth() >= 7 ? now.getFullYear() : now.getFullYear() - 1);
+        const defaultSemester = (now.getMonth() >= 7 || now.getMonth() === 0) ? "3" : "12";
+
+        const sysYearIndex = allYearOptions.findIndex(opt => opt.selected);
+        const calcYearIndex = allYearOptions.findIndex(opt => opt.value === defaultYear);
+        const defaultYearIndex = sysYearIndex !== -1 ? sysYearIndex
+            : (calcYearIndex !== -1 ? calcYearIndex : 0);
+
+        const sysSemIndex = semesterOptions.findIndex(opt => opt.selected);
+        const calcSemIndex = semesterOptions.findIndex(opt => opt.value === defaultSemester);
+        const defaultSemesterIndex = sysSemIndex !== -1 ? sysSemIndex
+            : (calcSemIndex !== -1 ? calcSemIndex : 0);
+
+        return { allYearOptions, semesterOptions, defaultYearIndex, defaultSemesterIndex };
+    } catch (e) {
+        return null;
+    }
+}
+
+async function selectAcademicYearAndSemester() {
+    const optionsData = await fetchAcademicOptions();
+
+    if (!optionsData) {
+        // 读取失败不阻断流程:退化为手动输入
+        window.shiguangBridge.showToast("自动读取学年学期失败,改为手动输入。");
+        return await manualSelectAcademicYearAndSemester();
+    }
+
+    const { allYearOptions, semesterOptions, defaultYearIndex, defaultSemesterIndex } = optionsData;
+
+    const yearIndex = await window.shiguangBridgePromise.showSingleSelection(
+        "选择学年",
+        JSON.stringify(allYearOptions.map(item => item.text)),
+        defaultYearIndex
+    );
+    if (yearIndex === null || yearIndex === -1) return null;
+    const academicYear = allYearOptions[yearIndex].value;
+
+    const semesterIndex = await window.shiguangBridgePromise.showSingleSelection(
+        "选择学期",
+        JSON.stringify(semesterOptions.map(item => item.text)),
+        defaultSemesterIndex
+    );
+    if (semesterIndex === null || semesterIndex === -1) return null;
+    const semesterCode = semesterOptions[semesterIndex].value;
+
+    return { academicYear, semesterCode };
+}
+
+/** 兜底:手动输入学年起始年 + 选择学期 */
+async function manualSelectAcademicYearAndSemester() {
+    const now = new Date();
+    const defaultYear = String(now.getMonth() >= 7 ? now.getFullYear() : now.getFullYear() - 1);
+    const academicYear = await window.shiguangBridgePromise.showPrompt(
+        "选择学年",
+        "请输入学年的起始年份,例如 2026-2027 学年请输入 2026。",
+        defaultYear,
+        "validateYearInput"
+    );
+    if (academicYear === null) return null;
+
+    const semesterIndex = await window.shiguangBridgePromise.showSingleSelection(
+        "选择学期",
+        JSON.stringify(["第一学期", "第二学期"]),
+        now.getMonth() >= 7 || now.getMonth() === 0 ? 0 : 1
+    );
+    if (semesterIndex === null || semesterIndex === -1) return null;
+    return { academicYear: String(academicYear).trim(), semesterCode: semesterIndex === 0 ? "3" : "12" };
+}
+
+function validateYearInput(input) {
+    return /^\d{4}$/.test(String(input || "").trim())
+        ? false
+        : "请输入四位数字的起始学年,例如 2026。";
+}
+
+/**
+ * 获取学期开学日期与总周数
+ * 已实测:返回数组每项含 rq(如 "2026-09-07/2026-09-13")与 zs(周序号)
+ */
+async function fetchSemesterInfo(academicYear, semesterCode) {
+    try {
+        const response = await fetch(WEEK_API_URL, {
+            method: "POST",
+            headers: {
+                "accept": "application/json, text/javascript, */*; q=0.01",
+                "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+                "x-requested-with": "XMLHttpRequest"
+            },
+            body: `xnm=${academicYear}&xqm=${semesterCode}`,
+            credentials: "include"
+        });
+
+        if (response.ok) {
+            const json = await response.json();
+            if (Array.isArray(json) && json.length > 0) {
+                const firstWeek = json.find(item => String(item.zs) === "1" || String(item.zsmc) === "1") || json[0];
+                let semesterStartDate = null;
+                if (firstWeek.rq) {
+                    const startDateStr = String(firstWeek.rq).split('/')[0];
+                    if (/^\d{4}-\d{2}-\d{2}$/.test(startDateStr)) semesterStartDate = startDateStr;
+                }
+                return { semesterStartDate, semesterTotalWeeks: json.length };
+            }
+        }
+    } catch (e) {
+        // 获取失败不影响主流程
+    }
+    return { semesterStartDate: null, semesterTotalWeeks: null };
+}
+
+async function fetchAndParseCourses(academicYear, semesterCode) {
+    window.shiguangBridge.showToast("正在获取课表数据...");
+
+    const requestBody = `xnm=${academicYear}&xqm=${semesterCode}&kzlx=ck&xsdm=&kclbdm=`;
+
+    const [courseResponse, semesterInfo] = await Promise.all([
+        fetch(COURSE_API_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8" },
+            body: requestBody,
+            credentials: "include"
+        }),
+        fetchSemesterInfo(academicYear, semesterCode)
+    ]);
+
+    if (!courseResponse.ok) {
+        throw new Error(`请求课表失败(HTTP ${courseResponse.status})。`);
+    }
+
+    const responseText = await courseResponse.text();
+    if (courseResponse.redirected || /login_slogin|用户登录|德州学院教学综合信息服务平台/.test(responseText)) {
+        throw new Error("登录状态已失效,请重新登录教务系统后再试。");
+    }
+
+    let jsonData;
+    try {
+        jsonData = JSON.parse(responseText);
+    } catch (error) {
+        throw new Error("教务系统未返回有效课表数据,请确认已经登录。");
+    }
+
+    const courses = parseApiData(jsonData);
+    if (!courses.length) {
+        throw new Error("所选学期未查询到课程,请检查学年和学期是否正确。");
+    }
+
+    return { courses, semesterInfo };
+}
+
+async function saveCourses(courses) {
+    try {
+        await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(courses));
+        return true;
+    } catch (error) {
+        console.error("DZU: Save courses error", error);
+        await window.shiguangBridgePromise.showAlert("保存失败", `课程保存失败:${error.message}`, "确定");
+        return false;
+    }
+}
+
+async function saveOptionalSettings(courses, semesterInfo) {
+    // 总周数:优先用教务系统返回的周数,否则按课表最大周推断
+    const config = {
+        semesterStartDate: semesterInfo.semesterStartDate,
+        semesterTotalWeeks: semesterInfo.semesterTotalWeeks || Math.max(...courses.flatMap(c => c.weeks)),
+        firstDayOfWeek: 1
+    };
+
+    try {
+        await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
+        let msg = "课表配置更新成功!";
+        if (config.semesterStartDate) msg += ` 开学日期:${config.semesterStartDate}`;
+        if (config.semesterTotalWeeks) msg += ` 共${config.semesterTotalWeeks}周`;
+        window.shiguangBridge.showToast(msg);
+    } catch (error) {
+        console.error("DZU: Save config error", error);
+        window.shiguangBridge.showToast(`课表配置保存失败:${error.message}`);
+    }
+
+    try {
+        await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(TIME_SLOTS));
+        window.shiguangBridge.showToast("德州学院作息时间写入成功!");
+    } catch (error) {
+        console.error("DZU: Save time slots error", error);
+        window.shiguangBridge.showToast(`作息时间保存失败:${error.message}`);
+    }
+}
+
+async function runImportFlow() {
+    const confirmed = await promptUserToStart();
+    if (!confirmed) {
+        window.shiguangBridge.showToast("用户取消了导入。");
+        return;
+    }
+
+    const selection = await selectAcademicYearAndSemester();
+    if (!selection) {
+        window.shiguangBridge.showToast("未选择学年学期,导入流程终止。");
+        return;
+    }
+
+    const { academicYear, semesterCode } = selection;
+
+    let result;
+    try {
+        result = await fetchAndParseCourses(academicYear, semesterCode);
+    } catch (error) {
+        console.error("DZU: Fetch or parse error", error);
+        await window.shiguangBridgePromise.showAlert("导入失败", error.message, "确定");
+        return;
+    }
+
+    const saved = await saveCourses(result.courses);
+    if (!saved) return;
+
+    await saveOptionalSettings(result.courses, result.semesterInfo);
+    window.shiguangBridge.showToast(`课程导入成功,共导入 ${result.courses.length} 条课程安排。`);
+    window.shiguangBridge.notifyTaskCompletion();
+}
+
+runImportFlow();