#用户手册

AstraSchedule 用户手册包含以下章节，帮助您充分了解和使用本系统的全部功能。

#课表功能

课程显示支持简称与全称两种模式。简称中可使用 @ 下标语法（如 自@物 显示为"自_物"），让课表更加清晰。系统提供三种高亮状态：已结束课程显示为灰色，当前课程根据 WebSocket 连接状态显示绿色或橙色，即将开始的课程以闪烁动画提示。通过托盘菜单中的"课上计时""上课隐藏""始终缩小"三个开关，可组合出四种显示模式，适应不同使用场景。倒计时框会跟踪当前高亮课程的位置平滑移动，以 MM:SS 格式显示剩余时间。

#倒计时与倒数日

主窗口右侧边栏可显示距离目标日期的天数（如距离中考、期末考等）。独立倒数日窗口提供展开和最小化两种模式：展开模式左侧显示最高优先级的主卡片，右侧显示最多四条副卡片；最小化模式以竖排文字在屏幕右侧显示最优先的一条日程。天数颜色随紧迫程度变化，大于等于 100 天为舒适的绿色，50 到 99 天为绿黄渐变，0 到 49 天为黄红渐变，当天显示为醒目的红色。

#天气与预警

客户端实时显示当前温度和天气状况文字。温度颜色支持离散和渐变两种映射模式，默认内置四个温度端点（20 度蓝色、30 度绿色、36 度橙色、100 度红色），可在管理端自由调整色值和温度断点。温度偏移校准功能允许校正显示与实际体感的偏差。极端天气预警可自动替换顶部横幅通知，支持简略和详细两种模式。

#横幅通知

客户端顶部横幅支持跑马灯滚动效果（速度 80 像素/秒），采用双段无缝循环实现平滑滚动。横幅文字为空时自动隐藏，不影响课表显示。当启用天气预警替代功能时，横幅将自动显示极端天气预警内容以引起注意。

#自动任务与调休

自动任务支持四种类型：调休（节假日与工作日互换）、作息表调整、课程表调整、全部调整。每种任务可指定三级生效域（学校、年级、班级），按优先级排序，到期自动生效和过期恢复。调休数据支持节假日与工作日双向查询，全年调休可批量导入。任务配置时支持自动填充课程模板和冲突检测。

#备份与复制

系统提供完整的备份导出和导入功能，涵盖全部七张数据表（课表、客户端配置、作息表、科目、数据版本、自动任务记录、倒数日记录），导出格式为 JSON。导入支持覆盖和跳过两种模式，可用于 MySQL 与 SQLite 之间的跨数据库迁移。管理端还提供班级间配置复制功能，方便新建班级时快速复用现有配置。

#客户端使用

客户端托盘菜单提供二十余项功能，包括云端连接、更新管理、天气设置、课表操作、窗口模式、开机启动等。窗口支持置顶、点击穿透和透明度调节三种特性，鼠标悬停时可临时关闭穿透以便操作。所有用户偏好设置通过 electron-store 持久化保存，自动更新机制支持自定义更新源和镜像代理。

#管理端使用

管理端（NaiveClassSchedule）是一个基于 Web 的管理后台，提供以下功能页面：

• 首页仪表盘：实时查看各班级客户端连接状态、WebSocket 断连次数、天气 API 错误统计。
• 自动任务管理：创建、编辑、查看和删除自动任务，支持全年调休批量导入。
• 倒数日管理：配置倒数日日程，支持指定生效域和优先级。
• 科目配置：管理科目简称与全称的映射关系。
• 作息表配置：管理每日作息时间表，支持多种作息类型和分隔线设置。
• 课表配置：配置各班级每天的课程安排和每周轮换课程。
• 通用设置：调整倒计时目标、横幅文字、天气预警覆盖、CSS 变量和温度颜色映射。
• 实用工具：完整备份导出导入、班级间配置复制。