- 首次运行课表为空，可点击工具栏「✨ 示例数据」快速体验，或双击任意空白格子添加自己的课程。

## 工具栏按钮一览

| 按钮 | 功能 |

|---|---|

| ➕ 添加 | 弹出编辑框新增一门课程 |

| 📥 导入 | 从 JSON / CSV 文件批量导入课程 |

| 📅 当前：单周 | 显示/切换单双周模式（设置开学日期后为自动模式） |

| ⏱ 作息 | 展开/收起右侧作息设置面板 |

| 🌤 今日剩余 | 查看今天还没上完的课（含进行中、倒计时） |

| ⏰ 明日课程 | 查看明天的全部课程 |

| 📤 导出 CSV | 把当前课程导出为 CSV 表格 |

| ✨ 示例数据 | 一键载入 14 门示例课程 |

| 🗑 清空 | 清空全部课程（不可撤销，谨慎操作） |

| ✖ 关闭 | 关闭窗口（数据自动保存） |

---

## 三、课程管理

### 添加课程

- 点击工具栏「➕ 添加」，或**双击课表中任意空白格子**（会自动定位到该星期、该节次）；

- 填写课程信息：

| 字段 | 说明 |

|---|---|

| 课程名称 * | 必填 |

| 教师 | 选填 |

| 教室 | 选填，显示在卡片中间 |

| 星期 | 周一～周日 |

| 开始节次 / 结束节次 | 支持连堂（如第 3-5 节） |

| 单双周 | **每周** / **仅单周** / **仅双周** |

### 编辑 / 删除课程

- **双击课程卡片** → 打开编辑框，可修改任意字段；

- 编辑框中的「🗑 删除此课程」可删除该课程；

- 仅单周/双周的课程卡片边框加粗，并标注「仅单周」/「仅双周」字样。

---

## 四、单双周显示

课表会按当前模式隐藏不属于本周的课程：单周模式下隐藏「仅双周」的课，双周模式下隐藏「仅单周」的课，「每周」的课始终显示。

### 方式一：开学日期自动判断（推荐）

1. 打开「⏱ 作息」面板 → 顶部「📅 学期设置」；

2. 填写**开学日期**（格式 `yyyy-MM-dd`，如 `2026-09-07`，即教学周第 1 周的周一）；

3. 点「💾 保存」。

之后每次打开窗口，程序自动按 `（今天 − 开学日期）÷ 7 + 1` 计算当前学期周数：

- 第 1、3、5…… 周（奇数周）→ **单周**

- 第 2、4、6…… 周（偶数周）→ **双周**

- 今天早于开学日期 → 按第 1 周（单周）处理

工具栏按钮会显示「📅 第 N 周 · 单周/双周」，一眼看到学期进度。

### 方式二：手动切换

作息面板中**留空**开学日期并保存，即回到手动模式：点击工具栏「📅 当前：单周」按钮可在单周/双周间切换。

> 💡 自动模式下点击「📅」按钮会弹提示，不允许手动改，防止误操作。想恢复手动，清空开学日期保存即可。

---

## 五、作息时间设置

点击「⏱ 作息」按钮，主窗口右侧展开设置面板（再次点击收起；**双击课表左侧节次栏或休息横条**也可快速打开）。

### 学期设置

- **开学日期**：见上文「单双周显示」，留空 = 手动模式。

### 节次时间（第 1～12 节）

- 格式：`开始-结束`，如 `08:00-08:45`；

- 留空则使用该节的默认时间；

- 内置默认作息：上午 4 节（08:00 起）、下午 4 节（14:00 起）、晚上 4 节（19:40 起）。

### 休息时段

| 字段 | 说明 |

|---|---|

| 😴 午休 | 默认 `11:40-13:40`，自动对齐第 4 节结束～第 5 节开始 |

| 午休安排 | 显示文字，如「午餐 · 午睡」，随意填写 |

| 🌇 傍晚休息 | 默认 `17:40-19:40`，自动对齐第 8 节结束～第 9 节开始 |

| 傍晚安排 | 显示文字，如「晚餐 · 运动 · 洗澡」 |

### 底部按钮

- **💾 保存**：写入数据（自动记忆），刷新课表并收起面板；

- **↩ 恢复默认**：全部恢复内置作息（不触发级联，需再点保存生效）；

