重构i18n，支持全局多语言切换

Author: YILS-LIN

CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 此项目的所有显著更改都将记录在此文件中。
 
+## [v1.1.0] - 2025-08-22
+### Added
+- Multi-Language Support
+### 添加
+- 多语言支持
+
 ## [v1.0.1] - 2025-08-12
 ### Fixed
 - 修复混剪片段与语音时长不一致问题

README.md

@@ -48,11 +48,13 @@
 - 🎥 **自动剪辑**：支持多种视频格式，自动化批量处理视频剪辑任务
 - 🎙️ **语音合成**：将生成的文案转换为自然流畅的语音
 - 🎬 **字幕特效**：自动添加字幕和特效，提升视频质量
+- 📦 **批量处理**：支持批量任务，按预设自动持续合成视频
+- 🌐 **多语言支持**：支持中文、英文等多种语言，满足不同用户需求
 - 📦 **开箱即用**：无需复杂配置，用户可以快速上手
 - 📈 **持续更新**：定期发布新版本，修复bug并添加新功能
 - 🔒 **安全可靠**：完全本地本地化运行，确保用户数据安全
 - 🎨 **用户友好**：简洁直观的用户界面，易于操作
-- 🌐 **多平台支持**：支持Windows、macOS和Linux等多个操作系统
+- 💻 **多平台支持**：支持Windows、macOS和Linux等多个操作系统
 
 <p align="right">(<a href="#readme-top">返回顶部</a>)</p>
 
@@ -66,6 +68,9 @@
 - [x] 语音合成，支持EdgeTTS
 - [x] 视频剪辑，文案、视频、音频、字幕合成，自动混剪
 - [x] 批量处理，支持一个批量任务，按预设自动持续合成视频
+- [x] 多语言支持，能够支持中文、英文等多种语言
+- [ ] 更全面的参数调整
+- [ ] 更多的语音合成API
 - [ ] 字幕特效，支持多种字幕样式和特效
 
 

electron-builder.json5

@@ -7,7 +7,7 @@
   directories: {
     output: 'release/${version}',
   },
