dsh-drawai 0.4.1 → 0.4.2

package/lib/motion-project.js

@@ -1,87 +1,106 @@
 /* 由 tools/build.mjs 生成 —— 请勿直接编辑；改 src/ 下的源文件。 */
-import { existsSync, mkdirSync, writeFileSync, readFileSync, realpathSync } from 'node:fs'
-import { join, dirname, resolve, relative, isAbsolute } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { videoRuntimeRequire } from './motion/video-runtime.js'
-import { validateMotionSources, sceneComponentPath } from './motion-source.js'
-import { shotcraftModuleMap } from './motion-library.js'
-import { enforceMotionCards } from './motion-library.js'
-import { enforceMgStyle } from './motion-library.js'
-import { validateMotionPlan } from './motion-core.js'
-import { parseProjectJson } from './motion/json.js'
-
-// Agent projects are edited on disk. Read their sources before validating or
-// building; never restore a stale inline source over an agent's changes.
-export function readMotionProject(directory, input) {
-  const root=realpathSync(directory)
-  const read=(name)=>{
-    const file=realpathSync(join(root,name)),rel=relative(root,file)
-    if(isAbsolute(rel)||rel==='..'||/^\.\.[\\/]/.test(rel))throw new Error('工程文件超出任务目录')
-    return readFileSync(file,'utf8')
-  }
-  const raw=parseProjectJson(read('composition.json'))
-  if(!Array.isArray(raw.shots))throw new Error('工程缺少 shots 分镜')
-  raw.shots=raw.shots.map((shot,index)=>({...shot,sceneSource:read('scene-'+index+'.tsx'),
-    ...(shot.sceneComponents?{sceneComponents:shot.sceneComponents.map(c=>({...c,source:read(sceneComponentPath('shot-'+(index+1),c.id))}))}:{})}))
-  return enforceMgStyle(enforceMotionCards(validateMotionSources(validateMotionPlan(raw,input)),input),input)
-}
-
-export function prepareMotionProject(composition, directory, options = {}) {
-  validateMotionSources(composition)
-  mkdirSync(directory, { recursive: true })
-  const imports = [], entries = []
-  composition.shots.forEach((shot, index) => {
-    if (shot.recipeId !== 'scene') return
-    const name = 'scene-' + index + '.tsx'
-    if(!options.preserveSources)writeFileSync(join(directory, name), shot.sceneSource)
-    for (const component of shot.sceneComponents || []) {
-      const file = join(directory, sceneComponentPath(shot.id, component.id))
-      mkdirSync(dirname(file), { recursive: true })
-      if(!options.preserveSources)writeFileSync(file, component.source)
-    }
-    imports.push(`import Scene${index} from './${name}';`)
-    entries.push(`${JSON.stringify(shot.id)}:Scene${index}`)
-  })
-  const runtime = fileURLToPath(new URL('./motion/entry.jsx', import.meta.url)).replaceAll('\\', '/')
-  const entryPoint = join(directory, 'index.jsx')
-  if(!options.preserveSources||options.refreshEntry||!existsSync(entryPoint))writeFileSync(entryPoint, `import {registerMotionRoot} from ${JSON.stringify(runtime)};\n${imports.join('\n')}\nregisterMotionRoot({${entries.join(',')}});\n`)
-  if(!options.preserveSources)writeFileSync(join(directory, 'composition.json'), JSON.stringify(composition, null, 2))
-  if (composition.production && !options.preserveSources) {
-    writeFileSync(join(directory, 'design.json'), JSON.stringify(composition.production, null, 2))
-    writeFileSync(join(directory, 'storyboard.json'), JSON.stringify(composition.shots.map(({ sceneSource: _source, sceneComponents, ...shot }) => ({ ...shot,
-      ...(sceneComponents ? { components: sceneComponents.map(({ source: _code, ...component }) => component) } : {}) })), null, 2))
-  }
-  const alias = Object.fromEntries(Object.entries(shotcraftModuleMap()).map(([name, url]) => [name + '$', fileURLToPath(url)]))
-  // Demos use paths relative to the upstream repository. Generated components
-  // live elsewhere: resolve known library paths without rewriting their source.
-  const library = shotcraftModuleMap()
-  const libraryImports = { apply(compiler) {
-    compiler.hooks.normalModuleFactory.tap('DrawAiShotcraftImports', (factory) => {
-      factory.hooks.beforeResolve.tap('DrawAiShotcraftImports', (request) => {
-        if (!request?.request?.startsWith('.')) return
-        const local = relative(resolve(directory), resolve(request.context))
-        if (isAbsolute(local) || local === '..' || /^\.\.[\\/]/.test(local)) return
-        const stem = resolve(request.context, request.request)
-        if (['', '.tsx', '.ts', '.jsx', '.js', '/index.tsx', '/index.ts', '/index.js'].some((ext) => existsSync(stem + ext))) return
-        const path = request.request.replaceAll('\\', '/').replace(/^(?:\.\.?\/)+/, '').replace(/\.(tsx?|jsx?)$/, '')
-        const name = path.startsWith('demos/') ? '@shotcraft/' + path
-          : path.startsWith('_fixtures/') ? '@shotcraft/demos/' + path
-          : path.startsWith('assets/lib/') ? '@shotcraft/lib/' + path.slice('assets/lib/'.length)
-          : path.startsWith('lib/') ? '@shotcraft/' + path : ''
-        if (Object.hasOwn(library, name)) request.request = fileURLToPath(library[name])
-      })
-    })
-  } }
-  alias['@drawai/motion$'] = fileURLToPath(new URL('./motion/reference-media.jsx', import.meta.url))
-  // Resolve the runtime lazily: creating a project only writes its files, and
-  // the video runtime may not be initialized yet (it is installed on first use).
-  const runtimeModules = () => {
-    const require = videoRuntimeRequire(options.runtimeDirectory)
-    return [...new Set(['react', 'remotion', '@remotion/motion-blur'].map((name) => dirname(require.resolve(name + '/package.json')).replace(/[\\/]@remotion[\\/][^\\/]+$/, '').replace(/[\\/](?:react|remotion)$/, '')))]
-  }
-  return { entryPoint, webpackOverride: (config) => {
-    const modules = runtimeModules()
-    return { ...config, plugins: [...(config.plugins || []), libraryImports], resolve: { ...config.resolve,
-      alias: { ...config.resolve?.alias, ...alias }, modules: [...modules, ...(config.resolve?.modules || ['node_modules'])] } }
-  } }
-}
+import { existsSync, mkdirSync, writeFileSync, readFileSync, realpathSync } from 'node:fs'
+import { join, dirname, resolve, relative, isAbsolute } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { videoRuntimeRequire } from './motion/video-runtime.js'
+import { validateMotionSources, sceneComponentPath } from './motion-source.js'
+import { shotcraftModuleMap } from './motion-library.js'
+import { enforceMotionCards } from './motion-library.js'
+import { enforceMgStyle } from './motion-library.js'
+import { validateMotionPlan } from './motion-core.js'
+import { parseProjectJson } from './motion/json.js'
+
+// Agent projects are edited on disk. Read their sources before validating or
+// building; never restore a stale inline source over an agent's changes.
+export function readMotionProject(directory, input) {
+  const root=realpathSync(directory)
+  const read=(name)=>{
+    const file=realpathSync(join(root,name)),rel=relative(root,file)
+    if(isAbsolute(rel)||rel==='..'||/^\.\.[\\/]/.test(rel))throw new Error('工程文件超出任务目录')
+    return readFileSync(file,'utf8')
+  }
+  const raw=parseProjectJson(read('composition.json'))
+  if(!Array.isArray(raw.shots))throw new Error('工程缺少 shots 分镜')
+  raw.shots=raw.shots.map((shot,index)=>({...shot,sceneSource:read('scene-'+index+'.tsx'),
+    ...(shot.sceneComponents?{sceneComponents:shot.sceneComponents.map(c=>({...c,source:read(sceneComponentPath('shot-'+(index+1),c.id))}))}:{})}))
+  return enforceMgStyle(enforceMotionCards(validateMotionSources(validateMotionPlan(raw,input)),input),input)
+}
+
+// 入口与运行时 JSX 的源文件在插件里，但它们**必须被复制到工程目录**再引用：
+// Remotion 的 webpack 只给 .tsx?/.ts 挂 esbuild-loader，配 .jsx? 的那条规则显式
+// exclude /node_modules/ —— 插件装在 profile 的 node_modules 下时，入口 JSX 会被当成
+// 普通文本解析，报 "Unexpected token (<AbsoluteFill>)"（issue #21、#22）。
+const RUNTIME_ENTRY = fileURLToPath(new URL('./motion/entry.jsx', import.meta.url))
+const RUNTIME_REFERENCE = fileURLToPath(new URL('./motion/reference-media.jsx', import.meta.url))
+const GENERATED_HEADER = '// 由 dsh-drawai 生成，请勿手改；插件更新后会按源文件重新生成。\n'
+
+// 只在内容变化时写盘：保持 mtime 稳定，bundle 缓存才不会每次重建。
+function writeGenerated(file, source) {
+  const desired = GENERATED_HEADER + source
+  if (existsSync(file) && readFileSync(file, 'utf8') === desired) return
+  mkdirSync(dirname(file), { recursive: true })
+  writeFileSync(file, desired)
+}
+
+export function prepareMotionProject(composition, directory, options = {}) {
+  validateMotionSources(composition)
+  mkdirSync(directory, { recursive: true })
+  const imports = [], entries = []
+  composition.shots.forEach((shot, index) => {
+    if (shot.recipeId !== 'scene') return
+    const name = 'scene-' + index + '.tsx'
+    if(!options.preserveSources)writeFileSync(join(directory, name), shot.sceneSource)
+    for (const component of shot.sceneComponents || []) {
+      const file = join(directory, sceneComponentPath(shot.id, component.id))
+      mkdirSync(dirname(file), { recursive: true })
+      if(!options.preserveSources)writeFileSync(file, component.source)
+    }
+    imports.push(`import Scene${index} from './${name}';`)
+    entries.push(`${JSON.stringify(shot.id)}:Scene${index}`)
+  })
+  writeGenerated(join(directory, 'entry.gen.jsx'), readFileSync(RUNTIME_ENTRY, 'utf8'))
+  writeGenerated(join(directory, 'reference-media.gen.jsx'), readFileSync(RUNTIME_REFERENCE, 'utf8'))
+  const entryPoint = join(directory, 'index.jsx')
+  const entrySource = `import {registerMotionRoot} from './entry.gen.jsx';\n${imports.join('\n')}\nregisterMotionRoot({${entries.join(',')}});\n`
+  // 入口本身就是生成的：内容变了（换插件路径、增删镜头）就重写，不看 preserveSources。
+  if(!existsSync(entryPoint) || readFileSync(entryPoint, 'utf8') !== entrySource)writeFileSync(entryPoint, entrySource)
+  if(!options.preserveSources)writeFileSync(join(directory, 'composition.json'), JSON.stringify(composition, null, 2))
+  if (composition.production && !options.preserveSources) {
+    writeFileSync(join(directory, 'design.json'), JSON.stringify(composition.production, null, 2))
+    writeFileSync(join(directory, 'storyboard.json'), JSON.stringify(composition.shots.map(({ sceneSource: _source, sceneComponents, ...shot }) => ({ ...shot,
+      ...(sceneComponents ? { components: sceneComponents.map(({ source: _code, ...component }) => component) } : {}) })), null, 2))
+  }
+  const alias = Object.fromEntries(Object.entries(shotcraftModuleMap()).map(([name, url]) => [name + '$', fileURLToPath(url)]))
+  // Demos use paths relative to the upstream repository. Generated components
+  // live elsewhere: resolve known library paths without rewriting their source.
+  const library = shotcraftModuleMap()
+  const libraryImports = { apply(compiler) {
+    compiler.hooks.normalModuleFactory.tap('DrawAiShotcraftImports', (factory) => {
+      factory.hooks.beforeResolve.tap('DrawAiShotcraftImports', (request) => {
+        if (!request?.request?.startsWith('.')) return
+        const local = relative(resolve(directory), resolve(request.context))
+        if (isAbsolute(local) || local === '..' || /^\.\.[\\/]/.test(local)) return
+        const stem = resolve(request.context, request.request)
+        if (['', '.tsx', '.ts', '.jsx', '.js', '/index.tsx', '/index.ts', '/index.js'].some((ext) => existsSync(stem + ext))) return
+        const path = request.request.replaceAll('\\', '/').replace(/^(?:\.\.?\/)+/, '').replace(/\.(tsx?|jsx?)$/, '')
+        const name = path.startsWith('demos/') ? '@shotcraft/' + path
+          : path.startsWith('_fixtures/') ? '@shotcraft/demos/' + path
+          : path.startsWith('assets/lib/') ? '@shotcraft/lib/' + path.slice('assets/lib/'.length)
+          : path.startsWith('lib/') ? '@shotcraft/' + path : ''
+        if (Object.hasOwn(library, name)) request.request = fileURLToPath(library[name])
+      })
+    })
+  } }
+  alias['@drawai/motion$'] = join(directory, 'reference-media.gen.jsx')
+  // Resolve the runtime lazily: creating a project only writes its files, and
+  // the video runtime may not be initialized yet (it is installed on first use).
+  const runtimeModules = () => {
+    const require = videoRuntimeRequire(options.runtimeDirectory)
+    return [...new Set(['react', 'remotion', '@remotion/motion-blur'].map((name) => dirname(require.resolve(name + '/package.json')).replace(/[\\/]@remotion[\\/][^\\/]+$/, '').replace(/[\\/](?:react|remotion)$/, '')))]
+  }
+  return { entryPoint, webpackOverride: (config) => {
+    const modules = runtimeModules()
+    return { ...config, plugins: [...(config.plugins || []), libraryImports], resolve: { ...config.resolve,
+      alias: { ...config.resolve?.alias, ...alias }, modules: [...modules, ...(config.resolve?.modules || ['node_modules'])] } }
+  } }
+}

