feat(HNU): 湖南大学教务适配

index/root_index.yaml

@@ -1242,3 +1242,9 @@ schools:
     name: "四川工商职业技术学院"
     initial: "S"
     resource_folder: "SCTBC"
+
+  - id: "HNU"
+    name: "湖南大学"
+    initial: "H"
+    resource_folder: "HNU"
+

resources/HNU/adapters.yaml

@@ -0,0 +1,9 @@
+# resources/HNU/adapters.yaml
+adapters:
+  - adapter_id: "HNU_01"
+    adapter_name: "湖南大学强智教务"
+    category: "BACHELOR_AND_ASSOCIATE"
+    asset_js_path: "hnu_01.js"
+    import_url: "http://hdjw.hnu.edu.cn/jsxsd/sso.jsp"
+    maintainer: "星河欲转"
+    description: "湖南大学强智教务适配，支持获取开学日期,非本校开发者适配如果有误建议提交issues"

resources/HNU/hnu_01.js

@@ -0,0 +1,467 @@
+// 湖南大学(hnu.edu.cn) 拾光课程表适配脚本
+// 非该大学开发者适配,开发者无法及时发现问题
+// 出现问题请联系开发者或者提交pr更改,这更加快速
+
+
+const BASE_URL = "https://hdjw.hnu.edu.cn";
+const URL_SEMESTER = `${BASE_URL}/jsxsd/jxzl/jxzl_query`;   // 教学周历（学期列表 + 开学日期 + 最大周次）
+const URL_COURSE   = `${BASE_URL}/jsxsd/xskb/xskb_list.do`; // 课表查询
+
+// 工具函数
+
+function parseWeeks(weekStr) {
+    const weeks = [];
+    if (!weekStr) return weeks;
+    const pureWeekData = weekStr.split('(')[0];
+    pureWeekData.split(',').forEach(seg => {
+        if (seg.includes('-')) {
+            const [s, e] = seg.split('-').map(Number);
+            if (!isNaN(s) && !isNaN(e)) {
+                for (let i = s; i <= e; i++) weeks.push(i);
+            }
+        } else {
+            const w = parseInt(seg);
+            if (!isNaN(w)) weeks.push(w);
+        }
+    });
+    return [...new Set(weeks)].sort((a, b) => a - b);
+}
+
+/**
+ * 节次与周次合并去重函数
+ * @param {Array<Object>} courses 原始解析课程数组
+ * @returns {Array<Object>} 合并去重后的课程数组
+ */
+function mergeAndDistinctCourses(courses) {
+    if (!Array.isArray(courses) || courses.length <= 1) return courses;
+
+    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) {
+            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) {
+            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 parseTimetableToModel(doc) {
+    const table = doc.querySelector('table.qz-weeklyTable');
+    if (!table) return [];
+
+    const results = [];
+
+    // 表头顺序：星期日、星期一、...、星期六
+    // 应用里 day 定义：1=周一, 7=周日
+    const dayMap = {
+        0: 7, // 星期日 -> 7
+        1: 1, // 星期一 -> 1
+        2: 2,
+        3: 3,
+        4: 4,
+        5: 5,
+        6: 6  // 星期六 -> 6
+    };
+
+    const bodyRows = Array.from(table.querySelectorAll('tbody tr'));
+
+    bodyRows.forEach(row => {
+        const cells = Array.from(row.querySelectorAll('td[name="kbDataTd"]'));
+        if (cells.length === 0) return;
+
+        cells.forEach((cell, idx) => {
+            const day = dayMap[idx];
+            if (!day) return;
+
+            const items = Array.from(cell.querySelectorAll('li.courselists-item'));
+            if (items.length === 0) return;
+
+            // 该单元格的 tooltip 列表，顺序和 items 对应
+            const tooltipItems = Array.from(cell.querySelectorAll('.qz-tooltip .qz-toolitiplists'));
+
+            items.forEach((li, i) => {
+                const name = li.querySelector('.qz-hasCourse-title')?.textContent.trim() || '';
+                if (!name) return;
+
+                const abbr = li.querySelector('.qz-hasCourse-abbrinfo')?.textContent || '';
+
+                // 老师
+                let teacher = '未知教师';
+                const teacherMatch = abbr.match(/老师[:：]\s*([^;；]+)/);
+                if (teacherMatch) teacher = teacherMatch[1].trim();
+
+                // 地点（abbr 里可能是空的括号，优先用 tooltip 里的地点）
+                let position = '未知地点';
+                const posMatchAbbr = abbr.match(/地点[:：]\s*([^;；]*)/);
+                if (posMatchAbbr && posMatchAbbr[1].trim() && posMatchAbbr[1].trim() !== '()') {
+                    position = posMatchAbbr[1].trim();
+                }
+
+                // 节次（从 abbr 里拿）
+                let startSection = 0, endSection = 0;
+                const secMatch = abbr.match(/\[([\d\-,\s]+?)节\]/);
+                if (secMatch && secMatch[1]) {
+                    const nums = secMatch[1]
+                        .split(/[^\d]+/)
+                        .map(Number)
+                        .filter(n => !isNaN(n) && n > 0);
+                    if (nums.length > 0) {
+                        startSection = Math.min(...nums);
+                        endSection = Math.max(...nums);
+                    }
+                }
+
+                // 周次 + 地点：优先从 tooltip 里拿
+                let weeks = [];
+                const tip = tooltipItems[i];
+                if (tip) {
+                    // 地点
+                    const posDiv = Array.from(tip.querySelectorAll('.qz-tooltipContent-detailitem'))
+                        .find(d => d.textContent.trim().startsWith('地点：'));
+                    if (posDiv) {
+                        const p = posDiv.textContent.replace('地点：', '').trim();
+                        if (p && p !== '()') position = p;
+                    }
+
+                    // 时间：3-4,7-16 周 [1-4节]
+                    const timeDiv = Array.from(tip.querySelectorAll('.qz-tooltipContent-detailitem'))
+                        .find(d => d.textContent.includes('时间：'));
+                    if (timeDiv) {
+                        const t = timeDiv.textContent.replace(/\s+/g, ' ').trim();
+                        // 取“时间：”和“周”之间的部分
+                        const wm = t.match(/时间[:：]\s*([\d,\-]+)\s*周/);
+                        if (wm) weeks = parseWeeks(wm[1]);
+                        // 如果 tooltip 里也有节次，可以覆盖
+                        const sm = t.match(/\[([\d\-,\s]+?)节\]/);
+                        if (sm && sm[1]) {
+                            const nums = sm[1].split(/[^\d]+/).map(Number).filter(n => !isNaN(n) && n > 0);
+                            if (nums.length > 0) {
+                                startSection = Math.min(...nums);
+                                endSection = Math.max(...nums);
+                            }
+                        }
+                    }
+                }
+
+                // 如果 tooltip 没拿到周次，退回 abbr
+                if (weeks.length === 0) {
+                    weeks = parseWeeks(abbr);
+                }
+
+                if (name && weeks.length > 0 && startSection > 0) {
+                    results.push({
+                        name,
+                        teacher,
+                        weeks,
+                        position,
+                        day,
+                        startSection,
+                        endSection
+                    });
+                }
+            });
+        });
+    });
+
+    return mergeAndDistinctCourses(results);
+}
+
+// 网络请求封装
+
+/**
+ * GET 教学周历页面（用于获取学期列表）
+ */
+async function requestSemesterPage() {
+    const response = await fetch(URL_SEMESTER, {
+        method: "GET",
+        credentials: "include"
+    });
+    return await response.text();
+}
+
+/**
+ * POST 教学周历页面（用于获取指定学期的开学日期与最大周次）
+ * @param {string} semesterId 形如 "2025-2026-2"
+ */
+async function requestSemesterDetailPage(semesterId) {
+    const response = await fetch(URL_SEMESTER, {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: `xnxq01id=${semesterId}`,
+        credentials: "include"
+    });
+    return await response.text();
+}
+
+async function requestCoursePage(semesterId) {
+    const params = new URLSearchParams({
+        viweType: "0",
+        xnxq01id: semesterId
+    });
+
+    const response = await fetch(`${URL_COURSE}?${params.toString()}`, {
+        method: "GET",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        referrer: `${URL_COURSE}?viweType=0`,
+        credentials: "include"
+    });
+    return await response.text();
+}
+
+// 业务逻辑
+
+/**
+ * 获取学期列表，以 selected 为原点上下各取 3 个
+ * @returns {Promise<{list: Array<{value:string,label:string}>, defaultIndex:number}>}
+ */
+async function fetchSemesterList() {
+    const html = await requestSemesterPage();
+    const doc = new DOMParser().parseFromString(html, "text/html");
+    const select = doc.getElementById("xnxq01id");
+    if (!select) return { list: [], defaultIndex: -1 };
+
+    const allOptions = Array.from(select.querySelectorAll("option")).map(opt => ({
+        value: opt.value,
+        label: opt.textContent.trim(),
+        selected: opt.hasAttribute("selected")
+    }));
+
+    let selectedIndex = allOptions.findIndex(o => o.selected);
+    if (selectedIndex === -1) selectedIndex = 0;
+
+    const start = Math.max(0, selectedIndex - 3);
+    const end = Math.min(allOptions.length, selectedIndex + 4);
+
+    const list = allOptions.slice(start, end);
+    const defaultIndex = selectedIndex - start;
+
+    return { list, defaultIndex };
+}
+
+/**
+ * 获取指定学期的开学日期 + 最大周次
+ * @param {string} semesterId 形如 "2026-2027-1"
+ * @returns {Promise<{startDate: string|null, totalWeeks: number|null}>}
+ */
+async function fetchSemesterInfo(semesterId) {
+    const html = await requestSemesterDetailPage(semesterId);
+    const doc = new DOMParser().parseFromString(html, "text/html");
+    const timetable = doc.getElementById("dataTable");
+    if (!timetable) return { startDate: null, totalWeeks: null };
+
+    const rows = Array.from(timetable.querySelectorAll("tbody tr"))
+        .filter(r => r.querySelector("td"));
+    if (rows.length === 0) return { startDate: null, totalWeeks: null };
+
+    let week1Row = null;
+    for (const row of rows) {
+        const label = row.querySelector("td.qz-weeklyTable-label")?.textContent.trim() || "";
+        if (label === "第1周") {
+            week1Row = row;
+            break;
+        }
+    }
+    if (!week1Row) week1Row = rows[0];
+
+    let startDate = null;
+    const dayCells = Array.from(week1Row.querySelectorAll("td.qz-weeklyTable-normalDay"));
+    if (dayCells.length > 0) {
+        const firstCellText = dayCells[0].textContent || "";
+        const dm = firstCellText.match(/(\d{2})月(\d{2})日/);
+        if (dm) {
+            const month = parseInt(dm[1], 10);
+            const day = dm[2];
+
+            const yearMatch = semesterId.match(/^(\d{4})/);
+            let year = yearMatch ? parseInt(yearMatch[1], 10) : new Date().getFullYear();
+            if (month < 8) year += 1;
+
+            startDate = `${year}-${dm[1]}-${day}`;
+        }
+    }
+
+    let totalWeeks = null;
+    for (const row of rows) {
+        const label = row.querySelector("td.qz-weeklyTable-label")?.textContent.trim() || "";
+        const wm = label.match(/第(\d+)周/);
+        if (wm) {
+            const n = parseInt(wm[1], 10);
+            if (!isNaN(n) && n > 0) {
+                if (totalWeeks === null || n > totalWeeks) totalWeeks = n;
+            }
+        }
+    }
+
+    return { startDate, totalWeeks };
+}
+
+/**
+ * 获取并解析指定学期的课程
+ * @param {string} semesterId 形如 "2025-2026-2"
+ * @returns {Promise<Array<Object>>}
+ */
+async function fetchCourses(semesterId) {
+    const html = await requestCoursePage(semesterId);
+    return parseTimetableToModel(new DOMParser().parseFromString(html, "text/html"));
+}
+
+// 配置保存
+
+async function saveAppConfig(semesterStartDate, totalWeeks) {
+    const config = {
+        "semesterTotalWeeks": totalWeeks || 20,
+        "firstDayOfWeek": 7
+    };
+    if (semesterStartDate) {
+        config.semesterStartDate = semesterStartDate;
+    }
+    return await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
+}
+
+/**
+ * 统一作息（湖南大学）
+ */
+async function saveAppTimeSlots() {
+    const unifiedSlots = [
+        { "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:30", "endTime": "15:15" },
+        { "number": 6,  "startTime": "15:15", "endTime": "16:00" },
+        { "number": 7,  "startTime": "16:10", "endTime": "16:55" },
+        { "number": 8,  "startTime": "16:55", "endTime": "17:40" },
+        { "number": 9,  "startTime": "19:00", "endTime": "19:45" },
+        { "number": 10, "startTime": "19:55", "endTime": "20:40" },
+        { "number": 11, "startTime": "20:50", "endTime": "21:35" }
+    ];
+
+    return await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(unifiedSlots));
+}
+
+// 流程编排
+
+async function runImportFlow() {
+    try {
+        // 1. 用户确认
+        const confirmed = await window.shiguangBridgePromise.showAlert(
+            "提示", "请确保已成功登录教务系统。是否开始导入？", "开始"
+        );
+        if (!confirmed) return;
+
+        // 2. 获取学期列表
+        window.shiguangBridge.showToast("正在获取学期列表...");
+        const { list: semesters, defaultIndex } = await fetchSemesterList();
+        if (!semesters || semesters.length === 0) {
+            window.shiguangBridge.showToast("未获取到学期列表，请检查登录状态。");
+            return;
+        }
+
+        // 3. 用户选择学期
+        const labels = semesters.map(s => s.label);
+        const selectedIndex = await window.shiguangBridgePromise.showSingleSelection(
+            "选择学期", JSON.stringify(labels), defaultIndex
+        );
+        if (selectedIndex === null) return;
+        const semesterId = semesters[selectedIndex].value;
+
+        // 4. 获取开学日期 + 最大周次
+        window.shiguangBridge.showToast("正在获取学期信息...");
+        const { startDate: semesterStartDate, totalWeeks } = await fetchSemesterInfo(semesterId);
+
+        // 5. 获取课程
+        window.shiguangBridge.showToast("正在请求课程数据...");
+        const finalCourses = await fetchCourses(semesterId);
+        if (finalCourses.length === 0) {
+            window.shiguangBridge.showToast("未发现课程，请检查学期选择或登录状态。");
+            return;
+        }
+
+        // 6. 保存配置（含开学日期 + 最大周次）/ 作息 / 课程
+        await saveAppConfig(semesterStartDate, totalWeeks);
+        await saveAppTimeSlots();
+        await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(finalCourses));
+
+        // 7. 完成
+        window.shiguangBridge.showToast(`成功导入 ${finalCourses.length} 门课程`);
+        window.shiguangBridge.notifyTaskCompletion();
+    } catch (error) {
+        window.shiguangBridge.showToast("异常: " + error.message);
+    }
+}
+
+// 启动导入流程
+runImportFlow();