Skip to content

PRINTFILM: AI short-video marketing and AI short-drama creation platform

8.0 KB
Raw Blame
/**
 * 科普分镜脚本内 @duration 解析、校验与分段预览
 * 常量与后端 seedance_segments 对齐(单段 3–12s,镜合计 ≤30s)
 */

/** 单段时长下限(秒) */
export const SEGMENT_DURATION_MIN = 3

/** 单段时长上限(秒) */
export const SEGMENT_DURATION_MAX = 12

/** 单镜脚本内 @duration 合计上限(秒) */
export const SHOT_DURATION_MAX = 30

/** 时长快捷选项(秒) */
export const SEGMENT_DURATION_PRESETS = [4, 6, 8, 10, 12] as const

/** 与后端一致的字幕 cue(后期叠字,非模型烧录) */
export const SUBTITLE_CUE = '【字幕:后期叠旁白字幕,简体中文逐句同步】'

/** 与后端一致的旁白前缀(科普自然偏快;旧稿「慢速清晰」仍可识别) */
export const NARRATION_PREFIX = '【旁白·自然语速·同步字幕】'

/** 脚本编辑区 placeholder */
export const SEGMENT_SCRIPT_PLACEHOLDER = `${SUBTITLE_CUE}\n【BGM:后期混音 · 轻快专业,音量低于人声】\n@duration:4\n过肩工位操作画面…\n@duration:8\n${NARRATION_PREFIX}口播内容…`

const DURATION_TOKEN_PATTERN = /@duration:(\d+)/g

export type SegmentBeatView = { duration: number; text: string }

/**
 * 从脚本中提取全部 @duration 秒数(保留顺序)
 * @param content 逐段分镜脚本文本
 */
export function extractDurations(content: string): number[] {
  const durations: number[] = []
  for (const match of content.matchAll(DURATION_TOKEN_PATTERN)) {
    const seconds = Number(match[1])
    if (Number.isFinite(seconds) && seconds > 0) {
      durations.push(seconds)
    }
  }
  return durations
}

/**
 * 合计脚本内 @duration 秒数
 * @param content 逐段分镜脚本文本
 */
export function sumDuration(content: string): number {
  return extractDurations(content).reduce((sum, value) => sum + value, 0)
}

/**
 * 分镜列表展示用时长:优先脚本内 @duration 合计,否则回退 shot.duration
 * (生成时 LLM 的 duration 字段常与逐段标签脱节,列表应对齐用户看到的 3s/4s 标签)
 */
export function shotDisplayDurationSec(shot: {
  duration?: number | null
  segment_script?: string | null
  video_prompt?: string | null
}): number {
  const script = String(shot.segment_script || shot.video_prompt || '')
  const tagged = sumDuration(script)
  if (tagged > 0) return tagged
  const stored = Number(shot.duration)
  return Number.isFinite(stored) && stored > 0 ? stored : 0
}

/**
 * 校验单个时长是否在科普单段合法区间
 * @param seconds 时长秒数
 */
export function isValidSegmentDuration(seconds: number): boolean {
  return (
    Number.isFinite(seconds) &&
    seconds >= SEGMENT_DURATION_MIN &&
    seconds <= SEGMENT_DURATION_MAX
  )
}

/**
 * 校验脚本内时长标签:单段范围 + 合计 ≤ 镜上限
 * @param content 逐段分镜脚本文本
 */
export function validateSegmentScriptDuration(content: string): {
  valid: boolean
  total: number
  durations: number[]
  message?: string
} {
  const durations = extractDurations(content)
  const total = durations.reduce((sum, value) => sum + value, 0)

  if (durations.length === 0) {
    return { valid: true, total: 0, durations }
  }

  if (durations.some((value) => !isValidSegmentDuration(value))) {
    return {
      valid: false,
      total,
      durations,
      message: `单个 @duration 需在 ${SEGMENT_DURATION_MIN}–${SEGMENT_DURATION_MAX} 秒之间`,
    }
  }

  if (total > SHOT_DURATION_MAX) {
    return {
      valid: false,
      total,
      durations,
      message: `镜头时长合计不能超过 ${SHOT_DURATION_MAX} 秒(当前 ${total}s)`,
    }
  }

  return { valid: true, total, durations }
}

/**
 * 解析脚本为字幕/BGM cues 与带时长的正文段(列表预览用)
 * @param script 逐段分镜脚本
 */