- **收起**：只收起面板，不保存。

> ⚠️ 修改作息后**必须点「💾 保存」**才会真正写入，直接点「收起」或关闭窗口不会保存面板中的修改。

---

## 六、级联联动规则

v10 的核心特性：**改一处，后面全部自动跟着变，无需手动逐个修改**。

| 你修改的内容 | 自动发生的变化 |

|---|---|

| 第 n 节时间（结束时间变化） | 第 n+1～12 节整体平移相同偏移量，各节时长与课间间隔保持不变 |

| 午休的**结束**时间（如 13:40→14:00） | 第 5～12 节全部顺延（+20 分钟），傍晚休息同步对齐 |

| 傍晚休息的**结束**时间（如 19:40→20:00） | 第 9～12 节全部顺延（+20 分钟） |

| 任何变化波及边界 | 午休自动 = 第4节结束～第5节开始；傍晚自动 = 第8节结束～第9节开始 |

| 只改某节的**开始**时间（结束不变） | 视为调整该节时长，后面不动 |

### 细节说明

- 级联以**结束时间的变化量**为准：结束时间不变就不平移（比如只是想让某节晚 5 分钟开始、同时早 5 分钟结束）；

- 休息时段的开始时间会被自动对齐覆盖，但**你正在编辑的那个输入框不会被程序回写**（v10 修复项：退格时光标不再跳到开头）；

- 平移结果自动限制在 `00:00-23:59` 内，不会越界；

- 输入到一半的中间状态（如 `19:0`）如能被解析为合法时间（19:00），会触发临时级联，属正常现象，输入完成后以最终值为准。

---

## 七、今日剩余 / 明日课程

### 🌤 今日剩余

- 按**今天**的星期 + **当前单双周模式**过滤（自动模式下即为本周实际该上的课）；

- 只列出结束时间晚于当前时刻的课（含正在进行的）；

- 每门课显示：节次、开始时间、进行中 ● / 倒计时 ○（如「约 1 小时 25 分钟后上课」）、教室、教师；

- 今天没课了会贴心地告诉你「好好休息吧」。

### ⏰ 明日课程

- 列出明天星期几的全部课程（按节次排序）；

- 单双周课程会带「（仅单周）/（仅双周）」标注，请结合本周模式自行判断。

---

## 八、导入与导出

### 📥 导入

支持 JSON 和 CSV 两种格式：

**JSON 格式**（数组，字段：name/teacher/room/day/start/end/week）：

```json

[

  {"name":"高等数学","teacher":"张明","room":"教三-401","day":1,"start":1,"end":2,"week":0},

  {"name":"大学英语","teacher":"李华","room":"外语楼-205","day":1,"start":3,"end":4,"week":2}

]

```

- `day`：1=周一 … 7=周日

- `start`/`end`：节次序号 1～12

- `week`：0=每周，1=仅单周，2=仅双周

**CSV 格式**（支持表头自动识别，推荐带表头）：

```csv

星期,开始节次,结束节次,课程名称,教师,教室,单双周

周一,1,2,高等数学,张明,教三-401,每周

周一,3,4,大学英语,李华,外语楼-205,仅双周

```

- 星期列支持「周一/一/1/Monday」等写法；

- 单双周列按文字判断：含「单」= 仅单周，含「双」= 仅双周，其他 = 每周；

- 无表头时按固定列序解析：星期,开始节次,结束节次,课程名称,教师,教室,单双周。

### 📤 导出 CSV

- 导出全部课程（含单双周标注），文件名自动带日期，如 `课程表_20260909.csv`；

- 导出文件可直接再导入（格式互通），或用 Excel 打开。

---

## 九、数据存储说明

课程表所有数据通过 Quicker 动作变量**自动记忆**（SaveState），关闭窗口即保存，下次打开自动恢复：

| 变量 | 内容 |

|---|---|

| coursesJson | 全部课程数据 |

| timesJson | 作息时间与休息安排 |

| weekMode | 单双周显示模式 |

| termStartDate | 开学日期 |

- 数据保存在本机该 Quicker 动作中，**不联网、不上传**；

- 备份课表 = 导出一份 CSV；恢复 = 重新导入；

- 「🗑 清空」只清空课程，**不影响**作息和开学日期设置。

---