diff --git a/AGENTS.md b/AGENTS.md index 987e20b..7014eec 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,6 +11,7 @@ pnpm monorepo,根 `package.json` 是版本单一来源。文档、注释、界 | 目录 | 用途 | | -------------------------- | --------------------------------------------------------- | +| `packages/ui/src/` | Web 与桌面端共享 Vue 控件、主题、日期选择器与全屏引导 | | `packages/shared/src/` | 三端共享类型、权限、常量、动效、岛方案与课件契约 | | `packages/server/` | Express、Prisma、Socket.IO;API 前缀 `/api` | | `packages/web-admin/` | Vue Web 管理端,PWA | @@ -39,7 +40,8 @@ pnpm monorepo,根 `package.json` 是版本单一来源。文档、注释、界 - 作业和通知按本地 `assignDate` 归类,使用 `dayKeyLocal/isDayKey/shiftDayKey`,不用 UTC 日期切片。 - 批量通知/作业逐班返回结果;跨班作业按科目名匹配既有课程,找不到则该班失败,不自动把发布者设为任课老师。 - 两个登录接口共用登录限流。附件链接校验 scheme;表格文件上限 8 MB、JSON 请求体 12 MB,超限映射 413。 -- AI 助手只解析待确认动作,前端确认后调既有发布接口;参数重新校验,Key 加密存储且不回传。自动化用 mock,不访问外网。 +- AI 查询和模型上下文按原业务权限读取;写操作由动作目录生成计划,用户确认后调用既有业务接口,入口绑定操作者、参数和步骤并持久去重。数据库维护、服务器运维与密钥操作不注册为 AI 动作。密码经专用表单提交,计划参数加密保存;自动化用 mock,不访问外网。 +- AI 可管理客户端安装包缓存:写入仅 ADMIN + `client:update`,要求专门确认,固定复用 `/update/client/fetch` 和 `/update/client/releases`。预览和执行核对版本、文件及已有登记;不开放服务器更新或任意下载地址,不自动推送或运行安装器。 ## 3. 课表、周次、成绩与学年 @@ -77,6 +79,7 @@ pnpm monorepo,根 `package.json` 是版本单一来源。文档、注释、界 - 事件名与房间名取 shared 常量。班级房间为 `class:{id}:{channel}`,教师按每域读键及范围订阅,班级端仅本班全部通道;握手回查数据库身份。业务用 `emitToClass/emitToSession`,由总线选择事件域。 - 会话房间为 `session:{id}`;教师/管理员 id 为账号 id,班级端为班级 id。`students` 是班级端广播房间,不是个人学生账号房间。 - 新实时事件同步服务端、Web 订阅、客户端订阅。成绩实时载荷不可泄漏个人成绩。 +- 两端基础控件、主题、日期圆点与全屏引导维护在 `packages/ui`。日期统计跟随当前筛选和日历可见范围,缓存按服务器与班级隔离;业务日期使用本地日期工具。 - Web 菜单分组在 `config/navigation.ts`,标题/图标/权限取路由;守卫与服务端都检查权限,前端隐藏不能代替鉴权。 - 侧栏折叠用 CSS 保持 DOM,关怀模式放大字号/控件,不改变几何令牌。使用语义色,动效统一 shared 令牌;图标新增后检查注册表。 - 图标源是 `build/classhelper.png` 与设计导出的 `.ico`,`pnpm icons` 派生其余资源。ICO 原样透传,客户端兜底 `build/icon.*` 同步保留。 @@ -112,6 +115,7 @@ Prisma 使用 driver adapter;本机优先应用已有迁移,不用 `migrate | `pnpm lint` / `pnpm typecheck` / `pnpm check:icons` | 代码静态门禁;按改动范围执行 | | `pnpm docs:check` | 文档严格构建,警告即失败 | | `pnpm verify:e2e` | 自动创建临时 SQLite 和账号,无需先开开发服务,禁止外网 | +| `pnpm verify:ai` | AI 白名单、计划确认、权限与附件隔离验收 | | `pnpm verify:authz` / `pnpm verify:audit` | 隔离授权攻击矩阵;审计事务、竞态、模型操作计数和 PWA | | `pnpm verify:web:isolated` | 构建 Web 后运行隔离服务和隐藏 UI 回归 | | `pnpm verify:courseware` / `pnpm verify:v14` | 课件/课表等隔离专项 | diff --git a/deploy/docker-compose.sqlite.yml b/deploy/docker-compose.sqlite.yml index f98a540..70c7619 100644 --- a/deploy/docker-compose.sqlite.yml +++ b/deploy/docker-compose.sqlite.yml @@ -23,7 +23,7 @@ services: context: .. dockerfile: deploy/Dockerfile target: runtime - image: classhelper-server:${APP_VERSION:-1.4.3} + image: classhelper-server:${APP_VERSION:-1.4.4} restart: unless-stopped environment: NODE_ENV: production diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml index d526e12..ae0c628 100644 --- a/deploy/docker-compose.yml +++ b/deploy/docker-compose.yml @@ -60,7 +60,7 @@ services: context: .. dockerfile: deploy/Dockerfile target: runtime - image: classhelper-server:${APP_VERSION:-1.4.3} + image: classhelper-server:${APP_VERSION:-1.4.4} restart: unless-stopped environment: NODE_ENV: production diff --git a/deploy/package.runtime.json b/deploy/package.runtime.json index 55effd0..ab86c69 100644 --- a/deploy/package.runtime.json +++ b/deploy/package.runtime.json @@ -1,6 +1,6 @@ { "name": "classhelper-server-runtime", - "version": "1.4.3", + "version": "1.4.4", "private": true, "type": "module", "description": "ClassHelper 服务端运行时(安装包 / 容器内置)", @@ -21,6 +21,7 @@ "socket.io": "^4.8.3", "typescript": "~5.9.3", "xlsx": "0.18.5", + "yaml": "^2.9.1", "zod": "^4.6.2" } } diff --git a/docs/app/appearance.md b/docs/app/appearance.md index 9b5c41e..6af036f 100644 --- a/docs/app/appearance.md +++ b/docs/app/appearance.md @@ -7,7 +7,7 @@ description: 深浅色主题、界面风格、设计令牌与动效语言,以 ## 深浅色主题 -**两端都有深色主题,机制完全一致**:在 `` 上挂 `.dark` 类,由各自的样式表覆盖**语义色令牌**, +**两端都有深色主题,机制完全一致**:在 `` 上挂 `.dark` 类,由共享 UI 主题覆盖**语义色令牌**, Element Plus 的深色变量提供组件层的默认值。两端的 `main.ts` 都在挂载之前就把主题落好, 所以深色用户打开时不会"先白后黑"闪一下。 @@ -19,7 +19,7 @@ Element Plus 的深色变量提供组件层的默认值。两端的 `main.ts` | 切换效果 | 从点击位置**扩散的圆**铺满整页换肤 | **刻意不随主题的区域**:登录页的深色渐变底、桌面端的启动过渡页与全屏作业看板、灵动岛自身、 -Web 管理端的侧边栏(本来就是深色),以及深色底上的白色文字。 +以及深色底上的白色文字。 Web 端还会同步 ``,并设 `color-scheme` 让**原生控件** (滚动条、日期选择器弹层、自动填充底色)也跟着走 —— 只改 CSS 变量的话它们会仍是浅色。 @@ -44,13 +44,15 @@ Web 端还会同步 ``,并设 `color-scheme` 让**原 ## 界面风格 -- 浅色底 `#f3f3f3` + 半透明卡片(`rgba(255,255,255,.7)` + `backdrop-filter: blur(20px)`); -- 强调色 `#0F6CBD`(悬停 `#115EA3`);选中的导航项 = 强调色淡底 + 左侧 3px 强调条; -- 圆角统一:卡片 8px / 控件 4px;描边用半透明黑代替灰线;阴影极轻; -- 字体 `Segoe UI Variable / 微软雅黑 UI`;Element Plus 的变量整体对齐这套规范。 +Web 和桌面主窗口共用简洁的管理界面:浅灰底、实色卡片、统一描边与紫蓝强调色。标题、筛选、操作栏和表单按同一套控件与间距规范呈现;深浅色切换保持相同几何。 -Web 管理端走的是另一套(1Panel 风格:深色侧边栏 + 白色圆角卡片), -圆角与投影集中定义在它的 `:root` 令牌里。 +共享主题和控件由 UI 包维护,灵动岛只引入共用语义令牌,保留透明窗口和各模式的布局规则。 + +日期统一通过日历选择。有记录的日期下方显示圆点,统计随当前筛选和可见月份更新。日期目录与日期下拉列表已改为日历,教师和文件夹仍可独立筛选。 + +Web 的作业、通知日期统计保留在当前会话缓存中,按服务器、操作者、权限范围和筛选条件隔离;退出或收到授权失败时清理。桌面端复用按服务器和班级隔离的离线缓存。只有网络不可达时才回退缓存,缓存故障不阻断在线读取。 + +首次进入新版会显示全屏分步引导,可以返回、跳过或完成;账号菜单、客户端登录页和通用设置保留重看入口。引导中的内容为示意,不创建业务数据。 ## 动效语言 diff --git a/docs/app/assistant.md b/docs/app/assistant.md index b98f7e9..4218872 100644 --- a/docs/app/assistant.md +++ b/docs/app/assistant.md @@ -1,26 +1,34 @@ --- title: AI 助手 -description: 将自然语言解析成待确认动作,核对后通过现有业务接口发布。 +description: 多轮对话、文件处理与操作计划,核对后通过现有业务接口执行。 --- # AI 助手 -AI 助手位于 Web 管理端工作台。输入要发布的作业、通知或叫人请求,助手会展示解析出的班级、科目、内容与提醒级别;核对并确认后才发布。内容仍通过原有业务接口,继续校验当前账号的功能权限、班级范围及任课关系。 +在 Web 管理端描述任务、补充条件或添加文件,助手会查询所需信息并生成操作计划。查询直接显示结果;任何发布、修改、导入和设备操作,都要核对计划并确认后执行。 -## 配置与使用 +## 使用 -管理员在大模型设置中开启助手,选择服务地址和模型并保存 API Key。密钥加密存储,读取设置只返回是否已配置及末尾提示,不返回完整密钥。修改服务端 JWT 密钥后,原有加密 Key 需要重新配置。 +1. 可先选择目标班级,再输入任务;文件也可以直接拖入对话区。 +2. 信息不足时补充说明。核对目标、文件、修改前内容和本次变更;表格导入可调整字段对应。 +3. 确认执行后逐步显示结果。跨班发布按班显示进度,成功班级不会重复执行。失败时只重试尚未成功的步骤;结果不明时先在对应业务页面核对。 -1. 在助手页面描述操作与目标班级,等待解析预览。 -2. 核对班级、科目、标题、正文和提醒级别;有歧义时修改后重新解析。 -3. 点击确认发布。紧急通知在上课期间仍需完成额外确认;批量操作逐班返回结果。 +文件推送复用课件上传、哈希校验和设备回执,普通课件上限 512 MB。结构化导入支持现有 CSV、Excel、JSON、YAML 格式,上限 8 MB,先解析预览,确认后才写入业务数据。 -解析成功不代表已经发布,也不代表拥有对应班级或科目的写权限。缺少任课关系时,请由管理员配置;助手不能替用户建立授权。 +## 权限 -## 离线示例与审计 +助手权限跟随操作者。教学业务、课表时间表、名单成绩、账号岗位和设备操作均使用原业务接口的授权规则;管理员专用功能仍限管理员。确认期间撤权、调班或任课关系变化后会重新校验。 -`mock` 提供确定性的离线示例解析,用于自动化验收,不访问外网;预览会提示当前为示例结果。真实模型调用失败时页面保留可操作的错误说明,不会自动改用发布接口。 +数据库备份、恢复、清空、切换、SQL,以及服务器配置、启停、升级和密钥维护不向助手开放。删除、权限调整、升学和远控保留专门确认;上课时的紧急通知仍需二次确认。 -有管理权限的账号可查看助手审计。审计记录解析意图和状态,不代替作业、通知或叫人的最终发布结果;请结合对应业务页面核对。 +管理员可让助手抓取、登记或删除客户端安装包缓存,核对版本、文件与替换信息并专门确认后执行。缓存管理不会自动推送、运行安装器或升级服务器。助手也可按设备权限处理远控、更新推送和移除设备登记。 -相关规则:[作业](homeworks.md)、[通知](notifications.md)、[叫人](calls.md)、[角色与权限](../dev/permissions.md)。 +密码通过操作卡片中的专用表单输入,不提供给模型。用户指令与任务所需的已授权业务信息由学校配置的模型服务解析;普通课件只提供文件元数据。对话历史保留在当前页面会话,计划与执行结果记入服务端审计。 + +## 模型配置与验收 + +管理员在大模型设置中配置服务地址、模型和 API Key。Key 加密保存且不回传;改变服务器 JWT 密钥后需重新配置 Key。 + +`mock` 用于离线示例和自动化验收,真实服务失败不会自动切换为 mock 或发布内容。`pnpm verify:ai` 使用临时数据库和模型 stub 验证权限、计划、附件和重复提交,不访问外网。 + +相关功能:[课件](courseware.md)、[课表](schedules.md)、[作业](homeworks.md)、[通知](notifications.md)、[角色与权限](../dev/permissions.md)。 diff --git a/docs/app/imports.md b/docs/app/imports.md index 8698a20..7152b3e 100644 --- a/docs/app/imports.md +++ b/docs/app/imports.md @@ -22,7 +22,7 @@ description: 表格预览、名单与成绩校验,以及完整离线档案导 ## 完整 ClassIsland 档案 -在“课表档案 → 导入档案”选择或粘贴 JSON,先预览再导入。 +在“课表档案 → 导入/导出 → 导入课表(JSON / YAML)”选择或粘贴 JSON,先预览再导入。 完整输入包含 TimeLayouts、ClassPlans、Subjects 字典,可包含 ClassPlanGroups 和 OrderedSchedules 等配置。 JSON 只作为离线文件导入,不依赖在线联动插件。 @@ -44,6 +44,37 @@ JSON 只作为离线文件导入,不依赖在线联动插件。 不完整展示群组/空课/停用等结构;提交直接调用完整导入,不能把预览的单双周列当作实际数据模型。 完整导入失败时事务回滚;部分缺失引用可能返回 warnings,须检查导入结果和日课表编辑器。 +## YAML 课表 + +同一导入窗口支持 `.yaml` / `.yml` 文件和粘贴内容,提供示例下载。先解析预览,再选择合并或覆盖。 +文件上限 8 MB。格式如下: + +```yaml +version: 1 +subjects: + - name: 数学 + simplified_name: 数 + teacher: 李梅 + room: '101' +schedules: + - name: 星期一 + enable_day: 1 + weeks: all + classes: + - subject: 数学 + start_time: '080000' + end_time: '090000' +``` + +`enable_day` 为 1–7(周一至周日);`weeks` 支持 `all`(每周)、`odd`(单周)、`even`(双周)。 +同一天的单周与双周分开填写,同一天同一相位不可重复,也不能混用每周与单双周课表。 +时间支持 `HHMMSS`、`HH:mm`、`HH:mm:ss`,秒必须为 `00`;未加引号的六位数字也可识别。 +兼容以 `version 1` 开头、字段省略冒号的示例写法,并在预览中提示;新文件建议采用上述标准 YAML。 + +`simplified_name` 保存为科目简称,`room` 保存为课次地点;`teacher` 只在预览中展示,不创建教师账号或改变任课关系。 +缺失科目按完整档案规则补建。YAML 归一化为关系化时间点和日课表后复用完整导入的权限、事务和实时更新。 +合并按星期与单双周更新同一套 YAML 对象;覆盖会替换该班已有日课表。语法或字段校验失败时不会写库。 + ## 时间配置兼容入口 旧 /imports/time-layout 接口保留,写入和删除需 timetable:manage,现行写入同步关系化时间点。 diff --git a/docs/app/schedules.md b/docs/app/schedules.md index fa1266f..cf23ed1 100644 --- a/docs/app/schedules.md +++ b/docs/app/schedules.md @@ -18,6 +18,8 @@ Web 管理端统一从「教学事务 → 课表档案」查看周课表并编 完整档案可在页头「导入/导出」中导入或导出 JSON,保留轮换、时间点类型、空课、停用、群组和预定。月视图提供日期导航,点击日期后由服务端解析教学周并进入周视图。 +「导入课表(JSON / YAML)」还支持简化的 YAML 课表,包含星期、单双周、科目和起止时间;字段与示例见[表格与课表导入](imports.md)。 + ## 日课表与时间表 时间表保存时间点:上课、课间、分割线、行动;日课表引用时间表,每节课程通过外键关联时间点。 diff --git a/docs/dev/api.md b/docs/dev/api.md index 651238a..e1a910f 100644 --- a/docs/dev/api.md +++ b/docs/dev/api.md @@ -27,28 +27,29 @@ API 前缀 /api,JWT 使用 Authorization: Bearer。成功/失败结构以 `lib ## 教学与文件 -| 路径/动作 | 行为及边界 | -| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -| /courses | 班级科目与任课关系 | -| GET /schedules、/grid、/current、/active-week | 新关系模型的兼容投影,按班级范围读取 | -| POST/PATCH/DELETE /schedules[/:id] | 兼容 CRUD,写新模型,不双写旧 Schedule | -| POST /schedules/swap、/overlay、/scheduled;GET /schedules/scheduled;DELETE /schedules/scheduled/:id | 换课、临时层、预定 | -| /time-layouts;POST /time-layouts/:id/clone、/:id/import | 时间表 CRUD/克隆/导入,写入 timetable:manage | -| /class-plans;PUT /class-plans/:id/entries;PATCH /class-plans/:id/enabled | 日课表 CRUD、整表保存、启用,写入 schedule:write + 班主任/管理员 | -| POST /class-plans/:id/clone、/class-plans/import、/class-plans/import/profile;GET /class-plans/:id/export | 复制、导入导出及完整档案导入;导入另需 import:schedule | -| /class-plan-groups;GET /class-plan-groups/selection;POST /class-plan-groups/select | 群组及当前/临时选择 | -| /homeworks、/homeworks/bulk、/:id/status、/:id/submissions | 作业、批量、完成与未交;员工功能键+科目检查,班级端可录作业 | -| /notifications、/notifications/bulk、/days、/creators、/unread-count、/:id/read、/read-all | 通知、归档和已读;发布需 notification:publish,课堂紧急须确认 | -| POST /calls | 叫人,call:create + 范围检查 | -| /grades、/grades/bulk、/stats、/levels、/my、/overview、/collective、/student/:studentNo、/exams、/ranking | [成绩与隐私](../app/grades.md),查询列表参数用 studentId,写入仍按科目 | -| /imports/template、/table/preview、/table/commit | 表格导入,按 kind 再检查对应导入键、管理键、班级和科目 | -| /imports/class-plan/preview、/imports/class-plan | 预览与提交均需 import:schedule + schedule:write;提交走关系化导入 | -| /imports/time-layout[/:id]、/time-layout/preview | 时间配置兼容入口,导入需 import:schedule + timetable:manage,删除需 timetable:manage | -| GET /class-plans/profile?classId= | 完整档案导出,按班级范围读取,保留时间点与课表关联 | -| GET /courseware、/courseware/:id、/:id/download | 课件目录/详情/下载;员工需 courseware:read,班级端按可见范围 | -| POST /courseware/upload、/:id/push;PATCH /courseware/:id/visibility;DELETE /courseware/:id | 写入 courseware:write + 员工身份;本人文件、任课班级与可见范围限制 | -| GET/POST /courseware/folders;PATCH /courseware/:id/folder | 员工 courseware:write;目录与课件均限本人 | -| GET /courseware/transfers;POST /courseware/transfers/:id/ack | 班级端补领、逐设备回执 | +| 路径/动作 | 行为及边界 | +| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | +| /courses | 班级科目与任课关系 | +| GET /schedules、/grid、/current、/active-week | 新关系模型的兼容投影,按班级范围读取 | +| POST/PATCH/DELETE /schedules[/:id] | 兼容 CRUD,写新模型,不双写旧 Schedule | +| POST /schedules/swap、/overlay、/scheduled;GET /schedules/scheduled;DELETE /schedules/scheduled/:id | 换课、临时层、预定 | +| /time-layouts;POST /time-layouts/:id/clone、/:id/import | 时间表 CRUD/克隆/导入,写入 timetable:manage | +| /class-plans;PUT /class-plans/:id/entries;PATCH /class-plans/:id/enabled | 日课表 CRUD、整表保存、启用,写入 schedule:write + 班主任/管理员 | +| POST /class-plans/:id/clone、/class-plans/import、/class-plans/import/profile;GET /class-plans/:id/export | 复制、导入导出及完整档案导入;导入另需 import:schedule | +| /class-plan-groups;GET /class-plan-groups/selection;POST /class-plan-groups/select | 群组及当前/临时选择 | +| /homeworks、/homeworks/bulk、/:id/status、/:id/submissions | 作业、批量、完成与未交;员工功能键+科目检查,班级端可录作业 | +| /notifications、/notifications/bulk、/days、/creators、/unread-count、/:id/read、/read-all | 通知、归档和已读;发布需 notification:publish,课堂紧急须确认 | +| POST /calls | 叫人,call:create + 范围检查 | +| /grades、/grades/bulk、/stats、/levels、/my、/overview、/collective、/student/:studentNo、/exams、/ranking | [成绩与隐私](../app/grades.md),查询列表参数用 studentId,写入仍按科目 | +| /imports/template、/table/preview、/table/commit | 表格导入,按 kind 再检查对应导入键、管理键、班级和科目 | +| /imports/class-plan/preview、/imports/class-plan | 预览与提交均需 import:schedule + schedule:write;提交走关系化导入 | +| POST /imports/class-plan/yaml/preview、/imports/class-plan/yaml | YAML 预览/导入;同课表导入权限与班级范围,支持 all/odd/even 与 HHMMSS,提交复用完整档案事务 | +| /imports/time-layout[/:id]、/time-layout/preview | 时间配置兼容入口,导入需 import:schedule + timetable:manage,删除需 timetable:manage | +| GET /class-plans/profile?classId= | 完整档案导出,按班级范围读取,保留时间点与课表关联 | +| GET /courseware、/courseware/:id、/:id/download | 课件目录/详情/下载;员工需 courseware:read,班级端按可见范围 | +| POST /courseware/upload、/:id/push;PATCH /courseware/:id/visibility;DELETE /courseware/:id | 写入 courseware:write + 员工身份;本人文件、任课班级与可见范围限制 | +| GET/POST /courseware/folders;PATCH /courseware/:id/folder | 员工 courseware:write;目录与课件均限本人 | +| GET /courseware/transfers;POST /courseware/transfers/:id/ack | 班级端补领、逐设备回执 | ## 设备、系统与运维 @@ -68,7 +69,7 @@ API 前缀 /api,JWT 使用 Authorization: Bearer。成功/失败结构以 `lib | /archives、/archives/transferred、/archives/transferred/:id/restore | 历史归档需 archive:manage 全校范围;撤回转出需 roster:manage;不提供手动创建归档 | | /database/status、/test-connection、/backups、/export、/import、/sqlite-file、/backup-schedule、/switch | database:manage;目标空库、快照及换库子进程保护 | | /system/settings、/autostart、/diagnostics | system:manage,非安装形态自启动返回不可用原因 | -| /ai/settings、/interpret、/audit | ai:manage/ai:use;只解析待确认动作,密钥只进不出 | +| /ai/settings、/interpret、/audit、/capabilities、/plans/:id | ai:manage/ai:use;查询遵循业务权限,写入计划确认后调用原接口,密钥只进不出 | | /dashboard/summary、/dashboard/term | 按范围读取看板与周次 | 探针 /healthz 和 /readyz 不带 API 前缀;/api/health 提供版本与模块详情。 @@ -117,3 +118,19 @@ API 前缀 /api,JWT 使用 Authorization: Bearer。成功/失败结构以 `lib 成绩 overview/collective/exams/ranking 显式检查 grade:read,班级端由服务断言限本班并执行查询开关。设备 heartbeat/update-progress/commands/:id/ack 仅接受绑定本班的 CLASS_DEVICE,不接受教师个人设备。 `GET /permissions/me` 同时返回 classScopes、manageScopes、allScopeKeys,供 Web 按钮与班级选择器显示实际能力范围;manageScopes 对名单、日课表、导入和考试配置叠加班主任或显式组织范围规则。界面范围提示不替代服务端断言。 + +## AI 操作计划 + +跨班作业与通知会归一为逐班步骤,分别调用单班业务接口。成功班级保持成功状态,后续重试跳过这些步骤。 + +客户端安装包缓存允许 `clients.releases` 查询,以及仅限 ADMIN + `client:update` 的 `clients.release-fetch/register/delete`。写入均要求专门确认,并核对版本、已有登记及缓存文件状态。更新模块只开放固定的 `/update/client/releases` 查询、`/update/client/fetch` 抓取、`/update/client/releases` 登记及按版本删除;没有服务器更新、配置或任意下载地址入口。抓取复用现有官方项目下载地址与流式校验,不推送或安装。 + +`POST /ai/interpret` 接收 `text`、可选班级、当前会话的 `messages` 和附件元数据 `attachments`,返回 `planId/message/steps/results`,并保留旧响应字段的兼容形状。附件包含 id、文件名、大小与 SHA256;普通课件内容不发送给模型。 + +- `GET /ai/capabilities`:当前操作者可用的动作及参数契约,目录不包含数据库维护、服务器运维和密钥操作。 +- `GET /ai/plans/:id`:本人计划和分步状态;业务权限及范围重新校验。 +- `POST /ai/plans/:id/prepare`:结构化附件经哈希核对后复用原导入解析器生成预览,不发布业务数据。 +- `POST /ai/plans/:id/confirm`:提交明确确认、必要的高影响操作确认和专用敏感字段;返回绑定后的业务请求。 +- `DELETE /ai/plans/:id`:取消尚未执行的步骤。 + +前端以 `x-classhelper-ai-step` 关联既有业务接口。服务端核对操作者、方法、路径、查询和正文后原子领取步骤,再由原接口执行完整鉴权。上传另核对文件哈希;已成功步骤返回保存的结果,不重复操作。连接中断或结果不明的步骤需先核对业务状态。自动化入口为 `pnpm verify:ai`,仅使用隔离库和模型 stub。 diff --git a/docs/screenshots/assistant-client-cache.png b/docs/screenshots/assistant-client-cache.png new file mode 100644 index 0000000..c54b244 Binary files /dev/null and b/docs/screenshots/assistant-client-cache.png differ diff --git a/docs/screenshots/assistant-plan.png b/docs/screenshots/assistant-plan.png new file mode 100644 index 0000000..908a781 Binary files /dev/null and b/docs/screenshots/assistant-plan.png differ diff --git a/docs/screenshots/fullscreen-guide-mobile-care.png b/docs/screenshots/fullscreen-guide-mobile-care.png new file mode 100644 index 0000000..54d3ea9 Binary files /dev/null and b/docs/screenshots/fullscreen-guide-mobile-care.png differ diff --git a/docs/screenshots/fullscreen-guide.png b/docs/screenshots/fullscreen-guide.png new file mode 100644 index 0000000..f17b8b4 Binary files /dev/null and b/docs/screenshots/fullscreen-guide.png differ diff --git a/docs/screenshots/plan-editor-list.png b/docs/screenshots/plan-editor-list.png index a0d016c..d887148 100644 Binary files a/docs/screenshots/plan-editor-list.png and b/docs/screenshots/plan-editor-list.png differ diff --git a/docs/screenshots/plan-editor-live-api.png b/docs/screenshots/plan-editor-live-api.png index b23159d..89fdc4a 100644 Binary files a/docs/screenshots/plan-editor-live-api.png and b/docs/screenshots/plan-editor-live-api.png differ diff --git a/docs/screenshots/plan-editor-shell.png b/docs/screenshots/plan-editor-shell.png index 89e078f..dec2a5d 100644 Binary files a/docs/screenshots/plan-editor-shell.png and b/docs/screenshots/plan-editor-shell.png differ diff --git a/docs/screenshots/plan-editor-timeline.png b/docs/screenshots/plan-editor-timeline.png index 2ce4e31..1a84acd 100644 Binary files a/docs/screenshots/plan-editor-timeline.png and b/docs/screenshots/plan-editor-timeline.png differ diff --git a/docs/screenshots/plan-editor-yaml.png b/docs/screenshots/plan-editor-yaml.png new file mode 100644 index 0000000..d59ebb5 Binary files /dev/null and b/docs/screenshots/plan-editor-yaml.png differ diff --git a/docs/screenshots/shared-calendar-dark-care.png b/docs/screenshots/shared-calendar-dark-care.png new file mode 100644 index 0000000..b9cd359 Binary files /dev/null and b/docs/screenshots/shared-calendar-dark-care.png differ diff --git a/docs/screenshots/shared-calendar.png b/docs/screenshots/shared-calendar.png new file mode 100644 index 0000000..0cdbca6 Binary files /dev/null and b/docs/screenshots/shared-calendar.png differ diff --git a/package.json b/package.json index 5e025fd..abdb3b7 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "class-helper", - "version": "1.4.3", + "version": "1.4.4", "private": true, "description": "ClassHelper - 班级信息管理系统(Web 管理端 + 后端服务 + 桌面客户端)", "packageManager": "pnpm@11.8.0", @@ -29,6 +29,7 @@ "db:switch:mysql": "node scripts/use-database.mjs mysql", "db:switch:sqlite": "node scripts/use-database.mjs sqlite", "verify:e2e": "node scripts/verify-e2e-isolated.mjs", + "verify:ai": "node scripts/verify-ai.mjs", "verify:courseware": "node scripts/verify-courseware.mjs", "verify:v14": "node scripts/verify-v14.mjs", "verify:lifecycle": "node scripts/verify-lifecycle.mjs", diff --git a/packages/desktop-client/package.json b/packages/desktop-client/package.json index 107207d..a7821f9 100644 --- a/packages/desktop-client/package.json +++ b/packages/desktop-client/package.json @@ -1,6 +1,6 @@ { "name": "@classhelper/desktop-client", - "version": "1.4.3", + "version": "1.4.4", "private": true, "description": "ClassHelper EXE 客户端(Electron + Vue 3 + Element Plus + Socket.IO + IndexedDB 离线缓存)", "author": "Class Helper", @@ -24,7 +24,8 @@ "pinia": "^4.0.3", "socket.io-client": "^4.8.3", "vue": "^3.5.42", - "vue-router": "^5.3.1" + "vue-router": "^5.3.1", + "@classhelper/ui": "workspace:*" }, "devDependencies": { "@types/node": "^22.20.2", diff --git a/packages/desktop-client/src/island/main.ts b/packages/desktop-client/src/island/main.ts index 6fcbdb4..af7ed5a 100644 --- a/packages/desktop-client/src/island/main.ts +++ b/packages/desktop-client/src/island/main.ts @@ -1,3 +1,4 @@ +import '@classhelper/ui/tokens.css'; import { createApp } from 'vue'; import IslandApp from './LayoutIslandApp.vue'; import { applyMotionTokens } from '../renderer/composables/motion.js'; diff --git a/packages/desktop-client/src/main/config.ts b/packages/desktop-client/src/main/config.ts index 6b6fb70..2b8cda1 100644 --- a/packages/desktop-client/src/main/config.ts +++ b/packages/desktop-client/src/main/config.ts @@ -38,6 +38,7 @@ interface PersistedConfig { homeworkPhrases?: string[]; /** 是否已看过初次启动引导(向后兼容:旧配置没有该字段视为没看过,首启弹一次) */ onboardingDone?: boolean; + onboardingVersion?: number; /** 界面主题(向后兼容:旧配置没有该字段用浅色) */ theme?: 'light' | 'dark'; /** 主侧边栏是否折叠(向后兼容:旧配置没有该字段视为展开) */ @@ -69,6 +70,7 @@ const DEFAULT_CONFIG: PersistedConfig = { homeworkBoard: { ...DEFAULT_HOMEWORK_BOARD }, homeworkPhrases: [...HOMEWORK_PHRASE_DEFAULTS], onboardingDone: false, + onboardingVersion: 0, theme: 'light', sidebarCollapsed: false, ignoredUpdateVersion: '', @@ -210,6 +212,7 @@ function readPersistedFromDisk(): PersistedConfig { homeworkBoard: normalizeHomeworkBoard(parsed.homeworkBoard), homeworkPhrases: normalizeHomeworkPhrases(parsed.homeworkPhrases), onboardingDone: parsed.onboardingDone === true, + onboardingVersion: Number.isInteger(parsed.onboardingVersion) ? Number(parsed.onboardingVersion) : 0, theme: normalizeTheme(parsed.theme), sidebarCollapsed: parsed.sidebarCollapsed === true, ignoredUpdateVersion: @@ -373,6 +376,7 @@ function toDesktopConfig(state: ConfigCache): DesktopStoredConfig { homeworkBoard: normalizeHomeworkBoard(persisted.homeworkBoard), homeworkPhrases: normalizeHomeworkPhrases(persisted.homeworkPhrases), onboardingDone: persisted.onboardingDone === true, + onboardingVersion: persisted.onboardingVersion ?? 0, theme: normalizeTheme(persisted.theme), sidebarCollapsed: persisted.sidebarCollapsed === true, ignoredUpdateVersion: persisted.ignoredUpdateVersion ?? '', @@ -460,6 +464,11 @@ export function saveConfig(patch: Partial): DesktopStoredCo if (patch.onboardingDone === true) { persisted.onboardingDone = true; } + if ( + Number.isInteger(patch.onboardingVersion) && + Number(patch.onboardingVersion) > (persisted.onboardingVersion ?? 0) + ) + persisted.onboardingVersion = Number(patch.onboardingVersion); if (patch.theme !== undefined) { persisted.theme = normalizeTheme(patch.theme); } diff --git a/packages/desktop-client/src/main/smoke-layout.ts b/packages/desktop-client/src/main/smoke-layout.ts index a0c6bd7..a775ef9 100644 --- a/packages/desktop-client/src/main/smoke-layout.ts +++ b/packages/desktop-client/src/main/smoke-layout.ts @@ -265,7 +265,7 @@ export async function verifyLayoutSmoke( await editor.webContents.executeJavaScript(`document.querySelector('[aria-label="新建方案"]').click()`); await pause(); await editor.webContents.executeJavaScript( - `(() => { const input=document.querySelector('.el-message-box__input input'); input.value='组件方案验收';input.dispatchEvent(new Event('input',{bubbles:true}));document.querySelector('.el-message-box__btns .el-button--primary').click(); })()`, + `(() => { const input=[...document.querySelectorAll('.el-message-box__input input')].filter(e=>e.getBoundingClientRect().width>0).at(-1); input.value='组件方案验收';input.dispatchEvent(new Event('input',{bubbles:true}));[...document.querySelectorAll('.el-message-box__btns .el-button--primary')].filter(e=>e.getBoundingClientRect().width>0).at(-1).click(); })()`, ); await pause(); if (getConfig().islandLayout.schemes.length !== 2) throw Error('新建方案没有保存'); @@ -274,7 +274,7 @@ export async function verifyLayoutSmoke( ); await pause(); await editor.webContents.executeJavaScript( - `document.querySelector('.el-message-box__btns .el-button--primary').click()`, + `[...document.querySelectorAll('.el-message-box__btns .el-button--primary')].filter(e=>e.getBoundingClientRect().width>0).at(-1).click()`, ); await pause(); await editor.webContents.executeJavaScript(`document.querySelector('[aria-label="管理方案"]').click()`); @@ -284,14 +284,26 @@ export async function verifyLayoutSmoke( ); await pause(); await editor.webContents.executeJavaScript( - `document.querySelector('.el-message-box__btns .el-button--primary').click()`, + `[...document.querySelectorAll('.el-message-box__btns .el-button--primary')].filter(e=>e.getBoundingClientRect().width>0).at(-1).click()`, ); await pause(); - return ( + const restored = getConfig().islandLayout.schemes.length === 1 && getConfig().islandLayout.activeSchemeId === 'default' && - getConfig().islandLayout.schemes[0]!.rows.length === 2 - ); + getConfig().islandLayout.schemes[0]!.rows.length === 2; + if (!restored) + throw Error( + '方案未恢复:' + + JSON.stringify({ + active: getConfig().islandLayout.activeSchemeId, + schemes: getConfig().islandLayout.schemes.map((s) => ({ + id: s.id, + name: s.name, + rows: s.rows.length, + })), + }), + ); + return restored; }); await check('方案 JSON 导入导出保留容器结构并重新生成标识', async () => { await editor.webContents.executeJavaScript(`document.querySelector('[aria-label="管理方案"]').click()`); @@ -329,10 +341,22 @@ export async function verifyLayoutSmoke( ); await pause(); await editor.webContents.executeJavaScript( - `document.querySelector('.el-message-box__btns .el-button--primary').click()`, + `[...document.querySelectorAll('.el-message-box__btns .el-button--primary')].filter(e=>e.getBoundingClientRect().width>0).at(-1).click()`, ); await pause(); - return preserved && getConfig().islandLayout.schemes.length === 1; + if (!preserved || getConfig().islandLayout.schemes.length !== 1) + throw Error( + '方案导入或收尾不一致:' + + JSON.stringify({ + preserved, + schemes: getConfig().islandLayout.schemes.map((s) => ({ + id: s.id, + name: s.name, + rows: s.rows.length, + })), + }), + ); + return true; }); if (process.env.ISLAND_SHOTS_DIR) { await editor.webContents.executeJavaScript(`document.querySelector('.main').scrollTop=0`); diff --git a/packages/desktop-client/src/main/smoke.ts b/packages/desktop-client/src/main/smoke.ts index 3f5e2c6..dc5db5b 100644 --- a/packages/desktop-client/src/main/smoke.ts +++ b/packages/desktop-client/src/main/smoke.ts @@ -3078,7 +3078,9 @@ async function runIslandChecks( `${islandStateSummary()}`, ); - // 10.7) 视觉风格:纯黑 / 毛玻璃(亚克力)/ 主题色渐变,切换立即生效 + // 消息使用实色底;先清空消息,单独验证用户设置的三种基础风格。 + await drainIsland(); + await sleep(260); const probeStyle = async (style: IslandAppearance['style']): Promise<{ fill: string; stroke: string }> => { island.setAppearance({ ...appearanceBefore, style }); await sleep(260); @@ -3102,7 +3104,7 @@ async function runIslandChecks( const glassStyle = await probeStyle('glass'); const tintedStyle = await probeStyle('tinted'); record( - '视觉风格切换立刻生效(纯黑 / 毛玻璃半透明 / 主题色)', + '无消息时视觉风格切换立刻生效(纯黑 / 毛玻璃半透明 / 主题色)', blackStyle.fill === 'rgb(0, 0, 0)' && glassStyle.fill.startsWith('rgba(32, 32, 36') && tintedStyle.fill === 'rgb(11, 11, 15)', diff --git a/packages/desktop-client/src/renderer/App.vue b/packages/desktop-client/src/renderer/App.vue index 3b5a6ff..9a58b61 100644 --- a/packages/desktop-client/src/renderer/App.vue +++ b/packages/desktop-client/src/renderer/App.vue @@ -13,6 +13,7 @@ import { import OnboardingWelcome from './components/OnboardingWelcome.vue'; import { useAppStore } from './stores/app.js'; import { useAuthStore } from './stores/auth.js'; +import { ONBOARDING_VERSION } from '@classhelper/ui'; import { useOnboardingStore } from './stores/onboarding.js'; import { useRealtimeStore } from './stores/realtime.js'; import { useUiStore } from './stores/ui.js'; @@ -123,13 +124,13 @@ onMounted(async () => { if (auth.isAuthenticated) await router.replace('/schedule'); else await router.replace('/login'); - // 初次启动引导:配置里没记「已看过」就自动弹一次(完成/跳过后由引导组件写入配置)。 + // 引导按版本展示,完成或跳过后记住当前版本。 // 稍等一拍再弹:让登录页/主界面先渲染完,避免和启动过渡的收尾抢帧。 window.setTimeout(() => { void window.desktop ?.getConfig() .then((config) => { - if (config.onboardingDone !== true) onboarding.open(); + if ((config.onboardingVersion ?? 0) < ONBOARDING_VERSION) onboarding.open(); }) .catch(() => undefined); }, 400); diff --git a/packages/desktop-client/src/renderer/api/index.ts b/packages/desktop-client/src/renderer/api/index.ts index 8af54a7..78f4058 100644 --- a/packages/desktop-client/src/renderer/api/index.ts +++ b/packages/desktop-client/src/renderer/api/index.ts @@ -67,8 +67,15 @@ export const homeworkApi = { date?: string; }): Promise => api.get(API_PATHS.homeworks, params), /** 哪些天有作业(日期选择器高亮) */ - days: (params: { classId?: string; from?: string; to?: string; days?: number }): Promise => - api.get(`${API_PATHS.homeworks}/days`, params), + days: (params: { + classId?: string; + courseId?: string; + keyword?: string; + pendingOnly?: boolean; + from?: string; + to?: string; + days?: number; + }): Promise => api.get(`${API_PATHS.homeworks}/days`, params), /** 在教室机器上直接录入作业(班级账号可调用;也可选所属日期) */ create: (payload: { classId: string; @@ -88,8 +95,21 @@ export const homeworkApi = { }; export const notificationApi = { - list: (params?: { classId?: string; unreadOnly?: boolean }): Promise => - api.get(API_PATHS.notifications, params), + days: (params: { + classId?: string; + from?: string; + to?: string; + createdBy?: string; + priority?: string; + unreadOnly?: boolean; + }): Promise<{ days: { date: string; count: number }[] }> => api.get('/notifications/days', params), + list: (params?: { + classId?: string; + unreadOnly?: boolean; + date?: string; + createdBy?: string; + priority?: string; + }): Promise => api.get(API_PATHS.notifications, params), unreadCount: (): Promise<{ count: number }> => api.get(`${API_PATHS.notifications}/unread-count`), // id 来自服务端或灵动岛(作业卡是本地合成的 `homework-…`),一律 encodeURIComponent: // 否则含 `/` 或 `..` 的 id 会改变实际请求的路径 diff --git a/packages/desktop-client/src/renderer/cache/self-test.ts b/packages/desktop-client/src/renderer/cache/self-test.ts index 229e19c..03fcd12 100644 --- a/packages/desktop-client/src/renderer/cache/self-test.ts +++ b/packages/desktop-client/src/renderer/cache/self-test.ts @@ -885,14 +885,7 @@ export async function islandHomeworkSuppressionCheck(): Promise { try { // 引导在启动后延迟 ~400ms 弹出,这里轮询等它出现 @@ -908,7 +901,10 @@ export async function onboardingSelfTest(): Promise { }; } - // 逐页「下一步」到最后一页再点「开始使用」(按钮由 data-action 标识,不依赖文案) + const guide = document.querySelector('.ch-guide')!; + const bounds = guide.getBoundingClientRect(); + const fullscreen = Math.abs(bounds.width - innerWidth) < 2 && Math.abs(bounds.height - innerHeight) < 2; + const focused = guide.contains(document.activeElement); const clicks: string[] = []; for (let attempt = 0; attempt < 12; attempt += 1) { const action = document.querySelector('.onboarding-welcome [data-action="finish"]') ? 'finish' : 'next'; @@ -928,10 +924,11 @@ export async function onboardingSelfTest(): Promise { } const config = await window.desktop?.getConfig?.(); - const done = config?.onboardingDone === true; + const { ONBOARDING_VERSION } = await import('@classhelper/ui'); + const done = config?.onboardingDone === true && config.onboardingVersion === ONBOARDING_VERSION; return { - ok: closed && done, - detail: `步骤点击=[${clicks.join(',')}] 已关闭=${closed} onboardingDone=${config?.onboardingDone ?? '-'}`, + ok: closed && done && fullscreen && focused, + detail: `步骤点击=[${clicks.join(',')}] 全屏=${fullscreen} 焦点=${focused} 已关闭=${closed} 引导版本=${config?.onboardingVersion ?? '-'}`, }; } catch (error) { return { diff --git a/packages/desktop-client/src/renderer/components/IslandComponentSettings.vue b/packages/desktop-client/src/renderer/components/IslandComponentSettings.vue index 59bf108..bd967ee 100644 --- a/packages/desktop-client/src/renderer/components/IslandComponentSettings.vue +++ b/packages/desktop-client/src/renderer/components/IslandComponentSettings.vue @@ -52,7 +52,7 @@ const containers = ['group', 'stack', 'slide', 'rolling'] as const; - -import { computed, onUnmounted, ref, watch } from 'vue'; +import { FullScreenGuide, ONBOARDING_VERSION } from '@classhelper/ui'; import { useOnboardingStore } from '../stores/onboarding.js'; - -/** - * 初次启动引导(六步向导)。 - * - * - 首次启动自动弹出(App.vue 按 `onboardingDone` 判定);完成 / 跳过(右上角按钮 / Esc) - * 都算看过,由这里写入主进程配置,之后不再自动弹出。 - * - 登录页与设置页的「使用引导」入口可随时重看(重看关闭时再写一次也无副作用)。 - * - **用 v-if 自绘遮罩而不是 el-dialog**:关闭即从 DOM 卸载。冒烟断言"引导已关闭"时 - * 不会踩 el-dialog「DOM 残留在文档里」的坑(AGENTS §7 第 22 条)。 - * - 操作按钮用 `data-action` 标识(prev/next/finish/skip),冒烟点击不依赖按钮文案。 - */ +import { BRAND_LOGO_URL } from '../config.js'; const onboarding = useOnboardingStore(); - const steps = [ { - icon: 'School', - title: '欢迎使用 ClassHelper', - lines: [ - '这台电脑将以「班级」的身份使用 ClassHelper:实时接收课表、作业、通知与成绩。', - '第一次使用,先花半分钟看看怎么开始。', - ], + id: 'server', + title: '连接学校服务器', + text: '填写管理员提供的服务器地址,测试连接后继续。', + example: ['服务器地址', '测试连接', '连接成功'], }, { - icon: 'Link', - title: '第一步 · 连接服务器', - lines: [ - '在登录页填写老师或管理员提供的服务器地址(通常形如 http://192.168.x.x:4000)。', - '点「测试连接」确认可达;以后也能在「设置」里随时修改。', - ], + id: 'login', + title: '登录班级', + text: '使用班级码和班级密码登录,这台设备将代表本班。', + example: ['班级码', '班级密码', '登录'], }, { - icon: 'Key', - title: '第二步 · 登录班级', - lines: [ - '使用班级码 + 班级密码登录(向老师或管理员索取)。', - '登录后这台设备就代表全班:作业完成、通知已读都会按全班记录,不需要每个学生单独登录。', - ], + id: 'teaching', + title: '查看课表与作业', + text: '从菜单切换页面,用日历查找记录;断网时可查看已缓存的内容。', + example: ['今日课表', '作业看板', '日期下方的圆点 ·'], }, { - icon: 'Calendar', - title: '登录之后', - lines: [ - '左侧菜单切换「课表 / 作业 / 通知 / 成绩」四个页面,作业支持看板全屏展示。', - '断网时自动显示最近同步的缓存数据,联网后自动更新。', - ], + id: 'files', + title: '接收通知与课件', + text: '新内容自动同步,课件下载后由你选择如何打开。', + example: ['班级通知', '课件传输进度', '打开所在文件夹'], }, { - icon: 'Bell', - title: '灵动岛提醒', - lines: [ - '屏幕上方会有一条「灵动岛」浮窗:新通知、叫人、作业都会在那里弹出。', - '上课时段自动隐藏、下课自动弹出;外观与位置可在「设置 → 灵动岛」调整。', - ], + id: 'island', + title: '选择灵动岛模式', + text: '经典模式自动呈现提醒;常驻模式先显示消息数量,由你展开查看。', + example: ['经典模式', '自定义常驻模式', '设置 → 灵动岛'], }, { - icon: 'CircleCheckFilled', + id: 'settings', title: '准备好了', - lines: [ - '按上面的步骤登录就可以开始使用了。', - '侧边栏「设置」分组里有通用、外观(深色模式)、灵动岛等页面;这份引导可以在登录页或「设置 → 通用 → 使用引导」随时重看。', - ], + text: '在设置中调整外观和关怀模式,也可以随时重看引导。', + example: ['通用设置', '外观', '使用引导'], }, ]; - -const index = ref(0); -const current = computed(() => steps[index.value] ?? steps[0]); -const isFirst = computed(() => index.value === 0); -const isLast = computed(() => index.value === steps.length - 1); - -/** 每次打开都从第一步开始(重看入口也走完整流程) */ -watch( - () => onboarding.visible, - (visible) => { - if (visible) index.value = 0; - }, -); - -function goNext(): void { - if (isLast.value) finish(); - else index.value += 1; -} - -function goPrev(): void { - if (!isFirst.value) index.value -= 1; -} - -/** 完成 / 跳过统一走这里:记「已看过」并关闭(重看时重复写一次无副作用) */ -function finish(): void { - const bridge = window.desktop; - // 桥接不可用(浏览器调试)也要能正常关掉引导 - if (!bridge) { +async function finish(): Promise { + try { + await window.desktop?.saveConfig({ onboardingDone: true, onboardingVersion: ONBOARDING_VERSION }); + } finally { onboarding.close(); - return; } - void bridge - .saveConfig({ onboardingDone: true }) - .then(() => onboarding.close()) - .catch(() => onboarding.close()); } - -function onKeydown(event: KeyboardEvent): void { - if (onboarding.visible && event.key === 'Escape') finish(); -} -if (typeof window !== 'undefined') { - window.addEventListener('keydown', onKeydown); -} -onUnmounted(() => { - window.removeEventListener('keydown', onKeydown); -}); - - - diff --git a/packages/desktop-client/src/renderer/main.ts b/packages/desktop-client/src/renderer/main.ts index a74952b..c38197a 100644 --- a/packages/desktop-client/src/renderer/main.ts +++ b/packages/desktop-client/src/renderer/main.ts @@ -11,6 +11,8 @@ import router from './router/index.js'; import { registerAppIcons } from './icons.js'; import { applyMotionTokens } from './composables/motion.js'; import './styles/index.css'; +import { registerSharedUi } from '@classhelper/ui'; +import '@classhelper/ui/theme.css'; const app = createApp(App); @@ -20,6 +22,7 @@ registerAppIcons(app); app.use(createPinia()); app.use(router); app.use(ElementPlus, { locale: zhCn }); +registerSharedUi(app); // 冒烟验证模式:把缓存自检钩子暴露给主进程调用(正常运行时不存在)。 // diff --git a/packages/desktop-client/src/renderer/stores/onboarding.ts b/packages/desktop-client/src/renderer/stores/onboarding.ts index e36cedb..6691f0f 100644 --- a/packages/desktop-client/src/renderer/stores/onboarding.ts +++ b/packages/desktop-client/src/renderer/stores/onboarding.ts @@ -1,14 +1,7 @@ import { ref } from 'vue'; import { defineStore } from 'pinia'; -/** - * 初次启动引导的显示状态。 - * - * 首次启动由 App.vue 按「配置里是否记过 onboardingDone」自动弹出; - * 登录页与设置页的「使用引导」入口调用 open() 随时重看。 - * 单独一个 store 而不是组件内部 ref:触发入口(登录页 / 设置页)与 - * 渲染点(App.vue 顶层)分处两棵互不相干的子树。 - */ +/** App.vue 按引导版本自动展示;登录页和设置页可随时重看。 */ export const useOnboardingStore = defineStore('onboarding', () => { const visible = ref(false); diff --git a/packages/desktop-client/src/renderer/views/CoursewareView.vue b/packages/desktop-client/src/renderer/views/CoursewareView.vue index cd5866b..baeeebf 100644 --- a/packages/desktop-client/src/renderer/views/CoursewareView.vue +++ b/packages/desktop-client/src/renderer/views/CoursewareView.vue @@ -1,4 +1,5 @@ @@ -175,16 +234,14 @@ onUnmounted(() => { -
- - - + { diff --git a/packages/desktop-client/src/renderer/views/settings/AccountSettingsView.vue b/packages/desktop-client/src/renderer/views/settings/AccountSettingsView.vue index 550488f..fa3bdb0 100644 --- a/packages/desktop-client/src/renderer/views/settings/AccountSettingsView.vue +++ b/packages/desktop-client/src/renderer/views/settings/AccountSettingsView.vue @@ -27,7 +27,6 @@ async function logout(): Promise { diff --git a/packages/desktop-client/src/renderer/views/settings/AppearanceView.vue b/packages/desktop-client/src/renderer/views/settings/AppearanceView.vue index 540f7ea..0e14936 100644 --- a/packages/desktop-client/src/renderer/views/settings/AppearanceView.vue +++ b/packages/desktop-client/src/renderer/views/settings/AppearanceView.vue @@ -26,7 +26,6 @@ async function selectTheme(value: 'light' | 'dark'): Promise { @@ -50,7 +49,10 @@ async function selectTheme(value: 'light' | 'dark'): Promise { - + + + + {{ option.label }} {{ option.desc }} diff --git a/packages/desktop-client/src/renderer/views/settings/DeveloperSettingsView.vue b/packages/desktop-client/src/renderer/views/settings/DeveloperSettingsView.vue index b925845..001ec4d 100644 --- a/packages/desktop-client/src/renderer/views/settings/DeveloperSettingsView.vue +++ b/packages/desktop-client/src/renderer/views/settings/DeveloperSettingsView.vue @@ -221,7 +221,6 @@ onMounted(async () => {