feat: 初始化船长·HeiXiu 桌面应用项目（错误是svg的问题）

Electron + React 19 + TypeScript + Ant Design 6 + Tailwind CSS 4

  【核心架构】
  - Electron 主进程（窗口管理、平台检测、图标适配）
  - Vite 构建链（双产物 dist/ + dist-electron/）
  - 共享层 shared/（类型、常量、工具函数）
  - IPC 通信框架 + 安全守卫

  【主题系统】
  - 蓝紫渐变主题（亮色/暗色双模式）
  - Ant Design ConfigProvider 适配（lightAlgorithm / darkAlgorithm）
  - Tailwind CSS 4 @theme 指令 + CSS 变量
  - 设计令牌三处同步（tokens.ts / globals.css / antd-theme.ts）

  【导航栏】
  - 自定义 H5 导航栏替代系统菜单
  - 个人版/企业版双布局
  - 未登录拦截 + 事件总线驱动登录弹窗

  【登录注册】
  - Modal 弹层（Portal）+ Tabs 切换
  - 登录/注册表单动态字段渲染
  - 记住密码 / 自动登录 / 用户协议

  【更新系统】
  - 自定义 API 版本检查（替代 electron-updater generic provider）
  - 手动下载 + SHA512 校验 + spawn NSIS 安装
  - 渲染进程更新状态机 Hook（useUpdater）
  - 检查更新按钮 + 下载进度展示

  【构建工具链】
  - build.mjs 构建总管（--win/--mac/--linux --personal/--enterprise --build/--clean/--sign/--upload/--publish）
  - scripts/ 自动化脚本（clean / generate-update-info / upload-oss / publish-release）
  - electron-builder NSIS 安装器（可选路径、多版本打包）
  - update-info.json 自动生成（fileSize/sha512/changelog/releaseDate）

  【代码质量】
  - ESLint + TypeScript strict + Prettier
  - husky + lint-staged（提交前自动检查）
  - commitlint（规范提交信息）
  - Playwright E2E + Vitest 单元测试框架
  - rollup-plugin-visualizer 打包体积分析

  【文档】
  - README.md（快速开始 + 目录结构 + 命令速查）
  - UpdateA.md（发布手册：API/签名/发版流程/数据库）
  - CHANGELOG.md（更新日志）
  - .env.example（构建环境变量模板）

electron/main.ts

@@ -0,0 +1,126 @@
+import { app, BrowserWindow } from 'electron';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+import { getPlatform, isMacOS } from './main/utils/platform';
+import { getWindowIconPath } from './main/utils/logo';
+import { buildWindowTitle, parseEdition } from '../shared/constants/app';
+import { initUpdater, registerUpdateIpcHandlers } from './main/updater';
+import { setupAppMenu } from './main/menu';
+
+createRequire(import.meta.url);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+process.env.APP_ROOT = path.join(__dirname, '..');
+
+export const VITE_DEV_SERVER_URL = process.env['VITE_DEV_SERVER_URL'];
+export const MAIN_DIST = path.join(process.env.APP_ROOT, 'dist-electron');
+export const RENDERER_DIST = path.join(process.env.APP_ROOT, 'dist');
+
+process.env.VITE_PUBLIC = VITE_DEV_SERVER_URL
+   ? path.join(process.env.APP_ROOT, 'public')
+   : RENDERER_DIST;
+
+// ---------- 平台 & 版本信息 ----------
+const currentPlatform = getPlatform();
+const currentEdition = parseEdition(process.env.EDITION);
+const WINDOW_TITLE = buildWindowTitle(currentPlatform, currentEdition);
+
+// ============================================================
+// 窗口引用
+// ============================================================
+
+let mainWindow: BrowserWindow | null = null;
+
+// ============================================================
+// 主窗口
+// ============================================================
+
+function createMainWindow(): BrowserWindow {
+   const iconPath = getWindowIconPath(app.getAppPath());
+
+   mainWindow = new BrowserWindow({
+      title: WINDOW_TITLE,
+      icon: iconPath,
+      width: 1280,
+      height: 800,
+      minWidth: 960,
+      minHeight: 600,
+      show: false,
+      ...(isMacOS() ? { titleBarStyle: 'hiddenInset' as const } : {}),
+      webPreferences: {
+         preload: path.join(__dirname, 'preload.mjs'),
+         contextIsolation: true,
+         nodeIntegration: false,
+      },
+   });
+
+   mainWindow.setTitle(WINDOW_TITLE);
+
+   if (VITE_DEV_SERVER_URL) {
+      mainWindow.webContents.openDevTools();
+   }
+
+   // macOS 全屏事件
+   if (isMacOS()) {
+      mainWindow.on('enter-full-screen', () =>
+         mainWindow?.webContents.send('window-fullscreen-changed', true),
+      );
+      mainWindow.on('leave-full-screen', () =>
+         mainWindow?.webContents.send('window-fullscreen-changed', false),
+      );
+   }
+
+   mainWindow.webContents.on('did-finish-load', () => {
+      mainWindow?.webContents.send('main-process-message', new Date().toLocaleString());
+      mainWindow?.webContents.send('platform-info', {
+         platform: currentPlatform,
+         edition: currentEdition,
+      });
+   });
+
+   // ready-to-show 后显示，避免白屏闪烁
+   mainWindow.once('ready-to-show', () => {
+      mainWindow?.show();
+   });
+
+   if (VITE_DEV_SERVER_URL) {
+      mainWindow.loadURL(VITE_DEV_SERVER_URL);
+   } else {
+      mainWindow.loadFile(path.join(RENDERER_DIST, 'index.html'));
+   }
+
+   return mainWindow;
+}
+
+// ============================================================
+// 应用生命周期
+// ============================================================
+
+app.on('window-all-closed', () => {
+   if (!isMacOS()) {
+      app.quit();
+   }
+});
+
+app.on('activate', () => {
+   if (BrowserWindow.getAllWindows().length === 0) {
+      createMainWindow();
+   }
+});
+
+app.on('before-quit', () => {
+   // 清理工作
+});
+
+app.whenReady().then(() => {
+   setupAppMenu();
+   app.setName(WINDOW_TITLE);
+   registerUpdateIpcHandlers();
+
+   // 始终打开主窗口
+   // 登录/注册由渲染进程内的 Modal 弹层处理，不再新开窗口
+   const win = createMainWindow();
+   initUpdater(win);
+});