[new] new project
This commit is contained in:
@@ -0,0 +1,187 @@
|
||||
/**
|
||||
* 华中科技大学 HUB 系统课表适配器。
|
||||
*
|
||||
* 接口与解析规则参考 StayUP-Calendar 的 HUST importer:
|
||||
* https://github.com/Lucas04-nhr/StayUP-Calendar/blob/main/lib/src/pages/crawler/hust.dart
|
||||
*/
|
||||
|
||||
const HUST_COURSE_API = new URL("/LsController/findNameCourse", location.origin).toString();
|
||||
const HUST_DEFAULT_SEMESTER_WEEKS = 20;
|
||||
|
||||
function getDefaultTerm(now = new Date()) {
|
||||
return {
|
||||
academicYear: now.getMonth() === 0 ? now.getFullYear() - 1 : now.getFullYear(),
|
||||
semester: now.getMonth() >= 1 && now.getMonth() <= 6 ? 2 : 1
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 生成与原 importer 相同范围的学期:当前年份前 4 年至后 1 年,共 12 个。
|
||||
* semester=1 为秋季,semester=2 为春季;倒序排列便于优先选择近期学期。
|
||||
*/
|
||||
function buildTermOptions(now = new Date()) {
|
||||
const currentYear = now.getFullYear();
|
||||
const terms = [];
|
||||
|
||||
for (let year = currentYear + 1; year >= currentYear - 4; year--) {
|
||||
terms.push({ academicYear: year, semester: 1, label: `${year} 年秋季学期` });
|
||||
terms.push({ academicYear: year, semester: 2, label: `${year} 年春季学期` });
|
||||
}
|
||||
|
||||
return terms;
|
||||
}
|
||||
|
||||
async function selectTerm() {
|
||||
const terms = buildTermOptions();
|
||||
const defaultTerm = getDefaultTerm();
|
||||
const defaultIndex = Math.max(0, terms.findIndex((term) =>
|
||||
term.academicYear === defaultTerm.academicYear &&
|
||||
term.semester === defaultTerm.semester
|
||||
));
|
||||
|
||||
const selectedIndex = await window.shiguangBridgePromise.showSingleSelection(
|
||||
"选择学期",
|
||||
JSON.stringify(terms.map((term) => term.label)),
|
||||
defaultIndex
|
||||
);
|
||||
|
||||
if (selectedIndex === null || selectedIndex === -1) {
|
||||
return null;
|
||||
}
|
||||
if (!Number.isInteger(selectedIndex) || selectedIndex < 0 || selectedIndex >= terms.length) {
|
||||
throw new Error("学期选择结果无效");
|
||||
}
|
||||
|
||||
return terms[selectedIndex];
|
||||
}
|
||||
|
||||
function parsePositiveInteger(value) {
|
||||
const parsed = Number.parseInt(String(value), 10);
|
||||
return Number.isInteger(parsed) && parsed > 0 ? parsed : null;
|
||||
}
|
||||
|
||||
function expandWeeks(startWeek, endWeek) {
|
||||
const weeks = [];
|
||||
for (let week = startWeek; week <= endWeek; week++) {
|
||||
weeks.push(week);
|
||||
}
|
||||
return weeks;
|
||||
}
|
||||
|
||||
/**
|
||||
* HUST 的一门课程可包含多个 tr 时段。本项目没有 extraSlots 字段,
|
||||
* 因此每个有效时段转换成一个标准课程块。
|
||||
*/
|
||||
function parseCourses(payload) {
|
||||
if (!payload || String(payload.code) !== "200" || !Array.isArray(payload.data)) {
|
||||
throw new Error(`课表接口返回异常(code: ${payload?.code ?? "未知"})`);
|
||||
}
|
||||
|
||||
const courses = [];
|
||||
|
||||
for (const item of payload.data) {
|
||||
const name = String(item?.KCMC ?? "").trim();
|
||||
if (!name || !Array.isArray(item?.tr)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
for (const slot of item.tr) {
|
||||
if (slot?.XQS === "<待定>" || slot?.QSJC === "<待定>") {
|
||||
continue;
|
||||
}
|
||||
|
||||
const day = parsePositiveInteger(slot?.XQS);
|
||||
const startSection = parsePositiveInteger(slot?.QSJC);
|
||||
const endSection = parsePositiveInteger(slot?.JSJC);
|
||||
const startWeek = parsePositiveInteger(slot?.QSZC);
|
||||
const endWeek = parsePositiveInteger(slot?.JSZC);
|
||||
|
||||
if (
|
||||
day === null || day > 7 ||
|
||||
startSection === null || endSection === null || endSection < startSection ||
|
||||
startWeek === null || endWeek === null || endWeek < startWeek
|
||||
) {
|
||||
console.warn("跳过无法解析的 HUST 课程时段:", name, slot);
|
||||
continue;
|
||||
}
|
||||
|
||||
courses.push({
|
||||
name,
|
||||
teacher: String(slot?.XM ?? "").trim(),
|
||||
position: String(slot?.JSMC ?? "").trim(),
|
||||
day,
|
||||
startSection,
|
||||
endSection,
|
||||
weeks: expandWeeks(startWeek, endWeek)
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
return courses;
|
||||
}
|
||||
|
||||
async function fetchCourses(term) {
|
||||
const termCode = `${term.academicYear}${term.semester}`;
|
||||
const response = await fetch(`${HUST_COURSE_API}?kcbxqh=${encodeURIComponent(termCode)}`, {
|
||||
method: "GET",
|
||||
credentials: "include",
|
||||
headers: {
|
||||
Accept: "application/json, text/plain, */*"
|
||||
}
|
||||
});
|
||||
|
||||
if (!response.ok) {
|
||||
throw new Error(`课表请求失败(HTTP ${response.status})`);
|
||||
}
|
||||
|
||||
const raw = await response.text();
|
||||
if (!raw.trim() || raw.trim().startsWith("<")) {
|
||||
throw new Error("未读取到课表数据,请确认已登录 HUB 系统并选择了正确的学期");
|
||||
}
|
||||
|
||||
try {
|
||||
return parseCourses(JSON.parse(raw));
|
||||
} catch (error) {
|
||||
if (error instanceof SyntaxError) {
|
||||
throw new Error("课表接口未返回有效 JSON,请重新登录后再试");
|
||||
}
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
async function saveCourses(courses) {
|
||||
await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(courses));
|
||||
|
||||
const semesterTotalWeeks = courses.reduce((maximum, course) => {
|
||||
const courseMaximum = course.weeks.length > 0 ? Math.max(...course.weeks) : 0;
|
||||
return Math.max(maximum, courseMaximum);
|
||||
}, HUST_DEFAULT_SEMESTER_WEEKS);
|
||||
|
||||
await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify({ semesterTotalWeeks }));
|
||||
}
|
||||
|
||||
async function runImportFlow() {
|
||||
try {
|
||||
const term = await selectTerm();
|
||||
if (term === null) {
|
||||
window.shiguangBridge.showToast("已取消导入");
|
||||
return;
|
||||
}
|
||||
|
||||
window.shiguangBridge.showToast(`正在获取 ${term.label} 课表...`);
|
||||
const courses = await fetchCourses(term);
|
||||
if (courses.length === 0) {
|
||||
window.shiguangBridge.showToast("该学期未查询到有效课程,请检查学期或登录状态");
|
||||
return;
|
||||
}
|
||||
|
||||
await saveCourses(courses);
|
||||
window.shiguangBridge.showToast(`成功导入 ${courses.length} 个课程时段,请按校历设置开学日期`);
|
||||
window.shiguangBridge.notifyTaskCompletion();
|
||||
} catch (error) {
|
||||
console.error("课表导入失败:", error);
|
||||
window.shiguangBridge.showToast(`导入失败:${error?.message ?? error}`);
|
||||
}
|
||||
}
|
||||
|
||||
runImportFlow();
|
||||
Reference in New Issue
Block a user