YoungestSongMo
767bb8b297
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（构建环境变量模板）
76 lines
1.9 KiB
TypeScript
76 lines
1.9 KiB
TypeScript
// ============================================================
|
||
// 共享工具函数 —— 主进程 & 渲染进程通用（纯函数，不依赖平台 API）
|
||
// ============================================================
|
||
|
||
/**
|
||
* 简单防抖函数
|
||
* @param fn 目标函数
|
||
* @param delay 延迟毫秒数
|
||
*/
|
||
export function debounce<T extends (...args: unknown[]) => void>(
|
||
fn: T,
|
||
delay: number,
|
||
): (...args: Parameters<T>) => void {
|
||
let timer: ReturnType<typeof setTimeout> | null = null;
|
||
return (...args: Parameters<T>) => {
|
||
if (timer !== null) {
|
||
clearTimeout(timer);
|
||
}
|
||
timer = setTimeout(() => {
|
||
fn(...args);
|
||
timer = null;
|
||
}, delay);
|
||
};
|
||
}
|
||
|
||
/**
|
||
* 节流函数
|
||
* @param fn 目标函数
|
||
* @param interval 间隔毫秒数
|
||
*/
|
||
export function throttle<T extends (...args: unknown[]) => void>(
|
||
fn: T,
|
||
interval: number,
|
||
): (...args: Parameters<T>) => void {
|
||
let lastTime = 0;
|
||
return (...args: Parameters<T>) => {
|
||
const now = Date.now();
|
||
if (now - lastTime >= interval) {
|
||
lastTime = now;
|
||
fn(...args);
|
||
}
|
||
};
|
||
}
|
||
|
||
/**
|
||
* 语义化版本号比较
|
||
* @returns 1 (v1 > v2), -1 (v1 < v2), 0 (相等)
|
||
*/
|
||
export function compareVersions(v1: string, v2: string): number {
|
||
const parts1 = v1.split('.').map(Number);
|
||
const parts2 = v2.split('.').map(Number);
|
||
const maxLen = Math.max(parts1.length, parts2.length);
|
||
|
||
for (let i = 0; i < maxLen; i++) {
|
||
const a = parts1[i] || 0;
|
||
const b = parts2[i] || 0;
|
||
if (a > b) return 1;
|
||
if (a < b) return -1;
|
||
}
|
||
return 0;
|
||
}
|
||
|
||
/**
|
||
* 深拷贝（JSON 安全类型）
|
||
*/
|
||
export function deepClone<T>(obj: T): T {
|
||
return JSON.parse(JSON.stringify(obj));
|
||
}
|
||
|
||
/**
|
||
* 生成唯一 ID（简易版，不依赖 crypto）
|
||
*/
|
||
export function generateId(): string {
|
||
return `${Date.now().toString(36)}-${Math.random().toString(36).substring(2, 9)}`;
|
||
}
|