-  files: ['dist', 'dist-electron', 'dist-native'],
+  files: ['dist', 'dist-electron', 'dist-native', 'locales'],
   npmRebuild: false, // disable rebuild node_modules 使用包内自带预构建二进制，而不重新构建
   beforePack: './scripts/before-pack.js',
   mac: {

electron/electron-env.d.ts

@@ -24,6 +24,11 @@ declare namespace NodeJS {
 // 在渲染器进程中使用，在 `preload.ts` 中暴露方法
 interface Window {
   ipcRenderer: Pick<import('electron').IpcRenderer, 'on' | 'once' | 'off' | 'send' | 'invoke'>
+  i18n: {
+    getLocalesPath: () => Promise<string>
+    getLanguage: () => Promise<string>
+    changeLanguage: (lng: string) => Promise<string>
+  }
   electron: {
     isWinMaxed: () => Promise<boolean>
     winMin: () => void

electron/i18n/common-options.ts

@@ -0,0 +1,15 @@
+import { InitOptions } from 'i18next'
+
+export const i18nLanguages = [
+  { code: 'en', name: 'English' },
+  { code: 'zh-CN', name: '简体中文' },
+]
+
+export const i18nCommonOptions: InitOptions = {
+  fallbackLng: i18nLanguages[0].code,
+  supportedLngs: i18nLanguages.map((l) => l.code),
+  load: 'currentOnly',
+  ns: ['common'],
+  defaultNS: 'common',
+  interpolation: { escapeValue: false },
+}

electron/i18n/index.ts

@@ -0,0 +1,42 @@
+import i18next from 'i18next'
+import Backend from 'i18next-fs-backend'
+import { app, BrowserWindow, ipcMain } from 'electron'
+import { fileURLToPath } from 'node:url'
+import path from 'node:path'
+import { i18nCommonOptions } from './common-options'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+process.env.APP_ROOT = path.join(__dirname, '..')
+
+const localesPath = path.join(process.env.APP_ROOT, 'locales/{{lng}}/{{ns}}.json')
+
+export const initI18n = async () => {
+  await i18next.use(Backend).init({
+    // initAsync: false,
+    // debug: true,
+    ...i18nCommonOptions,
+    lng: app.getLocale(), // 获取系统语言
+    backend: {
+      loadPath: localesPath,
+    },
+  })
+
+  // 获取多语言文件路径
+  ipcMain.handle('i18n-getLocalesPath', () => localesPath)
+
+  // 读取当前语言
+  ipcMain.handle('i18n-getLanguage', () => i18next.language)
+
+  // 渲染进程切换语言
+  ipcMain.handle('i18n-changeLanguage', async (_, lng: string) => {
+    await changeAppLanguage(lng)
+    return lng
+  })
+}
+
+export const changeAppLanguage = async (lng: string) => {
+  await i18next.changeLanguage(lng)
+  BrowserWindow.getAllWindows().forEach((win) => {
+    win.webContents.send('i18n-changeLanguage', lng)
+  })
+}

electron/ipc.ts

@@ -20,7 +20,7 @@ process.env.VITE_PUBLIC = VITE_DEV_SERVER_URL
   ? path.join(process.env.APP_ROOT, 'public')
   : RENDERER_DIST
 
-export default function initIPC(win: BrowserWindow) {
+export default function initIPC() {
   // sqlite 查询
   ipcMain.handle('sqlite-query', (_event, params) => sqQuery(params))
   // sqlite 插入
@@ -33,23 +33,27 @@ export default function initIPC(win: BrowserWindow) {
   ipcMain.handle('sqlite-bulk-insert-or-update', (_event, params) => sqBulkInsertOrUpdate(params))
 
   // 是否最大化
-  ipcMain.handle('is-win-maxed', () => {
+  ipcMain.handle('is-win-maxed', (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender)
     return win?.isMaximized()
   })
   //最小化
-  ipcMain.on('win-min', () => {
+  ipcMain.on('win-min', (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender)
     win?.minimize()
   })
   //最大化
-  ipcMain.on('win-max', () => {
+  ipcMain.on('win-max', (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender)
     if (win?.isMaximized()) {
       win?.restore()
     } else {
       win?.maximize()
     }
   })
   //关闭程序
-  ipcMain.on('win-close', () => {
+  ipcMain.on('win-close', (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender)
     win?.close()
   })
 
@@ -59,7 +63,12 @@ export default function initIPC(win: BrowserWindow) {
   })
 
   // 选择文件夹
-  ipcMain.handle('select-folder', async (_event, params?: SelectFolderParams) => {
+  ipcMain.handle('select-folder', async (event, params?: SelectFolderParams) => {
+    const win = BrowserWindow.fromWebContents(event.sender)
+    if (!win) {
+      throw new Error('无法获取窗口')
+    }
+
     const result = await dialog.showOpenDialog(win, {
       properties: ['openDirectory'],
       title: params?.title || '选择文件夹',

electron/lib/is-dev.ts

@@ -0,0 +1 @@
+export const isDev = !!process.env['VITE_DEV_SERVER_URL']

electron/lib/tools.ts

@@ -2,8 +2,6 @@ import fs from 'node:fs'
 import path from 'node:path'
 import { app } from 'electron'
 
-// import packageJson from '~/package.json'
-
 /**
  * 生成有序的唯一文件名，用于处理文件已存在的情况
  */

electron/main.ts

@@ -1,10 +1,13 @@
 import { app, BrowserWindow, screen, Menu } from 'electron'
 import type { MenuItemConstructorOptions } from 'electron'
 import { fileURLToPath } from 'node:url'
+import { isDev } from './lib/is-dev'
 import path from 'node:path'
-import GlobalSetting from '../setting.global'
 import initIPC from './ipc'
 import { initSqlite } from './sqlite'
+import i18next from 'i18next'
+import { changeAppLanguage, initI18n } from './i18n'
+import { i18nLanguages } from './i18n/common-options'
 import useCookieAllowCrossSite from './lib/cookie-allow-cross-site'
 
 // 用于引入 CommonJS 模块的方法
@@ -29,17 +32,14 @@ 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
+process.env.VITE_PUBLIC = isDev ? path.join(process.env.APP_ROOT, 'public') : RENDERER_DIST
 
 let win: BrowserWindow | null
 
 function createWindow() {
   const { width, height } = screen.getPrimaryDisplay().workAreaSize
   win = new BrowserWindow({
     icon: path.join(process.env.VITE_PUBLIC, 'icon.png'),
-    title: GlobalSetting.appName,
     width: Math.ceil(width * 0.8),
     height: Math.ceil(height * 0.8),
     minWidth: 800,
@@ -76,76 +76,63 @@ function buildMenu() {
     ...(process.platform === 'darwin'
       ? [
           {
-            label: app.name,
+            label: i18next.t('app.name'),
             submenu: [
-              { role: 'about' },
+              {
+                label: i18next.t('menu.app.about'),
+                click: async () => {
+                  const { shell } = await import('electron')
+                  await shell.openExternal('https://github.com/YILS-LIN/short-video-factory')
+                },
+              },
               { type: 'separator' },
-              { role: 'services' },
+              { label: i18next.t('menu.app.services'), role: 'services' },
               { type: 'separator' },
-              { role: 'hide' },
-              { role: 'hideOthers' },
-              { role: 'unhide' },
+              { label: i18next.t('menu.app.hide'), role: 'hide' },
+              { label: i18next.t('menu.app.hideOthers'), role: 'hideOthers' },
+              { label: i18next.t('menu.app.unhide'), role: 'unhide' },
               { type: 'separator' },
-              { role: 'quit' },
+              { label: i18next.t('menu.app.quit'), role: 'quit' },
             ] as MenuItemConstructorOptions[],
           },
         ]
       : []),
     {
-      label: 'Language',
-      submenu: [
-        {
-          label: 'English',
-          type: 'radio',
-          checked: true,
-          click: () => {
-            BrowserWindow.getAllWindows().forEach((w) => w.webContents.send('set-locale', 'en'))
-          },
+      label: i18next.t('menu.language'),
+      submenu: i18nLanguages.map((lng) => ({
+        label: lng.name,
+        type: 'radio',
+        checked: i18next.language === lng.code,
+        click: () => {
+          changeAppLanguage(lng.code)
         },
-        {
-          label: '中文',
-          type: 'radio',
-          click: () => {
-            BrowserWindow.getAllWindows().forEach((w) => w.webContents.send('set-locale', 'zh-CN'))
-          },
-        },
-      ] as MenuItemConstructorOptions[],
+      })) as MenuItemConstructorOptions[],
     },
     {
-      label: 'Edit',
+      label: i18next.t('menu.view.root'),
       submenu: [
-        { role: 'undo' },
-        { role: 'redo' },
+        { role: 'toggleDevTools', visible: false },
+        { label: i18next.t('menu.view.resetZoom'), role: 'resetZoom' },
+        { label: i18next.t('menu.view.zoomIn'), role: 'zoomIn' },
+        { label: i18next.t('menu.view.zoomOut'), role: 'zoomOut' },
         { type: 'separator' },
-        { role: 'cut' },
-        { role: 'copy' },
-        { role: 'paste' },
-        { role: 'selectAll' },
+        { label: i18next.t('menu.view.toggleFullscreen'), role: 'togglefullscreen' },
       ] as MenuItemConstructorOptions[],
     },
     {
-      label: 'View',
+      label: i18next.t('menu.window.root'),
+      role: 'window',
       submenu: [
-        { role: 'reload' },
-        { role: 'forceReload' },
-        { role: 'toggleDevTools' },
-        { type: 'separator' },
-        { role: 'resetZoom' },
-        { role: 'zoomIn' },
-        { role: 'zoomOut' },
-        { type: 'separator' },
-        { role: 'togglefullscreen' },
+        { label: i18next.t('menu.window.minimize'), role: 'minimize' },
+        { label: i18next.t('menu.window.close'), role: 'close' },
       ] as MenuItemConstructorOptions[],
     },
     {
-      role: 'window',
-      submenu: [{ role: 'minimize' }, { role: 'close' }] as MenuItemConstructorOptions[],
-    },
-    {
+      label: i18next.t('menu.help.root'),
       role: 'help',
       submenu: [
         {
-          label: 'Learn More',
+          label: i18next.t('menu.help.learnMore'),
           click: async () => {
             const { shell } = await import('electron')
             await shell.openExternal('https://github.com/YILS-LIN/short-video-factory')
@@ -181,17 +168,19 @@ app.on('activate', () => {
 // app.disableHardwareAcceleration();
 
 app.whenReady().then(() => {
-  createWindow()
   initSqlite()
-  initIPC(win as BrowserWindow)
+  initI18n()
+  initIPC()
+  createWindow()
+
+  i18next.on('languageChanged', () => {
+    buildMenu()
+  })
 
   // 允许跨站请求携带cookie
   useCookieAllowCrossSite()
   // 禁用 CORS
   app.commandLine.appendSwitch('disable-features', 'OutOfBlinkCors')
   // 允许本地网络请求
   app.commandLine.appendSwitch('disable-features', 'BlockInsecurePrivateNetworkRequests')
-
-  // Build application menu
-  buildMenu()
 })