Merge pull request #117 from lc6464/main

新增对仲恺农业工程学院强智教务本人学期理论课表的导入适配

index/root_index.yaml

@@ -16,13 +16,13 @@ schools:
   - id: "chaoxing_jiaowu"
     name: "超星教务系统-通用教务"
     initial: "C"
-    resource_folder: "chaoxing_jiaowu"  
+    resource_folder: "chaoxing_jiaowu"
 
   - id: "qingguo_jiaowu"
     name: "青果教务-通用教务"
     initial: "Q"
-    resource_folder: "qingguo_jiaowu"    
-  
+    resource_folder: "qingguo_jiaowu"
+
   - id: "CQU"
     name: "重庆大学"
     initial: "C"
@@ -31,18 +31,18 @@ schools:
   - id: "CUST"
     name: "长春理工大学"
     initial: "C"
-    resource_folder: "CUST" 
+    resource_folder: "CUST"
 
   - id: "SHZQ"
     name: "上海中侨职业技术大学"
     initial: "S"
-    resource_folder: "SHZQ"  
-    
+    resource_folder: "SHZQ"
+
   - id: "HNZY"
     name: "河南职业技术学院"
     initial: "H"
     resource_folder: "HNZY"
-    
+
   - id: "JYVTC"
     name: "济源职业技术学院"
     initial: "J"
@@ -61,28 +61,28 @@ schools:
   - id: "TARU"
     name: "塔里木大学"
     initial: "T"
-    resource_folder: "TARU"      
+    resource_folder: "TARU"
 
   - id: "MMPT"
     name: "茂名职业技术学院"
     initial: "M"
-    resource_folder: "MMPT"  
+    resource_folder: "MMPT"
 
   - id: "SXGCXY"
     name: "山西工程职业学院"
     initial: "S"
-    resource_folder: "SXGCXY"  
+    resource_folder: "SXGCXY"
 
   - id: "XAWL"
     name: "西安文理学院"
     initial: "X"
-    resource_folder: "XAWL"  
+    resource_folder: "XAWL"
 
   - id: "HNVCC"
     name: "湖南商务职业技术学院"
     initial: "H"
-    resource_folder: "HNVCC"    
-  
+    resource_folder: "HNVCC"
+
   - id: "IMUT"
     name: "内蒙古工业大学"
     initial: "N"
@@ -106,12 +106,12 @@ schools:
   - id: "JXUST"
     name: "江西理工大学"
     initial: "J"
-    resource_folder: "JXUST"  
+    resource_folder: "JXUST"
 
   - id: "GZST"
     name: "广州松田职业学院"
     initial: "G"
-    resource_folder: "GZST"      
+    resource_folder: "GZST"
 
   - id: "FJCPC"
     name: "福建船政交通职业学院"
@@ -132,7 +132,7 @@ schools:
     name: "东北大学"
     initial: "D"
     resource_folder: "NEU"
-  
+
   - id: "NJNU"
     name: "南京师范大学"
     initial: "N"
@@ -141,17 +141,17 @@ schools:
   - id: "XMCU"
     name: "厦门城市职业学院"
     initial: "X"
-    resource_folder: "XMCU"  
+    resource_folder: "XMCU"
 
   - id: "HBLGXY"
     name: "淮北理工学院"
     initial: "H"
-    resource_folder: "HBLGXY"  
+    resource_folder: "HBLGXY"
 
   - id: "XJIE"
     name: "新疆工程学院"
     initial: "X"
-    resource_folder: "XJIE" 
+    resource_folder: "XJIE"
 
   - id: "GDPU"
     name: "广东药科大学"
@@ -186,7 +186,7 @@ schools:
   - id: "CQRK"
     name: "重庆人文科技学院"
     initial: "C"
-    resource_folder: "CQRK"    
+    resource_folder: "CQRK"
 
   - id: "WBU"
     name: "武汉商学院"
