classhelper-island-refactor-prompt/out/refactor-sections/12-acceptance.md

12. 验收清单（逐项勾选，不得跳过）

所有自动验证默认无头/离屏；--visual 才允许真实桌面。任一项未通过都不得声称完成。

12.1 工程门禁

• pnpm lint 0 error（warning 需列出）。
• pnpm typecheck 0 error（先构建 shared）。
• pnpm build:desktop 成功；island.html 与主窗口产物分别可加载。
• 未新增 UI 框架/状态库/图标库；新增依赖（若有）≤ 200KB 且说明不可替代性。
• 只改 packages/shared、packages/desktop-client、packages/ui（如需）与 docs；服务端/Web 管理端零改动。
• 所有新增 IPC 通道有 sender 校验、payload 类型校验；preload 白名单与 desktop.d.ts 同步。
• 无 console.log 残留；日志走统一 logger。

12.2 视觉验收（像素级）

在 1920×1080@100%、2560×1440@125%、深色/浅色、family=classisland/winisland、Fluent/Classic 主题下截取离屏基准图，逐项比对（颜色 ±2/255、尺寸/位置 ±1px、透明度 ±1%）：

fixed（classisland 风格）

• fixed 窗口包围盒固定：宽 = min(工作区宽, 960)、高 = 40 + 2×pad（pad 默认 20）；消息到达/展开/多条列表均不改变窗口尺寸。
• 可见行高 40px，行内容左右内边距 12px，最小内容宽 20px；行间距 5px。
• 行背景：圆角 8px、背景不透明度 0.5、1px 描边、阴影 0 4 8 2 #48000000（Fluent）。
• 字号：次要 14 / 主体 16 / 强调 18 / 超大 20；字重 Medium；正文 line-height: 1.25。
• 进度条：高 3px、贴底、圆角 1.5px、颜色为强调色、按设置精度更新。
• 默认 1 行 = 日期 + 课程表；无课表时显示占位文本（"今天没有课程。"/"今日课程已全部结束。"）。
• 课程表显示当前/下一节/今日时间点模式，当前项展开显示起止时间，其余折叠；课间与"默认隐藏"时间点折叠时隐藏，分割线显示竖线，行动不显示。
• 下课前秒数徽标：蓝色圆形、显示在课程名右侧、剩余 1 秒显示 -1、不显示"即将下课"遮罩、不替换常态组件。
• 消息气泡：遮罩 5 区权重 [0,0.1,0.2,0.4,0.2,0.1]、60° 斜切、区段 360ms + 错峰 120ms、开 QuarticEaseOut / 关 QuadraticEaseIn；文字延迟 260/250ms、scale 1.1→1.0/750ms；退出 200ms (0.5,0,0.75,0)；行高 40。
• 强提醒：全屏/大区域遮罩、超时关闭、不抢焦点、在岛所在显示器出现；关闭后无残影。
• winisland 风格：胶囊 268×44（默认值可配置 220–420 × 36–72）、连续圆角（超椭圆 4.2/14 段）、弹簧形变、纯黑/毛玻璃/主题色渐变、阴影常驻；不得与 classisland 风格混用。

custom（始终 ClassIsland 规格，family 不影响 custom）

• 行高 40、行间距 5、组件外边距 6/6、行背景圆角 8、背景不透明度 0.5。
• 行结构：Auto, *, Auto 三列（左拖动把手 20px / 中组件 / 右行操作区）；选中框 1.5px 虚线 1,1.5、Opacity 0.75、圆角同背景。
• 多行、分体岛（separated）、主行标记、允许提醒标记、隐藏规则、组件外观覆盖（字号/前景/背景/圆角/透明度/宽度/对齐）逐项与设置一致。
• 编辑器中的组件库、行、容器嵌套、选中态、抽屉尺寸与间距符合第 9 部分。
• 所有组件的默认样式/空数据兜底/超长文本截断/滚动行为符合第 7 部分。

窗口与层级

• 岛窗口无边框、透明、置顶、默认不占任务栏、默认不抢焦点；winisland 与 classisland 风格均不出现白底/黑边/窗口阴影残影。
• 6 个停靠位 × 偏移（X/Y）× 多显示器索引正确；followCursorDisplay 行为保持。
• 编辑模式窗口/画布尺寸正确：屏宽 ×（屏高−1px）、四边 60px 内缩、开启命中。
• 深浅色/主题切换无残留样式；岛动画由 appearance.animations 开关控制（系统 prefers-reduced-motion 不强制关闭岛动画，遵循 ClassHelper 既有文档约定）。

12.3 功能验收

消息与提醒

