【问题】
桌面端(Electron)切换主题时颜色变化速度不一致、明显卡顿。
根因分析(4 轮迭代):
1. 过渡时长不统一(body 0.3s / 组件 0.15s)→ 统一到 0.2s
2. antd CSS-in-JS 标签替换导致瞬间变色 → 尝试 cssVar(无效,仍走标签替换)
3. applyHtmlTheme 在 updater 回调中执行,与 antd CSS 变更不同帧 → 移入 useLayoutEffect
4. html * 全局过渡在 Electron 中为数千 DOM 节点同步插值 → 合成器掉帧
终极方案:View Transitions API(GPU 合成器 1 次 cross-fade 替代 N 个 CSS 过渡)
+ 精准 CSS 过渡覆盖 ~80 个 antd 容器类(回退方案)
【修改】
ThemeProvider.tsx — 核心重构
- applyHtmlTheme 从 setIsDark updater → useLayoutEffect([isDark])
确保自定义 CSS 变量与 antd CSS-in-JS 在同一次 React 提交中生效
- View Transitions API:document.startViewTransition + flushSync
GPU 合成器截取旧/新两帧做单次 cross-fade,消除多元素插值卡顿
- 浏览器不支持时自动回退到 CSS transition 方案
globals.css — 过渡策略
- body: 0.3s ease → 0.15s linear
- View Transitions 动画:::view-transition-old/new(root) 0.15s linear
- ~80 个 antd 容器类精准过渡(Layout/Card/Modal/Table/Input/
Select/Picker/Menu/Tabs/Tag/Alert/Empty/Result/Skeleton 等)
按功能分组:布局 → 表格 → 表单 → 导航 → 反馈
不覆盖交互组件自有 transition(Button/Switch/Slider 等)
linear 替代 ease — 匀速插值,桌面应用更利落
Layout.tsx / HomeContent.tsx / LeftPanel.tsx / ModelSelector.tsx
- 过渡参数对齐:全部 0.2s → 0.15s linear
SettingsPage.tsx — 用户体验
- Modal 取消 keyboard={false},Esc 键可关闭
- macOS:关闭按钮移至标题左侧(遵循 macOS HIG)
- afterClose 中 blur 当前焦点元素,防止聚焦跳到导航栏
【文档】
CHANGELOG.md — 新增 0.0.15 版本记录
CLAUDE.md — 新增主题系统架构章节(双轨颜色体系 / 时序 / 过渡策略)
180 lines
5.9 KiB
TypeScript
180 lines
5.9 KiB
TypeScript
import {app, BrowserWindow, ipcMain, dialog, session} 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 {loadEnvFile} from './main/load-env';
|
|
import {initUpdater, registerUpdateIpcHandlers} from './main/updater';
|
|
import {setupAppMenu} from './main/menu';
|
|
import {initLogger, flushLogger, logger} from './main/logger';
|
|
import {registerLogIpcHandlers} from './main/log-ipc';
|
|
import {registerSafeStorageIpcHandlers} from './main/safe-storage-ipc';
|
|
import {BIDIRECTIONAL} from '../shared/constants/ipc-channels';
|
|
|
|
createRequire(import.meta.url);
|
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
|
|
process.env.APP_ROOT = path.join(__dirname, '..');
|
|
|
|
// 加载 .env 文件中的环境变量到 process.env
|
|
// 必须在任何读取 process.env.UPDATE_API_URL 的模块之前调用
|
|
loadEnvFile();
|
|
|
|
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);
|
|
|
|
// ============================================================
|
|
// 全局未捕获异常(主进程兜底记录)
|
|
// ============================================================
|
|
|
|
process.on('uncaughtException', (error) => {
|
|
try {
|
|
logger.error('app', 'Uncaught exception (main process)', error);
|
|
} catch {
|
|
/* logger 自身异常 — 最后防线 */
|
|
}
|
|
});
|
|
|
|
process.on('unhandledRejection', (reason) => {
|
|
try {
|
|
const error = reason instanceof Error ? reason : new Error(String(reason));
|
|
logger.error('app', 'Unhandled rejection (main process)', error);
|
|
} catch {
|
|
/* logger 自身异常 — 最后防线 */
|
|
}
|
|
});
|
|
|
|
// ============================================================
|
|
// 窗口引用
|
|
// ============================================================
|
|
|
|
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', () => {
|
|
flushLogger();
|
|
});
|
|
|
|
app.whenReady().then(() => {
|
|
initLogger();
|
|
registerLogIpcHandlers();
|
|
registerSafeStorageIpcHandlers();
|
|
setupAppMenu();
|
|
app.setName(WINDOW_TITLE);
|
|
registerUpdateIpcHandlers();
|
|
const fakeUserAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36';
|
|
session.defaultSession.webRequest.onBeforeSendHeaders((details, callback) => {
|
|
const url = details.url;
|
|
if (url.includes("rh-images-1252422369.cos.ap-beijing.myqcloud.com")) {
|
|
details.requestHeaders['User-Agent'] = fakeUserAgent;
|
|
}
|
|
callback({
|
|
requestHeaders: details.requestHeaders
|
|
});
|
|
});
|
|
|
|
// 文件对话框 IPC 处理(供渲染进程选择文件夹)
|
|
ipcMain.handle(BIDIRECTIONAL.FILE_DIALOG, async (_event, options: Electron.OpenDialogOptions) => {
|
|
if (!mainWindow) return {canceled: true, filePaths: []};
|
|
return dialog.showOpenDialog(mainWindow, {
|
|
title: options?.title || '选择文件夹',
|
|
defaultPath: options?.defaultPath || app.getPath('home'),
|
|
properties: options?.properties || ['openDirectory'],
|
|
});
|
|
});
|
|
|
|
// 始终打开主窗口
|
|
// 登录/注册由渲染进程内的 Modal 弹层处理,不再新开窗口
|
|
const win = createMainWindow();
|
|
initUpdater(win);
|
|
});
|