# 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`