fix(build): 自动准备本地媒体工具资源

Author: coderDJing

.github/workflows/release.yml

@@ -129,6 +129,9 @@ jobs:
           Remove-Item fpcalc.zip -Force
           Remove-Item fpcalc_unzip -Recurse -Force
 
+      - name: Validate bundled media tools (Windows)
+        run: node scripts/validate-bundled-media-tools.mjs --mode package --platform-key win32-x64
+
       - name: Build Rust N-API (rust_package)
         working-directory: rust_package
         run: npx --yes @napi-rs/cli@2.18.4 build --platform --release --target x86_64-pc-windows-msvc
@@ -420,6 +423,9 @@ jobs:
           rm -rf fpcalc-mac.tar.gz chromaprint-fpcalc-${CHROMAPRINT_VERSION}-macos-universal
           ls -l vendor/chromaprint/darwin
 
+      - name: Validate bundled media tools (macOS)
+        run: node scripts/validate-bundled-media-tools.mjs --mode package --platform-key darwin-universal
+
       - name: Build Rust N-API for mac (both arch)
         working-directory: rust_package
         run: |

package.json

@@ -147,11 +147,18 @@
     "dev": "node scripts/run-frkb-dev.mjs",
     "dev:release-runtime": "node scripts/run-frkb-dev.mjs --release-runtime",
     "build": "electron-vite build",
+    "media-tools:ensure": "node scripts/ensure-bundled-media-tools.mjs --mode dev",
+    "media-tools:ensure:package": "node scripts/ensure-bundled-media-tools.mjs --mode package",
+    "media-tools:ensure:win": "node scripts/ensure-bundled-media-tools.mjs --mode package --platform-key win32-x64",
+    "media-tools:validate": "node scripts/validate-bundled-media-tools.mjs --mode dev",
+    "media-tools:validate:package": "node scripts/validate-bundled-media-tools.mjs --mode package",
+    "media-tools:validate:win": "node scripts/validate-bundled-media-tools.mjs --mode package --platform-key win32-x64",
+    "media-tools:validate:mac-universal": "node scripts/validate-bundled-media-tools.mjs --mode package --platform-key darwin-universal",
     "postinstall": "electron-builder install-app-deps",
     "clean": "rimraf dist",
-    "build:unpack": "npm run build && npm run rekordbox:runtime:ensure && npm run rekordbox:runtime:validate && electron-builder --dir",
-    "build:win": "npm run clean && npm run build && npm run rekordbox:runtime:ensure && npm run rekordbox:runtime:validate && electron-builder --win",
-    "build:mac": "npm run clean && npm run build && npm run rekordbox:runtime:ensure:mac-universal && npm run rekordbox:runtime:validate:mac-universal && electron-builder --mac",
+    "build:unpack": "npm run media-tools:ensure:package && npm run build && npm run rekordbox:runtime:ensure && npm run rekordbox:runtime:validate && electron-builder --dir",
+    "build:win": "npm run clean && npm run media-tools:ensure:win && npm run build && npm run rekordbox:runtime:ensure && npm run rekordbox:runtime:validate && electron-builder --win",
+    "build:mac": "npm run clean && npm run media-tools:validate:mac-universal && npm run build && npm run rekordbox:runtime:ensure:mac-universal && npm run rekordbox:runtime:validate:mac-universal && electron-builder --mac",
     "build:linux": "npm run clean && npm run build && electron-builder --linux",
     "demucs:runtime:prepare": "node scripts/prepare-demucs-runtimes.mjs",
     "demucs:runtime:ensure": "node scripts/ensure-demucs-runtime.mjs",

scripts/ensure-bundled-media-tools.mjs

@@ -0,0 +1,27 @@
+import {
+  ensureBundledMediaTools,
+  logMediaToolsValidationResult,
+  parseMediaToolsCliOptions
+} from './lib/media-tools.mjs'
+
+try {
+  const options = parseMediaToolsCliOptions(process.argv.slice(2))
+  const result = await ensureBundledMediaTools(options)
+  if (result.changed) {
+    console.log(
+      `[media-tools] Auto-prepared bundled tools for ${result.platformKey} under ${result.vendorRoot}`
+    )
+  }
+  if (!logMediaToolsValidationResult(result)) {
+    process.exit(1)
+  }
+} catch (error) {
+  const message =
+    error instanceof Error
+      ? [String(error.message || '').trim(), String(error.cause || '').trim()]
+          .filter(Boolean)
+          .join('\n')
+      : String(error || 'unknown error')
+  console.error(message)
+  process.exit(1)
+}