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(构建环境变量模板)
This commit is contained in:
59
shared/constants/app.ts
Normal file
59
shared/constants/app.ts
Normal file
@@ -0,0 +1,59 @@
|
||||
// ============================================================
|
||||
// 应用常量 —— 版本号、版本类型、窗口标题
|
||||
// 主进程 & 渲染进程共享
|
||||
// ============================================================
|
||||
|
||||
import type { Edition, Platform } from '../types';
|
||||
import { APP_VERSION } from './version';
|
||||
|
||||
/** 应用显示名称 */
|
||||
export const APP_NAME = '船长·HeiXiu';
|
||||
|
||||
// APP_VERSION 从 ./version.ts 导入(读取 package.json),不再硬编码
|
||||
|
||||
// ============================================================
|
||||
// 版本类型(企业版 / 个人版)
|
||||
// ============================================================
|
||||
|
||||
/**
|
||||
* 解析版本类型字符串
|
||||
* @param raw - 环境变量值,如 "enterprise" / undefined
|
||||
* @returns 版本类型,默认 personal
|
||||
*/
|
||||
export function parseEdition(raw: string | undefined): Edition {
|
||||
if (raw === 'enterprise') return 'enterprise';
|
||||
return 'personal';
|
||||
}
|
||||
|
||||
/** 版本中文名称 */
|
||||
export function getEditionName(edition: Edition): string {
|
||||
return edition === 'enterprise' ? '企业版' : '个人版';
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// 窗口标题构建
|
||||
// ============================================================
|
||||
|
||||
/** 平台中文名称(简写) */
|
||||
function platformShortName(platform: Platform): string {
|
||||
if (platform === 'darwin') return 'MAC';
|
||||
if (platform === 'win32') return 'Windows';
|
||||
return 'Linux';
|
||||
}
|
||||
|
||||
/**
|
||||
* 构建完整窗口标题
|
||||
* 格式:船长·HeiXiu V{版本号} {平台}{版本}
|
||||
* 示例:"船长·HeiXiu V0.0.1 MAC企业版"
|
||||
* "船长·HeiXiu V0.0.1 Windows个人版"
|
||||
*
|
||||
* @param platform - 当前操作系统平台
|
||||
* @param edition - 版本类型
|
||||
* @param version - 可选覆盖版本号(默认 APP_VERSION)
|
||||
*/
|
||||
export function buildWindowTitle(platform: Platform, edition: Edition, version?: string): string {
|
||||
const ver = version ?? APP_VERSION;
|
||||
const os = platformShortName(platform);
|
||||
const edName = getEditionName(edition);
|
||||
return `${APP_NAME} V${ver} ${os}${edName}`;
|
||||
}
|
||||
Reference in New Issue
Block a user