feat(media-server): implement runtime runtime management system (#204)

* feat(media-server): implement runtime runtime management system

- add UV bootstrapper with cross-platform install, caching, progress, validation

- manage Python venv lifecycle, dependency installs, cleanup, and phased progress

- introduce MediaServerService with lifecycle control, health checks, and port management

- extend FFmpeg service to handle FFprobe with unified downloads and version updates

- build settings UI sections for media server and plugins with real-time status

- wire up 38 IPC channels covering UV, venv, FFmpeg/FFprobe, and server control

- update build configs, add ffprobe download script, auto-start server, and bump backend ref

* test: Update tests

* test(main): mock electron app for ipc handlers

* Update src/renderer/src/pages/settings/FFprobeSection.tsx

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Apply suggestion from @coderabbitai[bot]

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* refactor(types): extract common Platform and Arch types to shared package

- Create packages/shared/types/system.ts with Platform and Arch type definitions
- Remove duplicate type definitions from FFmpegDownloadService
- Remove duplicate type definitions from UvBootstrapperService
- Import shared types from @shared/types/system in both services

This change improves code maintainability by centralizing common system type definitions.

* fix(media-server): clear port and notify frontend on process exit

Ensure media server port is properly cleared and frontend is notified
when the process stops or crashes to prevent stale port usage.

Changes:
- Update notifyPortChanged signature to accept number | null
- Clear this.port to null in both normal stop and crash exit handlers
- Notify frontend with null port when server stops
- Update SessionService listener to handle null port notifications
- Add appropriate logging for port clearing events

This prevents the frontend from continuing to use expired ports after
the media server has stopped, requiring manual app restart.

* fix(settings): prevent setTimeout memory leak in MediaServerSection

Fix potential memory leak and unmounted component state update in
MediaServerSection by properly managing setTimeout lifecycle:

- Add successTimeoutRef to store timeout handle
- Clear timeout in effect cleanup on component unmount
- Clear timeout before creating new one in handleInstall
- Clear timeout in error handler to prevent orphaned timers
- Set ref to null after clearing to maintain clean state

This prevents "Can't perform a React state update on an unmounted
component" warnings and ensures proper cleanup of async operations.

Co-Authored-By: Claude <noreply@anthropic.com>

* fix(media-server): improve status display during installation and startup

- Add 'starting' status immediately after installation completes
- Move fetchServerInfo() to finally block to ensure status refresh
- Prevent confusing 'stopped' status display during startup process

* fix(python-venv): preserve final install progress state for callers

Remove finally block that immediately clears installProgress, preventing callers from reading final "completed" or "error" state. Instead:
- Clear installProgress at start of new installation
- Preserve final state after completion/error for caller consumption
- Remove unnecessary finally block cleanup

This ensures MediaServerSection and other callers can reliably read the final installation state.

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor(types): centralize media server types to shared package

- Create shared types module for Media Server and Python Venv
- Add media-server.ts with MediaServerInfo, MediaServerStatus, PythonVenvInfo, and InstallProgress types
- Remove duplicate type definitions from MediaServerService, PythonVenvService, and MediaServerSection
- Update imports to use @shared/types across main and renderer processes
- Maintain backward compatibility by re-exporting types from service files
- All type checks passing

Author: mkdir700

.gitignore

@@ -50,5 +50,7 @@ docs/.vitepress/cache/deps
 dist-test
 
 resources/ffmpeg/
+resources/ffprobe/
 resources/media-server
 .ffmpeg-cache
+.ffprobe-cache

backend

@@ -18,31 +18,12 @@ protocols:
       - echoplayer
 icon: icons
 files:
-  - '!**/.vscode/*'
-  - '!src/*'
-  - '!electron.vite.config.{js,ts,mjs,cjs}'
-  - '!{.eslintcache,eslint.config.mjs,.prettierignore,.prettierrc.yaml,dev-app-update.yml,CHANGELOG.md,README.md}'
-  - '!{.env,.env.*,.npmrc,pnpm-lock.yaml}'
-  - '!{tsconfig.json,tsconfig.node.json,tsconfig.web.json}'
-  - '!docs'
-  - '!scripts'
-  - '!.swc'
-  - '!.bin'
-  - '!*.log'
-  - '!*.md'
-  - '!**/*.{iml,o,hprof,orig,pyc,pyo,rbc,swp,csproj,sln,xproj}'
-  - '!**/*.{spec,test}.{js,jsx,ts,tsx}'
-  - '!**/*.min.*.map'
-  - '!**/*.d.ts'
-  - '!**/dist/es6/**'
-  - '!**/dist/demo/**'
-  - '!**/*.{h,iobj,ipdb,tlog,recipe,vcxproj,vcxproj.filters,Makefile,*.Makefile}' # filter .node build files
-  - '!**/{.DS_Store,Thumbs.db,thumbs.db,__pycache__}'
-  # 修复包含规则 - 需要排除不必要的文件但保留迁移文件
-  - '!**/*.{map,ts,tsx,jsx,less,scss,sass,css.d.ts,d.cts,d.mts,md,markdown,yaml,yml}'
-  - '!db/**/*.{ts,md,yaml,yml}' # 排除 db 目录中的非 js 文件
-  - '!**/{test,tests,__tests__,powered-test,coverage}/**'
-  - '!**/{example,examples}/**'
+  - from: .
+    filter:
+      - 'out/**' # 渲染进程打包后文件
+      - 'resources/**' # 运行时资源（如果需要）
+      - 'package.json'
+      - '!**/*.map'
 asarUnpack:
   - resources/**
   - '**/*.{metal,exp,lib}'

electron-builder.yml

@@ -66,39 +66,43 @@ export default defineConfig({
           }
 
           // 需要排除的文件和目录
-          const excludePatterns = [
-            '__pycache__',
-            '.pyc',
-            '.pyo',
-            '.pyd',
-            '.venv',
-            'venv',
-            'env',
-            '.git',
-            '.gitignore',
-            'cache',
-            '.vscode',
-            '.idea',
-            '.egg-info',
-            'dist',
-            'build',
-            '.pytest_cache',
-            '.mypy_cache',
-            '.ruff_cache',
-            'uv.lock',
-            '.DS_Store',
-            'assets'
+          const excludeDirPatterns = [
+            /^__pycache__$/,
+            /^\.venv$/,
+            /^venv$/,
+            /^env$/,
+            /^\.git$/,
+            /^\.gitignore$/,
+            /^\.vscode$/,
+            /^\.idea$/,
+            /^\.pytest_cache$/,
+            /^\.mypy_cache$/,
+            /^\.ruff_cache$/,
+            /^cache$/,
+            /^dist$/,
+            /^build$/,
+            /^assets$/,
+            /\.egg-info$/
           ]
+          const excludeFileNames = new Set(['uv.lock', '.gitignore', '.DS_Store'])
+          const excludeFileSuffixes = ['.pyc', '.pyo', '.pyd']
 
           // 检查是否应排除
-          const shouldExclude = (filePath: string): boolean => {
-            const basename = path.basename(filePath)
-            return excludePatterns.some((pattern) => {
-              if (pattern.startsWith('.') && !pattern.includes('_')) {
-                return basename.endsWith(pattern) || basename === pattern
+          const shouldExclude = (entry: fs.Dirent): boolean => {
+            const { name } = entry
+
+            if (entry.isDirectory()) {
+              return excludeDirPatterns.some((pattern) => pattern.test(name))
+            }
+
+            if (entry.isFile()) {
+              if (excludeFileNames.has(name)) {
+                return true
               }
-              return basename.includes(pattern)
-            })
+              return excludeFileSuffixes.some((suffix) => name.endsWith(suffix))
+            }
+
+            return false
           }
 
           // 递归复制目录
@@ -113,7 +117,7 @@ export default defineConfig({
               const srcPath = path.join(src, entry.name)
               const destPath = path.join(dest, entry.name)
 
-              if (shouldExclude(srcPath)) {
+              if (shouldExclude(entry)) {
                 continue
               }
 

electron.vite.config.ts

@@ -90,6 +90,44 @@ export enum IpcChannel {
   FfmpegDownload_GetAllVersions = 'ffmpeg-download:get-all-versions',
   FfmpegDownload_CleanupTemp = 'ffmpeg-download:cleanup-temp',
 
+  // FFprobe 相关 IPC 通道 / FFprobe related IPC channels
+  Ffprobe_GetPath = 'ffprobe:get-path',
+  Ffprobe_CheckExists = 'ffprobe:check-exists',
+  Ffprobe_GetVersion = 'ffprobe:get-version',
+  Ffprobe_GetInfo = 'ffprobe:get-info',
+
+  // FFprobe 下载相关 IPC 通道 / FFprobe download related IPC channels
+  FfprobeDownload_CheckExists = 'ffprobe-download:check-exists',
+  FfprobeDownload_GetVersion = 'ffprobe-download:get-version',
+  FfprobeDownload_Download = 'ffprobe-download:download',
+  FfprobeDownload_GetProgress = 'ffprobe-download:get-progress',
+  FfprobeDownload_Cancel = 'ffprobe-download:cancel',
+  FfprobeDownload_Remove = 'ffprobe-download:remove',
+
+  // UV 相关 IPC 通道 / UV related IPC channels
+  UV_CheckInstallation = 'uv:check-installation',
+  UV_Download = 'uv:download',
+  UV_GetProgress = 'uv:get-progress',
+  UV_CancelDownload = 'uv:cancel-download',
+  UV_GetInfo = 'uv:get-info',
+
+  // Python 环境相关 IPC 通道 / Python environment related IPC channels
+  PythonVenv_CheckInfo = 'python-venv:check-info',
+  PythonVenv_Initialize = 'python-venv:initialize',
+  PythonVenv_ReinstallDependencies = 'python-venv:reinstall-dependencies',
+  PythonVenv_Remove = 'python-venv:remove',
+  PythonVenv_GetProgress = 'python-venv:get-progress',
+  PythonVenv_GetMediaServerPath = 'python-venv:get-media-server-path',
+
+  // Media Server 相关 IPC 通道 / Media Server related IPC channels
+  MediaServer_Start = 'media-server:start',
+  MediaServer_Stop = 'media-server:stop',
+  MediaServer_Restart = 'media-server:restart',
+  MediaServer_GetInfo = 'media-server:get-info',
+  MediaServer_GetPort = 'media-server:get-port',
+  MediaServer_CheckHealth = 'media-server:check-health',
+  MediaServer_PortChanged = 'media-server:port-changed', // 端口变更事件
+
   // MediaInfo 相关 IPC 通道 / MediaInfo related IPC channels
   MediaInfo_CheckExists = 'mediainfo:check-exists',
   MediaInfo_GetVersion = 'mediainfo:get-version',

packages/shared/IpcChannel.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared types index
+ */
+export * from './database'
+export * from './media-server'
+export * from './mediainfo'
+export * from './system'

packages/shared/types/index.ts

@@ -0,0 +1,46 @@
+/**
+ * Media Server 和 Python Venv 相关的共享类型定义
+ */
+
+/**
+ * Media Server 状态
+ */
+export type MediaServerStatus =
+  | 'stopped' // 已停止
+  | 'starting' // 正在启动
+  | 'running' // 运行中
+  | 'stopping' // 正在停止
+  | 'error' // 错误
+
+/**
+ * Media Server 信息
+ */
+export interface MediaServerInfo {
+  status: MediaServerStatus
+  pid?: number
+  port?: number
+  startTime?: number
+  uptime?: number
+  error?: string
+}
+
+/**
+ * Python 虚拟环境状态
+ */
+export interface PythonVenvInfo {
+  exists: boolean
+  venvPath?: string
+  pythonPath?: string
+  pythonVersion?: string
+  hasProjectConfig: boolean
+  hasLockfile: boolean
+}
+
+/**
+ * 环境安装进度
+ */
+export interface InstallProgress {
+  stage: 'init' | 'venv' | 'deps' | 'completed' | 'error'
+  message: string
+  percent: number
+}

packages/shared/types/media-server.ts

@@ -0,0 +1,3 @@
+// Common platform and architecture types shared across main process services.
+export type Platform = 'win32' | 'darwin' | 'linux'
+export type Arch = 'x64' | 'arm64'

packages/shared/types/system.ts

@@ -35,12 +35,12 @@ const FFMPEG_CONFIG: FFmpegDownloadConfig = {
   },
   darwin: {
     x64: {
-      url: 'https://evermeet.cx/ffmpeg/ffmpeg-6.1.zip',
+      url: 'https://evermeet.cx/ffmpeg/ffmpeg-8.0.zip',
       executable: 'ffmpeg',
       extractPath: 'ffmpeg'
     },
     arm64: {
-      url: 'https://evermeet.cx/ffmpeg/ffmpeg-6.1.zip', // 通用二进制文件
+      url: 'https://evermeet.cx/ffmpeg/ffmpeg-8.0.zip', // 通用二进制文件
       executable: 'ffmpeg',
       extractPath: 'ffmpeg'
     }