hualixy.js 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513
  1. // 广州华立学院(jw.hualixy.edu.cn) 拾光课程表适配脚本
  2. // 基于正方新一代教务系统接口适配
  3. // 维护者:小漫君(xiaomanjun233)
  4. // 出现问题请提issues或者提交pr更改,这更加快速
  5. //
  6. // 通过正方接口 xskbcx_cxXsgrkb 拉取个人课表 JSON(kbList),解析课程名、教师、教室、
  7. // 星期、节次和周次(含单双周)。集中实践课(军训、毕业设计等)无星期节次,直接忽略不导入。
  8. // 交互上自动读取教务系统的学年/学期下拉列表,用户只需依次点选即可,无需手动输入。
  9. // 通过 xskbcx_cxXskbcxIndex 读取学年学期选项、xskbcxZccx_cxZcByXnxq 取所选学期开学日期,
  10. // 并优先从 xskbcx_cxRjc 动态读取该校真实节次作息时间,读取失败时跳过作息导入。
  11. //
  12. // 使用方式:通过统一认证(https://jw.hualixy.edu.cn/sso/ddlogin)或正方直登
  13. // (https://jw.hualixy.edu.cn/jwglxt/xtgl/login_slogin.html)登录后,
  14. // 在教务系统(jw.hualixy.edu.cn/jwglxt)任意页面(如首页)直接执行导入即可,
  15. // 无需进入课表查询页面。脚本通过接口自动读取学年学期并获取课表与节次作息。
  16. // 正方新一代教务部分学校接口模块号可能不同,依次尝试常见模块号
  17. const GNMKDMS = ["N2151", "N253508"];
  18. /**
  19. * 拼接教务系统接口地址。
  20. * 正方新一代部署在 /jwglxt 子路径下,接口路径必须带上该前缀;
  21. * 校外经 WebVPN 访问时路径还带有 /http/<hex> 前缀,需保留。
  22. */
  23. function buildApiUrl(modulePath, gnmkdm) {
  24. const prefixMatch = window.location.pathname.match(/^\/http\/[0-9a-f]+/i);
  25. const webvpnPrefix = prefixMatch ? prefixMatch[0] : "";
  26. const gnmkdmQuery = gnmkdm ? "?gnmkdm=" + gnmkdm : "";
  27. return window.location.origin + webvpnPrefix + "/jwglxt" + modulePath + gnmkdmQuery;
  28. }
  29. /**
  30. * 解析周次字符串,处理单双周和周次范围。
  31. */
  32. function parseWeeks(weekStr) {
  33. if (!weekStr) return [];
  34. const weekSets = weekStr.split(',');
  35. let weeks = [];
  36. for (const set of weekSets) {
  37. const trimmedSet = set.trim();
  38. const rangeMatch = trimmedSet.match(/(\d+)-(\d+)周/);
  39. const singleMatch = trimmedSet.match(/^(\d+)周/);
  40. let start = 0;
  41. let end = 0;
  42. let processed = false;
  43. if (rangeMatch) {
  44. start = Number(rangeMatch[1]);
  45. end = Number(rangeMatch[2]);
  46. processed = true;
  47. } else if (singleMatch) {
  48. start = end = Number(singleMatch[1]);
  49. processed = true;
  50. }
  51. if (processed) {
  52. const isSingle = trimmedSet.includes('(单)');
  53. const isDouble = trimmedSet.includes('(双)');
  54. for (let w = start; w <= end; w++) {
  55. if (isSingle && w % 2 === 0) continue;
  56. if (isDouble && w % 2 !== 0) continue;
  57. weeks.push(w);
  58. }
  59. }
  60. }
  61. return [...new Set(weeks)].sort((a, b) => a - b);
  62. }
  63. /**
  64. * 解析 API 返回的 JSON 数据。
  65. */
  66. function parseJsonData(jsonData) {
  67. console.log("JS: parseJsonData 正在解析 JSON 数据...");
  68. if (!jsonData || !Array.isArray(jsonData.kbList)) {
  69. console.warn("JS: JSON 数据结构错误或缺少 kbList 字段。");
  70. return [];
  71. }
  72. const rawCourseList = jsonData.kbList;
  73. const finalCourseList = [];
  74. for (const rawCourse of rawCourseList) {
  75. if (!rawCourse.kcmc || !rawCourse.xqj || !rawCourse.jcs || !rawCourse.zcd) {
  76. continue;
  77. }
  78. const weeksArray = parseWeeks(rawCourse.zcd);
  79. if (weeksArray.length === 0) {
  80. continue;
  81. }
  82. const sectionParts = rawCourse.jcs.split('-');
  83. const startSection = Number(sectionParts[0]);
  84. const endSection = Number(sectionParts[sectionParts.length - 1]);
  85. const day = Number(rawCourse.xqj);
  86. if (isNaN(day) || isNaN(startSection) || isNaN(endSection) || day < 1 || day > 7 || startSection > endSection) {
  87. continue;
  88. }
  89. const course = {
  90. name: String(rawCourse.kcmc).trim(),
  91. teacher: String(rawCourse.xm || "").trim(),
  92. position: String(rawCourse.cdmc || "").trim(),
  93. day: day,
  94. startSection: startSection,
  95. endSection: endSection,
  96. weeks: weeksArray
  97. };
  98. finalCourseList.push(course);
  99. }
  100. finalCourseList.sort((a, b) =>
  101. a.day - b.day ||
  102. a.startSection - b.startSection ||
  103. a.name.localeCompare(b.name)
  104. );
  105. console.log(`JS: JSON 数据解析完成,共找到 ${finalCourseList.length} 门课程。`);
  106. return finalCourseList;
  107. }
  108. async function promptUserToStart() {
  109. return await window.shiguangBridgePromise.showAlert(
  110. "广州华立学院课表导入",
  111. "导入前请确保您已通过统一认证(jw.hualixy.edu.cn/sso/ddlogin)或正方直登登录教务系统;在任意页面直接执行导入即可,无需进入课表查询页面。",
  112. "好的,开始导入"
  113. );
  114. }
  115. /**
  116. * 从教务系统课表查询页读取学年与学期下拉选项(多个模块号依次尝试)。
  117. */
  118. async function fetchAcademicOptions() {
  119. for (const gnmkdm of GNMKDMS) {
  120. const url = buildApiUrl("/kbcx/xskbcx_cxXskbcxIndex.html", gnmkdm);
  121. try {
  122. const response = await fetch(url, { method: "GET", credentials: "include" });
  123. if (!response.ok) continue;
  124. const htmlText = await response.text();
  125. const doc = new DOMParser().parseFromString(htmlText, "text/html");
  126. const allYearOptions = Array.from(doc.querySelectorAll("#xnm option"))
  127. .filter((opt) => opt.value !== "")
  128. .map((opt) => ({
  129. value: opt.value,
  130. text: opt.textContent.trim(),
  131. selected: opt.selected
  132. }));
  133. const semesterOptions = Array.from(doc.querySelectorAll("#xqm option"))
  134. .filter((opt) => opt.value !== "")
  135. .map((opt) => ({
  136. value: opt.value,
  137. text: opt.textContent.trim(),
  138. selected: opt.selected
  139. }));
  140. if (allYearOptions.length === 0 || semesterOptions.length === 0) continue;
  141. const defaultSemesterIndex = (() => {
  142. const i = semesterOptions.findIndex((opt) => opt.selected);
  143. return i !== -1 ? i : 0;
  144. })();
  145. const selectedIndex = allYearOptions.findIndex((opt) => opt.selected);
  146. if (selectedIndex === -1) {
  147. return {
  148. yearOptions: allYearOptions.slice(0, 5),
  149. semesterOptions,
  150. defaultYearIndex: 0,
  151. defaultSemesterIndex
  152. };
  153. }
  154. const start = Math.max(0, selectedIndex - 2);
  155. const end = Math.min(allYearOptions.length, selectedIndex + 3);
  156. return {
  157. yearOptions: allYearOptions.slice(start, end),
  158. semesterOptions,
  159. defaultYearIndex: selectedIndex - start,
  160. defaultSemesterIndex
  161. };
  162. } catch (e) {
  163. console.warn(`JS: 读取学年学期失败(gnmkdm=${gnmkdm}):`, e);
  164. }
  165. }
  166. return null;
  167. }
  168. async function selectAcademicYearAndSemester() {
  169. const optionsData = await fetchAcademicOptions();
  170. if (!optionsData) {
  171. window.shiguangBridge.showToast("从教务系统读取学年学期失败,请确认登录状态有效。");
  172. return null;
  173. }
  174. const { yearOptions, semesterOptions, defaultYearIndex, defaultSemesterIndex } = optionsData;
  175. const yearIndex = await window.shiguangBridgePromise.showSingleSelection(
  176. "选择学年",
  177. JSON.stringify(yearOptions.map((item) => item.text)),
  178. defaultYearIndex
  179. );
  180. if (yearIndex === null || yearIndex === -1) return null;
  181. const academicYear = yearOptions[yearIndex].value;
  182. const semesterIndex = await window.shiguangBridgePromise.showSingleSelection(
  183. "选择学期",
  184. JSON.stringify(semesterOptions.map((item) => item.text)),
  185. defaultSemesterIndex
  186. );
  187. if (semesterIndex === null || semesterIndex === -1) return null;
  188. return {
  189. academicYear,
  190. semesterCode: semesterOptions[semesterIndex].value
  191. };
  192. }
  193. /**
  194. * 获取所选学期的开学日期(第 1 周的日期)。
  195. */
  196. async function fetchSemesterStartDate(academicYear, semesterCode) {
  197. for (const gnmkdm of GNMKDMS) {
  198. const url = buildApiUrl("/kbcx/xskbcxZccx_cxZcByXnxq.html", gnmkdm);
  199. try {
  200. const response = await fetch(url, {
  201. method: "POST",
  202. headers: { "content-type": "application/x-www-form-urlencoded;charset=UTF-8" },
  203. body: `xnm=${academicYear}&xqm=${semesterCode}`,
  204. credentials: "include"
  205. });
  206. if (response.ok) {
  207. const json = await response.json();
  208. if (Array.isArray(json) && json.length > 0) {
  209. const firstWeekObj = json.find((item) => String(item.zs) === "1" || String(item.zsmc) === "1") || json[0];
  210. const matchStr = String(firstWeekObj.rq || firstWeekObj.zcrq || firstWeekObj.ksrq || "").match(/(\d{4}-\d{2}-\d{2})/);
  211. if (matchStr) return matchStr[1];
  212. }
  213. }
  214. } catch (e) {
  215. console.warn(`JS: 获取开学日期失败(gnmkdm=${gnmkdm}):`, e);
  216. }
  217. }
  218. return null;
  219. }
  220. /**
  221. * 从正方系统动态获取该学期真实节次作息时间。
  222. * 读取失败返回 null,由调用方跳过作息导入(不写死未知作息)。
  223. */
  224. async function fetchAndParseTimeSlots(academicYear, semesterCode) {
  225. const requestBody = "xnm=" + encodeURIComponent(academicYear) +
  226. "&xqm=" + encodeURIComponent(semesterCode) +
  227. "&kzlx=ck&xsdm=&kclbdm=&kclxdm=";
  228. let lastError = null;
  229. for (const gnmkdm of GNMKDMS) {
  230. const url = buildApiUrl("/kbcx/xskbcx_cxRjc.html", gnmkdm);
  231. try {
  232. const response = await fetch(url, {
  233. headers: {
  234. "content-type": "application/x-www-form-urlencoded;charset=UTF-8",
  235. "X-Requested-With": "XMLHttpRequest",
  236. },
  237. body: requestBody,
  238. method: "POST",
  239. credentials: "include"
  240. });
  241. if (!response.ok) {
  242. lastError = "HTTP " + response.status;
  243. console.warn(`JS: 节次时间接口请求失败(gnmkdm=${gnmkdm}):HTTP ${response.status}`);
  244. continue;
  245. }
  246. const responseText = await response.text();
  247. const responsePreview = responseText.replace(/\s+/g, " ").trim().slice(0, 200) || "<空响应>";
  248. let data;
  249. try {
  250. data = JSON.parse(responseText);
  251. } catch (e) {
  252. lastError = "非 JSON:响应=" + responsePreview;
  253. console.warn(`JS: 节次时间接口未返回 JSON(gnmkdm=${gnmkdm}):`, e);
  254. continue;
  255. }
  256. if (data && !Array.isArray(data) && Array.isArray(data.data)) {
  257. data = data.data;
  258. }
  259. if (!Array.isArray(data)) {
  260. lastError = "格式异常:响应=" + responsePreview;
  261. console.warn(`JS: 节次时间接口返回格式异常(gnmkdm=${gnmkdm}): ${responsePreview}`);
  262. continue;
  263. }
  264. const timeSlots = [];
  265. for (const item of data) {
  266. if (!item || typeof item !== "object") continue;
  267. const number = Number(item.jcdm != null ? item.jcdm : item.jcmc);
  268. let startTime = "";
  269. let endTime = "";
  270. if (item.qssj != null && item.jssj != null) {
  271. startTime = String(item.qssj).trim();
  272. endTime = String(item.jssj).trim();
  273. } else if (item.sksj) {
  274. const sksjParts = String(item.sksj).split(/[~\-—至到]/);
  275. if (sksjParts.length >= 2) {
  276. startTime = sksjParts[0].trim();
  277. endTime = sksjParts[1].trim();
  278. }
  279. }
  280. startTime = startTime.slice(0, 5);
  281. endTime = endTime.slice(0, 5);
  282. if (!(number > 0) || !startTime || !endTime) continue;
  283. timeSlots.push({ number, startTime, endTime });
  284. }
  285. timeSlots.sort((a, b) => a.number - b.number);
  286. if (timeSlots.length === 0) {
  287. lastError = "无有效数据:响应=" + responsePreview;
  288. console.warn(`JS: 节次时间接口未返回有效作息时间(gnmkdm=${gnmkdm}): ${responsePreview}`);
  289. continue;
  290. }
  291. console.log(`JS: 获取到真实节次作息 ${timeSlots.length} 条(gnmkdm=${gnmkdm}),第1节 ${timeSlots[0].startTime}-${timeSlots[0].endTime}`);
  292. return timeSlots;
  293. } catch (error) {
  294. lastError = error.message || String(error);
  295. console.warn(`JS: 获取节次作息时间失败(gnmkdm=${gnmkdm}):`, error);
  296. }
  297. }
  298. console.warn("JS: 所有节次时间接口尝试均失败,最后原因:" + lastError);
  299. return null;
  300. }
  301. /**
  302. * 计算课表配置。只在能拿到真实开学日期时返回配置,否则返回 null 由调用方跳过。
  303. */
  304. function buildCourseConfig(courses, startDate, firstDayOfWeek) {
  305. if (!startDate) return null;
  306. let maxWeek = 0;
  307. for (const course of courses) {
  308. for (const week of course.weeks) {
  309. if (week > maxWeek) maxWeek = week;
  310. }
  311. }
  312. return {
  313. semesterStartDate: startDate,
  314. semesterTotalWeeks: Math.max(maxWeek, 20),
  315. firstDayOfWeek: firstDayOfWeek
  316. };
  317. }
  318. /**
  319. * 请求和解析课程数据。并行拉取课表 JSON 与所选学期开学日期。
  320. */
  321. async function fetchAndParseCourses(academicYear, semesterCode) {
  322. window.shiguangBridge.showToast("正在请求课表数据...");
  323. const body = `xnm=${academicYear}&xqm=${semesterCode}&kzlx=ck&xsdm=&kclbdm=`;
  324. let lastError = null;
  325. for (const gnmkdm of GNMKDMS) {
  326. const url = buildApiUrl("/kbcx/xskbcx_cxXsgrkb.html", gnmkdm);
  327. try {
  328. const [courseResponse, startDate] = await Promise.all([
  329. fetch(url, {
  330. method: "POST",
  331. headers: { "content-type": "application/x-www-form-urlencoded;charset=UTF-8" },
  332. body,
  333. credentials: "include"
  334. }),
  335. fetchSemesterStartDate(academicYear, semesterCode)
  336. ]);
  337. if (!courseResponse.ok) {
  338. lastError = `网络请求失败。状态码: ${courseResponse.status} (${courseResponse.statusText})`;
  339. console.warn(`JS: 课程请求失败(gnmkdm=${gnmkdm}):${lastError}`);
  340. continue;
  341. }
  342. const jsonText = await courseResponse.text();
  343. if (jsonText.indexOf("登录") !== -1 && jsonText.indexOf("密码") !== -1) {
  344. lastError = "课表接口返回了登录页面,登录会话已失效";
  345. console.warn(`JS: ${lastError}(gnmkdm=${gnmkdm})`);
  346. continue;
  347. }
  348. let jsonData;
  349. try {
  350. jsonData = JSON.parse(jsonText);
  351. } catch (e) {
  352. lastError = "数据返回格式错误";
  353. console.warn(`JS: JSON 解析失败(gnmkdm=${gnmkdm}):`, e);
  354. continue;
  355. }
  356. const courses = parseJsonData(jsonData);
  357. if (courses.length === 0) {
  358. window.shiguangBridge.showToast("未找到任何课程数据,请确认登录状态有效(非停留在登录页)、所选学年学期正确,或本学期无课。");
  359. return null;
  360. }
  361. console.log(`JS: 课程数据解析成功,共找到 ${courses.length} 门课程(gnmkdm=${gnmkdm})。`);
  362. const rawFirstDay = Number(jsonData.qsxqj);
  363. const firstDayOfWeek = (rawFirstDay >= 1 && rawFirstDay <= 7) ? rawFirstDay : 1;
  364. return { courses, startDate, firstDayOfWeek };
  365. } catch (error) {
  366. lastError = error.message;
  367. console.warn(`JS: Fetch/Parse Error(gnmkdm=${gnmkdm}):`, error);
  368. }
  369. }
  370. window.shiguangBridge.showToast(`请求或解析失败: ${lastError}`);
  371. return null;
  372. }
  373. async function saveCourses(parsedCourses) {
  374. window.shiguangBridge.showToast(`正在保存 ${parsedCourses.length} 门课程...`);
  375. try {
  376. await window.shiguangBridgePromise.saveImportedCourses(JSON.stringify(parsedCourses, null, 2));
  377. return true;
  378. } catch (error) {
  379. window.shiguangBridge.showToast(`课程保存失败: ${error.message}`);
  380. console.error('JS: Save Courses Error:', error);
  381. return false;
  382. }
  383. }
  384. async function saveCourseConfigIfPossible(courses, startDate, firstDayOfWeek) {
  385. const config = buildCourseConfig(courses, startDate, firstDayOfWeek);
  386. if (!config) {
  387. window.shiguangBridge.showToast("未取到本学期开学日期,已跳过课表配置,请在应用内手动设置开学日期。");
  388. return;
  389. }
  390. try {
  391. await window.shiguangBridgePromise.saveCourseConfig(JSON.stringify(config));
  392. window.shiguangBridge.showToast(`开学日期 ${config.semesterStartDate},总周数 ${config.semesterTotalWeeks} 周。`);
  393. } catch (error) {
  394. window.shiguangBridge.showToast(`课表配置保存失败: ${error.message}`);
  395. console.error('JS: Save Config Error:', error);
  396. }
  397. }
  398. async function importPresetTimeSlots(timeSlots) {
  399. if (!timeSlots || timeSlots.length === 0) {
  400. window.shiguangBridge.showToast("未能读取该校真实作息时间,已跳过作息导入,请手动设置节次时间或其他节次时段。");
  401. return;
  402. }
  403. window.shiguangBridge.showToast(`正在导入 ${timeSlots.length} 个预设时间段...`);
  404. try {
  405. await window.shiguangBridgePromise.savePresetTimeSlots(JSON.stringify(timeSlots));
  406. window.shiguangBridge.showToast("预设时间段导入成功!");
  407. } catch (error) {
  408. window.shiguangBridge.showToast("导入时间段失败: " + error.message);
  409. console.error('JS: Save Time Slots Error:', error);
  410. }
  411. }
  412. async function runImportFlow() {
  413. const alertConfirmed = await promptUserToStart();
  414. if (!alertConfirmed) {
  415. window.shiguangBridge.showToast("用户取消了导入。");
  416. return;
  417. }
  418. const selection = await selectAcademicYearAndSemester();
  419. if (selection === null) {
  420. window.shiguangBridge.showToast("导入已取消。");
  421. return;
  422. }
  423. console.log(`JS: 已选择学年学期: ${selection.academicYear}/${selection.semesterCode}`);
  424. const result = await fetchAndParseCourses(selection.academicYear, selection.semesterCode);
  425. if (result === null) {
  426. console.log("JS: 课程获取或解析失败,流程终止。");
  427. return;
  428. }
  429. const { courses, startDate, firstDayOfWeek } = result;
  430. const saveResult = await saveCourses(courses);
  431. if (!saveResult) {
  432. console.log("JS: 课程保存失败,流程终止。");
  433. return;
  434. }
  435. await saveCourseConfigIfPossible(courses, startDate, firstDayOfWeek);
  436. const timeSlots = await fetchAndParseTimeSlots(selection.academicYear, selection.semesterCode);
  437. await importPresetTimeSlots(timeSlots);
  438. window.shiguangBridge.showToast(`课程导入成功,共导入 ${courses.length} 门课程!`);
  439. console.log("JS: 整个导入流程执行完毕并成功。");
  440. window.shiguangBridge.notifyTaskCompletion();
  441. }
  442. runImportFlow();