加了一些注释

Author: hello8693

src/core/classIslandLoader.ts

@@ -1,17 +1,26 @@
+// 导入Profile类
 import { Profile } from "./models/classisland/Profile";
 
+// 定义一个函数mapToObject，用于将Map对象转换为Object对象
 function mapToObject<TKey, TValue>(map: Map<TKey, TValue>): Map<TKey, TValue> {
+    // 创建一个新对象
     const obj = Object.create(null);
+    // 遍历Map对象，将每一项赋值给新对象
     map.forEach((v, k) => {
         obj[k] = v;
     })
+    // 返回新对象
     return obj;
 }
 
+// 定义一个函数saveClassIslandProfile，用于保存ClassIsland中的Profile
 export function saveClassIslandProfile(profile: Profile): string {
+    // 创建一个新的Profile对象
     const profileNew = Object.create(profile);
+    // 将Profile中的ClassPlans、TimeLayouts和Subjects转换为Object对象
     profileNew.ClassPlans = mapToObject(profile.ClassPlans);
     profileNew.TimeLayouts = mapToObject(profile.TimeLayouts);
     profileNew.Subjects = mapToObject(profile.Subjects);
+    // 返回新的Profile对象作为字符串
     return JSON.stringify(profileNew);
 }

src/core/ecs/converting.ts