@@ -221,4 +221,9 @@ schools:
   - id: "CUP"
     name: "中国石油大学(北京)"
     initial: "Z"
-    resource_folder: "CUP"
+    resource_folder: "CUP"
+
+  - id: "ZHKU"
+    name: "仲恺农业工程学院"
+    initial: "Z"
+    resource_folder: "ZHKU"

resources/ZHKU/adapters.yaml

@@ -0,0 +1,9 @@
+# resources/ZHKU/adapters.yaml
+adapters:
+  - adapter_id: "ZHKU_00"
+    adapter_name: "强智教务 - 学期理论课表"
+    category: "BACHELOR_AND_ASSOCIATE"
+    asset_js_path: "zhku_lc6464.js"
+    import_url: "https://edu-admin.zhku.edu.cn/"
+    maintainer: "lc6464"
+    description: "登录教务系统后在左侧找到“培养管理”->“我的课表”->“学期理论课表”，选择学期后点击右下角“执行导入”即可。\n学期理论课表默认为当前学期，若导入本学期课表则无需修改。\n目前仅支持导入“学期理论课表”内任意学期的课表，暂不支持导入其它类型的课表。"

resources/ZHKU/zhku_lc6464.js

@@ -0,0 +1,486 @@
+// 仲恺农业工程学院拾光课程表适配脚本
+// https://edu-admin.zhku.edu.cn/
+// 教务平台：强智教务
+// 适配开发者：lc6464
+
+const PRESET_TIME_CONFIG = {
+	campuses: {
+		haizhu: {
+			startTimes: {
+				morning: "08:00",
+				noon: "11:30",
+				afternoon: "14:30",
+				evening: "19:30"
+			}
+		},
+		baiyun: {
+			startTimes: {
+				morning: "08:40",
+				noon: "12:20",
+				afternoon: "13:30",
+				evening: "19:00"
+			}
+		}
+	},
+	common: {
+		sectionCounts: {
+			morning: 4,
+			noon: 1,
+			afternoon: 4,
+			evening: 3
+		},
+		durations: {
+			classMinutes: 40,
+			shortBreakMinutes: 10,
+			longBreakMinutes: 20
+		},
+		longBreakAfter: {
+			morning: 2,
+			noon: 0,    // 午间课程无大课间
+			afternoon: 2,
+			evening: 0  // 晚间课程无大课间
+		}
+	}
+};
+
+const CAMPUS_OPTIONS = [
+	{ id: "haizhu", label: "海珠校区" },
+	{ id: "baiyun", label: "白云校区" }
+];
+
+// 统一做文本清洗，避免 DOM 中换行与多空格干扰匹配
+function cleanText(value) {
+	return (value ?? "").replace(/\s+/g, " ").trim();
+}
+
+// HH:mm -> 当天分钟数
+function parseTimeToMinutes(hhmm) {
+	const [h, m] = hhmm.split(":").map(Number);
+	return h * 60 + m;
+}
+
+// 当天分钟数 -> HH:mm
+function formatMinutesToTime(totalMinutes) {
+	const h = Math.floor(totalMinutes / 60);
+	const m = totalMinutes % 60;
+	return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}`;
+}
+
+// 将“2026年03月09”这类中文日期转换为“2026-03-09”
+function normalizeCnDateToIso(cnDateText) {
+	const match = (cnDateText ?? "").match(/(\d{4})年(\d{1,2})月(\d{1,2})/);
+	if (match == null) {
+		throw new Error(`无法解析日期：${cnDateText}`);
+	}
+
+	// 这里使用 Number 而不是 parseInt
+	// 输入来自正则捕获组，已是纯数字，不需要 parseInt 的截断语义
+	const y = Number(match[1]);
+	const m = Number(match[2]);
+	const d = Number(match[3]);
+
+	return `${String(y).padStart(4, "0")}-${String(m).padStart(2, "0")}-${String(d).padStart(2, "0")}`;
+}
+
+// 通过首页时间模式标签识别校区
+// 规则：name="kbjcmsid" 的 li 中，带 layui-this 的若是第一个则海珠，第二个则白云
+async function detectCampusFromMainPage() {
+	const url = "https://edu-admin.zhku.edu.cn/jsxsd/framework/xsMain_new.htmlx";
+	const response = await fetch(url, {
+		method: "GET",
+		credentials: "include"
+	});
+
+	if (!response.ok) {
+		throw new Error(`获取首页时间模式失败：HTTP ${response.status}`);
+	}
+
+	const html = await response.text();
+	const parser = new DOMParser();
+	const doc = parser.parseFromString(html, "text/html");
+	const nodes = Array.from(doc.querySelectorAll('li[name="kbjcmsid"]'));
+
+	if (nodes.length < 2) {
+		return null;
+	}
+
+	const activeIndex = nodes.findIndex((node) => {
+		return node.classList.contains("layui-this");
+	});
+
+	if (activeIndex === 0) {
+		return "haizhu";
+	}
+
+	if (activeIndex === 1) {
+		return "baiyun";
+	}
+
+	// 兜底：若索引异常，按文本再次判断
+	const activeNode = activeIndex >= 0 ? nodes[activeIndex] : null;
+	const activeText = cleanText(activeNode?.textContent ?? "");
+	if (activeText.includes("白云")) {
+		return "baiyun";
+	}
+	if (activeText.includes("默认")) {
+		return "haizhu";
+	}
+
+	return null;
+}
+
+// 获取最终校区
+// 先尝试自动识别，识别失败再让用户选择
+async function chooseCampus() {
+	// 按 xsMain_new.htmlx 的时间模式标签判断
+	try {
+		const campusFromMain = await detectCampusFromMainPage();
+		if (campusFromMain != null) {
+			console.log("通过首页时间模式识别到校区：", campusFromMain);
+			return campusFromMain;
+		}
+	} catch (error) {
+		console.warn("通过首页时间模式识别校区失败，将回退到页面文本识别：", error);
+	}
+
+	const labels = CAMPUS_OPTIONS.map((item) => item.label);
+	const defaultIndex = 1; // 默认白云校区
+
+	const selectedIndex = await window.AndroidBridgePromise.showSingleSelection(
+		"请选择校区",
+		JSON.stringify(labels),
+		defaultIndex
+	);
+
+	if (selectedIndex == null || selectedIndex < 0 || selectedIndex >= CAMPUS_OPTIONS.length) {
+		return "baiyun";
+	}
+	return CAMPUS_OPTIONS[selectedIndex].id;
+}
+
+// 按规则动态生成节次时间
+// 这样后续学校调整作息时，只需要改 PRESET_TIME_CONFIG
+function buildPresetTimeSlots(campusId) {
+	const campus = PRESET_TIME_CONFIG.campuses[campusId] ?? PRESET_TIME_CONFIG.campuses.baiyun;
+	const common = PRESET_TIME_CONFIG.common;
+
+	const segments = ["morning", "noon", "afternoon", "evening"];
+	const slots = [];
+	let sectionNumber = 1;
+
+	for (const segment of segments) {
+		// 每个时段从配置中的起始时间开始滚动推导
+		let cursor = parseTimeToMinutes(campus.startTimes[segment]);
+		const count = common.sectionCounts[segment];
+		const longBreakAfter = common.longBreakAfter[segment] ?? 0;
+
+		for (let i = 1; i <= count; i += 1) {
+			const start = cursor;
+			const end = start + common.durations.classMinutes;
+
+			slots.push({
+				number: sectionNumber,
+				startTime: formatMinutesToTime(start),
+				endTime: formatMinutesToTime(end)
+			});
+			sectionNumber += 1;
+
+			cursor = end;
+			if (i < count) {
+				// 当 longBreakAfter 为 0 时，该时段不会触发大课间
+				const longBreakApplies = longBreakAfter > 0 && i === longBreakAfter;
+				cursor += longBreakApplies
+					? common.durations.longBreakMinutes
+					: common.durations.shortBreakMinutes;
+			}
+		}
+	}
+
+	return slots;
+}
+
+// 解析周次与节次
+// 示例："3-4,6-8(周)[01-02节]"、"1-16(单周)[03-04节]"
+function parseWeeksAndSections(rawText) {
+	const text = cleanText(rawText);
+	const match = text.match(/^(.*?)\(([^)]*周)\)\[(.*?)节\]$/);
+	if (match == null) {
+		throw new Error(`无法解析课程时间：${text}`);
+	}
+
+	const weeksPart = match[1];
+	const weekFlag = match[2];
+	const sectionsPart = match[3];
+
+	// 先把周次范围展开成完整数组
+	const weeks = [];
+	const weekRanges = weeksPart.match(/\d+(?:-\d+)?/g) ?? [];
+	for (const rangeText of weekRanges) {
+		if (rangeText.includes("-")) {
+			const [start, end] = rangeText.split("-").map(Number);
+			for (let w = start; w <= end; w += 1) {
+				weeks.push(w);
+			}
+		} else {
+			weeks.push(Number(rangeText));
+		}
+	}
+
+	// 去重并排序后，再根据单双周标记过滤
+	let normalizedWeeks = [...new Set(weeks)].sort((a, b) => a - b);
+	if (weekFlag.includes("单")) {
+		normalizedWeeks = normalizedWeeks.filter((w) => w % 2 === 1);
+	}
+	if (weekFlag.includes("双")) {
+		normalizedWeeks = normalizedWeeks.filter((w) => w % 2 === 0);
+	}
+
+	const sections = (sectionsPart.match(/\d+/g) ?? []).map(Number).sort((a, b) => a - b);
+	if (sections.length === 0) {
+		throw new Error(`无法解析节次：${text}`);
+	}
+
+	return {
+		weeks: normalizedWeeks,
+		startSection: sections[0],
+		endSection: sections[sections.length - 1]
+	};
+}
+
+// 从当前位置向前查找满足条件的 font 节点
+function findPreviousFont(fonts, startIndex, predicate) {
+	for (let i = startIndex - 1; i >= 0; i -= 1) {
+		if (predicate(fonts[i])) {
+			return fonts[i];
+		}
+	}
+	return null;
+}
+
+// 从当前位置向后查找满足条件的 font 节点
+function findNextFont(fonts, startIndex, predicate) {
+	for (let i = startIndex + 1; i < fonts.length; i += 1) {
+		if (predicate(fonts[i])) {
+			return fonts[i];
+		}
+	}
+	return null;
+}
+
+// 教务页面会用 display:none 隐藏辅助节点，这里只保留可见信息
+function isVisibleFont(font) {
+	const styleText = (font.getAttribute("style") ?? "").replace(/\s+/g, "").toLowerCase();
+	return !styleText.includes("display:none");
+}
+
+// 从课表 iframe 中解析课程
+// 输出为扁平数组，不做同名课程合并
+function parseCoursesFromIframeDocument(iframeDoc) {
+	const courses = [];
+	const cells = iframeDoc.querySelectorAll(".kbcontent[id$='2']");
+
+	cells.forEach((cell) => {
+		// id 形如 xxxxx-<day>-2，day 为 1~7
+		const idParts = (cell.id ?? "").split("-");
+		const day = Number(idParts[idParts.length - 2]);
+		if (!Number.isInteger(day) || day < 1 || day > 7) {
+			return;
+		}
+
+		// 同一个 cell 里可能存在多个课程，因此要逐个锚点拆解
+		const fonts = Array.from(cell.querySelectorAll("font"));
+
+		fonts.forEach((font, idx) => {
+			const title = cleanText(font.getAttribute("title") ?? "");
+			if (!title.includes("周次")) {
+				return;
+			}
+			if (!isVisibleFont(font)) {
+				return;
+			}
+
+			const weekText = cleanText(font.textContent);
+			if (weekText === "") {
+				return;
+			}
+
+			// 以“周次(节次)”行为锚点，向前找教师和课程名，向后找教室
+			const teacherFont = findPreviousFont(fonts, idx, (candidate) => {
+				const candidateTitle = cleanText(candidate.getAttribute("title") ?? "");
+				return candidateTitle.includes("教师") && isVisibleFont(candidate);
+			});
+
+			const teacherIndex = teacherFont == null ? idx : fonts.indexOf(teacherFont);
+			const nameFont = findPreviousFont(fonts, teacherIndex, (candidate) => {
+				const candidateTitle = cleanText(candidate.getAttribute("title") ?? "");
+				const candidateNameAttr = cleanText(candidate.getAttribute("name") ?? "");
+				const text = cleanText(candidate.textContent);
+				return (
+					candidateTitle === "" &&
+					candidateNameAttr === "" &&
+					isVisibleFont(candidate) &&
+					text !== ""
+				);
+			});
+
+			const locationFont = findNextFont(fonts, idx, (candidate) => {
+				const candidateTitle = cleanText(candidate.getAttribute("title") ?? "");
+				return candidateTitle.includes("教室") && isVisibleFont(candidate);
+			});
+
+			const courseName = cleanText(nameFont?.textContent ?? "");
+			const teacher = cleanText(teacherFont?.textContent ?? "");
+			let position = cleanText(locationFont?.textContent ?? "");
+
+			// 移除教室中的“(白)”“（白云）”“(白)实”等字样，该信息对于学生而言无意义
+			position = position.replace(/[(（]白云?[)）]实?/g, "");
+
+			// 过滤空课程名、网络课和不存在的虚拟位置
+			if (courseName === ""
+				|| position.includes("网络学时，不排时间教室")
+				|| position.includes("经典研读")
+				|| /^（?网络课）?/.test(courseName)) {
+				return;
+			}
+
+			const parsed = parseWeeksAndSections(weekText);
+
+			// 查重
+			const existingCourse = courses.find((c) => c.name === courseName
+				&& c.teacher === teacher
+				&& c.position === position
+				&& c.day === day
+				&& c.startSection === parsed.startSection
+				&& c.endSection === parsed.endSection
+				&& JSON.stringify(c.weeks) === JSON.stringify(parsed.weeks));
+
+			if (existingCourse != null) {
+				return;
+			}
+
+			courses.push({
+				name: courseName,
+				teacher,
+				position,
+				day,
+				startSection: parsed.startSection,
+				endSection: parsed.endSection,
+				weeks: parsed.weeks
+			});
+		});
+	});
+
+	return courses;
+}
+
+// 获取课表 iframe 的文档对象
+function getScheduleIframeDocument() {
+	const iframe = document.querySelector("iframe[src*='/jsxsd/xskb/xskb_list.do']");
+	if (iframe == null || iframe.contentDocument == null) {
+		throw new Error("未找到课表 iframe，或 iframe 内容尚未加载完成");
+	}
+	return iframe.contentDocument;
+}
+
+// 获取当前学年学期 ID，例如 2025-2026-2
+function getSemesterId(iframeDoc) {
+	const select = iframeDoc.querySelector("#xnxq01id");
+	if (select == null) {
+		throw new Error("未找到学年学期选择框 #xnxq01id");
+	}
+
+	// 优先读取 option[selected]，读取失败再回退到 select.value
+	const selectedOption = select.querySelector("option[selected]");
+	return cleanText(selectedOption?.value ?? select.value);
+}
+
+// 拉取教学周历并提取开学日期与总周数
+async function fetchSemesterCalendarInfo(semesterId) {
+	const url = `https://edu-admin.zhku.edu.cn/jsxsd/jxzl/jxzl_query?xnxq01id=${encodeURIComponent(semesterId)}`;
+	const response = await fetch(url, {
+		method: "GET",
+		credentials: "include"
+	});
+	if (!response.ok) {
+		throw new Error(`获取教学周历失败：HTTP ${response.status}`);
+	}
+
+	const html = await response.text();
+	const parser = new DOMParser();
+	const doc = parser.parseFromString(html, "text/html");
+	const rows = Array.from(doc.querySelectorAll("#kbtable tr"));
+
+	// 周次行特征：第一列是纯数字
+	const weekRows = rows.filter((row) => {
+		const firstCell = row.querySelector("td");
+		return /^\d+$/.test(cleanText(firstCell?.textContent ?? ""));
+	});
+	if (weekRows.length === 0) {
+		throw new Error("教学周历中未找到周次行");
+	}
+
+	// 学期起始日按“第一周周一”计算
+	const firstWeekRow = weekRows[0];
+	const mondayCell = firstWeekRow.querySelectorAll("td")[1];
+	const mondayTitle = mondayCell?.getAttribute("title") ?? "";
+	if (mondayTitle === "") {
+		throw new Error("教学周历中未找到第一周周一日期");
+	}
+
+	return {
+		semesterStartDate: normalizeCnDateToIso(mondayTitle),
+		semesterTotalWeeks: weekRows.length
+	};
+}
+
+// 主流程：读取课表 -> 选择校区 -> 拉周历 -> 生成节次 -> 调桥接导入
+async function importSchedule() {
+	AndroidBridge.showToast("开始读取教务课表……");
+
+	// 读取 iframe 并获取当前学年学期 ID
+	const iframeDoc = getScheduleIframeDocument();
+	const semesterId = getSemesterId(iframeDoc);
+
+	// 解析课程信息
+	const courses = parseCoursesFromIframeDocument(iframeDoc);
+	if (courses.length === 0) {
+		throw new Error("未解析到任何课程，请确认当前课表页面已加载完成");
+	}
+
+	// 拉取周历信息，获取开学日期与总周数
+	const calendarInfo = await fetchSemesterCalendarInfo(semesterId);
+
+	// 选择校区并生成预设上课时间配置
+	const campusId = await chooseCampus();
+	const campusLabel = CAMPUS_OPTIONS.find((item) => item.id === campusId)?.label ?? "白云校区";
+	const presetTimeSlots = buildPresetTimeSlots(campusId);
+
+	// 构建上课预设时间配置
+	const config = {
+		semesterStartDate: calendarInfo.semesterStartDate,
+		semesterTotalWeeks: calendarInfo.semesterTotalWeeks,
+		defaultClassDuration: PRESET_TIME_CONFIG.common.durations.classMinutes,
+		defaultBreakDuration: PRESET_TIME_CONFIG.common.durations.shortBreakMinutes,
+		// 每周按周一起始计算，因此固定为 1
+		firstDayOfWeek: 1
+	};
+
+	// 通知课表软件进行导入，传递课程与预设时间配置
+	await window.AndroidBridgePromise.saveImportedCourses(JSON.stringify(courses));
+	await window.AndroidBridgePromise.savePresetTimeSlots(JSON.stringify(presetTimeSlots));
+	await window.AndroidBridgePromise.saveCourseConfig(JSON.stringify(config));
+
+	AndroidBridge.showToast(`导入成功：${campusLabel}，课程 ${courses.length} 条`);
+	AndroidBridge.notifyTaskCompletion();
+}
+
+// 自执行入口
+(async () => {
+	try {
+		await importSchedule();
+	} catch (error) {
+		console.error("课表导入失败：", error);
+		// 失败原因直接提示给用户，便于在移动端快速定位问题
+		AndroidBridge.showToast(`导入失败：${error.message}`);
+	}
+})();