6eec0e8889
- SKILL.md: 新增工作流阶段定义、质量卡点、分镜规则 - manifest-schema.md: 补充完整字段规范及类型定义 - phase-tts.js: 优化 TTS 合成长逻辑，添加进度追踪 - capcut-tracks.js: 扩展轨道构建能力，支持更多元素类型 - capcut-timeline.js: 改进时间线生成，支持淡入淡出 - capcut_assemble.js: 新增 assemble 阶段完整实现 - cmd-init.js: 完善 init 命令逻辑 - qwen-tts.js: 调整超时配置 - accounts/禁忌帝王学: 更新拆分/图像/台词提示词 - accounts/健身跟练: 新增账号含 account.json 及全套提示词模板 - 新增 workflow-issues-20260501.md 参考文档 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
833 lines
26 KiB
JavaScript
833 lines
26 KiB
JavaScript
/**
|
||
* CapCut 轨道操作
|
||
*
|
||
* 所有 add* 函数 + 转场策略 + 账号配置读取。
|
||
* Agent 修改字幕风格、Ken Burns、转场、特效等只需关注此文件。
|
||
*
|
||
* 音频策略（固化铁律）：
|
||
* - 音频由 TTS 1.15x 生成，导入 CapCut 时无 speed 字段（不可调速）
|
||
* - 每个 item 的 segments[] 逐段添加，各段 start 按 startOffset 精确对齐
|
||
*/
|
||
|
||
const path = require('path')
|
||
const { api, US } = require('./capcut-api')
|
||
const { splitTextIntoSentences, loadAccountConfig: loadAccountConfigFromUtils } = require('./pipeline-utils')
|
||
|
||
// ============================================================================
|
||
// 账号配置读取
|
||
// ============================================================================
|
||
|
||
function loadAccountConfig(manifest) {
|
||
const account = manifest.account
|
||
if (!account) return {}
|
||
try { return loadAccountConfigFromUtils(account) } catch { return {} }
|
||
}
|
||
|
||
function loadSubtitleStyle(manifest) {
|
||
return loadAccountConfig(manifest).capcut?.subtitleStyle || {}
|
||
}
|
||
|
||
function loadKeywordStyle(manifest) {
|
||
return loadAccountConfig(manifest).capcut?.keywordStyle || {}
|
||
}
|
||
|
||
function loadTransitions(manifest) {
|
||
return loadAccountConfig(manifest).capcut?.transitions || null
|
||
}
|
||
|
||
function applyAnimationProps(cap, style = {}) {
|
||
if (style.inAnimation) cap.in_animation = style.inAnimation
|
||
if (style.outAnimation) cap.out_animation = style.outAnimation
|
||
if (style.inAnimDuration) cap.in_animation_duration = style.inAnimDuration
|
||
if (style.outAnimDuration) cap.out_animation_duration = style.outAnimDuration
|
||
}
|
||
|
||
// ============================================================================
|
||
// 转场策略
|
||
// ============================================================================
|
||
|
||
function getTransition(item, index, totalCount, transitionConfig, allItems, timeline) {
|
||
if (!transitionConfig) return { name: '', duration: 0 }
|
||
|
||
const defaultT = transitionConfig.default || { name: '闪白', duration: 150000 }
|
||
const strategy = transitionConfig.strategy || 'fixed'
|
||
|
||
if (index === 0) return { name: '', duration: 0 }
|
||
if (index >= totalCount - 1) return { name: '', duration: 0 }
|
||
|
||
switch (strategy) {
|
||
case 'director': {
|
||
const ref = (item.directorRef || '').toLowerCase()
|
||
const byDirector = transitionConfig.byDirector || {}
|
||
return byDirector[ref] || defaultT
|
||
}
|
||
|
||
case 'rhythm': {
|
||
const rules = transitionConfig.byPosition || {}
|
||
if (index >= totalCount - 2) return rules.closing || defaultT
|
||
if (allItems && index > 0) {
|
||
const prev = allItems[index - 1]
|
||
if (item.directorRef && prev.directorRef && item.directorRef !== prev.directorRef) {
|
||
return rules.keypoint || defaultT
|
||
}
|
||
if (item.keyword && !prev.keyword) {
|
||
return rules.keypoint || defaultT
|
||
}
|
||
}
|
||
if (timeline && timeline.length > 0) {
|
||
const elapsed = timeline[index].start
|
||
let lastTransStart = 0
|
||
for (let pi = index - 1; pi >= 1; pi--) {
|
||
const p = allItems[pi]
|
||
const pp = pi > 0 ? allItems[pi - 1] : null
|
||
if (pi >= totalCount - 2) { lastTransStart = timeline[pi].start; break }
|
||
if (pp && p.directorRef && pp.directorRef && p.directorRef !== pp.directorRef) {
|
||
lastTransStart = timeline[pi].start; break
|
||
}
|
||
if (p.keyword && pp && !pp.keyword) { lastTransStart = timeline[pi].start; break }
|
||
}
|
||
if (elapsed - lastTransStart >= 8000000) return rules.body || defaultT
|
||
} else {
|
||
if (index % 3 === 0) return rules.body || defaultT
|
||
}
|
||
return { name: '', duration: 0 }
|
||
}
|
||
|
||
case 'fixed':
|
||
default:
|
||
return defaultT
|
||
}
|
||
}
|
||
|
||
// ============================================================================
|
||
// 入场动画映射
|
||
// ============================================================================
|
||
|
||
const DIRECTOR_ANIMATIONS = {
|
||
tarantino: '动感放大',
|
||
kitano: '轻微放大',
|
||
fincher: '渐显',
|
||
}
|
||
|
||
function getAnimationForDirector(directorRef, defaultAnimation) {
|
||
if (!directorRef) return defaultAnimation
|
||
return DIRECTOR_ANIMATIONS[directorRef.toLowerCase()] || defaultAnimation
|
||
}
|
||
|
||
// ============================================================================
|
||
// Ken Burns 关键帧动画
|
||
// ============================================================================
|
||
|
||
const KEN_BURNS_FALLBACK = {
|
||
default: { startScale: 1.0, scaleRate: 0.8, panXRate: 0, panYRate: 0 },
|
||
byDirector: {
|
||
tarantino: { startScale: 1.0, scaleRate: 0.9, panXRate: 0, panYRate: -0.3 },
|
||
kitano: { startScale: 1.03, scaleRate: 0.5, panXRate: 0.4, panYRate: 0 },
|
||
fincher: { startScale: 1.0, scaleRate: 0.4, panXRate: 0, panYRate: 0 },
|
||
},
|
||
}
|
||
const KEN_BURNS_MAX_SCALE = 1.20
|
||
|
||
function loadKenBurns(manifest) {
|
||
const cfg = loadAccountConfig(manifest).capcut?.kenBurns
|
||
if (cfg && cfg.default) return cfg
|
||
return KEN_BURNS_FALLBACK
|
||
}
|
||
|
||
function getKenBurnsProfile(item, kbConfig) {
|
||
const director = (item.directorRef || '').toLowerCase()
|
||
const byDirector = kbConfig.byDirector || {}
|
||
return byDirector[director] || kbConfig.default
|
||
}
|
||
|
||
async function addKenBurns(draftUrl, segmentIds, items, timeline, manifest) {
|
||
if (!segmentIds || segmentIds.length === 0) {
|
||
console.log(' 无 segment IDs，跳过 Ken Burns')
|
||
return
|
||
}
|
||
|
||
const kbConfig = loadKenBurns(manifest)
|
||
if (kbConfig.enabled === false) {
|
||
console.log(' Ken Burns 已禁用（account.json kenBurns.enabled=false）')
|
||
return
|
||
}
|
||
|
||
const keyframes = []
|
||
for (let i = 0; i < segmentIds.length; i++) {
|
||
const segId = segmentIds[i]
|
||
const item = items[i]
|
||
const tl = timeline[i]
|
||
if (!segId || !tl) continue
|
||
|
||
const profile = getKenBurnsProfile(item, kbConfig)
|
||
const durSec = tl.duration / US
|
||
const segDur = tl.duration
|
||
|
||
const startScale = profile.startScale || 1.0
|
||
const scaleRate = profile.scaleRate != null ? profile.scaleRate : 0.8
|
||
const endScale = Math.min(startScale + scaleRate * durSec / 100, KEN_BURNS_MAX_SCALE)
|
||
|
||
keyframes.push(
|
||
{ segment_id: segId, property: 'UNIFORM_SCALE', offset: 0, value: startScale },
|
||
{ segment_id: segId, property: 'UNIFORM_SCALE', offset: segDur, value: endScale },
|
||
)
|
||
|
||
const panXRate = profile.panXRate || 0
|
||
const panYRate = profile.panYRate || 0
|
||
if (panXRate !== 0) {
|
||
const panX = panXRate * durSec
|
||
keyframes.push(
|
||
{ segment_id: segId, property: 'KFTypePositionX', offset: 0, value: 0 },
|
||
{ segment_id: segId, property: 'KFTypePositionX', offset: segDur, value: panX },
|
||
)
|
||
}
|
||
if (panYRate !== 0) {
|
||
const panY = panYRate * durSec
|
||
keyframes.push(
|
||
{ segment_id: segId, property: 'KFTypePositionY', offset: 0, value: 0 },
|
||
{ segment_id: segId, property: 'KFTypePositionY', offset: segDur, value: panY },
|
||
)
|
||
}
|
||
}
|
||
|
||
if (keyframes.length === 0) {
|
||
console.log(' 无关键帧生成，跳过')
|
||
return
|
||
}
|
||
|
||
const res = await api('add_keyframes', {
|
||
draft_url: draftUrl,
|
||
keyframes: JSON.stringify(keyframes),
|
||
})
|
||
console.log(` 已添加 ${res.keyframes_added || keyframes.length} 个 Ken Burns 关键帧 (${segmentIds.length} 段)`)
|
||
}
|
||
|
||
// ============================================================================
|
||
// 添加图片
|
||
// ============================================================================
|
||
|
||
async function addImages(draftUrl, items, imgUrls, timeline, width, height, animation = '', transitionConfig = null) {
|
||
const imageInfos = items.map((item, i) => {
|
||
const url = imgUrls[item.file]
|
||
if (!url) throw new Error(`图片 ${item.file} 未上传成功，无法添加`)
|
||
const tl = timeline[i]
|
||
const t = getTransition(item, i, items.length, transitionConfig, items, timeline)
|
||
const info = {
|
||
image_url: url,
|
||
width,
|
||
height,
|
||
start: tl.start,
|
||
end: tl.end,
|
||
duration: tl.duration,
|
||
transition: t.name,
|
||
transition_duration: t.duration,
|
||
}
|
||
|
||
const itemAnimation = getAnimationForDirector(item.directorRef, animation)
|
||
if (itemAnimation) {
|
||
const parts = itemAnimation.split('+').map(p => p.trim()).filter(Boolean)
|
||
const loopNames = ['缩放', '缩放 II', '回弹伸缩', '旋转伸缩']
|
||
const loopAnims = parts.filter(p => loopNames.includes(p))
|
||
const inAnims = parts.filter(p => !loopNames.includes(p))
|
||
if (loopAnims.length > 0) info.loop_animation = loopAnims.join('|')
|
||
if (inAnims.length > 0) info.in_animation = inAnims.join('|')
|
||
}
|
||
|
||
return info
|
||
})
|
||
|
||
console.log(` 一次性添加 ${imageInfos.length} 张图片...`)
|
||
const res = await api('add_images', {
|
||
draft_url: draftUrl,
|
||
image_infos: JSON.stringify(imageInfos),
|
||
alpha: 1, scale_x: 1, scale_y: 1,
|
||
transform_x: 0, transform_y: 0,
|
||
}, 300000)
|
||
const allSegmentIds = res.segment_ids || []
|
||
|
||
console.log(` 已添加 ${items.length} 张图片`)
|
||
return allSegmentIds
|
||
}
|
||
|
||
// ============================================================================
|
||
// 添加视频
|
||
// ============================================================================
|
||
|
||
async function addVideos(draftUrl, inputDir, items, timeline, width, height, transitionConfig = null) {
|
||
const videoInfos = items.map((item, i) => {
|
||
const tl = timeline[i]
|
||
const t = getTransition(item, i, items.length, transitionConfig, items, timeline)
|
||
return {
|
||
video_url: item.videoUrl || (item.video ? path.resolve(inputDir, item.video) : null) || item.url || path.resolve(inputDir, item.file),
|
||
width,
|
||
height,
|
||
start: tl.start,
|
||
end: tl.end,
|
||
duration: tl.duration,
|
||
mask: '',
|
||
transition: t.name,
|
||
transition_duration: t.duration,
|
||
volume: item.volume || 1,
|
||
}
|
||
})
|
||
|
||
try {
|
||
const res = await api('add_videos', {
|
||
draft_url: draftUrl,
|
||
video_infos: JSON.stringify(videoInfos),
|
||
alpha: 1, scale_x: 1, scale_y: 1,
|
||
transform_x: 0, transform_y: 0,
|
||
scene_timelines: [],
|
||
})
|
||
console.log(` 已添加 ${items.length} 个视频片段（全量）`)
|
||
return res.segment_ids || []
|
||
} catch (err) {
|
||
if (!err.message.includes('504') && !err.message.includes('timeout')) throw err
|
||
console.log(` 全量提交超时，降级为分批添加...`)
|
||
}
|
||
|
||
const BATCH_SIZE = 3
|
||
const allSegmentIds = []
|
||
for (let i = 0; i < videoInfos.length; i += BATCH_SIZE) {
|
||
const batch = videoInfos.slice(i, i + BATCH_SIZE)
|
||
const batchNum = Math.floor(i / BATCH_SIZE) + 1
|
||
const totalBatches = Math.ceil(videoInfos.length / BATCH_SIZE)
|
||
console.log(` 分批 [${batchNum}/${totalBatches}] 添加 ${batch.length} 个片段...`)
|
||
const res = await api('add_videos', {
|
||
draft_url: draftUrl,
|
||
video_infos: JSON.stringify(batch),
|
||
alpha: 1, scale_x: 1, scale_y: 1,
|
||
transform_x: 0, transform_y: 0,
|
||
scene_timelines: [],
|
||
})
|
||
if (res.segment_ids) allSegmentIds.push(...res.segment_ids)
|
||
}
|
||
|
||
console.log(` 已添加 ${items.length} 个视频片段（分批）`)
|
||
return allSegmentIds
|
||
}
|
||
|
||
// ============================================================================
|
||
// 将 segment 写入视频轨道时间线（slot）
|
||
// 背景：add_videos 只负责把视频加入素材库，不自动上时间线。
|
||
// 此函数在 add_videos 成功后调用，将每个 segment_id 写入第一个 video track。
|
||
// ============================================================================
|
||
|
||
async function addSlots(draftUrl, items, timeline) {
|
||
const { api: capcutApi, US } = require('./capcut-api')
|
||
const { getManifestDir } = require('./pipeline-utils')
|
||
const path = require('path')
|
||
|
||
// 获取当前云端草稿的 draft_content，获取第一个 video track 的 id
|
||
let draftData
|
||
try {
|
||
draftData = (await capcutApi('get_draft', { draft_url: draftUrl })).data || {}
|
||
} catch (err) {
|
||
// get_draft 接口不可用，尝试从本地 manifest 目录寻找草稿
|
||
const manifestDir = path.dirname(draftUrl.startsWith('http') ? draftUrl : '')
|
||
console.log(' get_draft 不可用，切换本地写入模式')
|
||
return addSlotsLocally(draftUrl, items, timeline)
|
||
}
|
||
|
||
const tracks = draftData.tracks || []
|
||
const videoTrack = tracks.find(t => t.type === 'video')
|
||
if (!videoTrack) {
|
||
console.log(' 未找到 video track，跳过 slot 写入')
|
||
return
|
||
}
|
||
|
||
// 构造 slot 数据
|
||
const slots = []
|
||
for (let i = 0; i < items.length; i++) {
|
||
const item = items[i]
|
||
const tl = timeline[i]
|
||
const segId = item.segmentId || item._segmentId
|
||
if (!segId) continue
|
||
|
||
const slotId = generateUUID()
|
||
slots.push({
|
||
id: slotId,
|
||
material_id: segId,
|
||
track_id: videoTrack.id,
|
||
render_index: i,
|
||
type: 'video',
|
||
common_property: {
|
||
start_time: tl.start,
|
||
source_timerange: { start: 0, duration: tl.duration },
|
||
target_timerange: { start: tl.start, duration: tl.duration },
|
||
is_avatar: false,
|
||
audio_fade: { fade_in_duration: 0, fade_out_duration: 0 },
|
||
volume: 1.0,
|
||
},
|
||
})
|
||
}
|
||
|
||
if (slots.length === 0) {
|
||
console.log(' 无有效 slot 数据，跳过')
|
||
return
|
||
}
|
||
|
||
// 通过 add_slots API 写入
|
||
try {
|
||
await capcutApi('add_slots', {
|
||
draft_url: draftUrl,
|
||
slots: JSON.stringify(slots),
|
||
})
|
||
console.log(` 已写入 ${slots.length} 个 slot 到视频轨道`)
|
||
} catch (err) {
|
||
// API 不支持时，降级为本地写入
|
||
console.log(` add_slots API 不可用: ${err.message}，降级为本地写入`)
|
||
await addSlotsLocally(draftUrl, items, timeline, videoTrack.id)
|
||
}
|
||
}
|
||
|
||
// 直接写入本地 draft_content.json 的 slot
|
||
// options.draftId: 可选，直接指定 draftId（优先使用），否则从 draftUrl 提取
|
||
async function addSlotsLocally(draftUrl, items, timeline, trackId, options = {}) {
|
||
const { api: capcutApi, US } = require('./capcut-api')
|
||
const fs = require('fs')
|
||
|
||
// 优先使用 options.draftId，否则从 draftUrl 提取
|
||
let draftId = options.draftId || null
|
||
if (!draftId) {
|
||
try {
|
||
draftId = new URL(draftUrl).searchParams.get('draft_id')
|
||
} catch {
|
||
console.log(' 无法解析 draftUrl，跳过本地 slot 写入')
|
||
return
|
||
}
|
||
}
|
||
|
||
if (!draftId) {
|
||
console.log(' 无法提取 draft_id，跳过本地 slot 写入')
|
||
return
|
||
}
|
||
|
||
const { getConfig } = require('./capcut-api')
|
||
const jianyingPath = getConfig().jianyingDraftPath
|
||
const draftPath = path.join(jianyingPath, draftId, 'draft_content.json')
|
||
if (!fs.existsSync(draftPath)) {
|
||
console.log(` 本地草稿不存在: ${draftPath}，跳过 slot 写入`)
|
||
return
|
||
}
|
||
|
||
let draft
|
||
try {
|
||
draft = JSON.parse(fs.readFileSync(draftPath, 'utf-8'))
|
||
} catch {
|
||
console.log(' draft_content.json 读取失败，跳过')
|
||
return
|
||
}
|
||
|
||
// 找到第一个 video track
|
||
const videoTrack = trackId
|
||
? draft.tracks.find(t => t.id === trackId)
|
||
: draft.tracks.find(t => t.type === 'video')
|
||
|
||
if (!videoTrack) {
|
||
console.log(' 未找到 video track，跳过')
|
||
return
|
||
}
|
||
|
||
const slots = []
|
||
for (let i = 0; i < items.length; i++) {
|
||
const item = items[i]
|
||
const tl = timeline[i]
|
||
const segId = item.segmentId || item._segmentId
|
||
if (!segId) {
|
||
// 尝试从 materials.videos 匹配
|
||
const fname = item.video ? path.basename(item.video) : ''
|
||
const matVideo = (draft.materials.videos || []).find(v => {
|
||
const matFname = path.basename(v.path || '')
|
||
return fname && matFname.includes(fname.replace('videos/', ''))
|
||
})
|
||
if (matVideo) {
|
||
items[i]._segmentId = matVideo.id
|
||
slots.push(buildSlot(matVideo.id, videoTrack.id, i, tl, US))
|
||
}
|
||
} else {
|
||
slots.push(buildSlot(segId, videoTrack.id, i, tl, US))
|
||
}
|
||
}
|
||
|
||
if (slots.length > 0) {
|
||
videoTrack.slots = slots
|
||
draft.duration = timeline.length > 0 ? timeline[timeline.length - 1].end : 0
|
||
fs.writeFileSync(draftPath, JSON.stringify(draft, null, 2), 'utf-8')
|
||
console.log(` 已本地写入 ${slots.length} 个 slot 到视频轨道`)
|
||
|
||
// 触发剪映扫描
|
||
triggerDirScan(path.dirname(draftPath))
|
||
}
|
||
}
|
||
|
||
function buildSlot(segId, trackId, index, tl, US) {
|
||
return {
|
||
id: generateUUID(),
|
||
material_id: segId,
|
||
track_id: trackId,
|
||
render_index: index,
|
||
type: 'video',
|
||
common_property: {
|
||
start_time: tl.start,
|
||
source_timerange: { start: 0, duration: tl.duration },
|
||
target_timerange: { start: tl.start, duration: tl.duration },
|
||
is_avatar: false,
|
||
audio_fade: { fade_in_duration: 0, fade_out_duration: 0 },
|
||
volume: 1.0,
|
||
},
|
||
}
|
||
}
|
||
|
||
function generateUUID() {
|
||
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
|
||
const r = Math.random() * 16 | 0
|
||
return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16).toUpperCase()
|
||
})
|
||
}
|
||
|
||
function triggerDirScan(dir) {
|
||
const { execFile } = require('child_process')
|
||
const tmp = dir + '.slot_tmp'
|
||
if (process.platform === 'darwin') {
|
||
execFile('rsync', ['-a', dir + '/', tmp], (err) => {
|
||
try { require('fs').rmSync(tmp, { recursive: true, force: true }) } catch {}
|
||
})
|
||
}
|
||
}
|
||
|
||
// ============================================================================
|
||
// 添加 TTS 配音
|
||
// ============================================================================
|
||
|
||
async function addVoiceover(draftUrl, inputDir, items, timeline, audioUrls = {}) {
|
||
// 优先使用 segments[] 逐段添加（精确对齐）
|
||
// 无 segments 时降级为旧的整段方式
|
||
const segmentsFlat = []
|
||
|
||
for (let i = 0; i < items.length; i++) {
|
||
const item = items[i]
|
||
const tl = timeline[i]
|
||
if (!item.audio) continue
|
||
|
||
if (item.segments && item.segments.length > 0) {
|
||
// 使用 segments 精确添加
|
||
for (const seg of item.segments) {
|
||
if (!seg.audio || seg.error) continue
|
||
const audioUrl = seg.audio.startsWith('http')
|
||
? seg.audio
|
||
: (audioUrls[seg.audio] || path.resolve(inputDir, seg.audio))
|
||
const segDurUs = Math.round(seg.duration * US)
|
||
const segStartUs = tl.start + Math.round(seg.startOffset * US)
|
||
segmentsFlat.push({
|
||
audio_url: audioUrl,
|
||
start: segStartUs,
|
||
end: segStartUs + segDurUs,
|
||
duration: segDurUs,
|
||
volume: 1.0,
|
||
})
|
||
}
|
||
} else {
|
||
// 降级：整段添加
|
||
const audioUrl = item.audio.startsWith('http')
|
||
? item.audio
|
||
: (audioUrls[item.audio] || path.resolve(inputDir, item.audio))
|
||
const audioDurUs = item.audioDuration ? item.audioDuration * US : tl.duration
|
||
segmentsFlat.push({
|
||
audio_url: audioUrl,
|
||
start: tl.start,
|
||
end: tl.start + audioDurUs,
|
||
duration: audioDurUs,
|
||
volume: 1.0,
|
||
})
|
||
}
|
||
}
|
||
|
||
if (segmentsFlat.length === 0) {
|
||
console.log(' 无 TTS 音频文件，跳过')
|
||
return
|
||
}
|
||
|
||
// 逐个添加音频（CapCut API 批量添加不稳定）
|
||
let addedCount = 0
|
||
for (const audioInfo of segmentsFlat) {
|
||
try {
|
||
await api('add_audios', {
|
||
draft_url: draftUrl,
|
||
audio_infos: JSON.stringify([audioInfo]),
|
||
})
|
||
addedCount++
|
||
} catch (err) {
|
||
console.error(` 音频添加失败: ${err.message.slice(0, 80)}`)
|
||
}
|
||
}
|
||
const ossCount = segmentsFlat.filter(a => a.audio_url.startsWith('http')).length
|
||
console.log(` 已添加 ${addedCount}/${segmentsFlat.length} 段 TTS 配音 (${ossCount} 段 OSS)`)
|
||
}
|
||
|
||
// ============================================================================
|
||
// 添加 BGM
|
||
// ============================================================================
|
||
|
||
async function addBGM(draftUrl, bgmUrl, totalDurationUs) {
|
||
let audioDuration = totalDurationUs
|
||
try {
|
||
const durRes = await api('get_audio_duration', { mp3_url: bgmUrl })
|
||
if (durRes.duration) audioDuration = durRes.duration
|
||
} catch (_) {}
|
||
|
||
const fadeIn = 500000
|
||
const fadeOut = 1000000
|
||
|
||
await api('add_audios', {
|
||
draft_url: draftUrl,
|
||
audio_infos: JSON.stringify([{
|
||
audio_url: bgmUrl,
|
||
duration: audioDuration,
|
||
end: Math.min(audioDuration, totalDurationUs),
|
||
start: 0,
|
||
volume: 0.15,
|
||
fade_in_duration: fadeIn,
|
||
fade_out_duration: fadeOut,
|
||
}]),
|
||
})
|
||
console.log(` 已添加 BGM (${(audioDuration / US).toFixed(1)}s, fade 0.5s/1s)`)
|
||
}
|
||
|
||
// ============================================================================
|
||
// 添加字幕
|
||
// ============================================================================
|
||
|
||
async function addSubtitles(draftUrl, items, timeline, style = {}, split = false) {
|
||
const captions = []
|
||
|
||
const animStyle = {
|
||
inAnimation: style.inAnimation || '',
|
||
outAnimation: style.outAnimation || '',
|
||
inAnimDuration: style.inAnimationDuration || null,
|
||
outAnimDuration: style.outAnimationDuration || null,
|
||
}
|
||
|
||
for (let i = 0; i < items.length; i++) {
|
||
const item = items[i]
|
||
const text = item.script || item.text || item.caption || ''
|
||
if (!text) continue
|
||
|
||
const tl = timeline[i]
|
||
|
||
if (split && item.segments && item.segments.length > 0) {
|
||
// 精确字幕模式：使用 segments 实测时长，逐段添加字幕
|
||
for (const seg of item.segments) {
|
||
if (seg.error || !seg.text) continue
|
||
const segStartUs = tl.start + Math.round(seg.startOffset * US)
|
||
const segDurUs = Math.round(seg.duration * US)
|
||
|
||
const cap = {
|
||
start: segStartUs,
|
||
end: segStartUs + segDurUs,
|
||
text: seg.text,
|
||
}
|
||
|
||
applyAnimationProps(cap, animStyle)
|
||
captions.push(cap)
|
||
}
|
||
} else if (split) {
|
||
// 降级：按字符比例分配（无 segments 时）
|
||
const sentences = splitTextIntoSentences(text)
|
||
if (sentences.length === 0) continue
|
||
|
||
const totalDuration = tl.end - tl.start
|
||
const totalChars = sentences.reduce((sum, s) => sum + s.length, 0)
|
||
let currentTime = tl.start
|
||
|
||
sentences.forEach((sentence, idx) => {
|
||
const charRatio = sentence.length / totalChars
|
||
let duration = Math.round(totalDuration * charRatio)
|
||
|
||
if (idx === sentences.length - 1) {
|
||
duration = tl.end - currentTime
|
||
}
|
||
|
||
duration = Math.max(duration, 500000)
|
||
|
||
const cap = {
|
||
start: currentTime,
|
||
end: currentTime + duration,
|
||
text: sentence,
|
||
}
|
||
|
||
applyAnimationProps(cap, animStyle)
|
||
captions.push(cap)
|
||
currentTime += duration
|
||
})
|
||
} else {
|
||
const cap = {
|
||
start: tl.start,
|
||
end: tl.end,
|
||
text,
|
||
}
|
||
|
||
applyAnimationProps(cap, animStyle)
|
||
captions.push(cap)
|
||
}
|
||
}
|
||
|
||
if (captions.length === 0) {
|
||
console.log(' 无字幕内容，跳过')
|
||
return
|
||
}
|
||
|
||
const commonStyle = {
|
||
font: style.font || null,
|
||
font_size: style.fontSize || 15,
|
||
text_color: style.color || '#ffffff',
|
||
alignment: 1,
|
||
bold: style.bold || false,
|
||
italic: false,
|
||
underline: false,
|
||
has_shadow: style.hasShadow || false,
|
||
shadow_info: style.shadowAlpha ? {
|
||
shadow_alpha: style.shadowAlpha,
|
||
shadow_color: style.shadowColor || '#000000',
|
||
shadow_diffuse: 15,
|
||
shadow_distance: 5,
|
||
shadow_angle: -45,
|
||
} : undefined,
|
||
letter_spacing: style.letterSpacing || 0,
|
||
line_spacing: style.lineSpacing || 0,
|
||
alpha: style.alpha || 1,
|
||
scale_x: 1, scale_y: 1,
|
||
transform_x: 0,
|
||
transform_y: style.transformY || 0,
|
||
style_text: 0,
|
||
}
|
||
|
||
// 逐条添加字幕（CapCut API 批量添加不稳定）
|
||
let addedCount = 0
|
||
for (const cap of captions) {
|
||
try {
|
||
await api('add_captions', {
|
||
draft_url: draftUrl,
|
||
captions: JSON.stringify([cap]),
|
||
...commonStyle,
|
||
})
|
||
addedCount++
|
||
} catch (err) {
|
||
console.error(` 字幕添加失败: ${err.message.slice(0, 80)}`)
|
||
}
|
||
}
|
||
console.log(` 已添加 ${addedCount}/${captions.length} 条字幕${split ? ' (分句模式)' : ''} (字体: ${style.font || '默认'}, 动画: ${animStyle.inAnimation || '无'} → ${animStyle.outAnimation || '无'})`)
|
||
}
|
||
|
||
// ============================================================================
|
||
// 添加关键字氛围词
|
||
// ============================================================================
|
||
|
||
async function addKeywordOverlays(draftUrl, items, timeline, style = {}) {
|
||
const keywordItems = items.filter(item => item.keyword)
|
||
if (keywordItems.length === 0) {
|
||
console.log(' 无关键字，跳过')
|
||
return
|
||
}
|
||
|
||
const captions = []
|
||
for (let i = 0; i < items.length; i++) {
|
||
const item = items[i]
|
||
if (!item.keyword) continue
|
||
const tl = timeline[i]
|
||
|
||
const cap = {
|
||
start: tl.start,
|
||
end: tl.end,
|
||
text: item.keyword,
|
||
}
|
||
applyAnimationProps(cap, style)
|
||
|
||
captions.push(cap)
|
||
}
|
||
|
||
if (captions.length === 0) return
|
||
|
||
await api('add_captions', {
|
||
draft_url: draftUrl,
|
||
captions: JSON.stringify(captions),
|
||
font: style.font || null,
|
||
font_size: style.fontSize || 60,
|
||
text_color: style.color || '#FFFFFF',
|
||
alignment: 1,
|
||
bold: style.bold || false,
|
||
has_shadow: style.hasShadow || false,
|
||
shadow_info: style.shadowAlpha ? {
|
||
shadow_alpha: style.shadowAlpha,
|
||
shadow_color: style.shadowColor || '#000000',
|
||
shadow_diffuse: 15,
|
||
shadow_distance: 5,
|
||
shadow_angle: -45,
|
||
} : undefined,
|
||
alpha: style.alpha || 1,
|
||
scale_x: 1, scale_y: 1,
|
||
transform_x: 0,
|
||
transform_y: style.transformY || 0,
|
||
text_effect: style.textEffect || null,
|
||
})
|
||
console.log(` 已添加 ${captions.length} 个关键字氛围词 (效果: ${style.textEffect || '无'})`)
|
||
}
|
||
|
||
// ============================================================================
|
||
// 添加特效
|
||
// ============================================================================
|
||
|
||
async function addEffects(draftUrl, effectsStr, totalDurationUs) {
|
||
const effectNames = effectsStr.split(',').map(s => s.trim()).filter(Boolean)
|
||
const effectInfos = effectNames.map(name => ({
|
||
effect_title: name,
|
||
start: 0,
|
||
end: totalDurationUs,
|
||
}))
|
||
|
||
await api('add_effects', {
|
||
draft_url: draftUrl,
|
||
effect_infos: JSON.stringify(effectInfos),
|
||
})
|
||
|
||
console.log(` 已添加: ${effectNames.join(', ')}`)
|
||
}
|
||
|
||
// ============================================================================
|
||
// 添加滤镜
|
||
// ============================================================================
|
||
|
||
async function addFilter(draftUrl, filterStr, totalDurationUs) {
|
||
const [name, intensity] = filterStr.split(':')
|
||
await api('add_filters', {
|
||
draft_url: draftUrl,
|
||
filter_infos: JSON.stringify([{
|
||
filter_title: (name || '').trim(),
|
||
start: 0,
|
||
end: totalDurationUs,
|
||
intensity: parseFloat(intensity) || 50,
|
||
}]),
|
||
})
|
||
console.log(` 已添加: ${(name || '').trim()} 强度 ${intensity || 50}`)
|
||
}
|
||
|
||
module.exports = {
|
||
loadAccountConfig,
|
||
loadSubtitleStyle,
|
||
loadKeywordStyle,
|
||
loadKenBurns,
|
||
loadTransitions,
|
||
getTransition,
|
||
addImages,
|
||
addVideos,
|
||
addKenBurns,
|
||
addVoiceover,
|
||
addBGM,
|
||
addSubtitles,
|
||
addKeywordOverlays,
|
||
addSlots,
|
||
addSlotsLocally,
|
||
addEffects,
|
||
addFilter,
|
||
}
|