# 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` 本机调用

状态：进行中