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（构建环境变量模板）

scripts/publish-release.mjs

@@ -0,0 +1,130 @@
+// ============================================================
+// 发布版本信息到后端 API
+//
+// 用法：
+//   node scripts/publish-release.mjs <platform> <edition> [version] [--url <url>]
+//
+// 环境变量：
+//   UPDATE_API_URL   — API 基地址（默认 https://www.heixiu.com）
+//   UPDATE_API_KEY   — API 鉴权 Key（通过 Authorization: Bearer 头传递）
+// ============================================================
+
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import axios from 'axios';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+
+// ---------- 参数 ----------
+
+const args = process.argv.slice(2);
+const positional = [];
+let urlOverride = '';
+let jsonOverride = '';
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--url' && args[i + 1]) {
+    urlOverride = args[++i];
+  } else if (args[i] === '--json' && args[i + 1]) {
+    jsonOverride = args[++i];
+  } else if (!args[i].startsWith('--')) {
+    positional.push(args[i]);
+  }
+}
+
+const platform = positional[0];
+const edition = positional[1];
+
+if (!platform || !edition) {
+  console.error('用法: node scripts/publish-release.mjs <platform> <edition> [version] [--url <url>]');
+  console.error('示例: node scripts/publish-release.mjs win32 personal 0.1.0');
+  process.exit(1);
+}
+
+const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf-8'));
+const version = positional[2] || pkg.version;
+
+// ---------- 读取 update-info.json ----------
+
+let updateInfo;
+
+if (jsonOverride) {
+  try {
+    updateInfo = JSON.parse(jsonOverride);
+  } catch {
+    console.error('错误: --json 参数不是有效的 JSON');
+    process.exit(1);
+  }
+} else {
+  const releaseDir = join(ROOT, 'release', version);
+  let infoFile;
+  try {
+    const all = readdirSync(releaseDir);
+    infoFile = all.find((f) =>
+      f.includes(platform) && f.includes(edition) && f.endsWith('-update-info.json'),
+    );
+    if (!infoFile) console.error(`未找到 ${platform}+${edition} 的 update-info.json`);
+  } catch (err) {
+    console.error(`错误: ${releaseDir} — ${err.message}`);
+    process.exit(1);
+  }
+  updateInfo = JSON.parse(readFileSync(join(releaseDir, infoFile), 'utf-8'));
+  if (urlOverride) updateInfo.downloadUrl = urlOverride;
+}
+
+// ---------- 发送到 API ----------
+
+const apiBase = (process.env.UPDATE_API_URL || 'https://www.heixiu.com').replace(/\/+$/, '');
+const apiKey = process.env.UPDATE_API_KEY || '';
+
+const payload = {
+  platform,
+  edition,
+  latestVersion: updateInfo.latestVersion || version,
+  downloadUrl: updateInfo.downloadUrl,
+  fileSize: updateInfo.fileSize,
+  sha512: updateInfo.sha512,
+  changelog: updateInfo.changelog,
+  releaseDate: updateInfo.releaseDate,
+  forceUpdate: updateInfo.forceUpdate || false,
+  minimumVersion: updateInfo.minimumVersion || '0.0.0',
+};
+
+const endpoint = `${apiBase}/api/v1/releases`;
+
+console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+console.log('📡 发布版本到 API');
+console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+console.log(`POST ${endpoint}`);
+console.log(`版本: ${version} (${platform}/${edition})`);
+console.log(`URL: ${payload.downloadUrl}\n`);
+
+try {
+  const response = await axios.post(endpoint, payload, {
+    headers: {
+      'Content-Type': 'application/json',
+      ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
+    },
+    timeout: 30000,
+  });
+
+  console.log('✅ 发布成功');
+  console.log(`响应: ${JSON.stringify(response.data, null, 2)}`);
+} catch (err) {
+  const status = err.response?.status;
+  const data = err.response?.data;
+
+  if (status) {
+    console.error(`❌ 发布失败 HTTP ${status}: ${JSON.stringify(data)}`);
+  } else {
+    console.error(`❌ 请求失败: ${err.message}`);
+  }
+
+  console.log('\n💡 手动备选 — 把以下 JSON 发给后端：');
+  console.log(JSON.stringify(payload, null, 2));
+  process.exit(1);
+}
+
+console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');