Merge pull request #16 from XingHeYuZhuan/pending

Pending

README.md

@@ -6,43 +6,84 @@
 
 ## 仓库结构说明
 
-- `schools.json`：适配学校索引列表，包含所有已适配学校的关键信息。
-- `schools/`：存放各学校的适配代码，每个学校一个独立的 JS 文件。
-- `LICENSE`：开源协议文件。
 
-## schools.json 字段说明
+## 资源目录结构
 
-每个学校索引应包含以下字段：
+每个学校或工具都有一个独立的目录，包含以下文件：
+## root_index.yaml 填写与适配流程
+
+所有适配学校/工具必须先在 `index/root_index.yaml` 文件中登记，CI/CD 构建脚本会根据此文件决定处理哪些资源。
+
+### 字段说明
+
+每个学校/工具条目需包含如下字段：
+
+| 字段名           | 类型    | 说明                       |
+| --------------- | ------- | -------------------------- |
+| id              | String  | 唯一标识（建议拼音或缩写） |
+| name            | String  | 中文名称                   |
+| initial         | String  | 名称首字母（用于排序）     |
+| resource_folder | String  | 资源文件夹名称             |
+
+示例：
+```yaml
+schools:
+      - id: "GLOBAL_TOOLS"
+            name: "通用工具与服务"
+            initial: "G"
+            resource_folder: "GLOBAL_TOOLS"
+      - id: "CUST"
+            name: "长春理工大学"
+            initial: "C"
+            resource_folder: "CUST"
+```
+
+### 适配注意
+
+1. 若要适配新学校/工具，**必须先在 `root_index.yaml` 添加条目**，填写上述字段。
+2. 在 `resources/` 下创建与 `resource_folder` 字段一致的文件夹。
+3. 在该文件夹内添加 `adapters.yaml` 和适配脚本。
+4. 只有在 `root_index.yaml` 已登记的学校/工具，才能提交适配文件。
+5. 新增学校/工具时，请确保在适配 PR 中已将相关条目添加到 `root_index.yaml` 的学校列表，无需单独提交更新 PR。
+
+```
+资源目录名/
+  ├── adapters.yaml  # 配置信息
+  └── xxx.js         # 适配脚本
+```
+
+## adapters.yaml 配置说明
+
+
+每个适配器配置应包含以下字段（YAML格式，字段全部必填）：
+
+| 字段名           | 类型    | 说明                                   |
+| --------------- | ------- | -------------------------------------- |
+| adapter_id      | String  | 唯一标识（建议用拼音或英文缩写）,个人建议使用学校id加序号的形式        |
+| adapter_name    | String  | 中文名称                               |
+| category        | String  | 分类：`BACHELOR_AND_ASSOCIATE`(本科/专科)、`POSTGRADUATE`(研究生)、`GENERAL_TOOL`(通用工具) |
+| asset_js_path   | String  | 适配脚本的**相对路径**（如 `school.js`）         |
+| import_url      | String  | 系统登录URL（教务系统适配器必填，工具可为空） |
+| maintainer      | String  | 维护者信息（如姓名或 GitHub 用户名）    |
+| description     | String  | 简要说明（如适配用途、备注等）          |
 
-| 字段名         | 类型    | 说明                                   |
-| -------------- | ------- | -------------------------------------- |
-| `id`           | String  | 学校唯一标识（建议用拼音或英文缩写）    |
-| `name`         | String  | 学校中文全称                           |
-| `initial`      | String  | 学校名称的首字母，用于排序和查找        |
-| `importUrl`    | String  | 教务系统登录的 URL                      |
-| `assetJsPath`  | String  | 适配脚本路径（如 `schools/school.js`）  |
-| `maintainer`   | String  | 维护者信息（如姓名或 GitHub 用户名）    |
-| `category`   | String  | 适配类别。 `BACHELOR_AND_ASSOCIATE` 表示“本科/专科”，`POSTGRADUATE` 表示“研究生”，`GENERAL_TOOL` 表示“通用工具”。 |
 
 示例：
