storyforge/docs/IMPLEMENTATION_PLAN_2026-03-18.md

StoryForge 分阶段实施计划

日期：2026-03-18

Phase 0: 审计与基线收拢

• 确认主工作区
• 识别旧数据集运行链的真实职责
• 识别多用户、多项目需要的主数据模型
• 对比 huobao-drama 旧改版与 upstream
• 审计 cutvideo 接口能力

状态：已完成

Phase 1: 业务后端改造成主状态中心

• 引入 projects
• 引入 content_sources
• 引入 job_events
• 让 knowledge_bases / assistants / jobs 全部 project 化
• 去掉 collector-service 中的旧运行链逻辑
• 增加 agents 别名接口，统一 Agent 语义

状态：已完成首版

Phase 2: n8n 接管流程编排

• 公共任务创建接口只负责建任务并触发工作流
• n8n 负责分发：
  • analysis_pipeline
  • real_cut_pipeline
  • ai_video_pipeline
• 业务步骤落在 collector-service 内部接口，保证状态统一入库

状态：已完成首版

Phase 3: 内容分析主线 MVP

• 支持文本
• 支持视频链接
• 支持上传视频
• 接下载器
• 接本地 ASR
• 接本地 LLM
• 产出：
  • transcript
  • style_summary
  • analysis
  • rewrite
  • storyboards

状态：已完成首版

Phase 4: 实拍自动剪辑主线 MVP

• 建立 real_cut 任务类型
• 通过 n8n -> collector -> cutvideo 调度 Windows 机器
• 记录 task_id / run_id / 结果产物

状态：已完成 API 级集成

待补：

• 用户上传素材到 Windows 侧的文件转运闭环

Phase 5: AI 自动生成视频主线 MVP

• 建立 ai_video 任务类型
• 从分析结果或直接 brief 生成分镜
• 调 huobao-drama：
  • 创建 drama
  • 生成首帧
  • 生成尾帧
  • 基于首尾帧生成视频
• 结果回写任务

状态：已完成 API 级集成

Phase 6: 删除旧运行链依赖

• 删除代码依赖
• 删除 compose 服务
• 删除环境变量
• 删除 README 说明

状态：已完成主仓库首版

Phase 7: 联调与验证

• Python 语法检查
• Compose 配置检查
• collector-service 本地启动
• n8n workflow 导入
• Windows cutvideo 局域网调度
• huobao-drama 本机调用

状态：进行中