[new] new project

This commit is contained in:
2026-09-20 13:33:09 +08:00
commit ca6a52fb2d
997 changed files with 140250 additions and 0 deletions
@@ -0,0 +1,18 @@
# resources/GDOU/adapters.yaml
adapters:
- adapter_id: "GDOU_01"
adapter_name: "广东海洋大学教务"
category: "BACHELOR_AND_ASSOCIATE"
asset_js_path: "gdou.js"
import_url: "https://jw.gdou.edu.cn/"
maintainer: "Mccurtain"
description: "广东海洋大学教务适配,如有误请提交 issues"
- adapter_id: "GDOUYJ_01"
adapter_name: "广东海洋大学阳江校区教务"
category: "BACHELOR_AND_ASSOCIATE"
asset_js_path: "gdouyj.js"
import_url: "https://jw.gdou.edu.cn/"
maintainer: "Yihe-ng"
description: "广东海洋大学阳江校区教务适配,使用阳江校区教学楼错峰作息时间,如有误请提交issues"
+665
View File
@@ -0,0 +1,665 @@
/**
* 广东海洋大学教务课表导入适配
* @date 2026-08-27
* @author Mccurtain
* @version 2.0
*/
(function () {
// ==================== 常量 ====================
// venues 为整栋楼使用特殊作息的楼名(包含匹配,如 "实验楼" 会命中 "实验楼301"、"网球场(实验楼东面)");
// venuePatterns 为楼名简写正则(如海滨 "实"+房间号 = 实验楼简写,实506-1计算机(2)室);
// outdoorKeywords 为特殊作息的室外场地关键词。
const CAMPUS_CONFIGS = [
{
id: "huguang",
label: "湖光校区",
venues: ["广学楼", "明德楼"],
venuePatterns: [],
outdoorKeywords: []
},
{
id: "haibin",
label: "海滨校区",
venues: ["实验楼"],
venuePatterns: [{ name: "实验楼简写", pattern: /^实\d/ }],
outdoorKeywords: ["球场", "东面", "南面", "西面", "北面"]
}
];
// 全校统一作息时间(1-10 节),未指定特殊作息的教室使用
const TimeSlots = [
{ number: 1, startTime: "08:10", endTime: "08:55" },
{ number: 2, startTime: "09:00", endTime: "09:45" },
{ number: 3, startTime: "10:15", endTime: "11:00" },
{ number: 4, startTime: "11:05", endTime: "11:50" },
{ number: 5, startTime: "14:30", endTime: "15:15" },
{ number: 6, startTime: "15:20", endTime: "16:05" },
{ number: 7, startTime: "16:30", endTime: "17:15" },
{ number: 8, startTime: "17:20", endTime: "18:05" },
{ number: 9, startTime: "19:30", endTime: "20:15" },
{ number: 10, startTime: "20:25", endTime: "21:10" }
];
// 指定楼/室外场地的特殊作息时间块(连堂)
const SPECIAL_TIME_BLOCKS = [
{ startSection: 3, endSection: 4, startTime: "10:05", endTime: "11:35" },
{ startSection: 7, endSection: 8, startTime: "16:25", endTime: "17:50" }
];
// ==================== 解析函数 ====================
/**
* 将周次字符串展开为具体周次数组
* 支持范围(如 1-16周)、单周(如 6周)、单双周(如 1-8周(单))、
* 以及逗号分隔的多种写法混合,全角逗号也会被兼容
*/
function parseWeeks(weekStr) {
if (!weekStr) return [];
const groups = String(weekStr).replace(/,/g, ',').split(',');
const weeks = [];
for (const group of groups) {
const item = group.trim();
// 先尝试匹配 "起-止周",再尝试匹配单个周次
const rangeMatch = item.match(/(\d+)\s*-\s*(\d+)\s*周?/);
const singleMatch = item.match(/^(\d+)\s*周?/);
let start = 0;
let end = 0;
let matched = false;
if (rangeMatch) {
start = Number(rangeMatch[1]);
end = Number(rangeMatch[2]);
matched = true;
} else if (singleMatch) {
start = end = Number(singleMatch[1]);
matched = true;
}
if (matched && start >= 1 && end >= start) {
const isOddOnly = item.includes('(单)');
const isEvenOnly = item.includes('(双)');
for (let w = start; w <= end; w++) {
if (isOddOnly && w % 2 === 0) continue; // 单周:跳过偶数周
if (isEvenOnly && w % 2 !== 0) continue; // 双周:跳过奇数周
weeks.push(w);
}
}
}
return [...new Set(weeks)].sort((a, b) => a - b);
}
/**
* 解析节次字段,如 "1-2"、"3"、"1-2节",得到起止节次
* 格式无法识别或数值不合法时返回 null
*/
function parseSectionRange(sectionStr) {
const text = sectionStr == null ? '' : String(sectionStr);
const match = text.match(/^\s*(?:第)?(\d+)\s*(?:-\s*(\d+))?\s*节?\s*$/);
if (!match) return null;
const startSection = Number(match[1]);
const endSection = Number(match[2] || match[1]);
if (!Number.isInteger(startSection) || !Number.isInteger(endSection) ||
startSection < 1 || endSection < startSection) {
return null;
}
return { startSection, endSection };
}
// 提前公选课课程名
function normalizeCourseName(rawName) {
const name = String(rawName).trim();
if (!name) return name;
const match = name.match(/^[((]([^()()]+)[))]\s*/);
if (!match) return name;
const rest = name.slice(match[0].length);
if (!rest) return name;
return `${rest}(${match[1]})`;
}
/**
* 节次与周次合并去重函数
* @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) : []
}));
// 第一步:按课程、周次排序后合并连续节次,同时剔除完全重复项
list.sort((a, b) =>
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 step1 = [];
let current = list[0];
for (let i = 1; i < list.length; i++) {
const next = list[i];
const isSameCourse =
current.name === next.name &&
current.teacher === next.teacher &&
current.position === next.position &&
current.day === next.day &&
current.weeks.join(',') === next.weeks.join(',');
if (isSameCourse && current.endSection + 1 === next.startSection) {
// 节次紧邻,延长结束节次:1-2 节 + 3-4 节 -> 1-4 节
current.endSection = next.endSection;
} else if (isSameCourse && current.startSection === next.startSection && current.endSection === next.endSection) {
// 完全重复的记录,跳过
continue;
} else {
step1.push(current);
current = next;
}
}
step1.push(current);
// 第二步:按课程、节次排序后合并相同节次的周次
step1.sort((a, b) =>
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 step2 = [];
let cur = step1[0];
for (let i = 1; i < step1.length; i++) {
const nxt = step1[i];
const isSameSection =
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 (isSameSection) {
// 周次取并集:1-8 周 + 9-16 周 -> 1-16 周
cur.weeks = Array.from(new Set([...cur.weeks, ...nxt.weeks])).sort((a, b) => a - b);
} else {
step2.push(cur);
cur = nxt;
}
}
step2.push(cur);
return step2;
}
// ==================== 特殊作息处理 ====================
/**
* 判断位置是否命中特殊场地(指定楼或室外场地),返回命中的类型与关键词
* 楼名与室外关键词取并集,包含任一即可;命中者打标特殊作息
* @returns {{type: 'venue'|'outdoor', key: string}|null}
*/
function matchesSpecialVenue(positionText, campusConfig) {
const venueHit = campusConfig.venues.find(venue => positionText.includes(venue));
if (venueHit) return { type: 'venue', key: venueHit };
const patternHit = (campusConfig.venuePatterns || []).find(p => p.pattern.test(positionText));
if (patternHit) return { type: 'venue', key: patternHit.name };
const outdoorHit = campusConfig.outdoorKeywords.find(keyword => positionText.includes(keyword));
if (outdoorHit) return { type: 'outdoor', key: outdoorHit };
return null;
}
/**
* 判断课程是否命中特殊作息(正向策略)
* 命中指定楼/室外场地的课程,在节次恰为特殊时间块(3-4/7-8 节)时打标特殊时间;
* 其他普通教室不打标,使用 TimeSlots 全校统一作息。
* 返回对象附带 reason 判定原因,供内部诊断与本地验证脚本使用(不写入导出课程)。
*/
function getCustomTime(position, startSection, endSection, campusConfig) {
const positionText = position == null ? '' : String(position);
const hit = matchesSpecialVenue(positionText, campusConfig);
if (!hit) return { marked: false, reason: 'no-block' };
const block = SPECIAL_TIME_BLOCKS.find(
b => b.startSection === startSection && b.endSection === endSection
);
if (block) return { marked: true, startTime: block.startTime, endTime: block.endTime, reason: `special-${hit.type}:${hit.key}` };
return { marked: false, reason: `special-${hit.type}:${hit.key}-no-block` };
}
// ==================== 数据解析 ====================
/**
* 解析正方 v9 课表接口返回的 JSON,提取有效课程
* 数据位于 kbList 字段;课程名/星期/节次/周次缺失或不合法的记录会被跳过,
* 教师、教室允许为空
*/
function parseJsonData(jsonData, campusConfig) {
if (!jsonData || !Array.isArray(jsonData.kbList)) return [];
const courses = [];
for (const raw of jsonData.kbList) {
if (!raw || typeof raw !== 'object') continue;
if (!raw.kcmc || raw.xqj == null || raw.jcs == null || raw.zcd == null) continue;
const weeks = parseWeeks(raw.zcd);
if (weeks.length === 0) continue;
const sectionRange = parseSectionRange(raw.jcs);
if (!sectionRange) continue;
const day = Number(raw.xqj); // 1=周一 ... 7=周日
if (isNaN(day) || day < 1 || day > 7) continue;
// 直接基于原始接口字段 cdmc 构造课程位置
const position = raw.cdmc == null ? '' : String(raw.cdmc).trim();
const course = {
name: normalizeCourseName(raw.kcmc),
teacher: raw.xm == null ? '' : String(raw.xm).trim(),
position,
day,
startSection: sectionRange.startSection,
endSection: sectionRange.endSection,
weeks
};
// 边解析边判断:直接对原始教室字段 cdmc 判断是否命中特殊作息,
// 命中则在写入课程对象的同时打好 isCustomTime 标记,App 将优先显示自定义时间
const customTime = getCustomTime(position, course.startSection, course.endSection, campusConfig);
if (customTime.marked) {
course.isCustomTime = true;
course.customStartTime = customTime.startTime;
course.customEndTime = customTime.endTime;
}
courses.push(course);
}
const mergedCourses = mergeAndDistinctCourses(courses);
// 合并可能改变节次区间(如 1-2 节 + 3-4 节 -> 1-4 节),对已打标课程做最终校验:
// 合并后的区间不再精确命中特殊时间块时,撤销打标,避免特殊时间被错误扩散
return mergedCourses.map(course => {
if (!course.isCustomTime) return course;
const customTime = getCustomTime(course.position, course.startSection, course.endSection, campusConfig);
if (!customTime.marked) {
const plain = { ...course };
delete plain.isCustomTime;
delete plain.customStartTime;
delete plain.customEndTime;
return plain;
}
return course;
});
}
// ==================== 日期工具 ====================
/**
* 把教务返回的日期字段规范为 yyyy-MM-dd
* 兼容 "-"、"."、"/" 以及中文"年月日"等分隔写法
*/
function normalizeStartDate(value) {
const match = String(value || "").match(/(\d{4})[-\/.年](\d{1,2})[-\/.月](\d{1,2})/);
if (!match) return null;
return `${match[1]}-${match[2].padStart(2, "0")}-${match[3].padStart(2, "0")}`;
}
/**
* 在校历响应中查找第 1 周开学日期
* 兼容顶层数组、data/list/rows 等包装对象,以及 zrq/zcrq/rq/ksrq 字段
*/
function findSemesterStartDate(value) {
if (value == null) return null;
if (typeof value !== "object") return normalizeStartDate(value);
if (Array.isArray(value)) {
const firstWeek = value.find(item =>
item && typeof item === "object" &&
(String(item.zs) === "1" || String(item.zsmc) === "1")
) || value[0];
const found = findSemesterStartDate(firstWeek);
if (found) return found;
for (const item of value) {
const date = findSemesterStartDate(item);
if (date) return date;
}
return null;
}
for (const field of ["zrq", "zcrq", "rq", "ksrq"]) {
const date = normalizeStartDate(value[field]);
if (date) return date;
}
for (const item of Object.values(value)) {
const date = findSemesterStartDate(item);
if (date) return date;
}
return null;
}
// ==================== 教务接口 ====================
/**
* 读取课表查询页里的学年/学期下拉选项
* 成功返回 { yearOptions, semesterOptions, defaultYearIndex, defaultSemesterIndex };
* 读取失败返回 null,由调用方回退到默认值
*/
async function fetchAcademicOptions() {
const url = "https://jw.gdou.edu.cn/kbcx/xskbcx_cxXskbcxIndex.html?gnmkdm=N2151&layout=default";
try {
const response = await fetch(url, { method: "GET", credentials: "include" });
if (!response.ok) return null;
const doc = new DOMParser().parseFromString(await response.text(), "text/html");
// 解析单个下拉框;默认选中项优先跟随 select 当前值,其次取 selected 属性
const readSelect = (select) => {
if (!select) return null;
const options = Array.from(select.querySelectorAll("option"))
.map(opt => ({ value: opt.value, text: opt.textContent.trim() || opt.value }))
.filter(opt => opt.value !== "");
if (options.length === 0) return null;
const valueIndex = options.findIndex(opt => opt.value === select.value);
const selectedIndex = options.findIndex(opt => opt.selected);
return { options, defaultIndex: valueIndex !== -1 ? valueIndex : Math.max(0, selectedIndex) };
};
const yearData = readSelect(doc.querySelector("#xnm"));
const semesterData = readSelect(doc.querySelector("#xqm"));
if (!yearData || !semesterData) return null;
return {
yearOptions: yearData.options,
semesterOptions: semesterData.options,
defaultYearIndex: yearData.defaultIndex,
defaultSemesterIndex: semesterData.defaultIndex
};
} catch (e) {
return null;
}
}
/**
* 查询指定学期的周次安排,取出第 1 周的日期作为开学日期,并返回该学期总周数
* 接口失败时返回 null,不影响主流程
*/
async function fetchSemesterInfo(academicYear, semesterCode) {
const url = "https://jw.gdou.edu.cn/kbcx/xskbcxZccx_cxZcByXnxq.html?gnmkdm=N2154";
const body = `xnm=${encodeURIComponent(academicYear)}&xqm=${encodeURIComponent(semesterCode)}`;
try {
const response = await fetch(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,
credentials: "include"
});
if (!response.ok) return null;
const weeks = await response.json();
if (!Array.isArray(weeks) || weeks.length === 0) return null;
return {
startDate: findSemesterStartDate(weeks),
totalWeeks: weeks.length
};
} catch (e) {
return null;
}
}
/**
* 请求课表接口并解析课程,同时并行获取学期信息
* 成功返回 { courses, config },失败返回 null
*/
async function fetchAndParseCourses(academicYear, semesterCode, campusConfig) {
const body = `xnm=${encodeURIComponent(academicYear)}&xqm=${encodeURIComponent(semesterCode)}&kzlx=ck&xsdm=&kclbdm=`;
const courseUrl = "https://jw.gdou.edu.cn/kbcx/xskbcx_cxXsgrkb.html?gnmkdm=N2151";
const [courseResponse, semesterInfo] = await Promise.all([
fetch(courseUrl, {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8" },
body,
credentials: "include"
}),
fetchSemesterInfo(academicYear, semesterCode)
]);
try {
if (!courseResponse.ok) {
window.shiguangBridge.showToast(`课表请求失败:HTTP ${courseResponse.status}`);
return null;
}
const courses = parseJsonData(JSON.parse(await courseResponse.text()), campusConfig);
if (courses.length === 0) {
window.shiguangBridge.showToast("未查询到课表数据,请检查学年/学期选择或登录状态。");
return null;
}
// 总周数取接口返回值与课程最大周次中的较大者,保证不截断课表
const maxCourseWeek = courses.reduce((max, c) => Math.max(max, ...c.weeks), 0);
return {
courses,
config: {
semesterStartDate: semesterInfo ? semesterInfo.startDate : null,
semesterTotalWeeks: Math.max(maxCourseWeek, semesterInfo ? semesterInfo.totalWeeks : 20)
}
};
} catch (e) {
window.shiguangBridge.showToast("获取课表失败,请确认已登录且网络可访问 jw.gdou.edu.cn。");
return null;
}
}
// ==================== 交互 ====================
/**
* 按当前月份推断学年起始年份:9 月及以后属于新学年,其余月份沿用上一学年
*/
function getDefaultAcademicYear(date = new Date()) {
const currentYear = date.getFullYear();
return (date.getMonth() >= 8 ? currentYear : currentYear - 1).toString();
}
/**
* 弹出导入确认提示,说明使用前提
*/
async function promptUserToStart() {
return await window.shiguangBridgePromise.showAlert(
"广东海洋大学教务系统课表导入",
"导入前请确认已在浏览器中登录教务系统(jw.gdou.edu.cn)。\n脚本将通过接口直接获取课表,无需停留在特定页面。",
"好的,开始导入"
);
}
/**
* 弹出校区选择框,决定使用哪套特殊作息规则
* 取消返回 null,由调用方终止流程
*/
async function selectCampus() {
const campusIndex = await window.shiguangBridgePromise.showSingleSelection(
"选择校区",
JSON.stringify(CAMPUS_CONFIGS.map(item => item.label)),
0
);
if (campusIndex === null || campusIndex === -1) return null;
return CAMPUS_CONFIGS[campusIndex];
}
/**
* 依次弹出学年、学期选择框
* 选项优先来自教务系统;若读取失败,则按当前月份给出默认学年,
* 学期码(3=第一学期,12=第二学期)
*/
async function selectAcademicYearAndSemester() {
const options = await fetchAcademicOptions();
let yearOptions;
let semesterOptions;
let defaultYearIndex;
let defaultSemesterIndex;
if (options) {
({ yearOptions, semesterOptions, defaultYearIndex, defaultSemesterIndex } = options);
} else {
const year = getDefaultAcademicYear();
const isFirstSemester = new Date().getMonth() >= 8;
yearOptions = [{ value: year, text: `${year}-${Number(year) + 1}` }];
semesterOptions = [
{ value: "3", text: "第一学期" },
{ value: "12", text: "第二学期" }
];
defaultYearIndex = 0;
defaultSemesterIndex = isFirstSemester ? 0 : 1;
window.shiguangBridge.showToast("未读取到教务系统学年学期选项,已使用默认值,请核对。");
}
const yearIndex = await window.shiguangBridgePromise.showSingleSelection(
"选择学年",
JSON.stringify(yearOptions.map(item => item.text)),
defaultYearIndex
);
if (yearIndex === null || yearIndex === -1) return null;
const semesterIndex = await window.shiguangBridgePromise.showSingleSelection(
"选择学期",
JSON.stringify(semesterOptions.map(item => item.text)),
defaultSemesterIndex
);
if (semesterIndex === null || semesterIndex === -1) return null;
return {
academicYear: yearOptions[yearIndex].value,
semesterCode: semesterOptions[semesterIndex].value
};
}
// ==================== 保存 ====================
async function saveCourses(courses) {
try {
await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(courses));
return true;
} catch (error) {
window.shiguangBridge.showToast(`课程保存失败: ${error.message}`);
return false;
}
}
/**
* 将预设作息时间导入 App
*/
async function importPresetTimeSlots(timeSlots) {
if (timeSlots.length === 0) {
window.shiguangBridge.showToast("警告:时间段为空,未导入时间段信息。");
return;
}
try {
await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(timeSlots));
window.shiguangBridge.showToast("预设时间段导入成功!");
} catch (error) {
window.shiguangBridge.showToast("导入时间段失败: " + error.message);
}
}
// ==================== 主流程 ====================
async function runImportFlow() {
// 1. 确认导入
const confirmed = await promptUserToStart();
if (!confirmed) {
window.shiguangBridge.showToast("用户取消了导入。");
return;
}
// 2. 选择学年学期
const selection = await selectAcademicYearAndSemester();
if (!selection) {
window.shiguangBridge.showToast("未选择学年学期,导入流程终止。");
return;
}
// 3. 选择校区(决定特殊作息规则)
const campusConfig = await selectCampus();
if (!campusConfig) {
window.shiguangBridge.showToast("未选择校区,导入流程终止。");
return;
}
// 4. 拉取并解析课程
const result = await fetchAndParseCourses(selection.academicYear, selection.semesterCode, campusConfig);
if (result === null) return;
const { courses, config } = result;
// 5. 保存课程
if (!(await saveCourses(courses))) return;
// 6. 保存课表配置(开学日期、总周数)
try {
await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
let msg = `课表配置更新成功!总周数:${config.semesterTotalWeeks}周。`;
if (config.semesterStartDate) msg += ` 开学日期:${config.semesterStartDate}`;
window.shiguangBridge.showToast(msg);
} catch (error) {
window.shiguangBridge.showToast(`课表配置保存失败: ${error.message}`);
}
// 7. 导入预设作息时间
await importPresetTimeSlots(TimeSlots);
window.shiguangBridge.showToast(`课程导入成功,共导入 ${courses.length} 门课程!`);
window.shiguangBridge.showToast(`若课程时间有误,请提交issue或联系开发者!`);
window.shiguangBridge.notifyTaskCompletion();
}
runImportFlow();
})();
+670
View File
@@ -0,0 +1,670 @@
/**
* 广东海洋大学阳江校区教务适配
* @date 2026-7-30
* @author Mccurtain (原始 GDOU 适配)
* @adapted-by Yihe-ng (阳江校区作息与适配)
* @version 1.1
*/
(function () {
/**
* 节次与周次合并去重函数。
* @param {Array<Object>} courses 原始解析课程数组
* @returns {Array<Object>} 合并去重后的课程数组
*/
function mergeAndDistinctCourses(courses) {
if (!Array.isArray(courses) || courses.length <= 1) return courses;
const list = courses.map(course => ({
...course,
name: course.name || '',
teacher: course.teacher || '',
position: course.position || '',
weeks: Array.isArray(course.weeks) ? [...course.weeks].sort((a, b) => a - b) : []
}));
// 阶段 1:合并相同课程、星期、周次下的连续节次和重复记录。
list.sort((a, b) =>
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 sectionMerged = [];
let current = list[0];
for (let i = 1; i < list.length; i++) {
const next = list[i];
const sameCourseAndWeeks =
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 (sameCourseAndWeeks && isContinuous) {
current.endSection = next.endSection;
} else if (sameCourseAndWeeks && isDuplicate) {
continue;
} else {
sectionMerged.push(current);
current = next;
}
}
sectionMerged.push(current);
// 阶段 2:合并相同节次下分段返回的周次。
sectionMerged.sort((a, b) =>
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 result = [];
let currentCourse = sectionMerged[0];
for (let i = 1; i < sectionMerged.length; i++) {
const nextCourse = sectionMerged[i];
const sameCourseAndSection =
currentCourse.name === nextCourse.name &&
currentCourse.teacher === nextCourse.teacher &&
currentCourse.position === nextCourse.position &&
currentCourse.day === nextCourse.day &&
currentCourse.startSection === nextCourse.startSection &&
currentCourse.endSection === nextCourse.endSection;
if (sameCourseAndSection) {
currentCourse.weeks = Array.from(new Set([
...currentCourse.weeks,
...nextCourse.weeks
])).sort((a, b) => a - b);
} else {
result.push(currentCourse);
currentCourse = nextCourse;
}
}
result.push(currentCourse);
return result;
}
/**
* 解析周次字符串,处理单双周和周次范围。
* 兼容格式:"1-16周"、"6周"、"1-8周(单)"、"1-10周(双)"、"1-5周,9周"
*/
function parseWeeks(weekStr) {
if (!weekStr) return [];
const normalizedWeekStr = String(weekStr).replace(/,/g, ',');
const weekSets = normalizedWeekStr.split(',');
let weeks = [];
for (const set of weekSets) {
const trimmedSet = set.trim();
const rangeMatch = trimmedSet.match(/(\d+)\s*-\s*(\d+)\s*周?/);
const singleMatch = trimmedSet.match(/^(\d+)\s*周?/); // 匹配单个周次
let start = 0;
let end = 0;
let processed = false;
if (rangeMatch) { // 范围, 如 "1-5周"
start = Number(rangeMatch[1]);
end = Number(rangeMatch[2]);
processed = true;
} else if (singleMatch) { // 单个周, 如 "6周"
start = end = Number(singleMatch[1]);
processed = true;
}
if (processed && start >= 1 && end >= start) {
// 确定单双周
const isSingle = trimmedSet.includes('(单)');
const isDouble = trimmedSet.includes('(双)');
for (let w = start; w <= end; w++) {
if (isSingle && w % 2 === 0) continue; // 单周跳过偶数
if (isDouble && w % 2 !== 0) continue; // 双周跳过奇数
weeks.push(w);
}
}
}
// 去重并排序
return [...new Set(weeks)].sort((a, b) => a - b);
}
/**
* 解析节次字符串,例如 "1-2"、"1-2节" 或单节 "3"。
* 返回 null 表示接口返回了无法识别的节次格式。
*/
function parseSectionRange(sectionStr) {
const sectionText = sectionStr == null ? '' : String(sectionStr);
const sectionMatch = sectionText.match(/^\s*(?:第)?(\d+)\s*(?:-\s*(\d+))?\s*节?\s*$/);
if (!sectionMatch) {
return null;
}
const startSection = Number(sectionMatch[1]);
const endSection = Number(sectionMatch[2] || sectionMatch[1]);
if (!Number.isInteger(startSection) || !Number.isInteger(endSection) ||
startSection < 1 || endSection < startSection) {
return null;
}
return { startSection, endSection };
}
/**
* 阳江校区其他场地(非慎思楼)的作息。
* 只有第 3、4 节在校区作息表中是不同的连续时间块,使用自定义时间表示。
*/
const OTHER_VENUE_SECTION_3_4_TIME = { startTime: "10:10", endTime: "11:40" };
function getOtherVenueCustomTime(position, startSection, endSection) {
const positionText = position == null ? '' : String(position);
if (!positionText || positionText.includes("慎思楼")) {
return null;
}
if (startSection !== 3 || endSection !== 4) {
return null;
}
return OTHER_VENUE_SECTION_3_4_TIME;
}
function applyOtherVenueCustomTime(courses) {
return courses.map(course => {
const customTime = getOtherVenueCustomTime(
course.position,
course.startSection,
course.endSection
);
if (!customTime) return course;
return {
...course,
isCustomTime: true,
customStartTime: customTime.startTime,
customEndTime: customTime.endTime
};
});
}
/**
* 解析正方 v9 课表查询接口返回的 JSON 数据。
*/
function parseJsonData(jsonData) {
console.log("JS: parseJsonData 正在解析 JSON 数据...");
// 正方 v9 个人课表数据放在 kbList 字段中
if (!jsonData || !Array.isArray(jsonData.kbList)) {
console.warn("JS: JSON 数据结构错误或缺少 kbList 字段。");
return [];
}
const rawCourseList = jsonData.kbList;
const initialCourseList = [];
for (const rawCourse of rawCourseList) {
if (!rawCourse || typeof rawCourse !== 'object') {
continue;
}
// 课程名、星期、节次和周次是解析所必需的;教师或教室为空时仍保留课程。
if (!rawCourse.kcmc || rawCourse.xqj == null ||
rawCourse.jcs == null || rawCourse.zcd == null) {
continue;
}
const weeksArray = parseWeeks(rawCourse.zcd);
// 周次有效性检查
if (weeksArray.length === 0) {
continue;
}
const sectionRange = parseSectionRange(rawCourse.jcs);
if (!sectionRange) {
console.warn(`JS: 跳过无法解析节次的课程:${rawCourse.kcmc}`);
continue;
}
const day = Number(rawCourse.xqj); // xqj: 星期几 (周一为1, 周日为7)
// 数字有效性检查
if (isNaN(day) || day < 1 || day > 7) {
continue;
}
initialCourseList.push({
name: String(rawCourse.kcmc).trim(),
teacher: rawCourse.xm == null ? '' : String(rawCourse.xm).trim(),
position: rawCourse.cdmc == null ? '' : String(rawCourse.cdmc).trim(),
day: day,
startSection: sectionRange.startSection,
endSection: sectionRange.endSection,
weeks: weeksArray
});
}
const mergedCourses = mergeAndDistinctCourses(initialCourseList);
const finalCourseList = applyOtherVenueCustomTime(mergedCourses);
finalCourseList.sort((a, b) =>
a.day - b.day ||
a.startSection - b.startSection ||
a.name.localeCompare(b.name)
);
console.log(`JS: JSON 数据解析与合并完成,共找到 ${finalCourseList.length} 门课程。`);
return finalCourseList;
}
async function promptUserToStart() {
console.log("JS: 流程开始:显示公告。");
return await window.shiguangBridgePromise.showAlert(
"广东海洋大学阳江校区教务系统课表导入",
"请先登录广东海洋大学教务系统(jw.gdou.edu.cn),并在个人课表页选择要导入的学年学期。点击确认后按提示继续即可。",
"好的,开始导入"
);
}
/**
* 从 select 元素解析学年和学期选项。
* 默认索引优先使用当前 select.value,确保跟随用户在页面上的实际选择。
*/
function parseSelectOptions(selectElement) {
if (!selectElement || typeof selectElement.querySelectorAll !== "function") {
return { options: [], defaultIndex: 0 };
}
const options = [];
let defaultIndex = 0;
Array.from(selectElement.querySelectorAll("option")).forEach(option => {
const value = String(option.value || "").trim();
if (!value) return;
const text = String(option.textContent || "").trim() || value;
if (option.selected) defaultIndex = options.length;
options.push({ value, text });
});
const currentValue = String(selectElement.value || "").trim();
const currentIndex = options.findIndex(option => option.value === currentValue);
if (currentIndex !== -1) defaultIndex = currentIndex;
return { options, defaultIndex };
}
function parseAcademicOptionsFromDocument(doc) {
if (!doc || typeof doc.querySelector !== "function") return null;
const yearData = parseSelectOptions(doc.querySelector("#xnm"));
const semesterData = parseSelectOptions(doc.querySelector("#xqm"));
if (yearData.options.length === 0 || semesterData.options.length === 0) return null;
return {
yearOptions: yearData.options,
semesterOptions: semesterData.options,
defaultYearIndex: yearData.defaultIndex,
defaultSemesterIndex: semesterData.defaultIndex
};
}
function isOnTimetablePage() {
const pathname = typeof window !== "undefined" && window.location
? window.location.pathname
: "";
return typeof pathname === "string" && pathname.includes("xskbcx_cxXskbcxIndex.html");
}
function getCurrentPageAcademicOptions() {
if (!isOnTimetablePage() || typeof document === "undefined" || !document.querySelector) {
return null;
}
return parseAcademicOptionsFromDocument(document);
}
/**
* 从正方课表页读取学年和学期选项。
* 学期码直接使用教务系统返回的 value,例如第一学期为 3、第二学期为 12。
*/
async function fetchAcademicOptions() {
const currentPageOptions = getCurrentPageAcademicOptions();
if (currentPageOptions) {
console.log("JS: 使用当前课表页的学年学期选项。");
return currentPageOptions;
}
const url = "https://jw.gdou.edu.cn/kbcx/xskbcx_cxXskbcxIndex.html?gnmkdm=N2151&layout=default";
try {
const response = await fetch(url, {
method: "GET",
credentials: "include"
});
if (!response.ok) return null;
const htmlText = await response.text();
const doc = new DOMParser().parseFromString(htmlText, "text/html");
const optionsData = parseAcademicOptionsFromDocument(doc);
if (!optionsData) return null;
const selectedYearIndex = optionsData.defaultYearIndex;
const start = Math.max(0, selectedYearIndex - 2);
const end = Math.min(optionsData.yearOptions.length, selectedYearIndex + 3);
return {
...optionsData,
yearOptions: optionsData.yearOptions.slice(start, end),
defaultYearIndex: selectedYearIndex - start
};
} catch (error) {
console.warn("JS: 读取学年学期选项失败:", error);
return null;
}
}
/**
* 使用教务系统返回的选项让用户选择学年和学期。
* 学年和学期码直接使用 option 的 value,避免本地手动映射。
*/
async function selectAcademicYearAndSemester() {
const optionsData = await fetchAcademicOptions();
if (!optionsData) {
window.shiguangBridge.showToast("从教务系统读取学年学期失败,请确保登录状态。");
return null;
}
const { yearOptions, semesterOptions, defaultYearIndex, defaultSemesterIndex } = optionsData;
const yearTexts = yearOptions.map(option => option.text);
const yearIndex = await window.shiguangBridgePromise.showSingleSelection(
"选择学年",
JSON.stringify(yearTexts),
defaultYearIndex
);
if (yearIndex === null || yearIndex === -1 || !yearOptions[yearIndex]) return null;
const selectedYearCode = yearOptions[yearIndex].value;
const semesterTexts = semesterOptions.map(option => option.text);
const semesterIndex = await window.shiguangBridgePromise.showSingleSelection(
"选择学期",
JSON.stringify(semesterTexts),
defaultSemesterIndex
);
if (semesterIndex === null || semesterIndex === -1 || !semesterOptions[semesterIndex]) return null;
const selectedSemesterCode = semesterOptions[semesterIndex].value;
return {
academicYear: selectedYearCode,
semesterCode: selectedSemesterCode
};
}
/**
* 将正方返回的日期字段规范为 yyyy-MM-dd。
*/
function normalizeStartDate(value) {
const match = String(value || "").match(/(\d{4})[-\/.年](\d{1,2})[-\/.月](\d{1,2})/);
if (!match) return null;
return `${match[1]}-${match[2].padStart(2, "0")}-${match[3].padStart(2, "0")}`;
}
/**
* 从正方校历响应中查找第一周日期。
* 兼容顶层数组、data/list/rows 等包装对象,以及 zrq/zcrq/rq/ksrq 字段。
*/
function findSemesterStartDate(value) {
if (value == null) return null;
if (typeof value !== "object") {
return normalizeStartDate(value);
}
if (Array.isArray(value)) {
const firstWeek = value.find(item =>
item && typeof item === "object" &&
(String(item.zs) === "1" || String(item.zsmc) === "1")
) || value[0];
const firstWeekDate = findSemesterStartDate(firstWeek);
if (firstWeekDate) return firstWeekDate;
for (const item of value) {
const date = findSemesterStartDate(item);
if (date) return date;
}
return null;
}
for (const field of ["zrq", "zcrq", "rq", "ksrq"]) {
const date = normalizeStartDate(value[field]);
if (date) return date;
}
for (const item of Object.values(value)) {
const date = findSemesterStartDate(item);
if (date) return date;
}
return null;
}
/**
* 获取所选学期的第一周开学日期。
* 日期接口失败时返回 null,不阻断课表导入。
*/
async function fetchSemesterStartDate(academicYear, semesterCode) {
const url = "https://jw.gdou.edu.cn/kbcx/xskbcxZccx_cxZcByXnxq.html?gnmkdm=N2154";
const requestBody = `xnm=${encodeURIComponent(academicYear)}&xqm=${encodeURIComponent(semesterCode)}`;
try {
const response = await fetch(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: requestBody,
credentials: "include"
});
if (!response.ok) {
console.warn(`JS: 开学日期接口请求失败:HTTP ${response.status}`);
return null;
}
const responseText = await response.text();
let json;
try {
json = JSON.parse(responseText);
} catch (error) {
console.warn("JS: 开学日期接口未返回 JSON,可能登录已过期。", error);
return null;
}
const startDate = findSemesterStartDate(json);
if (!startDate) console.warn("JS: 校历响应中未找到第 1 周开学日期。");
return startDate;
} catch (error) {
console.warn("JS: 获取学期开学日期失败:", error);
}
return null;
}
/**
* 请求正方 v9 课表接口并解析课程数据。
*/
async function fetchAndParseCourses(academicYear, semesterCode) {
const requestBody = `xnm=${encodeURIComponent(academicYear)}&xqm=${encodeURIComponent(semesterCode)}&kzlx=ck&xsdm=&kclbdm=`;
// 广东海洋大学正方教务 v9 个人课表查询接口
const targetUrl = "https://jw.gdou.edu.cn/kbcx/xskbcx_cxXsgrkb.html?gnmkdm=N2151";
try {
// 课表和校历互不依赖,并行请求以减少导入等待时间。
const [courseResponse, semesterStartDate] = await Promise.all([
fetch(targetUrl, {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded;charset=UTF-8"
},
body: requestBody,
credentials: "include"
}),
fetchSemesterStartDate(academicYear, semesterCode)
]);
if (!courseResponse.ok) {
window.shiguangBridge.showToast(`课表请求失败:HTTP ${courseResponse.status}`);
console.error(`JS: 接口返回非 200 状态码:${courseResponse.status}`);
return null;
}
const jsonText = await courseResponse.text();
const jsonData = JSON.parse(jsonText);
if (!jsonData || !Array.isArray(jsonData.kbList) || jsonData.kbList.length === 0) {
window.shiguangBridge.showToast("未查询到课表数据,请检查学年/学期是否选择正确,或确认已登录教务系统。");
return null;
}
const parsedCourses = parseJsonData(jsonData);
if (parsedCourses.length === 0) {
window.shiguangBridge.showToast("课表数据为空或解析失败,请确认所选学年学期。");
return null;
}
return {
courses: parsedCourses,
// CourseConfigJsonModel(wiki 1.3):所有字段可选,未提供则用默认值。
// GDOU 各节课间隔不统一,因此用 TimeSlot 节次表达时间。
config: {
semesterStartDate,
semesterTotalWeeks: 20
}
};
} catch (e) {
console.error("JS: 获取课表失败:", e);
window.shiguangBridge.showToast("获取课表失败,请确认已登录教务系统且网络可访问 jw.gdou.edu.cn。");
return null;
}
}
async function saveCourses(parsedCourses) {
window.shiguangBridge.showToast(`正在保存 ${parsedCourses.length} 门课程...`);
console.log(`JS: 尝试保存 ${parsedCourses.length} 门课程...`);
try {
await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(parsedCourses, null, 2));
console.log("JS: 课程保存成功!");
return true;
} catch (error) {
window.shiguangBridge.showToast(`课程保存失败: ${error.message}`);
console.error('JS: Save Courses Error:', error);
return false;
}
}
// 阳江校区慎思楼上课时间(根据用户提供的校区作息表)
const TimeSlots = [
{ number: 1, startTime: "08:10", endTime: "08:55" },
{ number: 2, startTime: "09:05", endTime: "09:50" },
{ number: 3, startTime: "10:20", endTime: "11:05" },
{ number: 4, startTime: "11:15", endTime: "12:00" },
{ number: 5, startTime: "14:30", endTime: "15:15" },
{ number: 6, startTime: "15:20", endTime: "16:05" },
{ number: 7, startTime: "16:20", endTime: "17:05" },
{ number: 8, startTime: "17:10", endTime: "17:55" },
{ number: 9, startTime: "19:30", endTime: "20:15" },
{ number: 10, startTime: "20:25", endTime: "21:10" }
];
async function importPresetTimeSlots(timeSlots) {
console.log(`JS: 准备导入 ${timeSlots.length} 个预设时间段。`);
if (timeSlots.length > 0) {
window.shiguangBridge.showToast(`正在导入 ${timeSlots.length} 个预设时间段...`);
try {
await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(timeSlots));
window.shiguangBridge.showToast("预设时间段导入成功!");
console.log("JS: 预设时间段导入成功。");
} catch (error) {
window.shiguangBridge.showToast("导入时间段失败: " + error.message);
console.error('JS: Save Time Slots Error:', error);
}
} else {
window.shiguangBridge.showToast("警告:时间段为空,未导入时间段信息。");
console.warn("JS: 警告:传入时间段为空,未导入时间段信息。");
}
}
async function runImportFlow() {
const alertConfirmed = await promptUserToStart();
if (!alertConfirmed) {
window.shiguangBridge.showToast("用户取消了导入。");
console.log("JS: 用户取消了导入流程。");
return;
}
const selection = await selectAcademicYearAndSemester();
if (!selection) {
window.shiguangBridge.showToast("导入已取消。");
console.log("JS: 获取学年学期失败/取消,流程终止。");
return;
}
const { academicYear, semesterCode } = selection;
console.log(`JS: 已确定学年学期:${academicYear},学期码:${semesterCode}`);
const result = await fetchAndParseCourses(academicYear, semesterCode);
if (result === null) {
console.log("JS: 课程获取或解析失败,流程终止。");
return;
}
const { courses, config } = result;
const saveResult = await saveCourses(courses);
if (!saveResult) {
console.log("JS: 课程保存失败,流程终止。");
return;
}
try {
await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
const configMessage = config.semesterStartDate
? `课表配置更新成功!总周数:${config.semesterTotalWeeks}周,开学日期:${config.semesterStartDate}。`
: `课表配置更新成功!总周数:${config.semesterTotalWeeks}周,未获取到开学日期,已继续导入。`;
window.shiguangBridge.showToast(configMessage);
} catch (error) {
window.shiguangBridge.showToast(`课表配置保存失败: ${error.message}`);
console.error('JS: Save Config Error:', error);
return;
}
await importPresetTimeSlots(TimeSlots);
window.shiguangBridge.showToast(`课程导入成功,共导入 ${courses.length} 门课程!`);
console.log("JS: 整个导入流程执行完毕并成功。");
window.shiguangBridge.notifyTaskCompletion();
}
// 脚本执行入口
runImportFlow();
})();