add：北京工商大学(BTBU)强智教务适配 (#643)

index/root_index.yaml

@@ -973,6 +973,11 @@ schools:
     initial: "C"
     resource_folder: "CQEPC"
 
+  - id: "BTBU"
+    name: "北京工商大学"
+    initial: "B"
+    resource_folder: "BTBU"
+    
   - id: "SCNU"
     name: "华南师范大学"
     initial: "H"

resources/BTBU/adapters.yaml

@@ -0,0 +1,9 @@
+# resources/BTBU/adapters.yaml
+adapters:
+  - adapter_id: "BTBU"
+    adapter_name: "北京工商大学本科教务"
+    category: "BACHELOR_AND_ASSOCIATE"
+    asset_js_path: "btbu.js"
+    import_url: "https://jwgl.btbu.edu.cn/"
+    maintainer: "lztttt"
+    description: "适配北京工商大学强智教务系统，教务系统登录后即可一键导入，自动获取学期列表选择学期，兼容校园网直连与WebVPN访问"

resources/BTBU/btbu.js

@@ -0,0 +1,713 @@
+// 北京工商大学(btbu.edu.cn) 拾光课程表适配脚本 · API解析（BTBU_02）
+// 教务系统：强智（jsxsd）· 数据接口：/jsxsd/xskb/xskb_list.do
+// 使用流程：登录教务系统（校园网直连或 WebVPN 均可）→ 进入任意教务页面 → 点击一键导入
+// 自动获取学期列表
+// 维护者：lztttt（出现解析问题请提交 issue 或 PR）
+//
+// 接口说明（依据 webvpn 抓包与 samples/xskb_list.html 校准）：
+//   GET  {jsxsd前缀}/xskb/xskb_list.do          → 课表页（含学期下拉 xnxq01id 与课程模式 kbjcmsid）
+//   POST {jsxsd前缀}/xskb/xskb_list.do          → 切换学期后的课表页（HTML，按真实页面结构解析）
+//   请求体：cj0701id=&zc=&demo=&xnxq01id=学年-学期&sfFD=1&wkbkc=1&kbjcmsid=课程模式ID
+//   WebVPN 包装形态：https://vpn.btbu.edu.cn/{https|https-443}/<站点哈希>/jsxsd/...
+//   → 通过 location.pathname 中 '/jsxsd/' 的位置自动推导前缀，直连与 WebVPN 通用
+//
+// 传输方式：隐藏表单 + iframe 提交（与浏览器真实表单导航同语义）。
+//   实测 WebVPN（深澜 wengine 会 hook window.fetch 并破坏 POST）与校园网直连均可靠。
+//
+// 输出数据：CourseJsonModel（不输出 id/color/remark 内部字段）
+// 桥接 API 使用 v2 规范的 window.shiguangBridge / window.shiguangBridgePromise
+
+// =========================================================================
+// 桥接封装（浏览器 Alpha 调试时自动降级为 alert/console；原生返回值做归一化）
+// =========================================================================
+
+function toast(message) {
+    if (window.shiguangBridge && typeof window.shiguangBridge.showToast === 'function') {
+        window.shiguangBridge.showToast(message);
+    } else {
+        console.log('[BTBU] ' + message);
+    }
+}
+
+async function alertUser(title, message) {
+    if (window.shiguangBridgePromise && typeof window.shiguangBridgePromise.showAlert === 'function') {
+        // 原生侧以字符串 "true"/"false" 回传结果，字符串 "false" 为真值，统一归一化为布尔
+        const confirmed = await window.shiguangBridgePromise.showAlert(title, message, '确定');
+        return confirmed === true || confirmed === 'true';
+    }
+    alert(title + '\n' + message);
+    return true;
+}
+
+// showPrompt 的全局校验函数（规范要求：验证通过返回 false，失败返回错误文案）
+window.validateSemesterStartDate = function (input) {
+    if (/^\d{4}-\d{2}-\d{2}$/.test(input)) {
+        const d = new Date(input + 'T00:00:00');
+        if (!isNaN(d.getTime())) return false;
+    }
+    return '请输入 YYYY-MM-DD 格式的日期，例如 2025-09-01（学期第一周的周一）';
+};
+
+// showSingleSelection 归一化：原生以字符串序号或 "null" 回传，统一为数字序号（-1 表示取消）
+async function selectFromList(title, items, defaultIndex) {
+    if (!(window.shiguangBridgePromise && typeof window.shiguangBridgePromise.showSingleSelection === 'function')) {
+        return defaultIndex; // 无桥环境（浏览器调试）默认取推荐项
+    }
+    const r = await window.shiguangBridgePromise.showSingleSelection(title, JSON.stringify(items), defaultIndex);
+    if (r === null || r === undefined || r === 'null') return -1;
+    if (typeof r === 'number') return r;
+    const n = parseInt(r, 10);
+    return isNaN(n) ? -1 : n;
+}
+
+// =========================================================================
+// 接口地址推导：兼容校园网直连（jwgl.btbu.edu.cn）与 WebVPN（vpn.btbu.edu.cn）
+// =========================================================================
+
+// 从当前页面地址推导 /jsxsd 前缀；不在教务系统页面内时返回 null
+function getJsxsdBase() {
+    const path = window.location.pathname;
+    const idx = path.indexOf('/jsxsd/');
+    if (idx < 0) return null;
+    return path.slice(0, idx); // 直连：''；WebVPN：'/https/777264...b' 或 '/https-443/777...b'
+}
+
+async function fetchPage(url, options) {
+    const res = await fetch(url, Object.assign({ credentials: 'include' }, options || {}));
+    const text = await res.text();
+    return { ok: res.ok, status: res.status, url: res.url, text: text };
+}
+
+// =========================================================================
+// 课表解析（依据真实页面结构校准；API 返回整页 HTML，经 DOMParser 构建文档后解析）
+// =========================================================================
+
+// 星期文本 → 数字（1=周一 … 7=周日），无法识别返回 0
+function weekdayFromText(text) {
+    const match = String(text || '').match(/(?:星期|周)\s*([一二三四五六日天])/);
+    if (!match) return 0;
+    return { '一': 1, '二': 2, '三': 3, '四': 4, '五': 5, '六': 6, '日': 7, '天': 7 }[match[1]];
+}
+
+// 扫描前几行表头，建立 “网格列号 → 星期几” 映射（考虑 colspan），至少命中 2 列才认为校准成功
+function buildColumnDayMap(rows) {
+    const map = {};
+    for (let r = 0; r < Math.min(rows.length, 4); r++) {
+        let col = 0;
+        const headerCells = rows[r].querySelectorAll('th,td');
+        for (let c = 0; c < headerCells.length; c++) {
+            const span = parseInt(headerCells[c].getAttribute('colspan') || '1', 10) || 1;
+            const day = weekdayFromText(headerCells[c].textContent);
+            if (day >= 1 && day <= 7 && map[col] === undefined) map[col] = day;
+            col += span;
+        }
+        if (Object.keys(map).length >= 2) break;
+    }
+    return map;
+}
+
+// 计算单元格在所在行中的网格列号（0 起，考虑 colspan）
+function gridColumnIndexOf(cell) {
+    const row = cell.parentElement;
+    if (!row) return -1;
+    let col = 0;
+    for (let i = 0; i < row.children.length; i++) {
+        if (row.children[i] === cell) return col;
+        const span = parseInt(row.children[i].getAttribute('colspan') || '1', 10) || 1;
+        col += span;
+    }
+    return -1;
+}
+
+/**
+ * 解析“周次(节次)”文本 → { weeks: Number[], sections: Number[] }
+ * 兼容格式（前三种为北工商实页形态）：
+ *   "1-16(周)[01-02节]"、"1-16(周)[03-04-05节]"（三小节连排）、"9(周)"（单周）
+ *   "1-8,10-16(周)[03-04节]"（分段）、"1-15周(单)[01-02节]"、"2-16(双)[01-02节]"（单双周）
+ */
+function parseWeeksAndSections(text) {
+    const result = { weeks: [], sections: [] };
+    const str = String(text || '').trim();
+    if (!str) return result;
+
+    // 1) 先识别单双周标记（(单)/(双)），全周课程无标记
+    let parity = 0; // 1=单周 2=双周
+    if (/双/.test(str)) parity = 2;
+    else if (/单/.test(str)) parity = 1;
+
+    // 2) 周次部分：取节次方括号“[”之前的内容，剥掉全部括号标记（(周)/(单)/(双)）与“周”字
+    const bracketIdx = str.indexOf('[');
+    const weekPart = bracketIdx >= 0 ? str.slice(0, bracketIdx) : str;
+    const cleaned = weekPart
+        .replace(/第/g, '')
+        .replace(/至|到/g, '-')
+        .replace(/[（(][^（）()]*[）)]/g, '')
+        .replace(/周/g, '');
+
+    for (let seg of cleaned.split(/[,，、;；\s]+/)) {
+        seg = seg.trim();
+        if (!seg) continue;
+        const range = seg.match(/^(\d+)\s*[-–—~]\s*(\d+)$/);
+        if (range) {
+            let a = parseInt(range[1], 10);
+            let b = parseInt(range[2], 10);
+            if (a > b) { const t = a; a = b; b = t; }
+            for (let w = a; w <= b; w++) result.weeks.push(w);
+        } else {
+            const w = parseInt(seg, 10);
+            if (!isNaN(w)) result.weeks.push(w);
+        }
+    }
+
+    // 3) 应用单双周过滤并排序去重
+    if (parity === 1) result.weeks = result.weeks.filter(w => w % 2 === 1);
+    else if (parity === 2) result.weeks = result.weeks.filter(w => w % 2 === 0);
+    result.weeks = Array.from(new Set(result.weeks)).sort((a, b) => a - b);
+
+    // 4) 节次部分：“[01-02节]”→[1,2]，“[03-04-05节]”→[3,4,5]
+    //    存在三小节连排（如 03-04-05），直接提取方括号内全部数字
+    const secMatch = str.match(/\[([^\]]*)\]/);
+    if (secMatch) {
+        const nums = secMatch[1].match(/\d+/g);
+        if (nums) {
+            for (let i = 0; i < nums.length; i++) {
+                const s = parseInt(nums[i], 10);
+                if (!isNaN(s)) result.sections.push(s);
+            }
+        }
+    }
+
+    return result;
+}
+
+// 清理课程名称文本：剥离课程编号/课号前缀与后缀，返回纯课名（可能为空）
+function cleanCourseName(text) {
+    let name = String(text || '').trim();
+    if (!name) return '';
+    // “课程编号：XXX”（kchConfig 里的编号已在 DOM 层移除，这里兜底）
+    name = name.replace(/课程编号\s*[:：]?\s*[A-Z0-9]+/gi, '');
+    // 行首字母开头的短编码（如 CS101、GS140001），后随中文/空白/括号才剔除，
+    // 避免误伤 “MATLAB程序设计” 等以字母开头的真实课名
+    name = name.replace(/^[A-Za-z]{1,6}\d{2,10}[A-Za-z]?(?=[\u4e00-\u9fa5\s（(])\s*/, '');
+    // 行首长编码（北工商形如 080901C4S2007：连续字母数字≥8位且含数字，后随中文/括号）
+    name = name.replace(/^[A-Za-z0-9]{8,16}(?=[\u4e00-\u9fa5（(])/, function (m) {
+        return /\d/.test(m) ? '' : m;
+    });
+    // 行首纯数字编码（如 “14000101高等数学”）
+    name = name.replace(/^\d{5,12}(?=[\u4e00-\u9fa5\s（(])\s*/, '');
+    // 行尾编码（如 “高等数学01110037”“高等数学（01110037）”）
+    name = name.replace(/[（(][0-9A-Za-z]{5,16}[)）]\s*$/, '');
+    name = name.replace(/([\u4e00-\u9fa5）)])(\d{5,12}[A-Za-z]?)\s*$/, '$1');
+    return name.trim();
+}
+
+// 是否为“纯编号”文本（不含中文），兼容北工商形态 "080901C4S2007"、纯数字 "01110037"、"GS140001"
+function isPureCourseCode(text) {
+    if (/[\u4e00-\u9fa5]/.test(text)) return false;
+    if (/^\d{6,16}$/.test(text)) return true;
+    return /^[A-Z0-9]{6,16}$/.test(text) && /\d/.test(text) && /[A-Za-z]/.test(text);
+}
+
+// 解析一个课表格子（.kbcontent / .kbcontent1）内的课程信息，追加到 out
+// 北工商真实结构（依据 samples/xskb_list.html 校准）：
+//   课名 = 无 title 的外层 font，内嵌 <font class="kchConfig">（含 hint 与纯编号）+ <br> + 课名；
+//   元数据 font 带 title：教师 / 周次(节次) / 教室 / 教学楼 / 通知单编号 / 班级 / 备注 / 课程二维码；
+//   教务渲染的隐藏 kbcontent1 与可见 kbcontent 内容重复，由 parseTimetable 负责跳过。
+function parseCellInto(cellDiv, day, out, rowSections) {
+    const allFonts = cellDiv.getElementsByTagName('font');
+    const fonts = [];
+    for (let i = 0; i < allFonts.length; i++) {
+        // 跳过嵌套在另一个 font 内部的 font（kchConfig/hint 会随外层整体清理）
+        if (allFonts[i].parentElement && allFonts[i].parentElement.tagName === 'FONT') continue;
+        fonts.push(allFonts[i]);
+    }
+
+    let current = null;
+    let pendingCode = null; // 尚未等到课名的纯编号
+
+    const pushCurrent = function () {
+        if (current) {
+            // 无 [节次] 括号时，用所在行标签的节次范围兜底（如 “1~2节”）
+            if (current.sections.length === 0 && rowSections) {
+                for (let s = rowSections[0]; s <= rowSections[1]; s++) current.sections.push(s);
+            }
+            out.push(current);
+            current = null;
+        }
+    };
+    const startCourse = function (name) {
+        pushCurrent();
+        current = { name: name, position: '', teacher: '', weeks: [], day: day, sections: [] };
+    };
+
+    for (let j = 0; j < fonts.length; j++) {
+        const f = fonts[j];
+        const title = f.getAttribute('title') || '';
+
+        if (!title) {
+            const tempNode = f.cloneNode(true);
+            const kchElements = tempNode.getElementsByClassName('kchConfig');
+            while (kchElements.length > 0) kchElements[0].parentNode.removeChild(kchElements[0]);
+
+            const text = tempNode.textContent.replace(/\u00a0/g, ' ').trim();
+            if (!text || /^[-—\s]+$/.test(text)) {
+                // 同格两门课之间的 “------” 分隔线：结算上一门
+                pushCurrent();
+                pendingCode = null;
+                continue;
+            }
+
+            // 关键：用清理后的名字判断是否课名，避免 “课程编号：XXX” 被清成纯编号后误当成课名
+            const name = cleanCourseName(text);
+            if (name && /[\u4e00-\u9fa5]/.test(name)) {
+                startCourse(name);
+                pendingCode = null;
+            } else if (name && isPureCourseCode(name)) {
+                if (!current) pendingCode = name; // 编号在课名之前单独出现，先暂存
+                // 课程已开始时出现的编号只是附加信息，忽略
+            }
+        } else if (title.indexOf('课程') !== -1 && title.indexOf('周次') === -1) {
+            // title=“课程名称”（其他强智变体的结构）
+            const name = cleanCourseName(f.textContent.trim());
+            if (name) startCourse(name);
+            pendingCode = null;
+        } else {
+            if (!current && pendingCode) {
+                // 编号后直接跟元数据且始终无课名：以编号兜底建课，避免丢课
+                startCourse(pendingCode);
+            }
+            pendingCode = null;
+            if (current) {
+                const text = f.textContent.trim();
+                // title 兼容 “教师/老师” 两种强智写法
+                if (title.indexOf('教师') !== -1 || title.indexOf('老师') !== -1) {
+                    current.teacher = text;
+                } else if (title.indexOf('周次') !== -1) {
+                    const parsed = parseWeeksAndSections(text);
+                    current.weeks = parsed.weeks;
+                    current.sections = parsed.sections;
+                } else if (title.indexOf('教室') !== -1) {
+                    current.position = text;
+                }
+            }
+        }
+    }
+    pushCurrent();
+}
+
+function parseTimetable(doc) {
+    const table = doc.getElementById('timetable');
+    if (!table) return [];
+
+    const rows = Array.from(table.querySelectorAll('tr'));
+    const colDayMap = buildColumnDayMap(rows);
+
+    const result = [];
+    for (let r = 0; r < rows.length; r++) {
+        // 行标签里的节次范围（北工商形如 “1~2节 (01,02小节) 08:00-09:35”），作为无 [节次] 括号时的兜底
+        const firstCell = rows[r].querySelector('th,td');
+        const labelMatch = firstCell ? String(firstCell.textContent).match(/(\d+)\s*[~～]\s*(\d+)\s*节/) : null;
+        const rowSections = labelMatch ? [parseInt(labelMatch[1], 10), parseInt(labelMatch[2], 10)] : null;
+
+        const cells = rows[r].querySelectorAll('.kbcontent, .kbcontent1');
+        if (cells.length === 0) continue;
+
+        for (let i = 0; i < cells.length; i++) {
+            const cellDiv = cells[i];
+            // 北工商的 kbcontent1 是 display:none 的缩略副本，与同格 kbcontent 内容重复，跳过
+            // （其他强智变体中可见的 kbcontent1 表示同格第二门课，不受影响）
+            if (cellDiv.style && cellDiv.style.display === 'none') continue;
+
+            const ownerCell = cellDiv.closest('td,th');
+            if (!ownerCell) continue;
+
+            const col = gridColumnIndexOf(ownerCell);
+            if (col < 0) continue;
+
+            // 优先使用表头校准结果；无表头时退化为“列号+1”（强智首列通常为节次标签列）
+            const day = colDayMap[col] !== undefined ? colDayMap[col] : col + 1;
+            if (day < 1 || day > 7) continue;
+
+            parseCellInto(cellDiv, day, result, rowSections);
+        }
+    }
+    return result;
+}
+
+// =========================================================================
+// 学期信息提取（从 xskb_list.do 返回的页面中读取下拉框）
+// =========================================================================
+
+// 学期列表：[{ value: "2025-2026-2", label: "2025-2026学年第2学期" }, ...]（新学期在前）
+function parseSemesterOptions(doc) {
+    const sel = doc.querySelector('select[name="xnxq01id"]');
+    if (!sel) return [];
+    const out = [];
+    sel.querySelectorAll('option').forEach(function (opt) {
+        const v = (opt.getAttribute('value') || '').trim();
+        if (!v) return;
+        const label = v.replace(/^(\d{4})-(\d{4})-(\d)$/, '$1-$2 学年第 $3 学期');
+        out.push({ value: v, label: label });
+    });
+    return out;
+}
+
+// 课程模式 ID（北工商仅 “默认节次模式” 一项；取不到时使用抓包所得常量兜底）
+function parseKbjcmsid(doc) {
+    const sel = doc.querySelector('select[name="kbjcmsid"]');
+    if (sel) {
+        const selected = sel.querySelector('option[selected], option:checked');
+        const opt = selected || sel.querySelector('option[value]');
+        if (opt) return (opt.getAttribute('value') || '').trim();
+    }
+    return 'BA619E6D28314968AD899E77F638AE08';
+}
+
+// =========================================================================
+// 数据结构转换与合并（官方推荐，严格条件）
+// =========================================================================
+
+function convertCourses(rawCourses) {
+    return rawCourses
+        .map(function (item) {
+            const sections = item.sections;
+            return {
+                name: item.name,
+                teacher: item.teacher || '未知教师',
+                position: item.position || '未知地点',
+                day: item.day,
+                startSection: sections[0],
+                endSection: sections[sections.length - 1],
+                weeks: item.weeks
+            };
+        })
+        .filter(function (c) {
+            return c.weeks.length > 0 &&
+                Number.isInteger(c.startSection) && Number.isInteger(c.endSection);
+        });
+}
+
+/**
+ * 节次与周次合并去重函数
+ * 来源：官方 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) {
+            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;
+}
+
+// =========================================================================
+// 保存流程（顺序遵循规范参考：配置 → 课程 → 时间段；时间段失败不阻塞导入）
+// =========================================================================
+
+async function promptSemesterStartDate() {
+    if (!(window.shiguangBridgePromise && typeof window.shiguangBridgePromise.showPrompt === 'function')) {
+        return null;
+    }
+    const input = await window.shiguangBridgePromise.showPrompt(
+        '学期开始日期',
+        '请输入本学期第一周的周一日期（YYYY-MM-DD）\n 点击取消跳过、后续可在软件内设置。',
+        '',
+        'validateSemesterStartDate'
+    );
+    // 原生侧取消时回传字符串 "null"，一并按取消处理
+    if (input === null || input === undefined || input === 'null') return null;
+    const trimmed = String(input).trim();
+    return trimmed ? trimmed : null;
+}
+
+async function saveCourseConfig(rawCourses) {
+    const allWeeks = rawCourses.flatMap(function (c) { return c.weeks; });
+    const maxWeek = allWeeks.length > 0 ? Math.max.apply(null, allWeeks) : 20;
+
+    const startDate = await promptSemesterStartDate();
+
+    const config = {
+        semesterTotalWeeks: maxWeek > 0 ? maxWeek : 20,
+        defaultBreakDuration: 5
+    };
+    if (startDate) {
+        config.semesterStartDate = startDate;
+    } else {
+        toast('未设置学期开始日期，可稍后在软件内手动校准周次');
+    }
+
+    try {
+        await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
+        return true;
+    } catch (error) {
+        console.error('[BTBU] 保存课表配置失败:', error);
+        toast('课表配置保存失败：' + (error && error.message ? error.message : error));
+        return false;
+    }
+}
+
+async function saveCourses(courses) {
+    try {
+        await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(courses));
+        return true;
+    } catch (error) {
+        console.error('[BTBU] 保存课程失败:', error);
+        toast('课程保存失败：' + (error && error.message ? error.message : error));
+        return false;
+    }
+}
+
+async function importPresetTimeSlots() {
+    // 北工商作息时间表（13 节）
+    const timeSlots = [
+        { number: 1, startTime: '08:00', endTime: '08:45' },
+        { number: 2, startTime: '08:50', endTime: '09:35' },
+        { number: 3, startTime: '09:50', endTime: '10:35' },
+        { number: 4, startTime: '10:40', endTime: '11:25' },
+        { number: 5, startTime: '11:30', endTime: '12:15' },
+        { number: 6, startTime: '13:40', endTime: '14:25' },
+        { number: 7, startTime: '14:30', endTime: '15:15' },
+        { number: 8, startTime: '15:30', endTime: '16:15' },
+        { number: 9, startTime: '16:20', endTime: '17:05' },
+        { number: 10, startTime: '17:10', endTime: '17:55' },
+        { number: 11, startTime: '18:45', endTime: '19:30' },
+        { number: 12, startTime: '19:35', endTime: '20:20' },
+        { number: 13, startTime: '20:25', endTime: '21:10' }
+    ];
+
+    try {
+        await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(timeSlots));
+        return true;
+    } catch (error) {
+        // 规范：时间段导入失败通常不阻止最终流程完成
+        console.warn('[BTBU] 时间段导入失败(不阻塞):', error);
+        toast('作息时间导入失败，可稍后在软件内手动设置');
+        return false;
+    }
+}
+
+// 通过隐藏表单 + 隐藏 iframe 提交（与浏览器真实表单导航同语义，
+// Sec-Fetch-Dest: iframe / Referer 均与浏览器一致）。
+// 实测：WebVPN 环境下深澜 wengine 会 hook window.fetch 并破坏 POST 请求，
+// 而真实表单导航四个学期全部成功 —— 故为唯一的课表传输方式。
+// 超时可经 window.__BTBU_FORM_TIMEOUT_MS__ 覆盖（默认 8000ms，移动网络经 WebVPN 较慢）。
+// 返回提交后 iframe 内的 document（无论是否含课表，由调用方判定），异常时返回 null。
+function submitViaHiddenForm(action, body) {
+    return new Promise(function (resolve) {
+        try {
+            const frame = document.createElement('iframe');
+            frame.name = 'btbuPostFrame' + Date.now();
+            frame.style.display = 'none';
+            const form = document.createElement('form');
+            form.action = action;
+            form.method = 'POST';
+            form.target = frame.name;
+            new URLSearchParams(body).forEach(function (v, k) {
+                const input = document.createElement('input');
+                input.type = 'hidden';
+                input.name = k;
+                input.value = v;
+                form.appendChild(input);
+            });
+            document.body.appendChild(frame);
+            document.body.appendChild(form);
+
+            const timeoutMs = (window.__BTBU_FORM_TIMEOUT_MS__ | 0) || 8000;
+            let settled = false;
+            const finish = function (doc) {
+                if (settled) return;
+                settled = true;
+                try { if (form.parentNode) form.parentNode.removeChild(form); } catch (e) {}
+                setTimeout(function () { try { if (frame.parentNode) frame.parentNode.removeChild(frame); } catch (e) {} }, 1000);
+                resolve(doc || null);
+            };
+            frame.addEventListener('load', function () {
+                try {
+                    const d = frame.contentDocument;
+                    if (!d || d.location.href === 'about:blank') return; // 初始空页，忽略
+                    finish(d);
+                } catch (e) { finish(null); }
+            });
+            setTimeout(function () {
+                try { finish(frame.contentDocument); } catch (e) { finish(null); }
+            }, timeoutMs);
+            form.submit();
+        } catch (e) { resolve(null); }
+    });
+}
+
+// =========================================================================
+// 流程编排
+// =========================================================================
+
+/**
+ * 编排整个课程导入流程：
+ *   推导接口前缀 → 拉取课表页（学期列表）→ 弹窗选学期 → 隐藏表单+iframe 拉取对应学期课表
+ *   → 解析合并 → 保存。任何一步取消或失败都立即退出；notifyTaskCompletion 只在成功后调用。
+ */
+async function runImportFlow() {
+    try {
+        const base = getJsxsdBase();
+        if (base === null) {
+            await alertUser(
+                '请先进入教务系统',
+                '未检测到教务系统页面（/jsxsd/）。请先登录教务系统，进入主页或任意教务功能页面后再点击导入。'
+            );
+            return;
+        }
+        const listUrl = window.location.origin + base + '/jsxsd/xskb/xskb_list.do';
+
+        // 1. 拉取课表页，提取学期列表
+        toast('正在获取学期信息...');
+        const listPage = await fetchPage(listUrl);
+        const listDoc = new DOMParser().parseFromString(listPage.text, 'text/html');
+        const semesters = parseSemesterOptions(listDoc);
+        if (semesters.length === 0) {
+            await alertUser(
+                '未获取到学期列表',
+                '课表页返回异常（HTTP ' + listPage.status + '，' + listPage.text.length + ' 字节），可能是登录已失效。请重新登录教务系统后再点击导入。'
+            );
+            return;
+        }
+
+        // 2. 用户选择学期（默认第一项，即最新学期）
+        const labels = semesters.map(function (s) { return s.label; });
+        const picked = await selectFromList('选择学期', labels, 0);
+        if (picked < 0 || picked >= semesters.length) {
+            toast('导入已取消');
+            return;
+        }
+        const semester = semesters[picked];
+        const kbjcmsid = parseKbjcmsid(listDoc);
+
+        // 3. 请求所选学期的课表（请求体与浏览器抓包一致，经隐藏表单+iframe 提交）
+        toast('正在获取 ' + semester.label + ' 课表...');
+        const body = 'cj0701id=&zc=&demo=&xnxq01id=' + encodeURIComponent(semester.value) +
+            '&sfFD=1&wkbkc=1&kbjcmsid=' + encodeURIComponent(kbjcmsid);
+        let tableDoc = null;
+        const frameDoc = await submitViaHiddenForm(listUrl, body);
+        if (frameDoc && frameDoc.getElementById('timetable')) tableDoc = frameDoc;
+
+        if (!tableDoc) {
+            await alertUser(
+                '未获取到课表数据',
+                '请确认已登录教务系统后重试；如多次失败，请重新登录后再试或反馈给维护者。'
+            );
+            return;
+        }
+
+        // 4. 解析与合并（依据真实页面结构校准的解析规则）
+        toast('正在解析课表...');
+        const rawCourses = parseTimetable(tableDoc);
+        if (rawCourses.length === 0) {
+            await alertUser(
+                '未解析到课程',
+                semester.label + ' 的课表页面已获取，但表格中没有课程内容——该学期可能暂未发布课表数据。'
+            );
+            return;
+        }
+
+        // 5. 课表配置（含学期开始日期，可跳过）
+        const configSaved = await saveCourseConfig(rawCourses);
+        if (!configSaved) return;
+
+        // 6. 课程数据（核心）
+        const courses = mergeAndDistinctCourses(convertCourses(rawCourses));
+        const saved = await saveCourses(courses);
+        if (!saved) return;
+
+        // 7. 预设作息时间段（失败不阻塞导入结果）
+        await importPresetTimeSlots();
+
+        toast('导入成功：' + semester.label + ' 共 ' + courses.length + ' 条课程时段');
+        if (window.shiguangBridge && typeof window.shiguangBridge.notifyTaskCompletion === 'function') {
+            window.shiguangBridge.notifyTaskCompletion();
+        }
+    } catch (error) {
+        console.error('BTBU import failed:', error);
+        await alertUser('导入失败', error && error.message ? error.message : String(error));
+    }
+}
+
+// 启动导入流程
+runImportFlow();