feat: 添加RenewService，重构文件结构，重构Course

Author: x6eull

eslint.config.js

@@ -6,13 +6,24 @@ import pluginReactHooks from 'eslint-plugin-react-hooks'
 
 /** @type {import('eslint').Linter.Config[]} */
 export default [
-  pluginJs.configs.recommended,
+  { name: 'globalIgnore', ignores: ['dist/', 'android/', 'eslint.config.js'] },
+  { name: 'pluginJs.configs.recommended', ...pluginJs.configs.recommended },
   ...tseslint.configs.recommendedTypeChecked,
-  pluginReact.configs.flat.recommended,
-  pluginReact.configs.flat['jsx-runtime'],
-  { plugins: { 'react-hooks': pluginReactHooks } },
-  { rules: pluginReactHooks.configs.recommended.rules },
   {
+    name: 'pluginReact.configs.flat.recommended',
+    ...pluginReact.configs.flat.recommended,
+  },
+  {
+    name: "pluginReact.configs.flat['jsx-runtime']",
+    ...pluginReact.configs.flat['jsx-runtime'],
+  },
+  {
+    name: 'pluginReactHooks',
+    plugins: { 'react-hooks': pluginReactHooks },
+    rules: pluginReactHooks.configs.recommended.rules,
+  },
+  {
+    name: 'customConfig',
     settings: { react: { version: 'detect' } },
     languageOptions: {
       globals: globals.browser,
@@ -21,8 +32,6 @@ export default [
         tsconfigRootDir: import.meta.dirname,
       },
     },
-  },
-  {
-    ignores: ['dist/', 'android/', 'eslint.config.js'],
+    rules: { eqeqeq: ['error', 'always'] },
   },
 ]

src/extension/ExtensionWidgetCapability.tsx

@@ -7,7 +7,7 @@ import { WidgetExtension } from './Extension'
 import { z } from 'zod'
 import { afterDone, PromiseAwaited } from '../utils/func'
 import { BorrowedHandle, BorrowManager } from './BorrowManager'
-import { ZjuamService } from '../interop/zjuam'
+import { ZjuamService } from '../services/ZjuamService'
 import { encodeReturn } from './ExtensionIO'
 
 type ResolveHandle<H> = H extends BorrowedHandle<infer O> ? O : H

src/interop/credential.ts

@@ -1,5 +1,5 @@
 import { env } from './env'
-import { ZjuamService } from './zjuam'
+import { ZjuamService } from '../services/ZjuamService'
 
 export type Credential = {
   username: string

src/models/Course.ts

@@ -0,0 +1,14 @@
+import { Semester } from './shared'
+
+/**课程最基础的识别信息。选课课号为唯一标识符。
+ *
+ * 某些上游不返回学期字段，此时semester字段通过选课课号解析，可能不准确（如实际秋学期的课，该字段为秋冬）。
+ */
+export interface CourseBase {
+  /**学年&学期 */
+  semester: Semester
+  /**选课号 如(2024-2025-1)-761T0060-0017687-4 */
+  id: string
+  /**课程名称（中文） */
+  name: string
+}

src/models/CourseBase.ts

@@ -0,0 +1,22 @@
+import { WeekType, DayOfWeek } from './shared'
+
+/**课程教学信息，包括教师和上课时间地点。 */
+export interface CourseClassInfo {
+  /**教师姓名 */
+  teacherName: string
+  /**上课时间地点 */
+  classes: ClassArrangement[]
+}
+/**相对于学期的上课时间、地点 */
+
+export interface ClassArrangement {
+  /**上课周次 */
+  weekType: WeekType
+  dayOfWeek: DayOfWeek
+  /**从第几节开始 =djj */
+  startSection: number
+  /**持续节数 =kccd */
+  sectionCount: number
+  /**地点 =skdd */
+  location: string
+}

src/models/CourseClassInfo.ts

@@ -0,0 +1,17 @@
+import { CourseBase } from '@/models/CourseBase'
+import { CourseTodoInfo } from './CourseTodoInfo'
+import { CourseGradeInfo } from './CourseGradeInfo'
+import { CourseExamInfo } from './CourseExamInfo'
+import { CourseClassInfo } from './CourseClassInfo'
+import { Maybe } from '@/utils/type'
+
+export type DataOrigin = 'class' | 'exam' | 'grade' | 'xzzdTodo'
+/**从课程表、考试、成绩、学在浙大多方来源合并的课程信息。
+ *
+ * 注意：如果没有来自'class'的信息（如实践课），则学期可能不准确（单个学期的课可能被解析为长学期）
+ */
+export type CourseCombined = CourseBase &
+  Maybe<CourseClassInfo> &
+  Maybe<CourseExamInfo> &
+  Maybe<CourseGradeInfo> &
+  Maybe<CourseTodoInfo> & { origin: DataOrigin[] }

src/models/CourseCombined.ts

@@ -0,0 +1,17 @@
+/**课程考试信息。 */
+export interface CourseExamInfo {
+  /**考试 */
+  exams: ExamArrangement[]
+}
+
+export type ExamType = 'midterm' | 'final'
+/**单场考试安排 */
+export interface ExamArrangement {
+  type: ExamType
+  startAt: Date
+  endAt: Date
+  /**考试地点，可空 */
+  location?: string
+  /**座位号，可空，原样保留上游结果，不需要转Number再转字符串 */
+  seat?: string
+}

src/models/CourseExamInfo.ts

@@ -1,7 +1,6 @@
-import type { Course } from './Course'
-
-export interface Grade {
-  course: Pick<Course, 'semester' | 'id' | 'name' | 'credit'>
+export interface CourseGradeInfo {
+  /**学分 */
+  credit: number
   /**原始成绩。包括“缺考”、“缓考”等 */
   rawScore: string
   /**原始绩点（原样保留上游数据） */

src/models/Grade.ts src/models/CourseGradeInfo.tssrc/models/Grade.ts renamed to src/models/CourseGradeInfo.ts

@@ -0,0 +1,12 @@
+import { XzzdTodoType } from '@/spiders/XzzdSpider'
+
+export interface CourseTodoInfo {
+  todos: CourseTodo[]
+}
+
+export interface CourseTodo {
+  endAt: Date
+  /**待办名称 */
+  title: string
+  type: XzzdTodoType
+}