一、 模块化工程架构 (The Architecture)

参考 SSY 的模块化一致性设计与 Medeo 的时序流逻辑，将系统解耦为四大仿生模块。

二、 故事线场景深度优化

三、 智能体工程核心逻辑 (Python)

实现“自动解析关键帧”与“分批流水线”的核心代码。

class VideoProject:
    def __init__(self, script_json):
        # Project Manifest: 维护所有资产状态
        # list of {id, prompt, audio, duration, asset_path}
        self.timeline = script_json  

    async def batch_generate_assets(self):
        # 智能分包策略：解决并发限制 (10/20规则)
        batch_size = 10
        batches = [self.timeline[i:i + batch_size] for i in range(0, len(self.timeline), batch_size)]
        
        for batch in batches:
            # 并行生成当前批次
            tasks = [nanobanana.generate(scene['prompt']) for scene in batch]
            results = await asyncio.gather(*tasks)
            
            # 【关键体验】Batch A 完成即刻预渲染，前端无需等待全片
            # 实现了“边生成边播放”的流式体验
            await self.render_preview_clip(batch)

    def regenerate_scene_asset(self, scene_id, new_prompt):
        # 用户修改 Prompt 后，仅重绘该帧
        new_asset = nanobanana.generate_sync(new_prompt)
        
        # 更新 Manifest
        scene = self.get_scene(scene_id)
        scene['asset_path'] = new_asset
        
        # Smart Render: 利用 FFmpeg concat demuxer 仅替换片段
        # 无需重编全片，实现秒级响应
        return ffmpeg.smart_replace(self.full_video, scene_id, new_asset)

四、 用户体验地图 (UX Map) & 测试指标