feat(engine): 添加启动超时功能和强制终止引擎的支持

- 在 ControlWindow 中添加了 'control.engine.forceKill' 事件处理，允许强制终止引擎。 - 在 CaptionEngine 中实现了启动超时机制，若引擎启动超时，将自动强制停止并发送错误消息。 - 更新了国际化文件，添加了与启动超时相关的提示信息。 - 在 EngineControl 组件中添加了启动超时的输入选项，允许用户设置超时时间。 - 更新了相关类型定义以支持新的启动超时配置。
2026-02-04 04:14:42 +08:00 · 2025-08-28 10:24:08 +10:00
parent 34362fea3d
commit 051a497f3a
14 changed files with 150 additions and 16 deletions
--- a/src/main/ControlWindow.ts
+++ b/src/main/ControlWindow.ts
@@ -159,6 +159,10 @@ class ControlWindow {
      captionEngine.stop()
    })

+    ipcMain.on('control.engine.forceKill', () => {
+      captionEngine.forceKill()
+    })
+
    ipcMain.on('control.captionLog.clear', () => {
      allConfig.captionLog.splice(0)
    })
--- a/src/main/i18n/lang/en.ts
+++ b/src/main/i18n/lang/en.ts
@@ -4,5 +4,6 @@ export default {
  "engine.start.error": "Caption engine failed to start: ",
  "engine.output.parse.error": "Unable to parse caption engine output as a JSON object: ",
  "engine.error": "Caption engine error: ",
-  "engine.shutdown.error": "Failed to shut down the caption engine process: "
+  "engine.shutdown.error": "Failed to shut down the caption engine process: ",
+  "engine.start.timeout": "Caption engine startup timeout, automatically force stopped"
 }
--- a/src/main/i18n/lang/ja.ts
+++ b/src/main/i18n/lang/ja.ts
@@ -4,5 +4,6 @@ export default {
  "engine.start.error": "字幕エンジンの起動に失敗しました: ",
  "engine.output.parse.error": "字幕エンジンの出力を JSON オブジェクトとして解析できませんでした: ",
  "engine.error": "字幕エンジンエラー: ",
-  "engine.shutdown.error": "字幕エンジンプロセスの終了に失敗しました: "
+  "engine.shutdown.error": "字幕エンジンプロセスの終了に失敗しました: ",
+  "engine.start.timeout": "字幕エンジンの起動がタイムアウトしました。自動的に強制停止しました"
 }
--- a/src/main/i18n/lang/zh.ts
+++ b/src/main/i18n/lang/zh.ts
@@ -4,5 +4,6 @@ export default {
  "engine.start.error": "字幕引擎启动失败：",
  "engine.output.parse.error": "字幕引擎输出内容无法解析为 JSON 对象：",
  "engine.error": "字幕引擎错误：",
-  "engine.shutdown.error": "字幕引擎进程关闭失败："
+  "engine.shutdown.error": "字幕引擎进程关闭失败：",
+  "engine.start.timeout": "字幕引擎启动超时，已自动强制停止"
 }
