[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,9 @@
# resources/SWU/adapters.yaml
adapters:
- adapter_id: "SWU_01"
adapter_name: "西南大学教务"
category: "BACHELOR_AND_ASSOCIATE"
asset_js_path: "swu.js"
import_url: "https://i.swu.edu.cn/"
maintainer: "小漫君"
description: "基于正方新一代教务接口取数。请从办事大厅(i.swu.edu.cn)登录后进入教务系统课表查询页面,再执行导入脚本;脚本会自动套用西南大学节次时间。"
+510
View File
@@ -0,0 +1,510 @@
// 西南大学(swu.edu.cn) 拾光课程表适配脚本
// 基于正方新一代教务系统接口适配
// 维护者:小漫君(xiaomanjun233)
// 出现问题请提issues或者提交pr更改,这更加快速
//
// 通过正方接口 xskbcx_cxXsgrkb 拉取个人课表 JSON(kbList),解析课程名、教师、教室、
// 星期、节次和周次(含单双周)。集中实践课(军训、毕业设计等)无星期节次,直接忽略不导入。
// 交互上自动读取教务系统的学年/学期下拉列表,用户只需依次点选即可,无需手动输入。
// 通过 xskbcx_cxXskbcxIndex 读取学年学期选项、xskbcxZccx_cxZcByXnxq 取所选学期开学日期;
// 导入课程、课表配置与西南大学 14 节节次时间。
//
// 使用方式:从办事大厅(i.swu.edu.cn)登录后进入教务系统(jw.swu.edu.cn/jwglxt)课表查询页面,再执行导入。
/**
* 解析周次字符串,处理单双周和周次范围。
*/
function parseWeeks(weekStr) {
if (!weekStr) return [];
const weekSets = weekStr.split(',');
let weeks = [];
for (const set of weekSets) {
const trimmedSet = set.trim();
const rangeMatch = trimmedSet.match(/(\d+)-(\d+)周/);
const singleMatch = trimmedSet.match(/^(\d+)周/); // 匹配以数字周结束的
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) {
// 确定单双周
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);
}
/**
* 拼接教务系统接口地址。
* 西南大学教务(jw.swu.edu.cn)的正方新一代部署在 /jwglxt 子路径下,
* 接口路径必须带上该前缀;校外经 WebVPN 访问时路径还带有 /http/<hex> 前缀,需保留。
*/
function buildApiUrl(path) {
const prefixMatch = window.location.pathname.match(/^\/http\/[0-9a-f]+/i);
const webvpnPrefix = prefixMatch ? prefixMatch[0] : "";
return window.location.origin + webvpnPrefix + "/jwglxt" + path;
}
/**
* 拼装课程备注。
* xm 只有姓名,kcmc 只有课程名,以下信息只存在于原始字段里,
* 放进备注方便用户核对:重修标记、选课备注(体育项目、微专业等)、周次原文。
*/
function buildCourseRemark(rawCourse) {
const parts = [];
const retakeFlag = String(rawCourse.cxbjmc || "").trim();
if (retakeFlag) {
parts.push(retakeFlag);
}
const selectionNote = String(rawCourse.xkbz || "").trim();
if (selectionNote) {
parts.push(selectionNote);
}
const weekDesc = String(rawCourse.zcd || "").trim();
if (weekDesc) {
parts.push(weekDesc);
}
return parts.join(" | ");
}
/**
* 解析 API 返回的 JSON 数据。
*/
function parseJsonData(jsonData) {
console.log("JS: parseJsonData 正在解析 JSON 数据...");
// 检查JSON结构:新的数据在 kbList 字段中
if (!jsonData || !Array.isArray(jsonData.kbList)) {
console.warn("JS: JSON 数据结构错误或缺少 kbList 字段。");
return [];
}
const rawCourseList = jsonData.kbList;
const finalCourseList = [];
for (const rawCourse of rawCourseList) {
// 关键字段检查:只有 kcmc(课名), xqj(星期), jcs(节次范围), zcd(周次描述) 是排课必需的。
// xm(教师) 与 cdmc(教室) 在实践课、线上课、未排地点的课程上可能为空,
// 缺这两项不影响排课,不能因此丢弃整门课程。
if (!rawCourse.kcmc || !rawCourse.xqj || !rawCourse.jcs || !rawCourse.zcd) {
continue;
}
const weeksArray = parseWeeks(rawCourse.zcd);
// 周次有效性检查
if (weeksArray.length === 0) {
continue;
}
// 解析节次范围,例如 "1-2"
const sectionParts = rawCourse.jcs.split('-');
const startSection = Number(sectionParts[0]);
const endSection = Number(sectionParts[sectionParts.length - 1]);
const day = Number(rawCourse.xqj); // xqj: 星期几 (周一为1, 周日为7)
// 数字有效性检查
if (isNaN(day) || isNaN(startSection) || isNaN(endSection) || day < 1 || day > 7 || startSection > endSection) {
continue;
}
const remark = buildCourseRemark(rawCourse);
const course = {
name: String(rawCourse.kcmc).trim(),
teacher: String(rawCourse.xm || "").trim(),
position: String(rawCourse.cdmc || "").trim(),
day: day,
startSection: startSection,
endSection: endSection,
weeks: weeksArray
};
if (remark) {
course.remark = remark;
}
finalCourseList.push(course);
}
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() {
return await window.shiguangBridgePromise.showAlert(
"西南大学课表导入",
"导入前请确保您已从办事大厅(i.swu.edu.cn)登录并进入教务系统(jw.swu.edu.cn)课表查询页面。",
"好的,开始导入"
);
}
/**
* 从教务系统课表查询页读取学年与学期下拉选项。
* 学年以选中的一项为中心,取前 2 年 + 后 2 年,最多 5 项,避免列表过长。
*/
async function fetchAcademicOptions() {
const url = buildApiUrl("/kbcx/xskbcx_cxXskbcxIndex.html?gnmkdm=N2151");
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 allYearOptions = Array.from(doc.querySelectorAll("#xnm option"))
.filter((opt) => opt.value !== "")
.map((opt) => ({
value: opt.value,
text: opt.textContent.trim(),
selected: opt.selected
}));
const semesterOptions = Array.from(doc.querySelectorAll("#xqm option"))
.filter((opt) => opt.value !== "")
.map((opt) => ({
value: opt.value,
text: opt.textContent.trim(),
selected: opt.selected
}));
if (allYearOptions.length === 0 || semesterOptions.length === 0) {
return null;
}
const defaultSemesterIndex = (() => {
const i = semesterOptions.findIndex((opt) => opt.selected);
return i !== -1 ? i : 0;
})();
const selectedIndex = allYearOptions.findIndex((opt) => opt.selected);
if (selectedIndex === -1) {
return {
yearOptions: allYearOptions.slice(0, 5),
semesterOptions,
defaultYearIndex: 0,
defaultSemesterIndex
};
}
const start = Math.max(0, selectedIndex - 2);
const end = Math.min(allYearOptions.length, selectedIndex + 3);
return {
yearOptions: allYearOptions.slice(start, end),
semesterOptions,
defaultYearIndex: selectedIndex - start,
defaultSemesterIndex
};
} catch (e) {
return null;
}
}
/**
* 让用户依次点选学年与学期(带默认选中项),返回 API 所需的 xnm/xqm 代码。
* 无需手动输入,用户一路点下一步即可。
*/
async function selectAcademicYearAndSemester() {
const optionsData = await fetchAcademicOptions();
if (!optionsData) {
window.shiguangBridge.showToast("从教务系统读取学年学期失败,请确认登录状态有效。");
return null;
}
const { yearOptions, semesterOptions, defaultYearIndex, defaultSemesterIndex } = optionsData;
const yearIndex = await window.shiguangBridgePromise.showSingleSelection(
"选择学年",
JSON.stringify(yearOptions.map((item) => item.text)),
defaultYearIndex
);
if (yearIndex === null || yearIndex === -1) {
return null;
}
const academicYear = yearOptions[yearIndex].value;
const semesterIndex = await window.shiguangBridgePromise.showSingleSelection(
"选择学期",
JSON.stringify(semesterOptions.map((item) => item.text)),
defaultSemesterIndex
);
if (semesterIndex === null || semesterIndex === -1) {
return null;
}
return {
academicYear,
semesterCode: semesterOptions[semesterIndex].value
};
}
/**
* 获取所选学期的开学日期(第 1 周的日期)。
* 该接口按用户所选 xnm/xqm 返回对应学期的周历,能拿到比当前学期更准确的开班日期。
*/
async function fetchSemesterStartDate(academicYear, semesterCode) {
const url = buildApiUrl("/kbcx/xskbcxZccx_cxZcByXnxq.html?gnmkdm=N2154");
try {
const response = await fetch(url, {
method: "POST",
headers: {
"content-type": "application/x-www-form-urlencoded;charset=UTF-8"
},
body: `xnm=${academicYear}&xqm=${semesterCode}`,
credentials: "include"
});
if (response.ok) {
const json = await response.json();
if (Array.isArray(json) && json.length > 0) {
const firstWeekObj = json.find((item) => String(item.zs) === "1" || String(item.zsmc) === "1") || json[0];
const matchStr = String(firstWeekObj.rq || firstWeekObj.zcrq || firstWeekObj.ksrq || "").match(/(\d{4}-\d{2}-\d{2})/);
if (matchStr) {
return matchStr[1];
}
}
}
} catch (e) {
// 获取失败不影响主流程
}
return null;
}
/**
* 计算课表配置。
*
* 应用侧的 saveCourseConfig 是整体覆盖而非字段级合并:没有传入的字段会被写成模型默认值,
* 其中 semesterStartDate 的默认值是 null,会把用户已经设置好的开学日期清空。
* 所以拿不到真实开学日期时返回 null,由调用方跳过整个配置保存,宁可不写也不要写坏。
*/
function buildCourseConfig(courses, startDate, firstDayOfWeek) {
if (!startDate) {
return null;
}
let maxWeek = 0;
for (const course of courses) {
for (const week of course.weeks) {
if (week > maxWeek) {
maxWeek = week;
}
}
}
return {
semesterStartDate: startDate,
// 只增不减:默认 20 周,课表里出现更大的周次时才扩展。
semesterTotalWeeks: Math.max(maxWeek, 20),
firstDayOfWeek: firstDayOfWeek
};
}
/**
* 请求和解析课程数据。
* 并行拉取课表 JSON 与所选学期开学日期。
*/
async function fetchAndParseCourses(academicYear, semesterCode) {
window.shiguangBridge.showToast("正在请求课表数据...");
const body = `xnm=${academicYear}&xqm=${semesterCode}&kzlx=ck&xsdm=&kclbdm=`;
const url = buildApiUrl("/kbcx/xskbcx_cxXsgrkb.html?gnmkdm=N2151");
const [courseResponse, startDate] = await Promise.all([
fetch(url, {
method: "POST",
headers: {
"content-type": "application/x-www-form-urlencoded;charset=UTF-8"
},
body,
credentials: "include"
}),
fetchSemesterStartDate(academicYear, semesterCode)
]);
try {
if (!courseResponse.ok) {
throw new Error(`网络请求失败。状态码: ${courseResponse.status} (${courseResponse.statusText})`);
}
const jsonText = await courseResponse.text();
let jsonData;
try {
jsonData = JSON.parse(jsonText);
} catch (e) {
console.error('JS: JSON 解析失败:', e);
window.shiguangBridge.showToast("数据返回格式错误,请确认已进入教务系统(jw.swu.edu.cn)课表查询页面(而非停留在办事大厅门户页),且登录状态有效。");
return null;
}
const courses = parseJsonData(jsonData);
if (courses.length === 0) {
window.shiguangBridge.showToast("未找到任何课程数据,请检查所选学年学期是否正确或本学期无课。");
return null;
}
console.log(`JS: 课程数据解析成功,共找到 ${courses.length} 门课程。`);
// qsxqj: 教务系统设置的一周起始星期几,缺失时按周一处理。
const rawFirstDay = Number(jsonData.qsxqj);
const firstDayOfWeek = (rawFirstDay >= 1 && rawFirstDay <= 7) ? rawFirstDay : 1;
return {
courses,
startDate,
firstDayOfWeek
};
} catch (error) {
window.shiguangBridge.showToast(`请求或解析失败: ${error.message}`);
console.error('JS: Fetch/Parse Error:', error);
return null;
}
}
async function saveCourses(parsedCourses) {
window.shiguangBridge.showToast(`正在保存 ${parsedCourses.length} 门课程...`);
try {
await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(parsedCourses, null, 2));
return true;
} catch (error) {
window.shiguangBridge.showToast(`课程保存失败: ${error.message}`);
console.error('JS: Save Courses Error:', error);
return false;
}
}
/**
* 只在能拿到真实开学日期时写入课表配置。
* 拿不到就完全不调用 saveCourseConfig —— 应用侧是整体覆盖,
* 传入不含 semesterStartDate 的配置会把用户已设置的开学日期清空。
*/
async function saveCourseConfigIfPossible(courses, startDate, firstDayOfWeek) {
const config = buildCourseConfig(courses, startDate, firstDayOfWeek);
if (!config) {
window.shiguangBridge.showToast("未取到本学期开学日期,已跳过课表配置,请在应用内手动设置开学日期。");
console.log("JS: 无可用开学日期,跳过 saveCourseConfig 以保留用户现有配置。");
return;
}
try {
await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
window.shiguangBridge.showToast(
`课表配置更新成功!开学日期 ${config.semesterStartDate},总周数 ${config.semesterTotalWeeks} 周。`
);
} catch (error) {
window.shiguangBridge.showToast(`课表配置保存失败: ${error.message}`);
console.error('JS: Save Config Error:', error);
}
}
// 西南大学统一作息时间(14 节,第 5 节 12:10 从中午开始,傍晚 17:50 后为第 11 节)
const SWU_TIME_SLOTS = [
{ number: 1, startTime: "08:00", endTime: "08:45" },
{ number: 2, startTime: "08:55", endTime: "09:40" },
{ number: 3, startTime: "10:00", endTime: "10:45" },
{ number: 4, startTime: "10:55", endTime: "11:40" },
{ number: 5, startTime: "12:10", endTime: "12:55" },
{ number: 6, startTime: "13:05", endTime: "13:50" },
{ number: 7, startTime: "14:00", endTime: "14:45" },
{ number: 8, startTime: "14:55", endTime: "15:40" },
{ number: 9, startTime: "15:50", endTime: "16:35" },
{ number: 10, startTime: "16:55", endTime: "17:40" },
{ number: 11, startTime: "17:50", endTime: "18:35" },
{ number: 12, startTime: "19:20", endTime: "20:05" },
{ number: 13, startTime: "20:15", endTime: "21:00" },
{ number: 14, startTime: "21:10", endTime: "21:55" },
];
async function importPresetTimeSlots(timeSlots) {
if (timeSlots.length > 0) {
window.shiguangBridge.showToast(`正在导入 ${timeSlots.length} 个预设时间段...`);
try {
await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(timeSlots));
window.shiguangBridge.showToast("预设时间段导入成功!");
} catch (error) {
window.shiguangBridge.showToast("导入时间段失败: " + error.message);
console.error('JS: Save Time Slots Error:', error);
}
} else {
window.shiguangBridge.showToast("警告:时间段为空,未导入时间段信息。");
}
}
async function runImportFlow() {
const alertConfirmed = await promptUserToStart();
if (!alertConfirmed) {
window.shiguangBridge.showToast("用户取消了导入。");
return;
}
const selection = await selectAcademicYearAndSemester();
if (selection === null) {
window.shiguangBridge.showToast("导入已取消。");
return;
}
console.log(`JS: 已选择学年学期: ${selection.academicYear}/${selection.semesterCode}`);
const result = await fetchAndParseCourses(selection.academicYear, selection.semesterCode);
if (result === null) {
console.log("JS: 课程获取或解析失败,流程终止。");
return;
}
const { courses, startDate, firstDayOfWeek } = result;
const saveResult = await saveCourses(courses);
if (!saveResult) {
console.log("JS: 课程保存失败,流程终止。");
return;
}
await saveCourseConfigIfPossible(courses, startDate, firstDayOfWeek);
await importPresetTimeSlots(SWU_TIME_SLOTS);
window.shiguangBridge.showToast(`课程导入成功,共导入 ${courses.length} 门课程!`);
console.log("JS: 整个导入流程执行完毕并成功。");
window.shiguangBridge.notifyTaskCompletion();
}
runImportFlow();