add: 泉州职业技术大学强智教务适配 (#775)

index/root_index.yaml

@@ -1177,3 +1177,9 @@ schools:
     name: "南京信息职业技术学院"
     initial: "N"
     resource_folder: "NJCIT"
+
+  - id: "QVTU"
+    name: "泉州职业技术大学"
+    initial: "Q"
+    resource_folder: "QVTU"
+    

resources/QVTU/adapters.yaml

@@ -0,0 +1,9 @@
+# resources/QVTU/adapters.yaml
+adapters:
+  - adapter_id: "QVTU"
+    adapter_name: "泉州职业技术大学强智教务"
+    category: "BACHELOR_AND_ASSOCIATE"
+    asset_js_path: "qvtu.js"
+    import_url: "https://jw.qvtu.edu.cn/jsxsd/"
+    maintainer: "suiren0219"
+    description: "泉州职业技术大学强智教务。登录教务系统后直接导入即可，可选择学期；开学日期与总周数取自教学周历。有问题请通过 GitHub 联系开发者。"

resources/QVTU/qvtu.js

@@ -0,0 +1,379 @@
+// ============================================================
+// 泉州职业技术大学（jw.qvtu.edu.cn/jsxsd，强智教务）
+// 拾光课程表适配脚本
+//
+// 参照官方强智适配案例（YSSDUFE_01，见 shiguangschedule Wiki
+// "常见教务系统适配案例参考"）编写：
+//   1. 教学周历 jxzl_query 提供学期列表 / 开学日期 / 总周数；
+//   2. 学期理论课表 xskb_list.do 提供课程数据（#kbtable / div.kbcontent 官方结构）。
+// 若站点周历页结构与案例不同，自动降级：跳过选学期、不提交开学日期，
+// 任何情况都不会阻塞导入。
+// 流程遵循官方开发文档约定：学期配置 → 课程 → 作息时间（可选，失败不阻止完成）；
+// notifyTaskCompletion 只在流程成功后调用。
+// 出现问题请联系开发者或提交 PR 更改。
+// ============================================================
+
+// 整体包一层 IIFE：本脚本可能被反复注入同一页面（测试器每次点击都会
+// 重新注入且不刷新页面），顶层 const/function 会与上一次注入冲突
+// （Identifier has already been declared），也会覆盖教务页面自己的全局函数。
+(function () {
+
+// ================= 配置 =================
+
+// 作息时间：来自教务"大节"时段，小节按"45 分钟上课 + 15 分钟休息"拆分。
+// 注：站点里"第七大节(13,14小节) 12:00-13:59"与晚间节次时间重叠，
+//     会被拾光"时间段不可重叠"校验拒绝，故不提供 13、14 节时间（当前无课程使用）。
+const QVTU_TIME_SLOTS = [
+  { number: 1, startTime: "08:10", endTime: "08:55" },
+  { number: 2, startTime: "09:10", endTime: "09:55" },
+  { number: 3, startTime: "10:10", endTime: "10:55" },
+  { number: 4, startTime: "11:10", endTime: "11:55" },
+  { number: 5, startTime: "14:10", endTime: "14:55" },
+  { number: 6, startTime: "15:10", endTime: "15:55" },
+  { number: 7, startTime: "16:10", endTime: "16:55" },
+  { number: 8, startTime: "17:10", endTime: "17:55" },
+  { number: 9, startTime: "19:10", endTime: "19:55" },
+  { number: 10, startTime: "20:10", endTime: "20:55" },
+  { number: 11, startTime: "21:10", endTime: "21:55" },
+  { number: 12, startTime: "22:10", endTime: "22:55" }
+];
+
+// 教务系统地址与接口
+const QVTU_ORIGIN_CHECK = /jw\.qvtu\.edu\.cn$/i; // 只在教务站点上运行
+const QVTU_JXZL_URL = "/jsxsd/jxzl/jxzl_query"; // 教学周历（学期列表 + 开学日期 + 总周数）
+const QVTU_XSKB_URL = "/jsxsd/xskb/xskb_list.do"; // 学期理论课表
+
+const QVTU_REQUEST_TIMEOUT = 8000; // 单请求超时（毫秒）
+
+// ================= 工具函数 =================
+
+function toast(message) {
+  window.shiguangBridge.showToast(message);
+}
+
+// 生命周期结束信号：只在流程成功后调用（官方约定）
+function notifyDone() {
+  window.shiguangBridge.notifyTaskCompletion();
+}
+
+// 带超时保护的 fetch（门户切换页面时站点脚本会中断进行中的请求，失败重试一次）
+async function fetchText(url, options, tag) {
+  const opts = options || { method: "GET", credentials: "include" };
+  let lastErr = null;
+  for (let attempt = 1; attempt <= 2; attempt++) {
+    try {
+      const p = fetch(url, opts).then(r => r.text());
+      if (typeof setTimeout !== "function") return await p;
+      return await Promise.race([p, new Promise((_, reject) => {
+        setTimeout(() => reject(new Error("请求超时：" + tag)), QVTU_REQUEST_TIMEOUT);
+      })]);
+    } catch (e) {
+      lastErr = e;
+    }
+  }
+  throw new Error("请求失败（" + tag + "）：" + (lastErr && lastErr.message ? lastErr.message : "网络错误"));
+}
+
+// 解析 HTML 文本为文档对象
+function parseHtml(html) {
+  return new DOMParser().parseFromString(String(html || ""), "text/html");
+}
+
+// 只认可解析得了的课表（登录页/错误页不含这些标记）。
+// 不同强智版本课表格子用 class="kbcontent" 或 class="kb_table"，本站另有 <p title=...> 格式。
+function hasCourse(text) {
+  return /课程名称：|kbcontent|kb_table/.test(String(text || ""));
+}
+
+// ================= 核心解析逻辑（一）：教学周历 =================
+
+// GET 周历页：解析学期下拉框，以当前选中学期为原点上下各取 3 个。
+// 站点若无 xnxq01id 下拉框则返回空列表（流程自动跳过选学期）。
+async function fetchSemesterList() {
+  const doc = parseHtml(await fetchText(location.origin + QVTU_JXZL_URL, null, "教学周历页"));
+  const select = doc.getElementById("xnxq01id");
+  if (!select) return { list: [], defaultIndex: -1 };
+
+  const all = Array.from(select.querySelectorAll("option")).map(opt => ({
+    value: opt.value,
+    label: opt.textContent.trim(),
+    selected: opt.hasAttribute("selected")
+  }));
+  let idx = all.findIndex(o => o.selected);
+  if (idx === -1) idx = 0;
+  const start = Math.max(0, idx - 3);
+  return {
+    list: all.slice(start, Math.min(all.length, idx + 4)),
+    defaultIndex: idx - start
+  };
+}
+
+// POST 周历页：解析指定学期的开学日期（首行 td[title]）与总周数（首列最大整数）。
+// 结构不符时返回 { startDate: null, totalWeeks: null }，不阻塞流程。
+async function fetchSemesterInfo(semesterId) {
+  const html = await fetchText(location.origin + QVTU_JXZL_URL, {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: "xnxq01id=" + encodeURIComponent(semesterId),
+    credentials: "include"
+  }, "教学周历详情");
+  const doc = parseHtml(html);
+  const timetable = doc.getElementById("kbtable");
+  if (!timetable) return { startDate: null, totalWeeks: null };
+
+  const rows = Array.from(timetable.querySelectorAll("tr")).filter(r => r.querySelector("td"));
+  if (!rows.length) return { startDate: null, totalWeeks: null };
+
+  // 开学日期：第一行首个带 title 的 td，如 "2025年9月1日"（兼容不补零）
+  const title = (rows[0].querySelector("td[title]") || {}).getAttribute
+    ? rows[0].querySelector("td[title]").getAttribute("title") : "";
+  const m = String(title).match(/^(\d{4})年(\d{1,2})月(\d{1,2})日$/);
+  const pad = n => (n < 10 ? "0" + n : "" + n);
+  const startDate = m ? m[1] + "-" + pad(+m[2]) + "-" + pad(+m[3]) : null;
+
+  // 总周数：所有行首列能解析为整数的最大值
+  let totalWeeks = null;
+  for (const row of rows) {
+    const td = row.querySelector("td");
+    if (!td) continue;
+    const n = parseInt(td.textContent.trim(), 10);
+    if (!isNaN(n) && n > 0 && (totalWeeks === null || n > totalWeeks)) totalWeeks = n;
+  }
+  return { startDate, totalWeeks };
+}
+
+// ================= 核心解析逻辑（二）：课程 =================
+
+// "第3周"、"第1-16周"、"第1,3,5-8周"、"第1-15周(单周)" → [3] / [1..16] / 奇数周…
+function parseWeeks(text) {
+  let t = String(text || "").replace(/\s/g, "");
+  const parity = t.indexOf("单周") >= 0 ? 1 : t.indexOf("双周") >= 0 ? 2 : 0;
+  t = t.replace(/[（(][^）)]*[）)]/g, "");
+  const set = {};
+  const rangeRe = /(\d+)\s*[-–—~]\s*(\d+)/g;
+  let m;
+  while ((m = rangeRe.exec(t)) !== null) {
+    for (let w = Math.min(+m[1], +m[2]); w <= Math.max(+m[1], +m[2]); w++) set[w] = 1;
+  }
+  for (const s of t.replace(rangeRe, " ").match(/\d+/g) || []) set[+s] = 1;
+  const weeks = [];
+  for (const k in set) {
+    const n = +k;
+    if (n >= 1 && n <= 30 && !(parity === 1 && n % 2 === 0) && !(parity === 2 && n % 2 === 1)) weeks.push(n);
+  }
+  return weeks.sort((a, b) => a - b);
+}
+
+// 把解析结果合并进总表（同名同天同节次区间同地点 → 合并周次）
+function mergeCourse(map, c) {
+  if (!c.name || !c.day || !c.weeks.length || !c.startSection) return;
+  const key = [c.name, c.day, c.startSection + "-" + c.endSection, c.position].join("|");
+  if (!map[key]) {
+    map[key] = c;
+  } else {
+    for (const w of c.weeks) if (!map[key].weeks.includes(w)) map[key].weeks.push(w);
+    map[key].weeks.sort((a, b) => a - b);
+  }
+}
+
+// 解析路径 A：官方案例的 DOM 结构（#kbtable 内 div.kbcontent，多课程以长横线分隔）
+function parseKbcontent(doc) {
+  const timetable = doc.getElementById("kbtable");
+  if (!timetable) return [];
+  const map = {};
+  const rows = Array.from(timetable.querySelectorAll("tr")).filter(r => r.querySelector("td"));
+  rows.forEach(row => {
+    const cells = row.querySelectorAll("td");
+    cells.forEach((cell, dayIndex) => {
+      const day = dayIndex + 1;
+      cell.querySelectorAll("div.kbcontent").forEach(div => {
+        const raw = div.innerHTML.trim();
+        if (!raw || raw === "&nbsp;" || div.innerText.trim().length < 2) return;
+        raw.split(/-{10,}/).forEach(block => {
+          if (!block.trim()) return;
+          const box = document.createElement("div");
+          box.innerHTML = block;
+
+          let name = "";
+          for (const node of box.childNodes) {
+            if (node.nodeType === 3 && node.textContent.trim() !== "") { name = node.textContent.trim(); break; }
+          }
+          const teacher = (box.querySelector('font[title="老师"], font[title="教师"]') || {}).innerText || "";
+          const position = (box.querySelector('font[title="教室"]') || {}).innerText || "未知地点";
+          const weekStr = ((box.querySelector('font[title="周次(节次)"]') || {}).innerText) || "";
+
+          let startSection = 0, endSection = 0;
+          const sec = weekStr.match(/\[(.*?)节\]/);
+          if (sec && sec[1]) {
+            const nums = sec[1].split("-").map(Number).filter(n => !isNaN(n));
+            if (nums.length) { startSection = nums[0]; endSection = nums[nums.length - 1]; }
+          }
+          if (name && startSection > 0) {
+            mergeCourse(map, {
+              name, teacher: teacher.replace(/任课教师[:：]/, "").trim() || "未知教师",
+              position, day, weeks: parseWeeks(weekStr),
+              startSection, endSection
+            });
+          }
+        });
+      });
+    });
+  });
+  return Object.values(map);
+}
+
+// ================= 数据抓取与编排 =================
+
+async function fetchAndParseCourses() {
+  if (!QVTU_ORIGIN_CHECK.test(location.hostname)) {
+    throw new Error("请先在浏览器/WebView 打开教务网站（https://jw.qvtu.edu.cn/jsxsd）并登录，再运行。当前页面：" + location.href);
+  }
+
+  // 1) 学期列表 + 用户选择（站点无学期下拉框时自动跳过，导入当前学期）
+  let semesterId = null;
+  const { list, defaultIndex } = await fetchSemesterList();
+  if (list.length) {
+    const picked = await window.shiguangBridgePromise.showSingleSelection(
+      "选择学期", JSON.stringify(list.map(s => s.label)), defaultIndex
+    );
+    if (picked === null) { toast("已取消导入。"); return null; }
+    semesterId = list[picked].value;
+  }
+
+  // 2) 教学周历 → 开学日期 + 总周数（结构不符则降级为 null）
+  let startDate = null, totalWeeks = null;
+  if (semesterId) {
+    const info = await fetchSemesterInfo(semesterId);
+    startDate = info.startDate;
+    totalWeeks = info.totalWeeks;
+  }
+
+  // 3) 课表：选了学期用 POST 指定学期，否则 GET 当前学期
+  const html = await fetchText(location.origin + QVTU_XSKB_URL, semesterId ? {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: "jx0404id=&cj0701id=&zc=&demo=&xnxq01id=" + encodeURIComponent(semesterId),
+    credentials: "include"
+  } : null, "学期课表页");
+
+  if (!hasCourse(html)) {
+    if (/用户登录|请登录|loginForm|passwd/i.test(String(html))) {
+      throw new Error("教务会话已过期或尚未登录（接口返回登录页）。请重新登录教务系统后运行。");
+    }
+    console.warn("[泉州职业技术大学适配器] 学期课表页返回了意外内容（前 300 字符）：",
+      String(html || "").replace(/\s+/g, " ").slice(0, 300));
+    throw new Error("学期课表页返回了无法识别的内容，请按 F12 打开控制台，把警告信息发给开发者核对。");
+  }
+
+  // 4) 解析（官方案例 DOM 结构）
+  const courses = parseKbcontent(parseHtml(html));
+  if (!courses.length) {
+    throw new Error("教务页面里没有解析到课程。请确认所选学期已有排课，或把错误信息发给我核对。");
+  }
+
+  // 5) 周历未给出总周数时，取课程最大周次兜底
+  if (!totalWeeks) {
+    for (const c of courses) for (const w of c.weeks) if (w > totalWeeks) totalWeeks = w;
+  }
+  return { courses, startDate, totalWeeks };
+}
+
+// ================= 保存步骤（顺序参照官方开发文档） =================
+
+// 保存学期配置（开学日期/总周数来自教学周历，没拿到就不提交/用课程最大周兜底）
+// defaultClassDuration/defaultBreakDuration 与作息表一致（45 分钟一节、小节间休息 15 分钟）
+async function saveCourseConfig(startDate, totalWeeks) {
+  try {
+    const config = {
+      firstDayOfWeek: 1,
+      defaultClassDuration: 45,
+      defaultBreakDuration: 15,
+      semesterTotalWeeks: totalWeeks > 0 ? totalWeeks : 20
+    };
+    if (startDate) config.semesterStartDate = startDate;
+    const ok = await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
+    if (!ok) { toast("学期配置保存失败。"); return false; }
+    return true;
+  } catch (e) {
+    toast("学期配置保存失败：" + e.message);
+    return false;
+  }
+}
+
+// 保存课程数据
+async function saveCourses(courses) {
+  try {
+    const ok = await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(courses));
+    if (!ok) { toast("课程数据保存失败。"); return false; }
+    return true;
+  } catch (e) {
+    toast("课程数据保存失败：" + e.message);
+    return false;
+  }
+}
+
+// 保存作息时间表（官方文档：可选步骤，失败不阻止导入完成）
+async function savePresetTimeSlots() {
+  try {
+    const ok = await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(QVTU_TIME_SLOTS));
+    if (!ok) toast("作息时间保存失败。");
+    return !!ok;
+  } catch (e) {
+    toast("作息时间保存失败：" + e.message);
+    return false;
+  }
+}
+
+// ================= 流程编排 =================
+
+/**
+ * 编排整个课程导入流程（顺序与约定参照官方开发文档）。
+ * 用户取消或关键步骤保存失败时立即结束；作息时间为可选步骤，失败不阻止完成；
+ * notifyTaskCompletion 只在流程成功后调用（官方约定）。
+ */
+async function runImportFlow() {
+  try {
+    // 1. 公告和前置检查
+    const confirmed = await window.shiguangBridgePromise.showAlert(
+      "提示",
+      "请确保已成功登录泉州职业技术大学教务系统。是否开始导入？",
+      "开始"
+    );
+    if (!confirmed) {
+      toast("已取消导入。");
+      return;
+    }
+
+    // 2. 网络请求和数据解析（内部含选学期；取消时返回 null）
+    toast("正在获取学期课表…");
+    const result = await fetchAndParseCourses();
+    if (!result) return;
+    const { courses, startDate, totalWeeks } = result;
+
+    // 3. 保存学期配置
+    if (!await saveCourseConfig(startDate, totalWeeks)) return;
+
+    // 4. 保存课程数据
+    toast("正在保存 " + courses.length + " 条课程安排…");
+    if (!await saveCourses(courses)) return;
+
+    // 5. 导入作息时间表（可选步骤，失败不阻止导入完成）
+    if (!await savePresetTimeSlots()) {
+      toast("提示：作息时间未导入，课程已保存，可在 App 里手动设置或稍后重试。");
+    }
+
+    // 6. 流程成功，发送结束信号
+    toast(`成功导入 ${courses.length} 条课程安排！` +
+      (startDate ? `学期 ${startDate} 起，共 ${totalWeeks} 周。` : "开学日期未能自动获取，可在 App 里手动设置。"));
+    notifyDone();
+  } catch (error) {
+    // 任何一步失败：记录并提示用户，与官方适配一致不向外抛出，也不发送完成信号
+    console.error("[泉州职业技术大学适配器]", error);
+    toast("导入失败：" + (error && error.message ? error.message : error));
+  }
+}
+
+// 启动导入流程
+runImportFlow();
+
+})();