package/lib/motion-render-worker.js

@@ -1,153 +1,175 @@
 /* 由 tools/build.mjs 生成 —— 请勿直接编辑；改 src/ 下的源文件。 */
-import { ensureVideoRuntime, videoRuntimeRequire } from './motion/video-runtime.js'
-import { existsSync, rmSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { dirname, join, relative, isAbsolute, resolve } from 'node:path'
-import { createHash } from 'node:crypto'
-import { prepareMotionProject } from './motion-project.js'
-import { runFfmpeg } from './motion/ffmpeg.js'
-
-let cancelled = false, running = false
-const runtimeAbort = new AbortController()
-let cancel = () => {}
-const send = (message) => { if (process.connected) process.send(message) }
-process.on('message', async (request) => {
-  if (request.type === 'cancel') { cancelled = true; runtimeAbort.abort(new Error('已取消动效生成')); cancel(); return }
-  if (running) return
-  running = true
-  let browser
-  const outDir = request.bundleDir || join(dirname(request.output), 'bundle')
-  const cacheFile = join(outDir, '.drawai-bundle-key')
-  try {
-    const runtimeDirectory = await ensureVideoRuntime({signal:runtimeAbort.signal, onProgress:message => send({type:'progress', ...message, progress:0})})
-    if (cancelled) throw new Error('已取消动效生成')
-    const require = videoRuntimeRequire(runtimeDirectory)
-    const { bundle } = require('@remotion/bundler')
-    const { openBrowser, selectComposition, renderMedia, renderStill, makeCancelSignal } = require('@remotion/renderer')
-    const cancellation = makeCancelSignal()
-    const cancelSignal = cancellation.cancelSignal
-    cancel = cancellation.cancel
-    // 同一个工程连续预览/渲染时复用上次的 bundle：预览从 30 秒降到 3 秒，
-    // 改一个场景文件只会让 key 变化一次。request.bundleKey 由调用方按源码计算。
-    const reuse = request.reuseBundle === true && request.bundleKey && existsSync(join(outDir, 'index.html'))
-      && existsSync(cacheFile) && readFileSync(cacheFile, 'utf8').trim() === request.bundleKey
-    let serveUrl
-    if (reuse) {
-      serveUrl = outDir
-      send({ type: 'progress', phase: 'bundling', progress: .1 })
-    } else {
-      const project = prepareMotionProject(request.composition, request.projectDirectory || join(dirname(request.output), 'project'), {preserveSources:request.preserveSources===true, runtimeDirectory})
-      serveUrl = await bundle({ ...project, outDir, ignoreRegisterRootWarning: true,
-        publicDir: request.publicDir, onProgress: (progress) => send({ type: 'progress', phase: 'bundling', progress: progress / 100 * .1 }) })
-      const index = join(outDir, 'index.html')
-      writeFileSync(index, readFileSync(index, 'utf8').replace('<head>', '<head><meta http-equiv="Content-Security-Policy" content="default-src \'self\' blob: data:; script-src \'self\' \'unsafe-inline\' \'unsafe-eval\'; style-src \'self\' \'unsafe-inline\'; connect-src \'self\'; img-src \'self\' blob: data:; media-src \'self\' blob:; frame-src \'none\'; object-src \'none\'">'))
-      if (request.bundleKey) writeFileSync(cacheFile, request.bundleKey)
-    }
-    if (cancelled) throw new Error('已取消动效生成')
-    // Use a configured browser, or a local Windows browser before downloading Chromium.
-    const candidates = [request.browserExecutable, process.env.DRAWAI_CHROME_PATH,
-      'C:/Program Files/Google/Chrome/Application/chrome.exe', 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe']
-    const browserExecutable = candidates.find((path) => path && existsSync(path))
-    browser = await openBrowser('chrome', { browserExecutable, logLevel: 'error' })
-    if (cancelled) throw new Error('已取消动效生成')
-    const inputProps = { plan: request.composition, assets: request.assets }
-    const composition = await selectComposition({ serveUrl, id: 'DrawAiMotion', inputProps, browserInstance: browser })
-    if(request.operation==='compile'){send({type:'done',compiled:true});return}
-    send({ type: 'progress', phase: 'reviewing', progress: .1 })
-    const qaDirectory = request.qaDirectory || join(dirname(request.output), 'qa'); mkdirSync(qaDirectory, { recursive: true })
-    const audioCues = Array.isArray(request.composition?.audio) ? request.composition.audio : []
-    const qa = { status: 'render-checks-passed', visualReview: 'manual-required', audio: audioCues.length ? 'mixed:' + audioCues.length : 'silent', frames: [], warnings: [] }
-    if(request.operation==='still'){
-      const frames=[]
-      for(const frame of request.frames){
-        if(!Number.isInteger(frame)||frame<0||frame>=composition.durationInFrames)throw new Error('截图帧超出成片')
-        const filename='agent-frame-'+frame+'.png'
-        await renderStill({serveUrl,composition,inputProps,output:join(qaDirectory,filename),frame,browserInstance:browser,cancelSignal,logLevel:'error'})
-        frames.push({frame,filename,sha256:createHash('sha256').update(readFileSync(join(qaDirectory,filename))).digest('hex')})
-      }
-      send({type:'done',frames});return
-    }
-    for (const shot of request.composition.shots) {
-      const hashes = []
-      for (const fraction of (shot.motionCards?.length ? [0, .25, .5, .75, .98] : [.25, .7])) {
-        const frame = shot.startFrame + Math.min(shot.durationFrames - 1, Math.floor(shot.durationFrames * fraction))
-        const filename = shot.id + '-' + frame + '.png'
-        await renderStill({ serveUrl, composition, inputProps, output: join(qaDirectory, filename), frame, browserInstance: browser, cancelSignal, logLevel: 'error', timeoutInMilliseconds: 30000 })
-        const bytes = readFileSync(join(qaDirectory, filename))
-        const hash = createHash('sha256').update(bytes).digest('hex'); hashes.push(hash)
-        qa.frames.push({ shotId: shot.id, frame, filename, fraction, sha256: hash })
-      }
-      if (hashes[0] === hashes[1]) qa.warnings.push(shot.id + ': 两张采样帧相同，请检查主运动或停留段')
-    }
-    // 渲染规格随请求进来（由 render.js 的 resolveRenderSettings 解析过）：
-    // 编码参数、色彩标签、超采样倍数、并发都在这里唯一地落到 renderMedia 上。
-    const settings = request.render || {}
-    qa.render = settings
-    writeFileSync(join(qaDirectory, 'report.json'), JSON.stringify(qa, null, 2))
-    const scale = Number(settings.scale) > 1 ? Math.round(Number(settings.scale)) : 1
-    const finalOutput = request.output
-    // 超采样：Remotion 的 scale 是「渲成更大」，不会替你缩回来。
-    // 所以大图先落到临时文件，再用一次 lanczos + bt709 的母版编码缩回目标尺寸。
-    const rawOutput = scale > 1 ? join(dirname(finalOutput), '.supersample.mp4') : finalOutput
-    const startedAt = Date.now()
-    let seenFrames = 0
-    const totalFrames = request.frameRange
-      ? request.frameRange[1] - request.frameRange[0] + 1
-      : composition.durationInFrames
-    await renderMedia({ serveUrl, composition, inputProps, outputLocation: rawOutput,
-      codec: settings.codec || 'h264',
-      ...(settings.crf ? { crf: settings.crf } : {}),
-      ...(settings.preset ? { x264Preset: settings.preset } : {}),
-      ...(settings.pixelFormat ? { pixelFormat: settings.pixelFormat } : {}),
-      ...(settings.colorSpace ? { colorSpace: settings.colorSpace } : {}),
-      ...(settings.audioBitrate ? { audioBitrate: settings.audioBitrate } : {}),
-      scale,
-      concurrency: settings.concurrency || 2,
-      ...(request.frameRange?{frameRange:request.frameRange}:{}),
-      browserInstance: browser, cancelSignal, logLevel: 'error',
-      onProgress: ({ progress, renderedFrames }) => {
-        const done = Number(renderedFrames) || 0
-        if (done > seenFrames) seenFrames = done
-        const elapsed = (Date.now() - startedAt) / 1000
-        const perFrame = seenFrames > 0 ? elapsed / seenFrames : null
-        // 单帧耗时是「样本数该开多大」的唯一依据：没有它，超采样只能靠猜。
-        send({ type: 'progress', phase: 'rendering', progress: .1 + progress * .85,
-          frames: { done: seenFrames, total: totalFrames,
-            perFrameSeconds: perFrame ? Math.round(perFrame * 1000) / 1000 : null,
-            etaSeconds: perFrame ? Math.round(perFrame * Math.max(totalFrames - seenFrames, 0)) : null } })
-      } })
-    if (scale > 1) {
-      send({ type: 'progress', phase: 'encoding', progress: .96 })
-      // 这一趟本来就是重编码，顺手把 bt709 三标签补全。
-      // 注意：这个 ffmpeg 构建里 -color_primaries / -color_trc 当**输出选项**不生效
-      // （连续实测：只剩 colorspace 标签，primaries/trc 仍是 unknown），必须走 setparams 滤镜改帧元数据。
-      const colorFilter = settings.colorSpace === 'bt709'
-        ? ',setparams=color_primaries=bt709:color_trc=bt709:colorspace=bt709' : ''
-      await runFfmpeg(['-i', rawOutput,
-        '-vf', 'scale=' + composition.width + ':' + composition.height + ':flags=lanczos+accurate_rnd+full_chroma_int' + colorFilter,
-        '-c:v', 'libx264', '-crf', String(settings.crf || 14), '-preset', String(settings.preset || 'slow'),
-        '-profile:v', 'high', '-pix_fmt', 'yuv420p',
-        '-colorspace', 'bt709', '-color_primaries', 'bt709', '-color_trc', 'bt709',
-        '-c:a', 'copy', '-movflags', '+faststart', finalOutput],
-        { cwd: dirname(finalOutput), log: join(dirname(finalOutput), 'encode.log'), timeoutMs: 900000 })
-      rmSync(rawOutput, { force: true })
-      qa.supersample = { from: composition.width * scale + 'x' + composition.height * scale, to: composition.width + 'x' + composition.height }
-      qa.colorTags = settings.colorSpace === 'bt709' ? 'bt709（三标签齐全）' : '未标注'
-    } else if (settings.colorSpace === 'bt709') {
-      // Remotion 只写 colorspace，primaries/trc 留 unknown；要齐全只能再重编一次，
-      // 而重编会让画质掉一代——所以 1× 下宁可把这件事说清楚，不偷偷多编一遍。
-      qa.colorTags = '仅 colorspace=bt709（primaries/trc 为 unknown；母版级标签请设 render.scale=2）'
-      qa.warnings.push('色彩标签只写了 colorspace：要 primaries/trc 齐全（严格 QC）请用 render.scale=2，那一趟重编码会一并补齐')
-    }
-    const posterShot = request.composition.shots.find((shot) => shot.referenceIds.length) || request.composition.shots[0]
-    await renderStill({ serveUrl, composition, inputProps, output: request.poster,
-      frame: posterShot.startFrame + Math.floor(posterShot.durationFrames / 2), browserInstance: browser, cancelSignal, logLevel: 'error' })
-    writeFileSync(join(qaDirectory, 'report.json'), JSON.stringify(qa, null, 2))
-    send({ type: 'done', qa })
-  } catch (error) { send({ type: 'error', error: error.message || String(error) }); process.exitCode = 1 }
-  finally {
-    await browser?.close({ silent: true }).catch(() => {})
-    const cleanup = relative(resolve(dirname(request.output)), resolve(outDir))
-    if (request.keepBundle !== true && cleanup === 'bundle' && !isAbsolute(cleanup)) rmSync(outDir, { recursive: true, force: true })
-    process.disconnect()
-  }
-})
+import { ensureVideoRuntime, videoRuntimeRequire } from './motion/video-runtime.js'
+import { existsSync, rmSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, join, relative, isAbsolute, resolve } from 'node:path'
+import { createHash } from 'node:crypto'
+import { prepareMotionProject } from './motion-project.js'
+import { runFfmpeg } from './motion/ffmpeg.js'
+
+let cancelled = false, running = false
+const runtimeAbort = new AbortController()
+let cancel = () => {}
+const send = (message) => { if (process.connected) process.send(message) }
+process.on('message', async (request) => {
+  if (request.type === 'cancel') { cancelled = true; runtimeAbort.abort(new Error('已取消动效生成')); cancel(); return }
+  if (running) return
+  running = true
+  let browser
+  const outDir = request.bundleDir || join(dirname(request.output), 'bundle')
+  const cacheFile = join(outDir, '.drawai-bundle-key')
+  try {
+    const runtimeDirectory = await ensureVideoRuntime({signal:runtimeAbort.signal, onProgress:message => send({type:'progress', ...message, progress:0})})
+    if (cancelled) throw new Error('已取消动效生成')
+    const require = videoRuntimeRequire(runtimeDirectory)
+    const { bundle } = require('@remotion/bundler')
+    const { openBrowser, selectComposition, renderMedia, renderStill, makeCancelSignal } = require('@remotion/renderer')
+    const cancellation = makeCancelSignal()
+    const cancelSignal = cancellation.cancelSignal
+    cancel = cancellation.cancel
+    // 同一个工程连续预览/渲染时复用上次的 bundle：预览从 30 秒降到 3 秒，
+    // 改一个场景文件只会让 key 变化一次。request.bundleKey 由调用方按源码计算。
+    const reuse = request.reuseBundle === true && request.bundleKey && existsSync(join(outDir, 'index.html'))
+      && existsSync(cacheFile) && readFileSync(cacheFile, 'utf8').trim() === request.bundleKey
+    let serveUrl
+    if (reuse) {
+      serveUrl = outDir
+      send({ type: 'progress', phase: 'bundling', progress: .1 })
+    } else {
+      const project = prepareMotionProject(request.composition, request.projectDirectory || join(dirname(request.output), 'project'), {preserveSources:request.preserveSources===true, runtimeDirectory})
+      serveUrl = await bundle({ ...project, outDir, ignoreRegisterRootWarning: true,
+        publicDir: request.publicDir, onProgress: (progress) => send({ type: 'progress', phase: 'bundling', progress: progress / 100 * .1 }) })
+      const index = join(outDir, 'index.html')
+      writeFileSync(index, readFileSync(index, 'utf8').replace('<head>', '<head><meta http-equiv="Content-Security-Policy" content="default-src \'self\' blob: data:; script-src \'self\' \'unsafe-inline\' \'unsafe-eval\'; style-src \'self\' \'unsafe-inline\'; connect-src \'self\'; img-src \'self\' blob: data:; media-src \'self\' blob:; frame-src \'none\'; object-src \'none\'">'))
+      if (request.bundleKey) writeFileSync(cacheFile, request.bundleKey)
+    }
+    if (cancelled) throw new Error('已取消动效生成')
+    // Use a configured browser, or a local browser before downloading Chromium.
+    // 参数名必须是 puppeteerInstance：@remotion/renderer 4.x 只认这个名字，
+    // 写成 browserInstance 会被静默忽略，然后它自己去下载 chrome-headless-shell（内网/无外网必炸）。
+    // 同时把 browserExecutable 一并传下去：万一实例没用上，也还有本机浏览器可退回，不去联网。
+    const candidates = [
+      request.browserExecutable, process.env.DRAWAI_CHROME_PATH,
+      // Windows
+      'C:/Program Files/Google/Chrome/Application/chrome.exe', 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
+      // macOS（插件装在 Mac 上时，浏览器不在 PATH 里，也不在 Windows 的默认位置）
+      '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+      '/Applications/Chromium.app/Contents/MacOS/Chromium',
+      '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+      // Linux
+      '/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser', '/usr/bin/microsoft-edge',
+    ]
+    const browserExecutable = candidates.find((path) => path && existsSync(path))
+    if (!browserExecutable) {
+      // 没有本机浏览器时 Remotion 会去下载 chrome-headless-shell：内网/无外网会卡很久。
+      // 先把这件事说出来，别让它看起来像"卡死"（issue #22）。
+      send({ type: 'progress', phase: 'browser', progress: 0, message: '没找到本机 Chrome / Edge，正在下载内置浏览器；首次会慢一些' })
+    }
+    browser = await openBrowser('chrome', { browserExecutable, logLevel: 'error' }).catch((error) => {
+      const detail = error?.message || String(error)
+      throw new Error(browserExecutable
+        ? `打开本机浏览器失败（${browserExecutable}）：${detail}`
+        : `未找到本机 Chrome / Edge，下载 chrome-headless-shell 也失败：${detail}。请安装 Chrome，或用 DRAWAI_CHROME_PATH 指定浏览器路径。`)
+    })
+    if (cancelled) throw new Error('已取消动效生成')
+    const inputProps = { plan: request.composition, assets: request.assets }
+    const composition = await selectComposition({ serveUrl, id: 'DrawAiMotion', inputProps, puppeteerInstance: browser, browserExecutable })
+    if(request.operation==='compile'){send({type:'done',compiled:true});return}
+    send({ type: 'progress', phase: 'reviewing', progress: .1 })
+    const qaDirectory = request.qaDirectory || join(dirname(request.output), 'qa'); mkdirSync(qaDirectory, { recursive: true })
+    const audioCues = Array.isArray(request.composition?.audio) ? request.composition.audio : []
+    const qa = { status: 'render-checks-passed', visualReview: 'manual-required', audio: audioCues.length ? 'mixed:' + audioCues.length : 'silent', frames: [], warnings: [] }
+    if(request.operation==='still'){
+      const frames=[]
+      for(const frame of request.frames){
+        if(!Number.isInteger(frame)||frame<0||frame>=composition.durationInFrames)throw new Error('截图帧超出成片')
+        const filename='agent-frame-'+frame+'.png'
+        await renderStill({serveUrl,composition,inputProps,output:join(qaDirectory,filename),frame,puppeteerInstance:browser,browserExecutable,cancelSignal,logLevel:'error'})
+        frames.push({frame,filename,sha256:createHash('sha256').update(readFileSync(join(qaDirectory,filename))).digest('hex')})
+      }
+      send({type:'done',frames});return
+    }
+    for (const shot of request.composition.shots) {
+      const hashes = []
+      for (const fraction of (shot.motionCards?.length ? [0, .25, .5, .75, .98] : [.25, .7])) {
+        const frame = shot.startFrame + Math.min(shot.durationFrames - 1, Math.floor(shot.durationFrames * fraction))
+        const filename = shot.id + '-' + frame + '.png'
+        await renderStill({ serveUrl, composition, inputProps, output: join(qaDirectory, filename), frame, puppeteerInstance: browser, browserExecutable, cancelSignal, logLevel: 'error', timeoutInMilliseconds: 30000 })
+        const bytes = readFileSync(join(qaDirectory, filename))
+        const hash = createHash('sha256').update(bytes).digest('hex'); hashes.push(hash)
+        qa.frames.push({ shotId: shot.id, frame, filename, fraction, sha256: hash })
+      }
+      if (hashes[0] === hashes[1]) qa.warnings.push(shot.id + ': 两张采样帧相同，请检查主运动或停留段')
+    }
+    // 渲染规格随请求进来（由 render.js 的 resolveRenderSettings 解析过）：
+    // 编码参数、色彩标签、超采样倍数、并发都在这里唯一地落到 renderMedia 上。
+    const settings = request.render || {}
+    qa.render = settings
+    writeFileSync(join(qaDirectory, 'report.json'), JSON.stringify(qa, null, 2))
+    const scale = Number(settings.scale) > 1 ? Math.round(Number(settings.scale)) : 1
+    const finalOutput = request.output
+    // 超采样：Remotion 的 scale 是「渲成更大」，不会替你缩回来。
+    // 所以大图先落到临时文件，再用一次 lanczos + bt709 的母版编码缩回目标尺寸。
+    const rawOutput = scale > 1 ? join(dirname(finalOutput), '.supersample.mp4') : finalOutput
+    const startedAt = Date.now()
+    let seenFrames = 0
+    const totalFrames = request.frameRange
+      ? request.frameRange[1] - request.frameRange[0] + 1
+      : composition.durationInFrames
+    await renderMedia({ serveUrl, composition, inputProps, outputLocation: rawOutput,
+      codec: settings.codec || 'h264',
+      ...(settings.crf ? { crf: settings.crf } : {}),
+      ...(settings.preset ? { x264Preset: settings.preset } : {}),
+      ...(settings.pixelFormat ? { pixelFormat: settings.pixelFormat } : {}),
+      ...(settings.colorSpace ? { colorSpace: settings.colorSpace } : {}),
+      ...(settings.audioBitrate ? { audioBitrate: settings.audioBitrate } : {}),
+      scale,
+      concurrency: settings.concurrency || 2,
+      ...(request.frameRange?{frameRange:request.frameRange}:{}),
+      puppeteerInstance: browser, browserExecutable, cancelSignal, logLevel: 'error',
+      onProgress: ({ progress, renderedFrames }) => {
+        const done = Number(renderedFrames) || 0
+        if (done > seenFrames) seenFrames = done
+        const elapsed = (Date.now() - startedAt) / 1000
+        const perFrame = seenFrames > 0 ? elapsed / seenFrames : null
+        // 单帧耗时是「样本数该开多大」的唯一依据：没有它，超采样只能靠猜。
+        send({ type: 'progress', phase: 'rendering', progress: .1 + progress * .85,
+          frames: { done: seenFrames, total: totalFrames,
+            perFrameSeconds: perFrame ? Math.round(perFrame * 1000) / 1000 : null,
+            etaSeconds: perFrame ? Math.round(perFrame * Math.max(totalFrames - seenFrames, 0)) : null } })
+      } })
+    if (scale > 1) {
+      send({ type: 'progress', phase: 'encoding', progress: .96 })
+      // 这一趟本来就是重编码，顺手把 bt709 三标签补全。
+      // 注意：这个 ffmpeg 构建里 -color_primaries / -color_trc 当**输出选项**不生效
+      // （连续实测：只剩 colorspace 标签，primaries/trc 仍是 unknown），必须走 setparams 滤镜改帧元数据。
+      const colorFilter = settings.colorSpace === 'bt709'
+        ? ',setparams=color_primaries=bt709:color_trc=bt709:colorspace=bt709' : ''
+      await runFfmpeg(['-i', rawOutput,
+        '-vf', 'scale=' + composition.width + ':' + composition.height + ':flags=lanczos+accurate_rnd+full_chroma_int' + colorFilter,
+        '-c:v', 'libx264', '-crf', String(settings.crf || 14), '-preset', String(settings.preset || 'slow'),
+        '-profile:v', 'high', '-pix_fmt', 'yuv420p',
+        '-colorspace', 'bt709', '-color_primaries', 'bt709', '-color_trc', 'bt709',
+        '-c:a', 'copy', '-movflags', '+faststart', finalOutput],
+        { cwd: dirname(finalOutput), log: join(dirname(finalOutput), 'encode.log'), timeoutMs: 900000 })
+      rmSync(rawOutput, { force: true })
+      qa.supersample = { from: composition.width * scale + 'x' + composition.height * scale, to: composition.width + 'x' + composition.height }
+      qa.colorTags = settings.colorSpace === 'bt709' ? 'bt709（三标签齐全）' : '未标注'
+    } else if (settings.colorSpace === 'bt709') {
+      // Remotion 只写 colorspace，primaries/trc 留 unknown；要齐全只能再重编一次，
+      // 而重编会让画质掉一代——所以 1× 下宁可把这件事说清楚，不偷偷多编一遍。
+      qa.colorTags = '仅 colorspace=bt709（primaries/trc 为 unknown；母版级标签请设 render.scale=2）'
+      qa.warnings.push('色彩标签只写了 colorspace：要 primaries/trc 齐全（严格 QC）请用 render.scale=2，那一趟重编码会一并补齐')
+    }
+    const posterShot = request.composition.shots.find((shot) => shot.referenceIds.length) || request.composition.shots[0]
+    await renderStill({ serveUrl, composition, inputProps, output: request.poster,
+      frame: posterShot.startFrame + Math.floor(posterShot.durationFrames / 2), puppeteerInstance: browser, browserExecutable, cancelSignal, logLevel: 'error' })
+    writeFileSync(join(qaDirectory, 'report.json'), JSON.stringify(qa, null, 2))
+    send({ type: 'done', qa })
+  } catch (error) { send({ type: 'error', error: error.message || String(error) }); process.exitCode = 1 }
+  finally {
+    await browser?.close({ silent: true }).catch(() => {})
+    const cleanup = relative(resolve(dirname(request.output)), resolve(outDir))
+    if (request.keepBundle !== true && cleanup === 'bundle' && !isAbsolute(cleanup)) rmSync(outDir, { recursive: true, force: true })
+    process.disconnect()
+  }
+})