fix(integrations,grades,clients,web,client,plugin): 课表同步改为按需（修「课表被反复删改」）+ 客户端页合并 + 成绩排名（1.3.1）

线上问题的根因
- ClassIsland 插件默认每 15 秒上报一次，每次都带全量课表，上报完还顺手把课表镜像回教室
  （本机 `UploadSchedule` / `MirrorSchedule` 两个开关默认都是开）。于是教室的课表每 15 秒被重写、
  服务端也每 15 秒 merge + 清理一次幽灵行 —— 老师看到的就是"课表被反复删改"。
- 现在两个方向都只由 Web 端的一次性待办触发，插件侧那两个开关整体删除；
  定时上报只报**运行状态**（当前上什么课），不带课表。

课表同步（#3）
- 新增 `IntegrationDevice.requestMirrorSchedule` + `POST /integrations/devices/:id/mirror-schedule`
  （「下发课表」），与既有的 `request-schedule`（「获取课表」）对称；拉取成功即清标记
- 插件 `ClassPlanWriter.Apply(..., force: true)`：停用同一天同一单双周相位下冲突的旧课表
  —— **只停用不删除**，内容原样留在档案里，老师随时能重新启用
- 插件设置页删掉「自动上报课表」「镜像回 ClassIsland」两个开关，改为一句说明

「客户端」页（#4）
- 把「ClassIsland 联动」与「客户端设备」合成一页 `ClientHubView.vue`：一个班一张卡片，
  两条链路状态放一起，勾选可批量下发课表 / 更新，点卡片进详情做逐台操作
- 「下发提醒」也搬了过来；入口权限用 `classisland:notify`（默认 ADMIN + TEACHER），
  页内按钮再各自按 device:manage / remote:control / client:update-push 显示或禁用
- 两个旧页面 `meta.hidden: true` **保留路由**（安装包缓存管理、联动步骤说明仍在），
  从详情抽屉里给链接 —— 不删功能

成绩（#5/#6/#7）
- 新增 `Exam`（班级 + 考试名 + `countInTotal`）与迁移；`GET/PUT /api/grades/exams`、
  `GET /api/grades/ranking`（两条都**不挂权限键**，班级端的有效权限是空集，边界在 service 里）
- 排名口径写在服务端：**同一学生同一科目只取最高分**（补录 / 重考会多行，不去重等于"总分多一科"）、
  并列同名次（1、2、2、4）
- 「成绩录入」页加「考试口径」开关（按班级 + 考试名记住）；客户端「成绩」页新增总分榜 + 单科榜
- `updateStudentGradeQuery` 改成只有教师 / 管理员能改 —— 原先班级端自己也能改
- 客户端的成绩查询开关改为只读（只显示服务端下发的状态）

其他（#2/#5/#8/#9）
- 全校学期开始日期改成 `AppSetting` 的 `term.startDate`，管理员在「学期周次」页直接改、立刻重算周次
  （原先这一级只能来自 `.env`）
- 大模型助手发紧急通知补上「上课时段 3 秒全屏警告」：判据抽成 `composables/useClassInSession.ts`，
  与手动发布页共用
- 客户端去掉「关怀模式」「自动更新」两个开关（教室机器是统一投放的终端）
- 修掉「选中设置二级菜单后收起分组、高亮块仍留在原地」：底片只在路由 / 滚动 / 缩放时重测，
   而收起分组动不了 `.aside` 的盒子 —— 补上"子项被 overflow:hidden 裁掉"的判据 + 观察分组 `<ul>` 高度
- `src/types/express.d.ts` 里 `req.device` 改成引用 `DeviceContext`：原先手抄了一份结构，
  往接口加字段时两边就漂了，而报错会落在 `getDevice()` 的 `return device;` 上，看不出真正原因

验收：`lint` / `typecheck` / `check:icons` / `docs:check` 全绿；
后端端到端 **247/247**、联动链路 **44/44**、插件静态契约 **76/76**、
Web 真实点击 **34/34**（含新增的「客户端」页用例）、客户端冒烟 **90/90**。

packages/shared/src/types.ts

@@ -910,6 +910,66 @@ export interface GradeDto {
   className?: string | null;
 }
 
+/**
+ * 一次考试（月考 / 期中考…）在本班的设置。
+ *
+ * 需求：「单次考试在导入成绩时可选是否将所有科目相加以总分排名，客户端也能看到总分排名」。
+ * `Grade.examName` 是自由文本，服务端光看它不知道这次考试算不算总分，所以单独记一条。
+ */
+export interface ExamDto {
+  id: string;
+  classId: string;
+  name: string;
+  /** 是否把所有科目（本次考试已录入的）相加做总分排名 */
+  countInTotal: boolean;
+  /** 本次考试已录入的成绩条数 —— 老师据此判断"要不要算总分" */
+  gradeCount: number;
+}
+
+/** 排名表里的一行（单科或总分） */
+export interface ExamRankRow {
+  studentId: string;
+  studentNo: string;
+  studentName: string;
+  /** 得分（总分榜里是各科之和） */
+  score: number;
+  /** 这一科的满分；总分榜里是各科满分之和（仅供参考） */
+  totalScore: number;
+  /** 名次，从 1 开始；并列同名次（1、2、2、4） */
+  rank: number;
+}
+
+/** 单科排名 */
+export interface ExamSubjectRanking {
+  courseId: string | null;
+  courseName: string;
+  rows: ExamRankRow[];
+}
+
+/**
+ * 一次考试的排名结果（单科 + 总分）。
+ *
+ * 总分榜只在 `countInTotal` 为 true 时才有内容 —— 语数外与音体美的分数量纲不同，
+ * 加不加是学校的口径，不能由程序默认替它决定。
+ */
+export interface ExamRankingDto {
+  classId: string;
+  className: string;
+  examName: string;
+  countInTotal: boolean;
+  subjects: ExamSubjectRanking[];
+  /** 总分榜（同一学生各科相加）；countInTotal 为 false 时是空数组 */
+  total: Array<{
+    studentId: string;
+    studentNo: string;
+    studentName: string;
+    score: number;
+    /** 参与相加的科目数，便于识别"只录了两科也上榜"的情况 */
+    subjectCount: number;
+    rank: number;
+  }>;
+}
+
 export interface CreateGradeRequest {
   classId: string;
   courseId?: string | null;
@@ -1473,9 +1533,15 @@ export interface ClassIslandReportResult {
     enabled: boolean;
     /**
      * 服务端请求插件**立刻上报一次课表**（Web 端点了「从教室机器获取课表」）。
-     * 独立于 `syncScheduleToServer`：那个开关管的是"要不要自动回传"。
+     * 两个课表方向都只由这类一次性待办触发，本机没有"自动回传 / 自动镜像"的开关。
      */
     scheduleRequested?: boolean;
+    /**
+     * 服务端请求插件**下发一次课表到教室**（Web 端点了「下发课表到教室」）。
+     * 插件看到就去拉本班课表并**强制替换**写进 ClassIsland（停用同一天同一单双周相位下
+     * 冲突的旧课表，只停用不删除）；拉取成功时由服务端清除这个待办。
+     */
+    mirrorRequested?: boolean;
   };
   /** 尚未在 ClassIsland 上确认过的一条提醒（插件可立即弹出） */
   pendingNotification?: ClassIslandPushNotification | null;