--- a/src/main/types/index.ts
+++ b/src/main/types/index.ts
@@ -13,7 +13,8 @@ export interface Controls {
  modelPath: string,
  customized: boolean,
  customizedApp: string,
-  customizedCommand: string
+  customizedCommand: string,
+  startTimeoutSeconds: number
 }

 export interface Styles {
--- a/src/main/utils/AllConfig.ts
+++ b/src/main/utils/AllConfig.ts
@@ -39,7 +39,8 @@ const defaultControls: Controls = {
  translation: true,
  customized: false,
  customizedApp: '',
-  customizedCommand: ''
+  customizedCommand: '',
+  startTimeoutSeconds: 30
 };


--- a/src/main/utils/CaptionEngine.ts
+++ b/src/main/utils/CaptionEngine.ts
@@ -14,8 +14,9 @@ export class CaptionEngine {
  process: any | undefined
  client: net.Socket | undefined
  port: number = 8080
-  status: 'running' | 'starting' | 'stopping' | 'stopped' = 'stopped'
+  status: 'running' | 'starting' | 'stopping' | 'stopped' | 'starting-timeout' = 'stopped'
  timerID: NodeJS.Timeout | undefined
+  startTimeoutID: NodeJS.Timeout | undefined

  private getApp(): boolean {
    if (allConfig.controls.customized) {
@@ -96,6 +97,11 @@ export class CaptionEngine {

  public connect() {
    if(this.client) { Log.warn('Client already exists, ignoring...') }
+    // 清除启动超时计时器
+    if (this.startTimeoutID) {
+      clearTimeout(this.startTimeoutID)
+      this.startTimeoutID = undefined
+    }
    this.client = net.createConnection({ port: this.port }, () => {
      Log.info('Connected to caption engine server');
    });
@@ -130,6 +136,17 @@ export class CaptionEngine {
    this.process = spawn(this.appPath, this.command)
    this.status = 'starting'
    Log.info('Caption Engine Starting, PID:', this.process.pid)
+
+    // 设置启动超时机制
+    const timeoutMs = allConfig.controls.startTimeoutSeconds * 1000
+    this.startTimeoutID = setTimeout(() => {
+      if (this.status === 'starting') {
+        Log.warn(`Engine start timeout after ${allConfig.controls.startTimeoutSeconds} seconds, forcing kill...`)
+        this.status = 'starting-timeout'
+        controlWindow.sendErrorMessage(i18n('engine.start.timeout'))
+        this.forceKill()
+      }
+    }, timeoutMs)
    
    this.process.stdout.on('data', (data: any) => {
      const lines = data.toString().split('\n')
@@ -165,6 +182,11 @@ export class CaptionEngine {
      }
      this.status = 'stopped'
      clearInterval(this.timerID)
+      // 清理启动超时计时器
+      if (this.startTimeoutID) {
+        clearTimeout(this.startTimeoutID)
+        this.startTimeoutID = undefined
+      }
      Log.info(`Engine exited with code ${code}`)
    });
  }
@@ -188,21 +210,47 @@ export class CaptionEngine {
  }

  public kill(){
-    if(!this.process || !this.process.pid) return
    if(this.status !== 'running'){
      Log.warn('Trying to kill engine which is not running, current status:', this.status)
+      return
+    }
+    this.sendCommand('stop')
+    if(this.client){
+      this.client.destroy()
+      this.client = undefined
+    }
+    this.status = 'stopping'
+    this.timerID = setTimeout(() => {
+      if(this.status !== 'stopping') return
+      Log.warn('Engine process still not stopped, trying to kill...')
+      this.forceKill()
+    }, 4000);
+  }
+
+  public forceKill(){
+    if(!this.process || !this.process.pid) return
+    Log.warn('Force killing engine process, PID:', this.process.pid)
+    // 清理启动超时计时器
+    if (this.startTimeoutID) {
+      clearTimeout(this.startTimeoutID)
+      this.startTimeoutID = undefined
    }
-    Log.warn('Trying to kill engine process, PID:', this.process.pid)
    if(this.client){
      this.client.destroy()
      this.client = undefined
    }
    if (this.process.pid) {
-      let cmd = `kill ${this.process.pid}`;
+      let cmd = `kill -9 ${this.process.pid}`;
      if (process.platform === "win32") {
        cmd = `taskkill /pid ${this.process.pid} /t /f`
      }
-      exec(cmd)
+      exec(cmd, (error) => {
+        if (error) {
+          Log.error('Failed to force kill process:', error)
+        } else {
+          Log.info('Process force killed successfully')
+        }
+      })
    }
    this.status = 'stopping'
  }
--- a/src/renderer/src/components/EngineControl.vue
+++ b/src/renderer/src/components/EngineControl.vue
@@ -109,6 +109,22 @@
          v-model:value="currentModelPath"
        />
      </div>
+      <div class="input-item">
+        <a-popover>
+          <template #content>
+            <p class="label-hover-info">{{ $t('engine.startTimeoutInfo') }}</p>
+          </template>
+          <span class="input-label info-label">{{ $t('engine.startTimeout') }}</span>
+        </a-popover>
+        <a-input-number
+          class="input-area"
+          v-model:value="currentStartTimeoutSeconds"
+          :min="10"
+          :max="120"
+          :step="5"
+          addon-after="秒"
+        />
+      </div>
    </a-card>
  </a-card>
  <div style="height: 20px;"></div>
@@ -139,6 +155,7 @@ const currentModelPath = ref<string>('')
 const currentCustomized = ref<boolean>(false)
 const currentCustomizedApp = ref('')
 const currentCustomizedCommand = ref('')
+const currentStartTimeoutSeconds = ref<number>(30)

 const langList = computed(() => {
  for(let item of captionEngine.value){
@@ -160,6 +177,7 @@ function applyChange(){
  engineControl.customized = currentCustomized.value
  engineControl.customizedApp = currentCustomizedApp.value
  engineControl.customizedCommand = currentCustomizedCommand.value
+  engineControl.startTimeoutSeconds = currentStartTimeoutSeconds.value

  engineControl.sendControlsChange()

@@ -181,6 +199,7 @@ function cancelChange(){
  currentCustomized.value = engineControl.customized
  currentCustomizedApp.value = engineControl.customizedApp
  currentCustomizedCommand.value = engineControl.customizedCommand
+  currentStartTimeoutSeconds.value = engineControl.startTimeoutSeconds
 }

 function selectFolderPath() {
--- a/src/renderer/src/components/EngineStatus.vue
+++ b/src/renderer/src/components/EngineStatus.vue
@@ -67,11 +67,26 @@
      @click="openCaptionWindow"
    >{{ $t('status.openCaption') }}</a-button>
    <a-button
+      v-if="!isStarting"
      class="control-button"
      :loading="pending && !engineEnabled"
      :disabled="pending || engineEnabled"
      @click="startEngine"
    >{{ $t('status.startEngine') }}</a-button>
+    <a-popconfirm
+      v-if="isStarting"
+      :title="$t('status.forceKillConfirm')"
+      :ok-text="$t('status.confirm')"
+      :cancel-text="$t('status.cancel')"
+      @confirm="forceKillEngine"
+    >
+      <a-button
+        danger
+        class="control-button"
+        type="primary"
+        :loading="true"
+      >{{ $t('status.forceKillStarting') }}</a-button>
+    </a-popconfirm>
    <a-button
     danger class="control-button"
     :loading="pending && engineEnabled"
@@ -137,6 +152,7 @@ import { GithubOutlined, InfoCircleOutlined } from '@ant-design/icons-vue'

 const showAbout = ref(false)
 const pending = ref(false)
+const isStarting = ref(false)

 const captionLog = useCaptionLogStore()
 const { captionData } = storeToRefs(captionLog)
@@ -158,8 +174,11 @@ function openCaptionWindow() {

 function startEngine() {
  pending.value = true
+  isStarting.value = true
  if(engineControl.engine === 'vosk' && engineControl.modelPath.trim() === '') {
    engineControl.emptyModelPathErr()
+    pending.value = false
+    isStarting.value = false
    return
  }
  window.electron.ipcRenderer.send('control.engine.start')
@@ -170,6 +189,12 @@ function stopEngine() {
  window.electron.ipcRenderer.send('control.engine.stop')
 }

+function forceKillEngine() {
+  pending.value = true
+  isStarting.value = false
+  window.electron.ipcRenderer.send('control.engine.forceKill')
+}
+
 function getEngineInfo() {
  window.electron.ipcRenderer.invoke('control.engine.info').then((data: EngineInfo) => {
    pid.value = data.pid
@@ -181,12 +206,16 @@ function getEngineInfo() {
  })
 }

-watch(engineEnabled, () => {
+watch(engineEnabled, (enabled) => {
  pending.value = false
+  if (enabled) {
+    isStarting.value = false
+  }
 })

 watch(errorSignal, () => {
  pending.value = false
+  isStarting.value = false
  errorSignal.value = false
 })
 </script>
--- a/src/renderer/src/i18n/lang/en.ts
+++ b/src/renderer/src/i18n/lang/en.ts
@@ -27,7 +27,8 @@ export default {
    "engineChange": "Cpation Engine Configuration Changed",
    "changeInfo": "If the caption engine is already running, you need to restart it for the changes to take effect.",
    "styleChange": "Caption Style Changed",
-    "styleInfo": "Caption style changes have been saved and applied."
+    "styleInfo": "Caption style changes have been saved and applied.",
+    "engineStartTimeout": "Caption engine startup timeout, automatically force stopped"
  },
  general: {
    "title": "General Settings",
@@ -54,8 +55,10 @@ export default {
    "showMore": "More Settings",
    "apikey": "API KEY",
    "modelPath": "Model Path",
+    "startTimeout": "Start Timeout",
    "apikeyInfo": "API KEY required for the Gummy subtitle engine, which needs to be obtained from the Alibaba Cloud Bailing platform. For more details, see the project user manual.",
    "modelPathInfo": "The folder path of the model required by the Vosk subtitle engine. You need to download the required model to your local machine in advance. For more details, see the project user manual.",
+    "startTimeoutInfo": "Caption engine startup timeout duration. Engine will be forcefully stopped if startup exceeds this time. Recommended range: 10-120 seconds.",
    "customEngine": "Custom Engine",
    custom: {
      "title": "Custom Caption Engine",
@@ -112,6 +115,11 @@ export default {
    "startEngine": "Start Caption Engine",
    "restartEngine": "Restart Caption Engine",
    "stopEngine": "Stop Caption Engine",
+    "forceKill": "Force Stop",
+    "forceKillStarting": "Starting Engine... (Force Stop)",
+    "forceKillConfirm": "Are you sure you want to force stop the caption engine? This will terminate the process immediately.",
+    "confirm": "Confirm",
+    "cancel": "Cancel",
    about: {
      "title": "About This Project",
      "proj": "Auto Caption Project",
--- a/src/renderer/src/i18n/lang/ja.ts
+++ b/src/renderer/src/i18n/lang/ja.ts
@@ -27,7 +27,8 @@ export default {
    "engineChange": "字幕エンジンの設定が変更されました",
    "changeInfo": "字幕エンジンがすでに起動している場合、変更を有効にするには再起動が必要です。",
    "styleChange": "字幕のスタイルが変更されました",
-    "styleInfo": "字幕のスタイル変更が保存され、適用されました"
+    "styleInfo": "字幕のスタイル変更が保存され、適用されました",
+    "engineStartTimeout": "字幕エンジンの起動がタイムアウトしました。自動的に強制停止しました"
  },
  general: {
    "title": "一般設定",
@@ -54,8 +55,10 @@ export default {
    "showMore": "詳細設定",
    "apikey": "API KEY",
    "modelPath": "モデルパス",
+    "startTimeout": "起動タイムアウト",
    "apikeyInfo": "Gummy 字幕エンジンに必要な API KEY は、アリババクラウド百煉プラットフォームから取得する必要があります。詳細情報はプロジェクトのユーザーマニュアルをご覧ください。",
    "modelPathInfo": "Vosk 字幕エンジンに必要なモデルのフォルダパスです。必要なモデルを事前にローカルマシンにダウンロードする必要があります。詳細情報はプロジェクトのユーザーマニュアルをご覧ください。",
+    "startTimeoutInfo": "字幕エンジンの起動タイムアウト時間です。この時間を超えると自動的に強制停止されます。10-120秒の範囲で設定することを推奨します。",
    "customEngine": "カスタムエンジン",
    custom: {
      "title": "カスタムキャプションエンジン",
@@ -112,6 +115,11 @@ export default {
    "startEngine": "字幕エンジンを開始",
    "restartEngine": "字幕エンジンを再起動",
    "stopEngine": "字幕エンジンを停止",
+    "forceKill": "強制停止",
+    "forceKillStarting": "エンジン起動中... (強制停止)",
+    "forceKillConfirm": "字幕エンジンを強制停止しますか？プロセスが直ちに終了されます。",
+    "confirm": "確認",
+    "cancel": "キャンセル",
    about: {
      "title": "このプロジェクトについて",
      "proj": "Auto Caption プロジェクト",
--- a/src/renderer/src/i18n/lang/zh.ts
+++ b/src/renderer/src/i18n/lang/zh.ts
@@ -27,7 +27,8 @@ export default {
    "engineChange": "字幕引擎配置已更改",
    "changeInfo": "如果字幕引擎已经启动，需要重启字幕引擎修改才会生效",
    "styleChange": "字幕样式已修改",
-    "styleInfo": "字幕样式修改已经保存并生效"
+    "styleInfo": "字幕样式修改已经保存并生效",
+    "engineStartTimeout": "字幕引擎启动超时，已自动强制停止"
  },
  general: {
    "title": "通用设置",
@@ -54,8 +55,10 @@ export default {
    "showMore": "更多设置",
    "apikey": "API KEY",
    "modelPath": "模型路径",
+    "startTimeout": "启动超时",
    "apikeyInfo": "Gummy 字幕引擎需要的 API KEY，需要在阿里云百炼平台获取。详细信息见项目用户手册。",
    "modelPathInfo": "Vosk 字幕引擎需要的模型的文件夹路径，需要提前下载需要的模型到本地。信息详情见项目用户手册。",
+    "startTimeoutInfo": "字幕引擎启动超时时间，超过此时间将自动强制停止。建议设置为 10-120 秒之间。",
    "customEngine": "自定义引擎",
    custom: {
      "title": "自定义字幕引擎",
@@ -112,6 +115,11 @@ export default {
    "startEngine": "启动字幕引擎",
    "restartEngine": "重启字幕引擎",
    "stopEngine": "关闭字幕引擎",
+    "forceKill": "强行停止",
+    "forceKillStarting": "正在启动引擎... (强行停止)",
+    "forceKillConfirm": "确定要强行停止字幕引擎吗？这将立即终止进程。",
+    "confirm": "确定",
+    "cancel": "取消",
    about: {
      "title": "关于本项目",
      "proj": "Auto Caption 项目",
--- a/src/renderer/src/stores/engineControl.ts
+++ b/src/renderer/src/stores/engineControl.ts
@@ -27,6 +27,7 @@ export const useEngineControlStore = defineStore('engineControl', () => {
  const customized = ref<boolean>(false)
  const customizedApp = ref<string>('')
  const customizedCommand = ref<string>('')
+  const startTimeoutSeconds = ref<number>(30)

  const changeSignal = ref<boolean>(false)
  const errorSignal = ref<boolean>(false)
@@ -43,7 +44,8 @@ export const useEngineControlStore = defineStore('engineControl', () => {
      modelPath: modelPath.value,
      customized: customized.value,
      customizedApp: customizedApp.value,
-      customizedCommand: customizedCommand.value
+      customizedCommand: customizedCommand.value,
+      startTimeoutSeconds: startTimeoutSeconds.value
    }
    window.electron.ipcRenderer.send('control.controls.change', controls)
  }
@@ -75,6 +77,7 @@ export const useEngineControlStore = defineStore('engineControl', () => {
    customized.value = controls.customized
    customizedApp.value = controls.customizedApp
    customizedCommand.value = controls.customizedCommand
+    startTimeoutSeconds.value = controls.startTimeoutSeconds
    changeSignal.value = true
  }

@@ -137,6 +140,7 @@ export const useEngineControlStore = defineStore('engineControl', () => {
    customized,         // 是否使用自定义字幕引擎
    customizedApp,      // 自定义字幕引擎的应用程序
    customizedCommand,  // 自定义字幕引擎的命令
+    startTimeoutSeconds, // 启动超时时间（秒）
    setControls,        // 设置引擎配置
    sendControlsChange, // 发送最新控制消息到后端
    emptyModelPathErr,  // 模型路径为空时显示警告
--- a/src/renderer/src/types/index.ts
+++ b/src/renderer/src/types/index.ts
@@ -13,7 +13,8 @@ export interface Controls {
  modelPath: string,
  customized: boolean,
  customizedApp: string,
-  customizedCommand: string
+  customizedCommand: string,
+  startTimeoutSeconds: number
 }

 export interface Styles {