storyforge/n8n/README.md

n8n Workflows

本目录保存 StoryForge 的工作流导出文件，避免流程只存在于 n8n UI。

工作流

• workflows/storyforge-analysis.json：内容分析主线
• workflows/storyforge-real-cut.json：Windows cutvideo 调度主线
• workflows/storyforge-ai-video.json：huobao-drama AI 生成视频主线
• workflows/storyforge-content-source-sync.json：内容源账号同步与批量分析派发主线

约定

• 工作流内部调用地址通过 STORYFORGE_INTERNAL_BASE_URL 注入
• 工作流内部调用密钥通过 STORYFORGE_ORCHESTRATOR_SECRET 注入
• Docker Compose 默认把它们映射成：
  • STORYFORGE_INTERNAL_BASE_URL=http://collector:8081
  • STORYFORGE_ORCHESTRATOR_SECRET=$ORCHESTRATOR_SHARED_SECRET
• 如果你的 n8n 跑在宿主机或云服务器，而 collector 跑在别处，只需要改这两个环境变量，不要再手改 workflow JSON

导入

1. 先执行 docker compose up -d n8n collector
2. 打开 http://127.0.0.1:5670
3. 从 UI 导入本目录下的 4 个 JSON
4. 确认 n8n 运行环境里已设置 STORYFORGE_INTERNAL_BASE_URL 和 STORYFORGE_ORCHESTRATOR_SECRET
5. 激活工作流

Webhook 路径

• /webhook/storyforge-analysis
• /webhook/storyforge-real-cut
• /webhook/storyforge-ai-video
• /webhook/storyforge-content-source-sync