@@ -18,12 +18,17 @@ function generateGuid(): string {
 
 
 
+// 函数matchTimeSpan用于匹配字符串中的时间跨度
 function matchTimeSpan(s: string): TimeSpan {
+    // 定义正则表达式，匹配字符串中的数字
     const regex = /\d+/gi;
+    // 获取字符串中匹配到的数字
     const nums = s.match(regex);
+    // 判断匹配到的数字是否为4个，不是则抛出错误
     if (nums == null || nums.length != 4){
         throw new Error("无效的时间格式：" + s);
     }
+    // 定义开始时间和结束时间
     const start = new Date();
     start.setUTCHours(+nums[0]);
     start.setUTCMinutes(+nums[1]);
@@ -34,20 +39,27 @@ function matchTimeSpan(s: string): TimeSpan {
     end.setUTCMinutes(+nums[3]);
     end.setUTCSeconds(0);
     end.setUTCMilliseconds(0);
+    // 返回开始时间和结束时间
     return {
         start: start,
         end: end
     }
 }
 
 export function convertEcsToClassIsland(profile: Schedule): Profile {
+    // 创建一个Profile实例
     const classIsland = new Profile();
+    // 创建一个Map，用于存储学科的guid
     const subjectMapping = new Map<string, string>();
+    // 创建一个Map，用于存储时间表的guid
     const timeTableMapping = new Map<string, string>();
     // 处理科目
     profile.subject_name.forEach((v, k) => {
+        // 生成一个guid
         const guid = generateGuid();
+        // 将subject_name和guid存入subjectMapping
         subjectMapping.set(k, guid);
+        // 将guid和subject信息存入classIsland.Subjects
         classIsland.Subjects.set(guid, {
             Name: v,
             Initial: k,
@@ -56,30 +68,48 @@ export function convertEcsToClassIsland(profile: Schedule): Profile {
         });
     })
     // 处理时间表
-    profile.timetable.forEach((v, k) => {
+    // 为profile的timetable循环
+profile.timetable.forEach((v, k) => {
+        // 生成GUID
         const guid = generateGuid();
+        // 存储GUID到timeTableMapping
         timeTableMapping.set(k, guid);
+        // 创建TimeLayout实例
         const tl = new TimeLayout();
+        // 如果v.size小于等于0，返回
         if (v.size <= 0) {
             return;
         }
+        // 设置TimeLayout的name
         tl.Name = k;
+        // 初始化last为undefined
         let last: TimeLayoutItem | undefined;
+        // 获取dividers
         const dividers = profile.divider.get(k);
+        // 遍历v
         v.forEach((v, k) => {
+            // 创建TimeLayoutItem实例
             const tp = new TimeLayoutItem();
+            // 获取时间段
             const ts = matchTimeSpan(k);
             console.debug("匹配时间段：", ts);
+            // 设置TimeLayoutItem的startSecond
             tp.StartSecond = ts.start;
+            // 设置TimeLayoutItem的endSecond
             tp.EndSecond = ts.end;
+            // 如果last不为undefined，设置last的endSecond为tp的startSecond
             if (last != undefined) {
                 last.EndSecond = tp.StartSecond;
             }
+            // 如果v的类型为string，设置tp的timetype为1
             if (typeof(v) == "string") {
                 tp.TimeType = 1;
             }
+            // 设置last为tp
             last = tp
+            // 将tp添加到tl的layouts数组中
             tl.Layouts.push(tp);
+            // 如果v的类型为number，并且dividers包含v，创建TimeLayoutItem实例tpd，设置tpd的startSecond和endSecond，将tpd添加到tl的layouts数组中
             if (typeof(v) == "number" && dividers != undefined && dividers.includes(v as number)) {
                 const startDivider = new Date(ts.end.getTime() + 120);
                 const tpd = new TimeLayoutItem();
@@ -88,17 +118,23 @@ export function convertEcsToClassIsland(profile: Schedule): Profile {
                 tl.Layouts.push(tpd)
             }
         });
+        // 获取tl的layouts数组中的第一个元素
         const first = tl.Layouts[0];
+        // 获取tl的layouts数组中的最后一个元素
         const end = tl.Layouts[tl.Layouts.length - 1];
+        // 如果first的startSecond的时为0，且分为为0，将first从tl的layouts数组中移除
         if (first.StartSecond.getUTCHours() == 0 && first.StartSecond.getUTCMinutes() == 0) {
             tl.Layouts.shift();
         }
+        // 如果end的endSecond的时为23，且分为59，将end从tl的layouts数组中移除
         if (end != undefined && end.EndSecond.getUTCHours() == 23 && end.EndSecond.getUTCMinutes() == 59) {
             tl.Layouts.pop();
         }
+        // 对tl的layouts数组排序，根据startSecond
         tl.Layouts.sort((x, y) => {
             return x.StartSecond.getUTCSeconds() - y.EndSecond.getUTCSeconds();
         });
+        // 将tl添加到classIsland的TimeLayouts中
         classIsland.TimeLayouts.set(guid, tl);
     })
 

src/core/models/classisland/ClassPlan.ts

@@ -1,18 +1,31 @@
+// 导出ClassInfo类
 export class ClassInfo {
+    // 课程ID
     SubjectId: string = "";
 }
 
+// 导出TimeRule类
 export class TimeRule {
+    // 课程周期
     WeekDay: number = 0;
+    // 课程周期
     WeekCountDiv: number = 0;
 }
 
+// 导出ClassPlan类
 export class ClassPlan{
+    // 时间布局ID
     TimeLayoutId: string = "";
+    // 课程信息
     Classes: Array<ClassInfo> = [];
+    // 班级名称
     Name: string = "";
+    // 课程周期
     TimeRule: TimeRule = new TimeRule();
+    // 是否允许覆盖
     IsOverlay: boolean = false;
+    // 是否启用
     IsEnabled: boolean = true;
+    // 设置时间
     OverlaySetupTime: Date = new Date();
-}
+}

src/core/models/classisland/Subject.ts

@@ -1,6 +1,11 @@
+// 导出类Subject
 export class Subject {
+    // 课程名称
     Name: string = "";
+    // 课程缩写
     Initial: string = "";
+    // 教师名称
     TeacherName: string = "";
+    // 是否为室外课程
     IsOutDoor: boolean = false;
-}
+}

src/core/models/classisland/TimeLayoutItem.ts

@@ -1,6 +1,11 @@
+// 导出TimeLayoutItem类
 export class TimeLayoutItem {
+    // 开始时间
     StartSecond: Date = new Date();
+    // 结束时间
     EndSecond: Date = new Date();
+    // 时间类型
     TimeType: number = 0;
+    // 是否隐藏默认
     IsHideDefault: boolean = false;
-}
+}

src/core/models/ecs/Schedule.ts

@@ -1,11 +1,20 @@
+// 导入 DailyClass 类
 import { DailyClass } from "./DailyClass";
 
+// 定义 Schedule 类
 export class Schedule {
+    // 设置倒计时目标时间
     countdown_target: Date = new Date();
+    // 定义每日课程数组
     daily_class: Array<DailyClass> = [];
+    // 定义科目名称映射
     subject_name: Map<string, string> = new Map<string, string>();
+    // 定义时间表
     timetable: Map<string, Map<string, string | number>> = new Map<string, Map<string, string | number>>();
+    // 定义分隔线
     divider: Map<string, Array<number>> = new Map<string, Array<number>>();
+    // 设置是否显示星期
     week_display: boolean = true;
+    // 定义样式
     css_style: Map<string, string> = new Map<string, string>();
-}
+}

src/pages/ecs.vue

@@ -14,7 +14,7 @@
 
 <script lang="ts" setup>
 import { convertEcsToClassIsland } from "../core/ecs/converting";
-import { ref, reactive } from "vue";
+import { ref } from "vue";
 import { loadEcsSchedule } from "../core/ecs/ecsLoader";
 import { saveClassIslandProfile } from "../core/classIslandLoader";
 
@@ -29,7 +29,7 @@ function loadFile() {
   if (file.value) {
     const reader = new FileReader();
     reader.onload = (event) => {
-      fileContent.value = event.target?.result;
+      fileContent.value = event.target?.result as string;
     };
     reader.readAsText(file.value);
   }
@@ -41,7 +41,7 @@ function downloadJson(fileName, json) {
 
     const url = window.URL || window.webkitURL || window;
     const blob = new Blob([jsonStr]);
-    const saveLink = document.createElementNS('http://www.w3.org/1999/xhtml', 'a');
+    const saveLink = document.createElement('a');
     saveLink.href = url.createObjectURL(blob);
     saveLink.download = fileName;
     saveLink.click();