feat(island,homework,schedule): 灵动岛点开修复+胶囊类型汇总 · 作业看板与未交名单 · 单双周课表与 ClassIsland 课程表导入

一、灵动岛（用户反馈的三处"点不开"全部修复）
- 非紧急叫人：上课时段仍以胶囊保持可见、可点开（不再只进队列导致屏幕上什么都没有）；
  新增 isOpenable()：紧急消息 + 任何"叫人"都允许点开，但普通叫人不会自动展开打断课堂。
- 紧急叫人收起后再点：命中改为"主进程按光标位置兜底校正"（上一轮的 island:set-hit-rect 轮询），
  本轮补齐叫人类专项回归（展开 → 收起 → 再次点开）。
- 设置页预览：新增 preview 通道 —— 示例岛直接展开、失焦不收起、30 秒自行消失、关掉不残留。
- 收起态胶囊汇总消息类型：多条时显示「新消息：叫人/作业/通知（共 3 条）」+「点击查看」+ 类型小标签。
- 顺带修掉两个真问题：胶囊态收到新消息会把上一条静默顶掉（现在一律回队）；
  syncWindow 的上课时段守卫只认"紧急"导致普通叫人被藏掉。
- 性能：岛体矩形上报限流（~10 次/秒 + 尾随补发），修掉每帧 IPC 导致的开合采样骤降。

二、作业（学生端 + Web 教师端）
- 新增**看板模式**：按科目分卡片、点卡片放大全屏、工具栏可切「看板/列表」、
  开关「显示时间」、拖「看板字号」（11–28px），偏好持久化到客户端配置 homeworkBoard。
- 去掉「全班标记完成」，改为**未交名单**：勾选没交的同学，其余自动标记已交；
  新增 GET/PATCH /api/homeworks/:id/submissions（教师与班级设备可用，普通学生 403）。

三、课表单双周 + ClassIsland 课程表导入
- Schedule 新增 weekParity（ALL/ODD/EVEN）+ 迁移；周视图与上课判定按「第 1 周=单周」过滤，
  历史数据默认 ALL 行为不变；Web 手动新增/编辑课表可选单双周，学生端课表打「单周/双周」标签。
- 修复既有 P0 bug：ClassIsland 真实档案里 TimeLayouts 是 "Guid → { Name, Layouts }" 字典，
  旧解析器只认数组/.items，导致**真实导出完全导不进来**；现已按真实形态解析（并兼容旧写法），
  同时补上 TimeType=3（行动）映射。
- 新增 ClassIsland 课程表（ClassPlan）导入：解析 TimeRule.WeekCountDiv/WeekCountDivTotal → 单双周，
  Classes[i] 对齐第 i 个 TimeType=0 的时间点，Subjects 映射科目（缺失自动补建课程），
  星期 0=周日 换算为 1=周一 … 7=周日；replace/merge 两种模式，预览只解析不写库。
- 新增维护脚本 packages/server/scripts/apply-parity-column.cjs（手工覆盖 dist 部署时补列用）。

验证：verify:e2e 148/148（新增单双周 12 项 + 课程表导入 5 项）、verify:desktop 71/71（复跑 65/65）、
verify:web 20/20、typecheck / lint / format 全绿；服务端与 Web 已重新打包并部署到本机安装目录。

packages/shared/src/constants.ts

