feat(server,web,desktop,shared,deploy,plugin): 数据库管理模块 + 客户端深色模式/设置拆子路由/首启引导，版本统一 1.0.0

- 服务端新增 database 模块（/api/database/*，仅 ADMIN）：全库 JSON 快照（备份 / 恢复 / 导入导出 / 定时备份
  共用同一格式，14 张表按拓扑序导出、恢复时关外键检查）、连接测试与目标库校验、一键 SQLite ⇄ MySQL 切换
  （备份 → 导出 → 测试连接 → 校验空库 → 改 schema → 子进程 generate / tsc / db push → 写数据，全部成功才改写
  .env，中途失败回滚 schema）；XML 快照与 SQLite 数据文件均可下载；打包形态随包带上 prisma CLI 与 typescript
  （prisma-client 生成物是 .ts，需再编进 dist/generated，安装包因之变大）
- Web 管理端新增「数据库管理」页（仅管理员），并加首次登录新手引导（el-tour，可跳过、可随时重看，版本号写
  localStorage，改版后老用户会再收到一次）
- 客户端设置改版：侧边栏改为分组折叠菜单，设置拆成 6 个子路由
  （/settings/{general,appearance,island,reminder,account,about}），新增深色模式（主题持久化到主进程配置，
  主窗口底色跟主题走，避免"先白后黑"闪一下），新增「关于」页（应用信息 / 诊断信息）
- 客户端新增首启六步引导（OnboardingWelcome，状态存主进程配置 onboardingDone）
- 客户端主窗口初始尺寸与 ClassIsland 对齐（1242x582 / minHeight 540 / 居中）
- 版本号统一提升到 1.0.0：5 个 package.json、部署配置与镜像标签（.env.example / docker-compose / Dockerfile）、
  服务端 /health 与首页、插件 manifest.yml 与 BridgeService.PluginVersion、文档里的安装包名
- 文档与验收同步：AGENTS.md 补第 37~51 条约定（深色主题实现边界、设置子路由、数据库管理三件事、侧栏与窗口
  尺寸、引导在自动化里的判据等），README 补「数据库管理 / 新手引导 / 设置改版」三节；verify:e2e 增补 13 条
  数据库管理用例，客户端冒烟与 Web UI 冒烟跟进子路由、深色主题、侧栏与引导

验证：pnpm lint 0 error；pnpm typecheck 全过；verify:e2e 186/186；verify:classisland-plugin 68/68；
build:desktop 通过（含产物凭据门禁）；verify:desktop 99/102（3 项为上课时段下的"真实通知链路"用例，
客户端按产品规则暂存普通通知所致，见下）；插件 dotnet 编译 0 错误。

注：verify:desktop 的「真实通知链路 / 标记已读」三项要求当前不在上课时段——本次运行时种子课表恰有
「周五 10:55-11:40 生物」正在进行，客户端正确地暂存了普通通知（AGENTS.md 第 18 条），属时间相关用例，
与本次改动无关。

scripts/dist-server.mjs

@@ -156,6 +156,16 @@ function buildRuntime() {
     path.join(serverDir, 'prisma', 'migrations'),
     path.join(staging, 'server', 'prisma', 'migrations'),
   );
+  // 数据库管理模块「一键切换」需要的 Prisma 配置三件套：
+  //   schema.prisma       —— 切换时改写 provider 后供 prisma generate / db push 使用
+  //   prisma.config.ts    —— Prisma 7 的 CLI 配置（连接串来自子进程环境变量）
+  //   tsconfig.generate.json —— generate 产出的是 .ts，切换后用它编译进 dist/generated
+  for (const file of ['schema.prisma']) {
+    fs.copyFileSync(path.join(serverDir, 'prisma', file), path.join(staging, 'server', 'prisma', file));
+  }
+  for (const file of ['prisma.config.ts', 'tsconfig.generate.json']) {
+    fs.copyFileSync(path.join(serverDir, file), path.join(staging, 'server', file));
+  }
   // 工作区共享包（tsc 产物）
   const sharedTarget = path.join(staging, 'node_modules', '@classhelper', 'shared');
   fs.mkdirSync(sharedTarget, { recursive: true });

scripts/ui-smoke/main.cjs

@@ -44,7 +44,7 @@ const MENU_ITEMS = [
 ];
 
 /** 教师端必须隐藏的入口（前端隐藏 + 后端 403，双重保障） */
-const HIDDEN_MENU_LABELS = ['班级管理', '学生管理', '教师管理'];
+const HIDDEN_MENU_LABELS = ['班级管理', '学生管理', '教师管理', '数据库管理'];
 
 /** 管理员账号（教师录入用例）：与种子/安装初始化账号一致 */
 const ADMIN_USERNAME = process.env.UI_SMOKE_ADMIN ?? 'admin';