export function parseSegmentScript(script: string | undefined | null): {
  cues: string[]
  beats: SegmentBeatView[]
} {
  /*
   * cues 字幕/BGM 行
   * beats 带 duration 的正文段
   * pendingDur 上一段 @duration 值
   */
  const cues: string[] = []
  const beats: SegmentBeatView[] = []
  let pendingDur = 0

  const lines = String(script || '')
    .replace(/\r\n/g, '\n')
    .split('\n')
    .map((l) => l.trim())
    .filter(Boolean)

  for (const line of lines) {
    if (line.startsWith('【字幕') || line.startsWith('【BGM')) {
      cues.push(line)
      continue
    }
    const m = line.match(/^@duration:(\d+)/)
    if (m) {
      pendingDur = Number(m[1]) || 0
      continue
    }
    if (pendingDur > 0 || beats.length === 0) {
      beats.push({ duration: pendingDur || 0, text: line })
      pendingDur = 0
    } else {
      beats.push({ duration: 0, text: line })
    }
  }

  return { cues, beats }
}

const NARRATION_LINE_PREFIX = /^【旁白[^】]*】/

/** 脚本行是否为旁白口播(字幕 cue 含「旁白」二字但不算) */
export function isNarrationScriptLine(line: string): boolean {
  const stripped = line.trim()
  if (stripped.startsWith('【字幕') || stripped.startsWith('【BGM')) return false
  return NARRATION_LINE_PREFIX.test(stripped)
}

/** 去掉旁白前缀,得到可朗读正文 */
export function stripNarrationPrefix(line: string): string {
  return line.trim().replace(NARRATION_LINE_PREFIX, '').trim()
}

/** 从脚本提取旁白正文(多段拼接) */
export function narrationFromScript(script: string | undefined | null): string {
  const parts: string[] = []
  for (const line of String(script || '').replace(/\r\n/g, '\n').split('\n')) {
    if (isNarrationScriptLine(line)) {
      const text = stripNarrationPrefix(line)
      if (text) parts.push(text)
    }
  }
  return parts.join('')
}

/** 从脚本提取首段画面(非旁白、非 cue) */
export function firstVisualFromScript(script: string | undefined | null): string {
  for (const line of String(script || '').replace(/\r\n/g, '\n').split('\n')) {
    const stripped = line.trim()
    if (
      !stripped ||
      stripped.startsWith('@duration:') ||
      stripped.startsWith('【字幕') ||
      stripped.startsWith('【BGM') ||
      isNarrationScriptLine(stripped)
    ) {
      continue
    }
    return stripped.replace(/^【[^】]*】/, '').trim() || stripped
  }
  return ''
}

/** 把弹窗旁白写回脚本中的旁白段 */
export function replaceNarrationInScript(script: string, narration: string): string {
  const text = narration.trim()
  const lines = String(script || '').replace(/\r\n/g, '\n').split('\n')
  const out: string[] = []
  let replaced = false
  for (const raw of lines) {
    const stripped = raw.trim()
    if (text && isNarrationScriptLine(stripped) && !replaced) {
      const prefix = stripped.match(NARRATION_LINE_PREFIX)?.[0] || NARRATION_PREFIX
      out.push(`${prefix}${text}`)
      replaced = true
      continue
    }
    out.push(raw.replace(/\s+$/, ''))
  }
  if (text && !replaced) {
    out.push('@duration:6')
    out.push(`${NARRATION_PREFIX}${text}`)
  }
  return out.join('\n').trim()
}

/** 把弹窗首帧画面写回脚本第一段 visual */
export function replaceFirstVisualInScript(script: string, visual: string): string {
  const text = visual.trim()
  if (!text) return String(script || '').trim()
  const lines = String(script || '').replace(/\r\n/g, '\n').split('\n')
  const out: string[] = []
  let replaced = false
  let cueEnd = 0
  for (let i = 0; i < lines.length; i += 1) {
    const stripped = lines[i].trim()
    if (stripped.startsWith('【字幕') || stripped.startsWith('【BGM') || !stripped) {
      cueEnd = i + 1
      continue
    }
    break
  }
  for (const raw of lines) {
    const stripped = raw.trim()
    if (
      !replaced &&
      stripped &&
      !stripped.startsWith('@duration:') &&
      !stripped.startsWith('【字幕') &&
      !stripped.startsWith('【BGM') &&
      !isNarrationScriptLine(stripped)
    ) {
      out.push(text)
      replaced = true
      continue
    }
    out.push(raw.replace(/\s+$/, ''))
  }
  if (!replaced) {
    const extra = [`@duration:${SEGMENT_DURATION_MIN}`, text]
    return [...out.slice(0, cueEnd), ...extra, ...out.slice(cueEnd)].join('\n').trim()
  }
  return out.join('\n').trim()
}