-```json
-[
-  {
-    "id": "school_Cs",
-    "name": "测试大学(这是一个空网站，用于组件测试)",
-    "initial": "C",
-    "importUrl": "",
-    "assetJsPath": "schools/school.js",
-   "maintainer": "星河欲转",
-   "category": "GENERAL_TOOL"
-  }
-]
+```yaml
+adapters:
+      - adapter_id: "GENERAL_TOOL_01" # id加上序号
+            adapter_name: "组件测试"
+            category: "GENERAL_TOOL"
+            asset_js_path: "school.js" #相对路径
+            import_url: ""
+            maintainer: "星河欲转"
+            description: "这是一个空网站，用于组件测试与演示模式"
 ```
 
 **注意：**  
 - 请严格按照上述字段填写，不要添加或减少字段。
 - `importUrl` 一定要是登录页面。
-- `assetJsPath` 填写对应学校的适配脚本路径。
+- `asset_js_path` 填写对应学校的适配脚本**相对路径**。
 - `maintainer` 填写维护者信息，便于后续沟通和维护。
 
 ## 开发流程
@@ -53,8 +94,9 @@
 
 3.  **添加适配代码**
 
-      - 在 `schools/` 文件夹下新建对应学校的适配 JS 文件。
-      - 在 `schools.json` 中添加学校索引信息，确保各字段填写完整。
+      - 在 `resources/` 目录下创建对应学校/工具的目录,新增学校记得添加学校索引`root_index.yaml`
+      - 在学校/工具目录中添加 `adapters.yaml` 配置文件和对应的适配脚本。
+      - 确保配置文件中的所有字段都填写完整和准确。
 
 4.  **软件测试**
 
@@ -67,7 +109,7 @@
 ## 社区约束
 
 - 禁止恶意抹除公开代码的原始开发者的代码贡献记录。
-- 未经相关授权，禁止在脱离官方分支的包中包含其他开发者的适配代码，仅可使用自己所有的适配代码。其他开发者的适配代码仅能在官方仓库或其分支中使用。
+- 未经相关授权，禁止在脱离官方分支的包中包含其他开发者的适配代码，仅可使用自己所有的适配代码。其他开发者的适配代码仅能在官方仓库或其分支中使用，除非你获得相应的开发者授权。
 - **例外情况**：如果您的分支或私有适配仓库仅用于官方 app 的内部测试或个人使用（即仅在官方 app 范围内显示和调用，不对外分发或公开），则可以包含其他开发者的适配代码。  
   但如果您的分支或包对外分发、公开或用于非官方 app，则只能包含您自己拥有的适配代码，不能包含其他开发者的适配代码，除非获得相关授权。
 - 允许开发者建立私有仓库或分支本软件，但需遵守上述约定。
@@ -76,7 +118,7 @@
 
 ## 注意事项
 
-- 请确保 `schools.json` 信息准确，入口文件路径与实际文件一致。
+- 请确保 `adapters.yaml` 信息准确完整，符合规范要求。
 - 每次提交适配代码或索引信息后，建议自测通过再提交 PR。
 - 仓库需保留 `lighthouse` 标签，否则软件无法识别为适配仓库。
 

index/root_index.yaml

@@ -31,4 +31,9 @@ schools:
   - id: "YNUFE"
     name: "云南财经大学"
     initial: "Y"
-    resource_folder: "YNUFE"
+    resource_folder: "YNUFE"
+
+  - id: "HNSF"
+    name: "河南师范大学"
+    initial: "H"
+    resource_folder: "HNSF"    

resources/HNSF/adapters.yaml

@@ -0,0 +1,9 @@
+# resources/HNSF/adapters.yaml
+adapters:
+  - adapter_id: "HNSF_01"
+    adapter_name: "河南师范大学适配教务"
+    category: "BACHELOR_AND_ASSOCIATE"
+    asset_js_path: "hnsf_01.js"
+    import_url: "https://jwc.htu.edu.cn/"
+    maintainer: "星河欲转"
+    description: "河南师范大学适配教务,添加双季作息,非本校开发者适配如果有误建议提交issue"

resources/HNSF/hnsf_01.js

@@ -0,0 +1,328 @@
+// 河南师范大学(htu.edu.cn) 拾光课程表适配脚本
+// 非该大学开发者适配,开发者无法及时发现问题
+// 出现问题请提联系开发者或者提交pr更改,这更加快速
+
+function parseWeeks(weekStr) {
+    if (!weekStr) return [];
+    
+    // 假设新接口的 'zc' 字段已经是逗号分隔的周次数字字符串
+    const weeks = weekStr.split(',')
+        .map(w => Number(w.trim())) // 转换为数字
+        .filter(w => !isNaN(w) && w > 0); // 过滤掉无效数字
+
+    // 去重并排序
+    return [...new Set(weeks)].sort((a, b) => a - b);
+}
+
+function parseJsonData(jsonData) {
+    console.log("JS: parseJsonData 正在解析 JSON 数据...");
+    
+    // 检查JSON结构
+    if (!jsonData || jsonData.code !== 0 || !Array.isArray(jsonData.data)) {
+        console.warn("JS: JSON 数据结构错误或code不为0。");
+        return [];
+    }
+
+    const rawCourseList = jsonData.data;
+    const finalCourseList = [];
+
+    for (const rawCourse of rawCourseList) {
+        // 关键字段检查
+        if (!rawCourse.kcmc || !rawCourse.teaxms || !rawCourse.jxcdmc || 
+            !rawCourse.xq || !rawCourse.ps || !rawCourse.pe || !rawCourse.zc) {
+            // console.warn("JS: 发现缺少关键字段的课程记录，跳过。", rawCourse);
+            continue;
+        }
+
+        const weeksArray = parseWeeks(rawCourse.zc);
+        
+        // 周次有效性检查
+        if (weeksArray.length === 0) {
+             // console.warn(`JS: 课程 ${rawCourse.kcmc} 周次解析失败或为空，跳过。`);
+             continue;
+        }
+
+        const day = Number(rawCourse.xq); // xq: 星期几 (周一为1)
+        const startSection = Number(rawCourse.ps);
+        const endSection = Number(rawCourse.pe);
+        
+        // 数字有效性检查
+        if (isNaN(day) || isNaN(startSection) || isNaN(endSection) || day < 1 || day > 7 || startSection > endSection) {
+             // console.warn(`JS: 课程 ${rawCourse.kcmc} 星期或节次数据无效，跳过。`);
+             continue;
+        }
+
+        finalCourseList.push({
+            name: rawCourse.kcmc.trim(),
+            teacher: rawCourse.teaxms.trim(),
+            position: rawCourse.jxcdmc.trim(),
+            day: day, 
+            startSection: startSection,
+            endSection: endSection, 
+            weeks: weeksArray
+        });
+    }
+
+    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;
+}
+
+
+function isLoginPage() {
+    const url = window.location.href;
+    
+    const expectedBaseUrl = 'https://jwc.htu.edu.cn';
+    
+    const cleanUrl = url.endsWith('/') ? url.slice(0, -1) : url;
+    const isRootLogin = cleanUrl === expectedBaseUrl; 
+
+    const isKeywordLogin = url.includes('login') || url.includes('cas');
+    
+    return url.includes('htu.edu.cn') && (isRootLogin || isKeywordLogin);
+}
+
+function validateYearInput(input) {
+    console.log("JS: validateYearInput 被调用，输入: " + input);
+    if (/^[0-9]{4}$/.test(input)) {
+        console.log("JS: validateYearInput 验证通过。");
+        return false;
+    } else {
+        console.log("JS: validateYearInput 验证失败。");
+        return "请输入四位数字的学年！";
+    }
+}
+async function promptUserToStart() {
+    console.log("JS: 流程开始：显示公告。");
+    return await window.AndroidBridgePromise.showAlert(
+        "教务系统课表导入",
+        "导入前请确保您已在浏览器中成功登录教务系统",
+        "好的，开始导入"
+    );
+}
+
+async function getAcademicYear() {
+    const currentYear = new Date().getFullYear().toString();
+    console.log("JS: 提示用户输入学年。");
+    return await window.AndroidBridgePromise.showPrompt(
+        "选择学年",
+        "请输入要导入课程的学年（例如 2025）:",
+        currentYear,
+        "validateYearInput"
+    );
+}
+
+async function selectSemester() {
+    const semesters = ["第一学期 (01)", "第二学期 (02)"];
+    console.log("JS: 提示用户选择学期。");
+    const semesterIndex = await window.AndroidBridgePromise.showSingleSelection(
+        "选择学期",
+        JSON.stringify(semesters),
+        0
+    );
+    return semesterIndex;
+}
+
+async function fetchAndParseCourses(academicYear, semesterIndex) {
+    AndroidBridge.showToast("正在请求课表数据...");
+
+    // 学年学期代码组合：202501 (第一学期), 202502 (第二学期)
+    // semesterIndex 0 对应 01, 1 对应 02
+    const semesterCode = semesterIndex === 0 ? "01" : "02"; 
+    const xnxqdmBody = `xnxqdm=${academicYear}${semesterCode}`;
+    const url = "https://jwc.htu.edu.cn/new/student/xsgrkb/getCalendarWeekDatas";
+
+    console.log(`JS: 发送请求到 ${url}, body: ${xnxqdmBody}`);
+
+    const requestOptions = {
+        "headers": {
+            "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
+        },
+        "body": xnxqdmBody,
+        "method": "POST",
+        "credentials": "include"
+    };
+
+    try {
+        const response = await fetch(url, requestOptions);
+
+        if (!response.ok) {
+            throw new Error(`网络请求失败。状态码: ${response.status} (${response.statusText})`);
+        }
+        
+        const jsonText = await response.text();
+        let jsonData;
+        try {
+            jsonData = JSON.parse(jsonText);
+        } catch (e) {
+            console.error('JS: JSON 解析失败:', e);
+            AndroidBridge.showToast("数据返回格式错误，可能是您未成功登录或会话已过期。");
+            return null;
+        }
+
+        const courses = parseJsonData(jsonData);
+
+        if (courses.length === 0) {
+            AndroidBridge.showToast("未找到任何课程数据，请检查所选学年学期是否正确或本学期无课。");
+            return null;
+        }
+
+        console.log(`JS: 课程数据解析成功，共找到 ${courses.length} 门课程。`);
+
+        return { courses: courses };
+
+    } catch (error) {
+        AndroidBridge.showToast(`请求或解析失败: ${error.message}`);
+        console.error('JS: Fetch/Parse Error:', error);
+        return null;
+    }
+}
+
+
+async function saveCourses(parsedCourses) {
+    AndroidBridge.showToast(`正在保存 ${parsedCourses.length} 门课程...`);
+    console.log(`JS: 尝试保存 ${parsedCourses.length} 门课程...`);
+    try {
+        await window.AndroidBridgePromise.saveImportedCourses(JSON.stringify(parsedCourses, null, 2));
+        console.log("JS: 课程保存成功！");
+        return true;
+    } catch (error) {
+        AndroidBridge.showToast(`课程保存失败: ${error.message}`);
+        console.error('JS: Save Courses Error:', error);
+        return false;
+    }
+}
+
+const Non_summerTimeSlots = [
+    { number: 1, startTime: "08:00", endTime: "08:45" },
+    { number: 2, startTime: "08:55", endTime: "09:40" },
+    { number: 3, startTime: "10:10", endTime: "10:55" },
+    { number: 4, startTime: "11:05", endTime: "11:50" },
+    { number: 5, startTime: "14:30", endTime: "15:15" },
+    { number: 6, startTime: "15:25", endTime: "16:10" },
+    { number: 7, startTime: "16:40", endTime: "17:25" },
+    { number: 8, startTime: "17:35", "endTime": "18:20" },
+    { number: 9, startTime: "19:30", "endTime": "20:15" },
+    { number: 10, startTime: "20:25", "endTime": "21:10" }
+];
+const SummerTimeSlots = [
+    { number: 1, startTime: "08:00", endTime: "08:45" },
+    { number: 2, startTime: "08:55", endTime: "09:40" },
+    { number: 3, startTime: "10:10", endTime: "10:55" },
+    { number: 4, startTime: "11:05", endTime: "11:50" },
+    { number: 5, startTime: "15:00", endTime: "15:45" },
+    { number: 6, startTime: "15:55", endTime: "16:40" },
+    { number: 7, startTime: "17:10", endTime: "17:55" },
+    { number: 8, startTime: "18:05", "endTime": "18:50" },
+    { number: 9, startTime: "20:00", "endTime": "20:45" },
+    { number: 10, startTime: "20:55", "endTime": "21:40" }
+];
+
+async function selectTimeSlotsType() {
+    const timeSlotsOptions = ["非夏季作息", "夏季作息"];
+    console.log("JS: 提示用户选择作息时间类型。");
+    const selectedIndex = await window.AndroidBridgePromise.showSingleSelection(
+        "选择作息时间",
+        JSON.stringify(timeSlotsOptions),
+        0
+    );
+    return selectedIndex;
+}
+
+async function importPresetTimeSlots(timeSlots) {
+    console.log(`JS: 准备导入 ${timeSlots.length} 个预设时间段。`);
+
+    if (timeSlots.length > 0) {
+        AndroidBridge.showToast(`正在导入 ${timeSlots.length} 个预设时间段...`);
+        try {
+            await window.AndroidBridgePromise.savePresetTimeSlots(JSON.stringify(timeSlots));
+            AndroidBridge.showToast("预设时间段导入成功！");
+            console.log("JS: 预设时间段导入成功。");
+        } catch (error) {
+            AndroidBridge.showToast("导入时间段失败: " + error.message);
+            console.error('JS: Save Time Slots Error:', error);
+        }
+    } else {
+        AndroidBridge.showToast("警告：时间段为空，未导入时间段信息。");
+        console.warn("JS: 警告：传入时间段为空，未导入时间段信息。");
+    }
+}
+
+
+async function runImportFlow() {
+    if (isLoginPage()) {
+        AndroidBridge.showToast("导入失败：请先登录教务系统！");
+        console.log("JS: 检测到当前在登录页面，终止导入。");
+        return;
+    }
+
+    // 1. 公告和前置检查。
+    const alertConfirmed = await promptUserToStart();
+    if (!alertConfirmed) {
+        AndroidBridge.showToast("用户取消了导入。");
+        console.log("JS: 用户取消了导入流程。");
+        return;
+    }
+
+    const academicYear = await getAcademicYear();
+    if (academicYear === null) {
+        AndroidBridge.showToast("导入已取消。");
+        console.log("JS: 获取学年失败/取消，流程终止。");
+        return;
+    }
+    console.log(`JS: 已选择学年: ${academicYear}`);
+
+
+    const semesterIndex = await selectSemester();
+    if (semesterIndex === null || semesterIndex === -1) {
+        AndroidBridge.showToast("导入已取消。");
+        console.log("JS: 选择学期失败/取消，流程终止。");
+        return;
+    }
+    console.log(`JS: 已选择学期索引: ${semesterIndex}`);
+
+    // 2. 获取并解析课程
+    const result = await fetchAndParseCourses(academicYear, semesterIndex);
+    if (result === null) {
+        console.log("JS: 课程获取或解析失败，流程终止。");
+        return;
+    }
+    const { courses } = result;
+
+    // 3. 课程数据保存。
+    const saveResult = await saveCourses(courses);
+    if (!saveResult) {
+        console.log("JS: 课程保存失败，流程终止。");
+        return;
+    }
+
+    // 4. 作息时间选择与导入
+    const timeSlotsIndex = await selectTimeSlotsType();
+    let selectedTimeSlots = [];
+
+    if (timeSlotsIndex === 0) {
+        // 0: 非夏季作息
+        selectedTimeSlots = Non_summerTimeSlots;
+        console.log("JS: 已选择非夏季作息。");
+    } else if (timeSlotsIndex === 1) {
+        // 1: 夏季作息
+        selectedTimeSlots = SummerTimeSlots;
+        console.log("JS: 已选择夏季作息。");
+    } else {
+        selectedTimeSlots = Non_summerTimeSlots;
+        console.warn("JS: 作息时间选择失败/取消，使用非夏季作息作为默认值。");
+    }
+    await importPresetTimeSlots(selectedTimeSlots);
+
+
+    AndroidBridge.showToast(`课程导入成功，共导入 ${courses.length} 门课程！`);
+    console.log("JS: 整个导入流程执行完毕并成功。");
+    AndroidBridge.notifyTaskCompletion();
+}
+
+runImportFlow();

resources/YNUFE/adapters.yaml

@@ -1,9 +1,9 @@
 # resources/YNUFE/adapters.yaml
 adapters:
   - adapter_id: "YNUFE_01" # 采用数字编号规范
-    adapter_name: "云南财经大学教务系统"
+    adapter_name: "云财本科教务系统（强智）"
     category: "BACHELOR_AND_ASSOCIATE"
     asset_js_path: "ynufe.js"
     import_url: "https://xjwis.ynufe.edu.cn/jsxsd/"
     maintainer: "AxelPLN"
-    description: ""
+    description: "基于强智教务系统针对云财本科现行课程时间表进行了适配，理论上其他使用强智教务的学校也可借助本脚本进行适配，适配时请务必根据贵校现行的时间表进行修改。"

resources/YNUFE/ynufe.js

@@ -1,6 +1,3 @@
-// 云南财经大学教务系统课程表导入脚本
-// 基于拾光课表官方适配规范开发
-
 // ========== 工具函数 ==========
 
 /**