[new] new project

This commit is contained in:
2026-09-20 13:33:09 +08:00
commit ca6a52fb2d
997 changed files with 140250 additions and 0 deletions
+23
View File
@@ -0,0 +1,23 @@
# 术语表
| 用语 | 含义 |
|---|---|
| 星课表 / starschedule | 本应用的显示名与工程名 |
| 课表(CourseTable) | 一份独立课表,有自己的课程、节次、学期配置。用户可同时有多份 |
| 当前课表 | DataStore 里的 `current_course_table_id`,周课表、今日课表、小组件都读它 |
| 课程(Course) | 一条上课安排:名称、星期、节次或自定义时刻、周次、地点、教师等 |
| 课程实例 | 一门课在某个教学周的一次上课。小组件库按自然日展开后的记录 |
| 节次(TimeSlot) | 第 n 节课的起止钟点,按课表独立。编号从 1 连续 |
| 自定义时间课 | `isCustomTime = true`,用 `HH:mm` 起止,节次可空 |
| 开学日期 | 学期第一周的锚定日(`yyyy-MM-dd`)。计算当前周前会先对齐到 `firstDayOfWeek` |
| 每周起始日 | `firstDayOfWeek`:`1` 周一,`7` 周日 |
| 跳过日期 | 不提醒、小组件标记跳过的日期集合,可从节假日接口写入 |
| 颜色池下标 | `colorInt`,对应样式里 `courseColorMaps` 的序号,不是 ARGB |
| 正方 | 正方教务系统。本应用只内置这一套 HTML 抓取脚本 |
| JS Bridge | WebView 里 JS 调 Native 的通道:`shiguangBridge` / `shiguangBridgePromise` |
| 覆盖导入 | `importCoursesFromList` 先删该表全部课程再插入 |
| 主库 | `MainAppDatabase`,用户课表真相源,当前版本 5 |
| Widget 库 | `WidgetDatabase`,近 7 天快照,当前版本 3 |
| applicationId | 安装包名 `com.starschedule`,与 Kotlin 包名不是同一个东西 |
| Kotlin 包名 | 源码仍为 `com.xingheyuzhuan.shiguangschedule` |
| Destination | Navigation3 页面键,必须 `@Serializable` 并注册 serializer |