PRINTFILM: AI short-video marketing and AI short-drama creation platform
/**
* 漫剧分镜脚本校验(对齐 docs/EPISODE_RULES.md §3 / §9)
* 用于生成前告警:时长、空镜误标对白、资产缺图/缺音色
*/
import type { DramaAsset, DramaFragment } from '../api/drama'
import { dramaAssetHasImage } from './dramaAssetImage'
import {
DRAMA_SEGMENT_DURATION_HARD_MAX,
DRAMA_SEGMENT_DURATION_MAX,
DRAMA_SEGMENT_DURATION_MIN,
DRAMA_SHOT_DURATION_HARD_MAX,
FRAGMENT_CONTENT_DURATION_MAX,
} from './dramaEpisodePromptEditor'
import { extractDurations, sumDuration } from './segmentDuration'
import { DRAMA_VOICE_BINDING_ENABLED } from './dramaVoiceBinding'
/** 漫剧字幕 cue(与后端 DRAMA_SUBTITLE_CUE 一致) */
export const DRAMA_SUBTITLE_CUE = '【字幕:底部居中·简体中文·逐句轮换·与口播同步】'
/** 画面无配音前缀 */
export const VISUAL_PREFIX = '【画面·无配音仅环境音】'
/** 对白前缀 */
export const DIALOGUE_PREFIX = '【对白·慢速清晰·同步字幕】'
/** 旁白前缀 */
export const DRAMA_NARRATION_PREFIX = '【旁白·慢速清晰·同步字幕】'
// 空镜 / 景别冒号标签(与后端 VISUAL_SHOT_LABEL_RE 对齐)
const VISUAL_SHOT_LABEL_RE =
/^(?:空镜|画面|远景|近景|中景|全景|特写|大特写|跟拍|俯拍|仰拍|航拍|推镜|拉镜|摇镜|环境|镜头|动作|转场|闪回|建立镜头|气氛镜头)\s*[::]/
const VOICE_CUE_PREFIX_RE = /^【(?:对白|旁白|内心独白)[^】]*】\s*/
export type DramaScriptIssue = {
level: 'error' | 'warn'
message: string
}
// 去掉对白/旁白生产前缀
function stripVoiceCuePrefix(line: string): string {
return (line || '').replace(VOICE_CUE_PREFIX_RE, '').trim()
}
// 角色是否已绑定可提交的参考音频
function assetHasVoiceBinding(asset: DramaAsset): boolean {
const params = (asset.params || {}) as Record<string, unknown>
const raw = params.voiceAudio
if (raw && typeof raw === 'object') {
const data = raw as Record<string, unknown>
const url =
typeof data.url === 'string'
? data.url
: typeof data.previewUrl === 'string'
? data.previewUrl
: ''
if (url.trim()) return true
}
const canvas = params.canvas
if (canvas && typeof canvas === 'object') {
const voiceAudio = (canvas as Record<string, unknown>).voiceAudio
if (voiceAudio && typeof voiceAudio === 'object') {
const url = (voiceAudio as Record<string, unknown>).url
if (typeof url === 'string' && url.trim()) return true
}
}
return false
}
// 合并正文 @asset 与 asset_ids
function listFragmentAssetIds(frag: DramaFragment): number[] {
const seen = new Set<number>()
const out: number[] = []
const re = /@asset:(\d+)/g
let m: RegExpExecArray | null
while ((m = re.exec(frag.content || ''))) {
const id = Number(m[1])
if (!id || seen.has(id)) continue
seen.add(id)
out.push(id)
}
for (const id of frag.asset_ids || []) {
if (!id || seen.has(id)) continue
seen.add(id)
out.push(id)
}
return out
}
// 判断正文是否为纯画面 / 空镜描写
export function isVisualDescriptionBody(text: string): boolean {
let body = stripVoiceCuePrefix((text || '').trim())
body = body.replace(/^【(?:画面|空镜)[^】]*】\s*/, '').trim()
if (!body) return false
if (VISUAL_SHOT_LABEL_RE.test(body)) return true
if (body.startsWith('空镜') || body.startsWith('△') || body.startsWith('Δ')) return true
return false
}
// 脚本是否含真实口播意图(排除空镜冒号)
function scriptLikelyNeedsVoice(content: string): boolean {
for (const raw of (content || '').replace(/\r\n/g, '\n').split('\n')) {
const line = raw.trim()
if (!line || line.startsWith('@duration:')) continue
if (
line.startsWith('【字幕') ||
line.startsWith('【BGM') ||
line.startsWith('【人物介绍') ||
line.startsWith('【片头') ||
line.startsWith('【背景介绍')
) {
continue
}
if (line.startsWith('【对白') || line.startsWith('【旁白') || line.startsWith('【内心独白')) {
if (!isVisualDescriptionBody(line)) return true
continue
}
if (isVisualDescriptionBody(line)) continue
if (/^[^::\n]{1,16}[::]/.test(line) && !VISUAL_SHOT_LABEL_RE.test(line)) {
return true
}
}
return false
}
// 校验单镜脚本:时长 + 空镜误标
export function validateDramaFragmentScript(content: string): DramaScriptIssue[] {
const issues: DramaScriptIssue[] = []
const durations = extractDurations(content || '')
const total = sumDuration(content || '')
const badSegment = durations.find(
(value) =>
!Number.isFinite(value) ||
value < DRAMA_SEGMENT_DURATION_MIN ||
value > DRAMA_SEGMENT_DURATION_HARD_MAX,
)
if (badSegment != null) {
issues.push({
level: 'error',
message: `单个 @duration 需在 ${DRAMA_SEGMENT_DURATION_MIN}–${DRAMA_SEGMENT_DURATION_HARD_MAX} 秒之间`,
})
} else if (durations.some((value) => value > DRAMA_SEGMENT_DURATION_MAX)) {
issues.push({
level: 'warn',
message: `部分 @duration 超过新分镜建议 ${DRAMA_SEGMENT_DURATION_MAX}s,旧稿可继续生成`,
})
}
if (total > DRAMA_SHOT_DURATION_HARD_MAX) {
issues.push({
level: 'error',
message: `本镜 @duration 合计 ${total}s,超过 Seedance 上限 ${DRAMA_SHOT_DURATION_HARD_MAX}s`,
})
} else if (total > FRAGMENT_CONTENT_DURATION_MAX) {
issues.push({
level: 'warn',
message: `本镜 @duration 合计 ${total}s,超过新分镜建议 ${FRAGMENT_CONTENT_DURATION_MAX}s(旧稿可继续生成)`,
})
}
for (const raw of (content || '').replace(/\r\n/g, '\n').split('\n')) {
const line = raw.trim()
if (!line || line.startsWith('@duration:')) continue
if (line.startsWith('【字幕') || line.startsWith('【BGM') || line.startsWith('【人物介绍')) {
continue
}
if (VOICE_CUE_PREFIX_RE.test(line) && isVisualDescriptionBody(line)) {
issues.push({
level: 'error',
message:
'检测到「空镜/景别」被标成对白或旁白(会口播并烧字幕)。请改为「【画面·无配音仅环境音】」或「空镜:…」纯画面行',
})
break
}
}
return issues
}
// 校验本镜关联资产:缺参考图为硬错误;说话角色缺音色仍为警告
export function validateDramaFragmentAssets(
frag: DramaFragment | null | undefined,
assets: DramaAsset[],
): DramaScriptIssue[] {
const issues: DramaScriptIssue[] = []
if (!frag) return issues
const byId = new Map(assets.map((a) => [a.id, a]))
const ids = listFragmentAssetIds(frag)
const needsVoice = scriptLikelyNeedsVoice(frag.content || '')
const missingImage: string[] = []
const missingVoice: string[] = []
for (const id of ids) {
const asset = byId.get(id)
if (!asset) {
missingImage.push(`#${id}`)
continue
}
const kind = (asset.type || '').toLowerCase()
if ((kind === 'character' || kind === 'scene' || kind === 'prop') && !dramaAssetHasImage(asset)) {
missingImage.push(asset.name || `#${id}`)
}
if (DRAMA_VOICE_BINDING_ENABLED && kind === 'character' && needsVoice && !assetHasVoiceBinding(asset)) {
missingVoice.push(asset.name || `#${id}`)
}
}
if (missingImage.length > 0) {
issues.push({
level: 'error',
message: `以下关联资产缺少参考图,请先生成或上传后再生成视频:${missingImage.slice(0, 5).join('、')}${missingImage.length > 5 ? '…' : ''}`,
})
}
if (missingVoice.length > 0) {
issues.push({
level: 'warn',
message: `脚本含对白,但以下角色尚未绑定音色:${missingVoice.slice(0, 5).join('、')}${missingVoice.length > 5 ? '…' : ''}`,
})
}
return issues
}
// 合并脚本与资产问题;有 error 则不可直接生成
export function collectDramaGenerateGateIssues(
frag: DramaFragment | null | undefined,
assets: DramaAsset[],
): { blocking: DramaScriptIssue[]; warnings: DramaScriptIssue[] } {
const scriptIssues = validateDramaFragmentScript(frag?.content || '')
const assetIssues = validateDramaFragmentAssets(frag, assets)
const all = [...scriptIssues, ...assetIssues]
return {
blocking: all.filter((i) => i.level === 'error'),
warnings: all.filter((i) => i.level === 'warn'),
}
}
// 把问题列表拼成确认框文案
export function formatDramaGateMessage(
blocking: DramaScriptIssue[],
warnings: DramaScriptIssue[],
baseMessage: string,
): string {
const parts = [baseMessage]
if (blocking.length > 0) {
parts.push('', '【须先修复】', ...blocking.map((i) => `· ${i.message}`))
}
if (warnings.length > 0) {
parts.push('', '【建议处理,仍可继续】', ...warnings.map((i) => `· ${i.message}`))
}
return parts.join('\n')
}