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 条），属时间相关用例，
与本次改动无关。

packages/server/src/modules/database/database.module.ts

@@ -0,0 +1,124 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { Router } from 'express';
+import { sendCreated, sendOk } from '../../lib/http.js';
+import { authenticate, requireRole } from '../../middleware/auth.js';
+import { validate, validatedBody, validatedParams } from '../../middleware/validate.js';
+import { defineModule } from '../module.types.js';
+import {
+  backupNameParamSchema,
+  backupScheduleSchema,
+  importSnapshotSchema,
+  jobIdParamSchema,
+  switchDatabaseSchema,
+  testConnectionSchema,
+  type BackupScheduleInput,
+  type ImportSnapshotInput,
+  type SwitchDatabaseInput,
+  type TestConnectionInput,
+} from './database.schemas.js';
+import * as databaseService from './database.service.js';
+
+/**
+ * 数据库管理（仅管理员）：状态检测 / 连接测试 / 备份恢复 / 导入导出 / 定时备份 / 一键切换。
+ *
+ * 改动数据库属于最高危操作，全部接口挂在 requireRole('ADMIN') 之下；
+ * 前端入口同样只对 ADMIN 显示（Web 端「数据库管理」页）。
+ *
+ * 一键切换是异步任务：POST /switch 返回 jobId，前端轮询 GET /switch/jobs/:id 展示步骤进度。
+ * Redis 是键值库，不是 Prisma 支持的主数据库，因此不在此模块范围内。
+ */
+const router = Router();
+
+router.use(authenticate());
+router.use(requireRole('ADMIN'));
+
+/** GET /api/database/status - 当前数据库状态（连接/版本/大小/各表行数/备份与定时配置） */
+router.get('/status', async (_req, res) => {
+  sendOk(res, await databaseService.getDatabaseStatus());
+});
+
+/** POST /api/database/test-connection - 测试任意目标库连通性（切换前的前置检查） */
+router.post('/test-connection', validate({ body: testConnectionSchema }), async (req, res) => {
+  const result = await databaseService.testConnection(validatedBody<TestConnectionInput>(req));
+  sendOk(res, result, result.ok ? '连接成功' : '连接失败');
+});
+
+/** GET /api/database/backups - 备份列表 */
+router.get('/backups', (_req, res) => {
+  sendOk(res, databaseService.listBackups());
+});
+
+/** POST /api/database/backups - 立即创建一份手动备份 */
+router.post('/backups', async (_req, res) => {
+  sendCreated(res, await databaseService.createBackup('manual'), '备份已创建');
+});
+
+/** POST /api/database/backups/:name/restore - 从备份恢复（整库覆盖） */
+router.post('/backups/:name/restore', validate({ params: backupNameParamSchema }), async (req, res) => {
+  const { name } = validatedParams<{ name: string }>(req);
+  sendOk(res, await databaseService.restoreBackup(name), '已从备份恢复');
+});
+
+/** DELETE /api/database/backups/:name - 删除备份 */
+router.delete('/backups/:name', validate({ params: backupNameParamSchema }), async (req, res) => {
+  const { name } = validatedParams<{ name: string }>(req);
+  databaseService.deleteBackup(name);
+  sendOk(res, { name }, '备份已删除');
+});
+
+/** GET /api/database/export - 下载当前库的 JSON 快照 */
+router.get('/export', async (_req, res) => {
+  const json = await databaseService.exportSnapshotJson();
+  const filename = `classhelper-snapshot-${new Date().toISOString().slice(0, 19).replaceAll(':', '')}.json`;
+  res.setHeader('Content-Type', 'application/json; charset=utf-8');
+  res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+  res.status(200).send(json);
+});
+
+/** GET /api/database/sqlite-file - 下载数据库文件（仅 SQLite 模式） */
+router.get('/sqlite-file', (_req, res) => {
+  const filePath = databaseService.sqliteFilePathForDownload();
+  res.setHeader('Content-Type', 'application/octet-stream');
+  res.setHeader('Content-Disposition', `attachment; filename="${path.basename(filePath)}"`);
+  res.status(200).send(fs.readFileSync(filePath));
+});
+
+/** POST /api/database/import - 导入快照（整库覆盖；base64 随 JSON 请求体） */
+router.post('/import', validate({ body: importSnapshotSchema }), async (req, res) => {
+  const { data } = validatedBody<ImportSnapshotInput>(req);
+  sendOk(res, await databaseService.importSnapshotBase64(data), '快照已导入（原数据已被覆盖）');
+});
+
+/** GET /api/database/backup-schedule - 定时备份配置 */
+router.get('/backup-schedule', (_req, res) => {
+  sendOk(res, databaseService.getBackupSchedule());
+});
+
+/** PUT /api/database/backup-schedule - 更新定时备份配置（立即生效，重启后仍有效） */
+router.put('/backup-schedule', validate({ body: backupScheduleSchema }), async (req, res) => {
+  sendOk(
+    res,
+    databaseService.saveSchedulePatch(validatedBody<BackupScheduleInput>(req)),
+    '定时备份配置已保存',
+  );
+});
+
+/** POST /api/database/switch - 一键切换数据库（异步任务，返回 jobId） */
+router.post('/switch', validate({ body: switchDatabaseSchema }), async (req, res) => {
+  const job = databaseService.startSwitch(validatedBody<SwitchDatabaseInput>(req));
+  sendCreated(res, { jobId: job.id }, '切换任务已启动');
+});
+
+/** GET /api/database/switch/jobs/:id - 查询切换任务进度 */
+router.get('/switch/jobs/:id', validate({ params: jobIdParamSchema }), async (req, res) => {
+  const { id } = validatedParams<{ id: string }>(req);
+  const job = databaseService.getSwitchJob(id);
+  sendOk(res, job, job ? 'ok' : '任务不存在');
+});
+
+export const databaseModule = defineModule({
+  name: 'database',
+  basePath: '/database',
+  router,
+});