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/server/src/modules/homeworks/homeworks.module.ts

@@ -9,9 +9,11 @@ import {
   listHomeworksQuerySchema,
   updateHomeworkSchema,
   updateHomeworkStatusSchema,
+  updateHomeworkSubmissionsSchema,
   type CreateHomeworkInput,
   type UpdateHomeworkInput,
   type UpdateHomeworkStatusInput,
+  type UpdateHomeworkSubmissionsInput,
 } from './homeworks.schemas.js';
 import * as homeworkService from './homeworks.service.js';
 
@@ -97,6 +99,30 @@ router.patch(
   },
 );
 
+/** GET /api/homeworks/:id/submissions - 提交名单（未交名单功能） */
+router.get('/:id/submissions', validate({ params: idParamSchema }), async (req, res) => {
+  const user = getAuthUser(req);
+  const { id } = validatedParams<{ id: string }>(req);
+  const result = await homeworkService.listHomeworkSubmissions(user, id);
+  sendOk(res, result, `未交 ${result.notSubmitted.length} / ${result.total} 人`);
+});
+
+/** PATCH /api/homeworks/:id/submissions - 勾选未交名单（其余学生一律视为已交） */
+router.patch(
+  '/:id/submissions',
+  validate({ params: idParamSchema, body: updateHomeworkSubmissionsSchema }),
+  async (req, res) => {
+    const user = getAuthUser(req);
+    const { id } = validatedParams<{ id: string }>(req);
+    const result = await homeworkService.updateHomeworkSubmissions(
+      user,
+      id,
+      req.body as UpdateHomeworkSubmissionsInput,
+    );
+    sendOk(res, result, `已保存未交名单（未交 ${result.notSubmitted.length} 人）`);
+  },
+);
+
 export const homeworksModule = defineModule({
   name: 'homeworks',
   basePath: '/homeworks',

packages/server/src/modules/homeworks/homeworks.schemas.ts

@@ -30,6 +30,12 @@ export const updateHomeworkStatusSchema = z.object({
   userId: z.string().min(1).optional(),
 });
 
+/** 保存"未交名单"：列出未交的学生 id（其余学生一律标记为已交） */
+export const updateHomeworkSubmissionsSchema = z.object({
+  notSubmittedUserIds: z.array(z.string().min(1)).max(200).default([]),
+});
+
 export type CreateHomeworkInput = z.infer<typeof createHomeworkSchema>;
 export type UpdateHomeworkInput = z.infer<typeof updateHomeworkSchema>;
 export type UpdateHomeworkStatusInput = z.infer<typeof updateHomeworkStatusSchema>;
+export type UpdateHomeworkSubmissionsInput = z.infer<typeof updateHomeworkSubmissionsSchema>;

packages/server/src/modules/homeworks/homeworks.service.ts

@@ -1,4 +1,10 @@
-import { SOCKET_EVENTS, type HomeworkDto, type HomeworkStatusDto } from '@classhelper/shared';
+import {
+  SOCKET_EVENTS,
+  type HomeworkDto,
+  type HomeworkStatusDto,
+  type HomeworkSubmissionDto,
+  type HomeworkSubmissionsDto,
+} from '@classhelper/shared';
 import {
   assertCanPublishContent,
   assertClassAccess,
@@ -10,12 +16,13 @@ import { prisma } from '../../lib/db.js';
 import { ApiError } from '../../lib/http.js';
 import type { TokenPayload } from '../../lib/jwt.js';
 import { toHomeworkDto, toHomeworkStatusDto } from '../../lib/mappers.js';
-import { personalIdWhere, resolvePersonalIds } from '../../lib/session.js';
+import { isClassSession, personalIdWhere, resolvePersonalIds } from '../../lib/session.js';
 import { emitToClass } from '../../realtime/bus.js';
 import type {
   CreateHomeworkInput,
   UpdateHomeworkInput,
   UpdateHomeworkStatusInput,
+  UpdateHomeworkSubmissionsInput,
 } from './homeworks.schemas.js';
 
 const courseSelect = { select: { id: true, name: true } } as const;
@@ -213,6 +220,106 @@ export async function updateHomeworkStatus(
   return dto;
 }
 
+/* ------------------------------------------------------------------ 未交名单 */
+
+/** 组装某次作业的全班提交名单（未交名单 = completed=false 的那些） */
+async function buildSubmissions(classId: string, homeworkId: string): Promise<HomeworkSubmissionsDto> {
+  const [students, statuses] = await Promise.all([
+    prisma.user.findMany({
+      where: { classId, role: 'STUDENT' },
+      select: { id: true, name: true, username: true },
+      orderBy: { username: 'asc' },
+    }),
+    prisma.homeworkStatus.findMany({ where: { homeworkId }, select: { userId: true, completed: true } }),
+  ]);
+  const completedBy = new Map(statuses.map((item) => [item.userId, item.completed]));
+  const list: HomeworkSubmissionDto[] = students.map((item) => ({
+    userId: item.id,
+    name: item.name || item.username,
+    username: item.username,
+    completed: completedBy.get(item.id) === true,
+  }));
+  return {
+    homeworkId,
+    classId,
+    total: list.length,
+    completedCount: list.filter((item) => item.completed).length,
+    notSubmitted: list.filter((item) => !item.completed),
+    students: list,
+  };
+}
+
+/** 只有教师 / 管理员 / 班级设备可以维护"未交名单"（普通学生只能标记自己） */
+function assertCanManageSubmissions(user: TokenPayload): void {
+  if (user.role === 'ADMIN' || user.role === 'TEACHER') return;
+  if (isClassSession(user)) return;
+  throw ApiError.forbidden('只有教师或班级设备可以维护未交名单');
+}
+
+/** 读取作业提交名单（教师 / 班级设备） */
+export async function listHomeworkSubmissions(
+  user: TokenPayload,
+  homeworkId: string,
+): Promise<HomeworkSubmissionsDto> {
+  const homework = await prisma.homework.findUnique({
+    where: { id: homeworkId },
+    select: { id: true, classId: true },
+  });
+  if (!homework) throw ApiError.notFound('作业不存在');
+  await assertClassAccess(user, homework.classId);
+  assertCanManageSubmissions(user);
+  return buildSubmissions(homework.classId, homeworkId);
+}
+
+/**
+ * 保存"未交名单"：勾选的学生标记未完成，其余学生一律标记完成。
+ * 这样班级设备的操作语义是"点名谁没交"，比逐个勾"谁交了"更省事。
+ */
+export async function updateHomeworkSubmissions(
+  user: TokenPayload,
+  homeworkId: string,
+  input: UpdateHomeworkSubmissionsInput,
+): Promise<HomeworkSubmissionsDto> {
+  const homework = await prisma.homework.findUnique({
+    where: { id: homeworkId },
+    select: { id: true, classId: true },
+  });
+  if (!homework) throw ApiError.notFound('作业不存在');
+  await assertClassAccess(user, homework.classId);
+  assertCanManageSubmissions(user);
+
+  const students = await prisma.user.findMany({
+    where: { classId: homework.classId, role: 'STUDENT' },
+    select: { id: true },
+  });
+  if (students.length === 0) throw ApiError.badRequest('当前班级还没有学生账号');
+
+  const notSubmitted = new Set(input.notSubmittedUserIds);
+  const studentIds = new Set(students.map((item) => item.id));
+  const outsiders = [...notSubmitted].filter((id) => !studentIds.has(id));
+  if (outsiders.length > 0) throw ApiError.badRequest('未交名单里包含非本班学生');
+
+  await prisma.$transaction(
+    students.map((item) =>
+      prisma.homeworkStatus.upsert({
+        where: { homeworkId_userId: { homeworkId, userId: item.id } },
+        create: { homeworkId, userId: item.id, completed: !notSubmitted.has(item.id) },
+        update: { completed: !notSubmitted.has(item.id) },
+      }),
+    ),
+  );
+
+  const result = await buildSubmissions(homework.classId, homeworkId);
+  // 实时刷新教师端/学生端的完成情况
+  emitToClass(homework.classId, SOCKET_EVENTS.homeworkStatus, {
+    homeworkId,
+    classId: homework.classId,
+    completedCount: result.completedCount,
+    total: result.total,
+  });
+  return result;
+}
+
 async function assertCourseInClass(courseId: string, classId: string): Promise<void> {
   const course = await prisma.course.findUnique({ where: { id: courseId }, select: { classId: true } });
   if (!course) throw ApiError.badRequest('课程不存在');