@@ -118,6 +118,54 @@ async function runAdminTeacherChecks(win) {
   record('管理员登录（教师录入前置）', adminReady, `账号=${ADMIN_USERNAME}`);
   if (!adminReady) return;
 
+  // 1.1) localStorage.clear() 把「已看过引导」的标记也一并清掉 → 管理员登录后引导会再次自动
+  //      弹出；先把它跳过再继续，避免遮罩留在屏幕上干扰后续真实点击（跳过即记「已看过」）。
+  //      出现/关闭判据与 3.5 相同：等 × 按钮渲染，关闭看 .el-tour__mask 卸载。
+  await win.webContents.executeJavaScript(`(async () => {
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const deadline = Date.now() + 8000;
+    while (Date.now() < deadline && !document.querySelector('.el-tour__closebtn')) await sleep(120);
+    document.querySelector('.el-tour__closebtn')?.click();
+    const closeDeadline = Date.now() + 2000;
+    while (Date.now() < closeDeadline && document.querySelector('.el-tour__mask')) await sleep(100);
+    return true;
+  })()`);
+
+  // 1.2) 数据库管理页（仅管理员）：点开菜单 → 状态卡与备份表渲染
+  const databasePage = await win.webContents.executeJavaScript(`(async () => {
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const menu = Array.from(document.querySelectorAll('.el-menu-item')).find((node) =>
+      (node.textContent ?? '').trim().startsWith('数据库管理'),
+    );
+    if (!menu) return { ok: false, reason: '管理员菜单里没有「数据库管理」' };
+    menu.click();
+    const deadline = Date.now() + 6000;
+    while (Date.now() < deadline && location.pathname !== '/database') await sleep(80);
+    // 等状态卡与备份表渲染（状态卡含「当前数据库」标题，备份表在 el-table 里）
+    let hasStatusCard = false;
+    let hasBackupTable = false;
+    const tableDeadline = Date.now() + 8000;
+    while (Date.now() < tableDeadline && !(hasStatusCard && hasBackupTable)) {
+      hasStatusCard = Boolean(document.querySelector('.page-title'));
+      hasBackupTable = Boolean(document.querySelector('.el-table'));
+      await sleep(100);
+    }
+    const title = (document.querySelector('.page-title')?.textContent ?? '').trim();
+    return {
+      ok: location.pathname === '/database' && title === '数据库管理' && hasStatusCard && hasBackupTable,
+      reason: '',
+      path: location.pathname,
+      title,
+      hasStatusCard,
+      hasBackupTable,
+    };
+  })()`);
+  record(
+    '数据库管理页（仅管理员：状态卡与备份表渲染）',
+    databasePage?.ok === true,
+    `path=${databasePage?.path ?? '-'} 标题=${databasePage?.title ?? '-'} 状态卡=${databasePage?.hasStatusCard} 表=${databasePage?.hasBackupTable} ${databasePage?.reason ?? ''}`,
+  );
+
   // 2) 打开「教师管理」→ 新建教师（表单 → 保存 → 列表出现）
   const created = await win.webContents.executeJavaScript(`(async () => {
     const menu = Array.from(document.querySelectorAll('.el-menu-item')).find((node) =>
@@ -299,6 +347,28 @@ async function main() {
     return;
   }
 
+  // 3.5 初次登录引导（新功能）：首次登录自动弹出聚焦式引导，可跳过；
+  // 跳过（右上角 ×）后写入「已看过」标记，本次 profile 里不会再自动弹出。
+  // 判据说明：el-tour 关闭后内容元素会像 el-dialog 一样残留在 DOM（父级 .el-popper 被隐藏，
+  // AGENTS §7 第 22 条同款陷阱），所以「出现」等 × 按钮渲染、「关闭」看遮罩 .el-tour__mask 卸载。
+  const tour = await win.webContents.executeJavaScript(`(async () => {
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    // 引导在布局挂载后延迟 ~600ms 弹出，且 popper 内容晚于外壳渲染，等 × 按钮真正出现
+    const deadline = Date.now() + 10000;
+    while (Date.now() < deadline && !document.querySelector('.el-tour__closebtn')) await sleep(120);
+    if (!document.querySelector('.el-tour__closebtn')) return { appeared: false, closed: false };
+    const close = document.querySelector('.el-tour__closebtn');
+    close.click();
+    const closeDeadline = Date.now() + 3000;
+    while (Date.now() < closeDeadline && document.querySelector('.el-tour__mask')) await sleep(120);
+    return { appeared: true, closed: !document.querySelector('.el-tour__mask') };
+  })()`);
+  record(
+    '首次登录展示新手引导且可跳过',
+    tour?.appeared === true && tour?.closed === true,
+    `出现=${tour?.appeared ?? '-'} 跳过后关闭=${tour?.closed ?? '-'}`,
+  );
+
   // 4. 逐一点击侧边栏菜单
   const visited = [];
   const failures = [];