fix(stem): 修复 mac 运行时绝对软链接

Author: coderDJing

scripts/lib/demucs-runtime-portability.mjs

@@ -111,6 +111,68 @@ const inspectDarwinBinaryDependencies = ({ binaryPath }) => {
   }
 }
 
+const inspectDarwinRuntimeSymlinks = ({ runtimeDir }) => {
+  const issues = []
+  const visitDir = (currentDir) => {
+    const entries = fs.readdirSync(currentDir, { withFileTypes: true })
+    for (const entry of entries) {
+      const entryPath = path.join(currentDir, entry.name)
+      const relativePath = path.relative(runtimeDir, entryPath).replace(/\\/g, '/')
+      const stat = fs.lstatSync(entryPath)
+      if (stat.isSymbolicLink()) {
+        let rawTarget = ''
+        try {
+          rawTarget = fs.readlinkSync(entryPath)
+        } catch (error) {
+          issues.push(
+            `${relativePath} -> <unreadable> (${toErrorText(
+              error instanceof Error ? error.message : String(error || 'unknown')
+            )})`
+          )
+          continue
+        }
+        const normalizedTarget = String(rawTarget || '').trim()
+        if (!normalizedTarget) {
+          issues.push(`${relativePath} -> <empty>`)
+          continue
+        }
+        if (path.isAbsolute(normalizedTarget)) {
+          issues.push(`${relativePath} -> ${normalizedTarget} (absolute symlink)`)
+          continue
+        }
+        const resolvedTarget = path.resolve(path.dirname(entryPath), normalizedTarget)
+        if (!isPathInside(runtimeDir, resolvedTarget)) {
+          issues.push(`${relativePath} -> ${normalizedTarget} (escapes runtime root)`)
+          continue
+        }
+        if (!fs.existsSync(resolvedTarget)) {
+          issues.push(`${relativePath} -> ${normalizedTarget} (missing target)`)
+        }
+        continue
+      }
+      if (stat.isDirectory()) {
+        visitDir(entryPath)
+      }
+    }
+  }
+
+  try {
+    visitDir(runtimeDir)
+  } catch (error) {
+    return {
+      ok: false,
+      issues: [],
+      error: toErrorText(error instanceof Error ? error.message : String(error || 'unknown'))
+    }
+  }
+
+  return {
+    ok: issues.length === 0,
+    issues,
+    error: ''
+  }
+}
+
 const isAllowedDarwinDependency = (runtimeDir, dependencyPath) => {
   const normalizedDependency = String(dependencyPath || '').trim()
   if (!normalizedDependency) return true
@@ -204,6 +266,21 @@ export const validatePortableDarwinRuntime = ({ runtimeDir, pythonPath, env }) =
     }
   }
 
+  const symlinkCheck = inspectDarwinRuntimeSymlinks({
+    runtimeDir
+  })
+  if (!symlinkCheck.ok) {
+    const symlinkIssue = symlinkCheck.issues.slice(0, 5).join(' | ')
+    return {
+      ok: false,
+      payload: {
+        ...identity.payload,
+        dependencies: dependencyCheck.dependencies
+      },
+      error: symlinkCheck.error || `runtime symlink issues: ${symlinkIssue}`
+    }
+  }
+
   return {
     ok: true,
     payload: {

scripts/lib/demucs-runtime-support.mjs

@@ -9,6 +9,12 @@ let runtimeDownloadProxyInitialized = false
 let runtimeDownloadProxyDispatcher
 let runtimeDownloadProxySource = ''
 
+const buildPortableRuntimeCopyOptions = () => ({
+  recursive: true,
+  force: true,
+  ...(process.platform === 'darwin' ? { verbatimSymlinks: true } : {})
+})
+
 const formatErrorWithCause = (error, toShortText) => {
   const parts = []
   let current = error
@@ -556,7 +562,7 @@ const installRuntimeProfileFromAsset = async ({
       throw error
     }
     fs.rmSync(runtimeDir, { recursive: true, force: true })
-    fs.cpSync(extractedRuntimeDir, runtimeDir, { recursive: true, force: true })
+    fs.cpSync(extractedRuntimeDir, runtimeDir, buildPortableRuntimeCopyOptions())
     fs.rmSync(extractedRuntimeDir, { recursive: true, force: true })
   }
   writeRemoteAssetState(runtimeDir, entry)

scripts/lib/demucs-standalone-python.mjs

@@ -16,6 +16,12 @@ const DARWIN_TARGET_TRIPLE_BY_PLATFORM = {
   'darwin-x64': 'x86_64-apple-darwin'
 }
 
+const buildPortableRuntimeCopyOptions = () => ({
+  recursive: true,
+  force: true,
+  verbatimSymlinks: true
+})
+
 const resolveStandaloneArchiveSpec = (platformKey) => {
   const targetTriple = DARWIN_TARGET_TRIPLE_BY_PLATFORM[platformKey]
   if (!targetTriple) {
@@ -115,10 +121,7 @@ export const bootstrapPortableDarwinPython = async ({
       throw error
     }
     await fs.promises.rm(targetRuntimeDir, { recursive: true, force: true }).catch(() => {})
-    fs.cpSync(extractedRuntimeDir, targetRuntimeDir, {
-      recursive: true,
-      force: true
-    })
+    fs.cpSync(extractedRuntimeDir, targetRuntimeDir, buildPortableRuntimeCopyOptions())
     await fs.promises.rm(extractedRuntimeDir, { recursive: true, force: true }).catch(() => {})
   } finally {
     await fs.promises.rm(extractRoot, { recursive: true, force: true }).catch(() => {})

scripts/prepare-demucs-runtimes.mjs

@@ -397,6 +397,11 @@ const writeJson = (filePath, data) => {
   fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8')
 }
 
+const buildPortableRuntimeCopyOptions = () => ({
+  recursive: true,
+  ...(process.platform === 'darwin' ? { verbatimSymlinks: true } : {})
+})
+
 for (const [profileName, profileConfig] of selectedProfiles) {
   const targetDirName = String(profileConfig.targetDir || `runtime-${profileName}`)
   const targetRuntimeDir = path.resolve(runtimeRoot, platformArg, targetDirName)
@@ -435,7 +440,7 @@ for (const [profileName, profileConfig] of selectedProfiles) {
   }
 
   if (!fs.existsSync(targetRuntimeDir)) {
-    fs.cpSync(baseRuntimeDir, targetRuntimeDir, { recursive: true })
+    fs.cpSync(baseRuntimeDir, targetRuntimeDir, buildPortableRuntimeCopyOptions())
     console.log(`[demucs-runtime] Copied base runtime -> ${targetDirName}`)
   }