• 通知/作业/叫人三类消息的图标、标题、正文、优先级、时间显示符合第 8 部分。
• id 去重；同批消息按"优先级 → 时间"排序；列表"展开更多"与"超出工作区提示"正确。
• 上课期间普通通知/作业暂存、下课补弹；普通叫人保留可点胶囊；紧急通知/紧急叫人立即展开；与 ClassHelper 现有规则逐条一致。
• 已读/知道了/标为已读/批处理的语义与通知中心状态一致；本机新录作业指纹去重。
• 自动收起超时：胶囊 15s、展开 20s、紧急 45s、叫人 90s（按现有常量），可打断、可重入。
• 强提醒仅对开启"强调提醒"的消息出现；关闭后不出现；超时自动关闭；不阻塞岛与其他应用。
• 消息风暴 20 条/分钟：不丢、不重复、不卡顿、队列上限有日志。

课程与天气

• 准备/上课/课间/下课前倒数/课中进度五类提醒按设置触发，阈值默认 60s 可调。
• 课程状态机跨天、跨周、临时课表、预定课表、调课场景正确（与 ClassHelper 现有解析结果一致）。
• 课程提醒接管：fixed（classisland）按 ClassIsland 行内容接管显示 prepare/on-class/break；custom 不再临时接管整岛（移除 resident-lesson-page），进度由课程组件显示，ending 只保留课程名右侧 30×30 蓝色圆形秒数徽标。
• 天气：Open-Meteo 15 分钟刷新、断网缓存并显示"缓存"、失败重试与降级、无官方气象预警措辞。
• 课件传输：传输中覆盖岛内容，显示文件名/类型/教师/字节/进度，完成后校验并回执；不自动运行文件。

编辑器与设置

• 设置页：经典/自定义切换、风格切换、外观参数、课程提醒开关、指针避让、动画开关、强提醒开关全部即时保存并生效。
• 编辑器：方案栏（新建/复制/删除/重命名/导入导出/重置）、组件库 11 类、行（新增/排序/主行/允许提醒/删除）、容器嵌套、拖拽（行内/跨行/库→行/库→容器）、选中与组件设置（内容/外观/尺寸/隐藏条件）、编辑模式预览、预览缩放、退出保存/失败重试。
• 边界：12 行/200 节点/6 层/20 方案；超限拒绝并提示；非法颜色/数值被夹取；未知组件/未知 Kind 不崩溃。
• 旧方案导入后可直接渲染（迁移测试）。

12.4 动画验收

• 第 10 部分动画表逐项实现；时长误差 ≤ 16ms，曲线一致（DevTools Animations 或逐帧截图验证）。
• 岛出现/隐藏、行展开/折叠、行宽/高度、进度条、消息气泡两阶段、强提醒、课程徽标、滚动/轮播、主题切换全部流畅（≥55fps）。
• 不可打断的动画可被新状态覆盖（不排队、不闪回）。
• animations=false 生效（唯一岛动画开关）；speed 统一缩放时长；失焦/隐藏页暂停；恢复后不补播。
• 动画结束无残留 will-change、定时器、rAF。

12.5 兼容与迁移验收

• 旧 fixed/custom 配置 fixtures 升级后：方案、行、组件、外观、课程提醒、指针避让、residentEnabled 全部保留；迁移幂等。
• 升级失败可回滚（备份恢复）；不可用时保留原文件为 .corrupt 并启动默认配置，不得清空。
• 新配置被旧客户端读取时忽略未知字段、不崩溃（如能构造旧客户端则测；否则单测模拟）。
• winisland 风格下旧观感/旧交互无回归（对照基线图）。
• 切换 fixed↔custom、风格切换、方案切换均不新开窗口、不丢配置。

12.6 无头与不打扰验收

• pnpm verify:desktop（不带 --visual）全程不创建可见岛、托盘气泡、系统通知、声音；测试结束无残留进程/窗口。
• 使用独立 userData；不触碰真实配置/真实班级/真实通知。
• --visual 仅在显式允许时运行，且截图输出到临时目录；不自动发布。
• 崩溃自愈限流有效：1 分钟内最多重建 3 次，超过进入安全模式/停止重建。
• 日志无密码/令牌/敏感路径。

12.7 性能验收

• 岛渲染进程启动 ≤ 500ms；冷启动到岛可见 ≤ 3s。
• 空闲 CPU ≤ 1%；消息风暴峰值 ≤ 15% 且 ≤ 500ms。
• 主进程 + 岛渲染进程内存 ≤ 250MB；24h 增长 ≤ 10%；无句柄泄漏。
• 包体增量 ≤ 200KB（除说明的例外）；无新增大图标/字体文件。

12.8 文档与交付物

• docs/app/island.md、docs/dev/implementation.md 更新；新增 docs/dev/island-refactor.md。
• 架构图、数据契约、动画表、迁移与回滚、测试命令齐全。
• 交付说明：与 ClassIsland 差异、未实现项、性能数据、回滚步骤。
• 第 12 部分本清单逐项勾选并附验证输出摘要；未验证项标注原因。

12.9 禁止事项（验收时再次确认）

• 未通过修改验收标准/删除测试来"通过"。
• 未因重构删除既有功能（消息、课程、天气、课件、编辑、导入导出、指针避让、触摸）。
• 未引入需要联网/登录的新依赖。
• 未把 ClassIsland 的 C#/XAML/本地档案代码复制进 ClassHelper。