455 lines
14 KiB
TypeScript
455 lines
14 KiB
TypeScript
import type { Job } from 'bullmq'
|
||
import { beforeEach, describe, expect, it, vi } from 'vitest'
|
||
import { TASK_TYPE, type TaskJobData } from '@/lib/task/types'
|
||
|
||
type VoiceLineInput = {
|
||
lineIndex: number
|
||
speaker: string
|
||
content: string
|
||
emotionStrength: number
|
||
matchedPanel: {
|
||
storyboardId: string
|
||
panelIndex: number
|
||
}
|
||
}
|
||
|
||
const reportTaskProgressMock = vi.hoisted(() => vi.fn(async () => undefined))
|
||
const assertTaskActiveMock = vi.hoisted(() => vi.fn(async () => undefined))
|
||
const chatCompletionMock = vi.hoisted(() => vi.fn(async () => ({ responseId: 'resp-1' })))
|
||
const getCompletionPartsMock = vi.hoisted(() => vi.fn(() => ({ text: 'voice lines json', reasoning: '' })))
|
||
const withInternalLLMStreamCallbacksMock = vi.hoisted(() =>
|
||
vi.fn(async (_callbacks: unknown, fn: () => Promise<unknown>) => await fn()),
|
||
)
|
||
const resolveProjectModelCapabilityGenerationOptionsMock = vi.hoisted(() =>
|
||
vi.fn(async () => ({ reasoningEffort: 'high' })),
|
||
)
|
||
const runScriptToStoryboardOrchestratorMock = vi.hoisted(() =>
|
||
vi.fn(async () => ({
|
||
clipPanels: [
|
||
{
|
||
clipId: 'clip-1',
|
||
panels: [
|
||
{
|
||
panelIndex: 1,
|
||
shotType: 'close-up',
|
||
cameraMove: 'static',
|
||
description: 'panel desc',
|
||
videoPrompt: 'panel prompt',
|
||
location: 'room',
|
||
characters: ['Narrator'],
|
||
},
|
||
],
|
||
},
|
||
],
|
||
summary: {
|
||
totalPanelCount: 1,
|
||
totalStepCount: 4,
|
||
},
|
||
})),
|
||
)
|
||
const parseVoiceLinesJsonMock = vi.hoisted(() => vi.fn())
|
||
const persistStoryboardsAndPanelsMock = vi.hoisted(() => vi.fn())
|
||
const parseStoryboardRetryTargetMock = vi.hoisted(() => vi.fn())
|
||
const runScriptToStoryboardAtomicRetryMock = vi.hoisted(() => vi.fn())
|
||
const workflowLeaseMock = vi.hoisted(() => ({
|
||
assertWorkflowRunActive: vi.fn(async () => undefined),
|
||
withWorkflowRunLease: vi.fn(async (params: { run: () => Promise<unknown> }) => ({
|
||
claimed: true,
|
||
result: await params.run(),
|
||
})),
|
||
}))
|
||
|
||
const txState = vi.hoisted(() => ({
|
||
createdRows: [] as Array<Record<string, unknown>>,
|
||
deletedWhereClauses: [] as Array<Record<string, unknown>>,
|
||
}))
|
||
|
||
const prismaMock = vi.hoisted(() => ({
|
||
project: {
|
||
findUnique: vi.fn(),
|
||
},
|
||
novelPromotionProject: {
|
||
findUnique: vi.fn(),
|
||
},
|
||
novelPromotionEpisode: {
|
||
findUnique: vi.fn(),
|
||
},
|
||
$transaction: vi.fn(),
|
||
}))
|
||
|
||
vi.mock('@/lib/prisma', () => ({ prisma: prismaMock }))
|
||
|
||
vi.mock('@/lib/llm-client', () => ({
|
||
chatCompletion: chatCompletionMock,
|
||
getCompletionParts: getCompletionPartsMock,
|
||
getCompletionContent: vi.fn(() => 'voice lines json'),
|
||
}))
|
||
|
||
vi.mock('@/lib/config-service', () => ({
|
||
resolveProjectModelCapabilityGenerationOptions: resolveProjectModelCapabilityGenerationOptionsMock,
|
||
getUserWorkflowConcurrencyConfig: vi.fn(async () => ({
|
||
analysis: 2,
|
||
image: 5,
|
||
video: 5,
|
||
})),
|
||
}))
|
||
|
||
vi.mock('@/lib/llm-observe/internal-stream-context', () => ({
|
||
withInternalLLMStreamCallbacks: withInternalLLMStreamCallbacksMock,
|
||
}))
|
||
|
||
vi.mock('@/lib/logging/semantic', () => ({
|
||
logAIAnalysis: vi.fn(),
|
||
}))
|
||
|
||
vi.mock('@/lib/logging/file-writer', () => ({
|
||
onProjectNameAvailable: vi.fn(),
|
||
}))
|
||
|
||
vi.mock('@/lib/constants', () => ({
|
||
buildCharactersIntroduction: vi.fn(() => 'characters-introduction'),
|
||
}))
|
||
|
||
vi.mock('@/lib/workers/shared', () => ({
|
||
reportTaskProgress: reportTaskProgressMock,
|
||
}))
|
||
|
||
vi.mock('@/lib/workers/utils', () => ({
|
||
assertTaskActive: assertTaskActiveMock,
|
||
}))
|
||
|
||
vi.mock('@/lib/novel-promotion/script-to-storyboard/orchestrator', () => ({
|
||
runScriptToStoryboardOrchestrator: runScriptToStoryboardOrchestratorMock,
|
||
JsonParseError: class JsonParseError extends Error {
|
||
rawText: string
|
||
|
||
constructor(message: string, rawText: string) {
|
||
super(message)
|
||
this.name = 'JsonParseError'
|
||
this.rawText = rawText
|
||
}
|
||
},
|
||
}))
|
||
vi.mock('@/lib/workers/handlers/llm-stream', () => ({
|
||
createWorkerLLMStreamContext: vi.fn(() => ({ streamRunId: 'run-1', nextSeqByStepLane: {} })),
|
||
createWorkerLLMStreamCallbacks: vi.fn(() => ({
|
||
onStage: vi.fn(),
|
||
onChunk: vi.fn(),
|
||
onComplete: vi.fn(),
|
||
onError: vi.fn(),
|
||
flush: vi.fn(async () => undefined),
|
||
})),
|
||
}))
|
||
|
||
vi.mock('@/lib/prompt-i18n', () => ({
|
||
PROMPT_IDS: {
|
||
NP_AGENT_STORYBOARD_PLAN: 'plan',
|
||
NP_AGENT_CINEMATOGRAPHER: 'cinematographer',
|
||
NP_AGENT_ACTING_DIRECTION: 'acting',
|
||
NP_AGENT_STORYBOARD_DETAIL: 'detail',
|
||
NP_VOICE_ANALYSIS: 'voice-analysis',
|
||
},
|
||
getPromptTemplate: vi.fn(() => 'prompt-template'),
|
||
buildPrompt: vi.fn(() => 'voice-analysis-prompt'),
|
||
}))
|
||
|
||
vi.mock('@/lib/workers/handlers/script-to-storyboard-helpers', () => ({
|
||
asJsonRecord: (value: unknown) => {
|
||
if (!value || typeof value !== 'object' || Array.isArray(value)) return null
|
||
return value as Record<string, unknown>
|
||
},
|
||
buildStoryboardJson: vi.fn(() => '[]'),
|
||
parseEffort: vi.fn(() => null),
|
||
parseTemperature: vi.fn(() => 0.7),
|
||
parseVoiceLinesJson: parseVoiceLinesJsonMock,
|
||
persistStoryboardsAndPanels: persistStoryboardsAndPanelsMock,
|
||
toPositiveInt: (value: unknown) => {
|
||
if (typeof value !== 'number' || !Number.isFinite(value)) return null
|
||
const n = Math.floor(value)
|
||
return n > 0 ? n : null
|
||
},
|
||
}))
|
||
vi.mock('@/lib/workers/handlers/script-to-storyboard-atomic-retry', () => ({
|
||
parseStoryboardRetryTarget: parseStoryboardRetryTargetMock,
|
||
runScriptToStoryboardAtomicRetry: runScriptToStoryboardAtomicRetryMock,
|
||
}))
|
||
vi.mock('@/lib/run-runtime/workflow-lease', () => workflowLeaseMock)
|
||
|
||
import { handleScriptToStoryboardTask } from '@/lib/workers/handlers/script-to-storyboard'
|
||
|
||
function buildJob(payload: Record<string, unknown>, episodeId: string | null = 'episode-1'): Job<TaskJobData> {
|
||
const runId = typeof payload.runId === 'string' && payload.runId.trim() ? payload.runId.trim() : 'run-test-storyboard'
|
||
const payloadMeta = payload.meta && typeof payload.meta === 'object' && !Array.isArray(payload.meta)
|
||
? (payload.meta as Record<string, unknown>)
|
||
: {}
|
||
const normalizedPayload: Record<string, unknown> = {
|
||
...payload,
|
||
runId,
|
||
meta: {
|
||
...payloadMeta,
|
||
runId,
|
||
},
|
||
}
|
||
return {
|
||
data: {
|
||
taskId: 'task-1',
|
||
type: TASK_TYPE.SCRIPT_TO_STORYBOARD_RUN,
|
||
locale: 'zh',
|
||
projectId: 'project-1',
|
||
episodeId,
|
||
targetType: 'NovelPromotionEpisode',
|
||
targetId: 'episode-1',
|
||
payload: normalizedPayload,
|
||
userId: 'user-1',
|
||
},
|
||
} as unknown as Job<TaskJobData>
|
||
}
|
||
|
||
function baseVoiceRows(): VoiceLineInput[] {
|
||
return [
|
||
{
|
||
lineIndex: 1,
|
||
speaker: 'Narrator',
|
||
content: 'Hello world',
|
||
emotionStrength: 0.8,
|
||
matchedPanel: {
|
||
storyboardId: 'storyboard-1',
|
||
panelIndex: 1,
|
||
},
|
||
},
|
||
]
|
||
}
|
||
|
||
describe('worker script-to-storyboard behavior', () => {
|
||
beforeEach(() => {
|
||
vi.clearAllMocks()
|
||
txState.createdRows = []
|
||
txState.deletedWhereClauses = []
|
||
parseStoryboardRetryTargetMock.mockReturnValue(null)
|
||
runScriptToStoryboardAtomicRetryMock.mockReset()
|
||
|
||
prismaMock.project.findUnique.mockResolvedValue({
|
||
id: 'project-1',
|
||
name: 'Project One',
|
||
mode: 'novel-promotion',
|
||
})
|
||
|
||
prismaMock.novelPromotionProject.findUnique.mockResolvedValue({
|
||
id: 'np-project-1',
|
||
analysisModel: 'llm::analysis-model',
|
||
characters: [{ id: 'char-1', name: 'Narrator' }],
|
||
locations: [{ id: 'loc-1', name: 'Office' }],
|
||
})
|
||
|
||
prismaMock.novelPromotionEpisode.findUnique.mockResolvedValue({
|
||
id: 'episode-1',
|
||
novelPromotionProjectId: 'np-project-1',
|
||
novelText: 'A complete chapter text for voice analyze.',
|
||
clips: [
|
||
{
|
||
id: 'clip-1',
|
||
content: 'clip content',
|
||
characters: JSON.stringify(['Narrator']),
|
||
location: 'Office',
|
||
screenplay: 'Screenplay text',
|
||
},
|
||
],
|
||
})
|
||
|
||
prismaMock.$transaction.mockImplementation(async (fn: (tx: {
|
||
novelPromotionVoiceLine: {
|
||
deleteMany: (args: { where: Record<string, unknown> }) => Promise<unknown>
|
||
create: (args: { data: Record<string, unknown>; select: { id: boolean } }) => Promise<{ id: string }>
|
||
}
|
||
}) => Promise<unknown>) => {
|
||
const tx = {
|
||
novelPromotionVoiceLine: {
|
||
deleteMany: async (args: { where: Record<string, unknown> }) => {
|
||
txState.deletedWhereClauses.push(args.where)
|
||
return undefined
|
||
},
|
||
create: async (args: { data: Record<string, unknown>; select: { id: boolean } }) => {
|
||
txState.createdRows.push(args.data)
|
||
return { id: `voice-${txState.createdRows.length}` }
|
||
},
|
||
},
|
||
}
|
||
return await fn(tx)
|
||
})
|
||
|
||
persistStoryboardsAndPanelsMock.mockResolvedValue([
|
||
{
|
||
storyboardId: 'storyboard-1',
|
||
panels: [{ id: 'panel-1', panelIndex: 1 }],
|
||
},
|
||
])
|
||
|
||
parseVoiceLinesJsonMock.mockReturnValue(baseVoiceRows())
|
||
})
|
||
|
||
it('缺少 episodeId -> 显式失败', async () => {
|
||
const job = buildJob({}, null)
|
||
await expect(handleScriptToStoryboardTask(job)).rejects.toThrow('episodeId is required')
|
||
})
|
||
|
||
it('成功路径: 写入 voice line 时包含 matchedPanel 映射后的 panelId', async () => {
|
||
const job = buildJob({ episodeId: 'episode-1' })
|
||
|
||
const result = await handleScriptToStoryboardTask(job)
|
||
|
||
expect(result).toEqual({
|
||
episodeId: 'episode-1',
|
||
storyboardCount: 1,
|
||
panelCount: 1,
|
||
voiceLineCount: 1,
|
||
})
|
||
|
||
expect(txState.createdRows).toHaveLength(1)
|
||
expect(txState.createdRows[0]).toEqual(expect.objectContaining({
|
||
episodeId: 'episode-1',
|
||
lineIndex: 1,
|
||
speaker: 'Narrator',
|
||
content: 'Hello world',
|
||
emotionStrength: 0.8,
|
||
matchedPanelId: 'panel-1',
|
||
matchedStoryboardId: 'storyboard-1',
|
||
matchedPanelIndex: 1,
|
||
}))
|
||
expect(txState.deletedWhereClauses[0]).toEqual({
|
||
episodeId: 'episode-1',
|
||
lineIndex: {
|
||
notIn: [1],
|
||
},
|
||
})
|
||
})
|
||
|
||
it('voice 解析失败后会重试一次再成功', async () => {
|
||
parseVoiceLinesJsonMock
|
||
.mockImplementationOnce(() => {
|
||
throw new Error('invalid voice json')
|
||
})
|
||
.mockImplementationOnce(() => baseVoiceRows())
|
||
|
||
const job = buildJob({ episodeId: 'episode-1' })
|
||
const result = await handleScriptToStoryboardTask(job)
|
||
|
||
expect(result).toEqual(expect.objectContaining({
|
||
episodeId: 'episode-1',
|
||
voiceLineCount: 1,
|
||
}))
|
||
expect(chatCompletionMock).toHaveBeenCalledTimes(2)
|
||
expect(parseVoiceLinesJsonMock).toHaveBeenCalledTimes(2)
|
||
expect(withInternalLLMStreamCallbacksMock).toHaveBeenCalledTimes(3)
|
||
const firstChatCall = chatCompletionMock.mock.calls[0] as unknown as [unknown, unknown, unknown, Record<string, unknown>] | undefined
|
||
expect(firstChatCall?.[3]).toEqual(expect.objectContaining({
|
||
action: 'voice_analyze',
|
||
streamStepId: 'voice_analyze',
|
||
streamStepAttempt: 1,
|
||
}))
|
||
const secondChatCall = chatCompletionMock.mock.calls[1] as unknown as [unknown, unknown, unknown, Record<string, unknown>] | undefined
|
||
expect(secondChatCall?.[3]).toEqual(expect.objectContaining({
|
||
action: 'voice_analyze',
|
||
streamStepId: 'voice_analyze',
|
||
streamStepAttempt: 2,
|
||
}))
|
||
expect(reportTaskProgressMock).toHaveBeenCalledWith(
|
||
job,
|
||
84,
|
||
expect.objectContaining({
|
||
stage: 'script_to_storyboard_step',
|
||
stepId: 'voice_analyze',
|
||
stepAttempt: 2,
|
||
message: '台词分析失败，准备重试 (2/2)',
|
||
}),
|
||
)
|
||
})
|
||
|
||
it('空台词数组 -> 成功完成并清空旧台词', async () => {
|
||
parseVoiceLinesJsonMock.mockReturnValue([])
|
||
|
||
const job = buildJob({ episodeId: 'episode-1' })
|
||
const result = await handleScriptToStoryboardTask(job)
|
||
|
||
expect(result).toEqual({
|
||
episodeId: 'episode-1',
|
||
storyboardCount: 1,
|
||
panelCount: 1,
|
||
voiceLineCount: 0,
|
||
})
|
||
expect(txState.createdRows).toEqual([])
|
||
expect(txState.deletedWhereClauses[0]).toEqual({
|
||
episodeId: 'episode-1',
|
||
})
|
||
})
|
||
|
||
it('phase 级重试: 仅执行原子 phase，不走整图重跑', async () => {
|
||
parseStoryboardRetryTargetMock.mockReturnValue({
|
||
stepKey: 'clip_clip-1_phase3_detail',
|
||
clipId: 'clip-1',
|
||
phase: 'phase3_detail',
|
||
})
|
||
runScriptToStoryboardAtomicRetryMock.mockResolvedValue({
|
||
clipPanels: [
|
||
{
|
||
clipId: 'clip-1',
|
||
clipIndex: 1,
|
||
finalPanels: [
|
||
{
|
||
panel_number: 1,
|
||
description: 'phase3 retry panel',
|
||
location: 'Office',
|
||
},
|
||
],
|
||
},
|
||
],
|
||
phase1PanelsByClipId: {},
|
||
phase2CinematographyByClipId: {},
|
||
phase2ActingByClipId: {},
|
||
phase3PanelsByClipId: {
|
||
'clip-1': [
|
||
{
|
||
panel_number: 1,
|
||
description: 'phase3 retry panel',
|
||
location: 'Office',
|
||
},
|
||
],
|
||
},
|
||
totalPanelCount: 1,
|
||
totalStepCount: 6,
|
||
})
|
||
|
||
const job = buildJob({
|
||
episodeId: 'episode-1',
|
||
retryStepKey: 'clip_clip-1_phase3_detail',
|
||
retryStepAttempt: 2,
|
||
})
|
||
const result = await handleScriptToStoryboardTask(job)
|
||
|
||
expect(result).toEqual({
|
||
episodeId: 'episode-1',
|
||
storyboardCount: 1,
|
||
panelCount: 1,
|
||
voiceLineCount: 0,
|
||
retryStepKey: 'clip_clip-1_phase3_detail',
|
||
})
|
||
expect(runScriptToStoryboardAtomicRetryMock).toHaveBeenCalledTimes(1)
|
||
expect(runScriptToStoryboardOrchestratorMock).not.toHaveBeenCalled()
|
||
expect(persistStoryboardsAndPanelsMock).toHaveBeenCalledWith({
|
||
episodeId: 'episode-1',
|
||
clipPanels: [
|
||
{
|
||
clipId: 'clip-1',
|
||
clipIndex: 1,
|
||
finalPanels: [
|
||
{
|
||
panel_number: 1,
|
||
description: 'phase3 retry panel',
|
||
location: 'Office',
|
||
},
|
||
],
|
||
},
|
||
],
|
||
})
|
||
})
|
||
})
|