@@ -66,6 +66,21 @@ export const WEEKDAY_LABELS: Record<number, string> = {
 
 export const WEEKDAYS: readonly number[] = [1, 2, 3, 4, 5, 6, 7];
 
+/**
+ * 单双周标签与取值（课表用）。
+ * 语义与 ClassIsland 课表一致：WeekCountDivTotal=1 → 每周；=2 时 WeekCountDiv=1 → 单周、=2 → 双周。
+ */
+export const WEEK_PARITY_LABELS: Record<'ALL' | 'ODD' | 'EVEN', string> = {
+  ALL: '每周',
+  ODD: '单周',
+  EVEN: '双周',
+};
+
+export const WEEK_PARITY_VALUES: readonly ('ALL' | 'ODD' | 'EVEN')[] = ['ALL', 'ODD', 'EVEN'];
+
+/** 一个学期按多少周为一个单双周循环（ClassIsland WeekCountDivTotal 的默认值） */
+export const WEEK_PARITY_CYCLE = 2;
+
 /** 灵动岛默认外观（设置页个性化项的初始值，也是区间校验的单一来源） */
 export const DEFAULT_ISLAND_APPEARANCE = {
   height: 44,

packages/shared/src/types.ts

@@ -172,10 +172,18 @@ export interface ScheduleDto {
   location: string | null;
   weekStart: number;
   weekEnd: number;
+  /**
+   * 单双周：ALL = 每周都上（默认）；ODD = 只在单周；EVEN = 只在双周。
+   * 与 ClassIsland 课表的 WeekCountDiv / WeekCountDivTotal 语义对应（见导入模块）。
+   */
+  weekParity: WeekParity;
   createdAt: string;
   course?: CourseBrief | null;
 }
 
+/** 单双周（ClassIsland：WeekCountDivTotal=2 时按 WeekCountDiv 分单/双周） */
+export type WeekParity = 'ALL' | 'ODD' | 'EVEN';
+
 export interface CourseBrief {
   id: string;
   name: string;
@@ -190,6 +198,8 @@ export interface CreateScheduleRequest {
   location?: string | null;
   weekStart?: number;
   weekEnd?: number;
+  /** 单双周：ALL（默认）/ ODD（单周）/ EVEN（双周） */
+  weekParity?: WeekParity;
 }
 
 export type UpdateScheduleRequest = Partial<CreateScheduleRequest>;
@@ -206,6 +216,50 @@ export interface ScheduleWeekView {
   columns: ScheduleDayColumn[];
 }
 
+/* ------------------------------------------------------------------ ClassIsland 课程表导入（单双周） */
+
+/** 解析出来的单节课（预览用） */
+export interface ClassPlanEntryDto {
+  /** 1=周一 … 7=周日（已从 ClassIsland 的 0=周日 转换） */
+  dayOfWeek: number;
+  /** 展示用：周一 / 周二 … */
+  weekdayLabel?: string;
+  startTime: string;
+  endTime: string;
+  subject: string;
+  teacherName?: string;
+  /** 单双周：ALL / ODD（单周）/ EVEN（双周） */
+  weekParity: WeekParity;
+  /** 原始 WeekCountDiv / WeekCountDivTotal，便于核对来源 */
+  weekCountDiv: number;
+  weekCountDivTotal: number;
+  planName: string;
+}
+
+/** 课程表导入预览结果 */
+export interface ClassPlanPreviewDto {
+  entries: ClassPlanEntryDto[];
+  /** 解析到的科目名（去重） */
+  subjects: string[];
+  /** 班级里还没有、导入时会自动补建的科目 */
+  missingSubjects: string[];
+  /** 解析到的时间表名 */
+  layoutNames: string[];
+  errors: string[];
+  warnings: string[];
+}
+
+/** 课程表导入结果 */
+export interface ClassPlanImportResultDto {
+  imported: number;
+  created: number;
+  updated: number;
+  /** 自动补建的课程名 */
+  createdCourses: string[];
+  weekStart: number;
+  weekEnd: number;
+}
+
 /* ------------------------------------------------------------------ 作业 */
 
 export interface HomeworkDto {
@@ -246,6 +300,35 @@ export interface UpdateHomeworkStatusRequest {
   completed: boolean;
 }
 
+/** 作业提交名单里的一位学生 */
+export interface HomeworkSubmissionDto {
+  userId: string;
+  name: string;
+  username: string;
+  completed: boolean;
+}
+
+/**
+ * 作业提交名单（"未交名单"功能的载体）：
+ * 教师端 / 班级设备用它勾选谁没交作业，其余学生一律视为已交。
+ */
+export interface HomeworkSubmissionsDto {
+  homeworkId: string;
+  classId: string;
+  /** 全班学生数 */
+  total: number;
+  completedCount: number;
+  /** 只包含未交的学生（completed=false），便于直接渲染"未交名单" */
+  notSubmitted: HomeworkSubmissionDto[];
+  /** 全班学生及其完成状态 */
+  students: HomeworkSubmissionDto[];
+}
+
+export interface UpdateHomeworkSubmissionsRequest {
+  /** 未交作业的学生 id（其余学生一律标记为已交） */
+  notSubmittedUserIds: string[];
+}
+
 export interface HomeworkQueryParams {
   classId?: string;
   courseId?: string;

packages/shared/src/utils.ts

@@ -1,5 +1,5 @@
-import { WEEKDAY_LABELS, WEEKDAYS } from './constants.js';
-import type { ClassPeriod, GradeLevel, ScheduleDto, ScheduleWeekView } from './types.js';
+import { WEEKDAY_LABELS, WEEKDAYS, WEEK_PARITY_LABELS } from './constants.js';
+import type { ClassPeriod, GradeLevel, ScheduleDto, ScheduleWeekView, WeekParity } from './types.js';
 
 /* ------------------------------------------------------------------ 日期时间 */
 
@@ -60,12 +60,25 @@ export function relativeTime(value: string | number | Date, now: Date = new Date
 
 /* ------------------------------------------------------------------ 课表 */
 
-/** 判断某个课表条目在第 week 周是否上课 */
+/** 第 week 周是单周还是双周（第 1 周记为单周，与 ClassIsland 的 WeekCountDiv 一致） */
+export function weekParityOf(week: number): Exclude<WeekParity, 'ALL'> {
+  return week % 2 === 0 ? 'EVEN' : 'ODD';
+}
+
+/** 判断某个课表条目在第 week 周是否上课（周次区间 + 单双周） */
 export function isScheduleActiveInWeek(
-  schedule: Pick<ScheduleDto, 'weekStart' | 'weekEnd'>,
+  schedule: Pick<ScheduleDto, 'weekStart' | 'weekEnd'> & { weekParity?: WeekParity | null },
   week: number,
 ): boolean {
-  return week >= schedule.weekStart && week <= schedule.weekEnd;
+  if (week < schedule.weekStart || week > schedule.weekEnd) return false;
+  const parity = schedule.weekParity ?? 'ALL';
+  if (parity === 'ALL') return true;
+  return parity === weekParityOf(week);
+}
+
+/** 格式化单双周标签（课表卡片用） */
+export function formatWeekParity(parity: WeekParity | null | undefined): string {
+  return WEEK_PARITY_LABELS[(parity ?? 'ALL') as WeekParity] ?? '每周';
 }
 
 /** 格式化周次范围，例如"1-20 周" / "单周" */