krisolo/storyforge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a906e0cedafec49386b843cbe41f3309e0956b10
storyforge/docs/LAN_E2E_GUIDE_2026-03-18.md

5.3 KiB
Raw Blame History

StoryForge 本地 / 局域网联调说明

日期：2026-03-18

1. 准备 .env

复制：

cd /Users/kris/code/StoryForge-gitea
cp .env.example .env

至少确认这些变量：

  • N8N_BASE_URL=http://127.0.0.1:5670，用于你在宿主机单独运行 collector-service
  • COLLECTOR_N8N_BASE_URL=http://n8n:5678，用于 Docker 里的 collector
  • ORCHESTRATOR_SHARED_SECRET=storyforge-local-secret
  • CUTVIDEO_BASE_URL=http://<windows-lan-ip>:7860
  • CUTVIDEO_API_KEY= 如果 Windows 服务启用了鉴权
  • HUOBAO_BASE_URL=http://127.0.0.1:5678
  • WHISPER_BIN= 指向你现有本地 ASR 可执行文件时填写
  • ASR_HTTP_BASE_URL= 如果你已有常驻 ASR 服务，填写它的基地址
  • ASR_HTTP_TRANSCRIBE_PATH=/transcribe
  • ASR_HTTP_FIELD_NAME=wav
  • ASR_HTTP_TIMEOUT_SEC=120

说明：

  • 如果你单独重建 collector，要确保运行时仍带上 CUTVIDEO_BASE_URL，否则容器会退回空值
  • collector 容器不要直接复用宿主机的 N8N_BASE_URL=http://127.0.0.1:5670，否则容器内会连回自己并导致 webhook 调度失败
  • 当前已验证可用的 Windows cutvideo 地址是 http://192.168.31.18:7860
  • 当前已验证可用的本机 HTTP ASR 入口是 http://host.docker.internal:8088/transcribe
  • 如果你用的是本机 mac-whisper-service，建议同时以 WHISPER_TIMEOUT_MS=120000 启动，否则长视频会直接 504

2. 启动基础服务

cd /Users/kris/code/StoryForge-gitea
docker compose up -d --build

检查：

  • collector-service：http://127.0.0.1:8081/healthz
  • n8n：http://127.0.0.1:5670
  • cli-proxy-api：http://127.0.0.1:8317
  • 本机 huobao-drama：http://127.0.0.1:5678/health

3. 导入 n8n workflows

从 n8n/workflows/ 导入：

  • storyforge-analysis.json
  • storyforge-real-cut.json
  • storyforge-ai-video.json
  • storyforge-content-source-sync.json

导入后：

  • 检查每个 HTTP Request 节点的 X-Orchestrator-Secret
  • 如果你改了 .env 的 secret，这里必须同步

4. 登录与审批

默认超级管理员：

  • 用户名：kris
  • 密码：Asd123456.

新用户注册后，需要用超级管理员审批。

5. 内容分析链路验证

文本

调用 POST /v2/explore/text

预期：

  • 任务创建成功
  • n8n webhook 被触发
  • 任务最终进入 completed
  • 知识库文档里出现 transcript / style_summary / analysis / storyboards

已验证样例：

  • job_203bc8e9b20f4b1cbbc6cf7da79e46f4

视频链接

调用 POST /v2/explore/video-link

前提：

  • yt-dlp 可用
  • ffmpeg 可用
  • ASR 可调用

已验证样例：

  • job_bb405e2e878849e38c4bb31f7781e1e3 (artifacts.asr_backend=http)

上传视频

调用 POST /v2/explore/upload-video

预期与视频链接类似，但素材来源为本地上传

6. 内容源账号同步验证

调用 POST /v2/pipelines/content-source-sync

推荐最小请求体：

{
  "source_url": "https://space.bilibili.com/546195/video",
  "platform": "bilibili",
  "title": "Bilibili Creator Sync Smoke",
  "max_items": 2,
  "skip_existing": true,
  "auto_trigger_analysis": true
}

预期：

  • 创建一个 content_source_sync 父任务
  • n8n 触发 content_source_sync_pipeline
  • 父任务写回 discovered_videos / child_job_ids / queued_job_ids
  • 子任务以 parent_job_id 挂到父任务下，并自动进入分析主线

已验证样例：

  • 父任务：job_b02109cf9e8244fbb5b86f184a7c7574
  • 子任务：job_7f169db61af441f8a7f186d03db2d91c
  • 子任务：job_28c47774028441378a3974860c375ab7

7. cutvideo 实拍剪辑链路验证

调用 POST /v2/pipelines/real-cut

当前 MVP 前提：

  • 方式 A：直接传 input_dir，它必须是 Windows cutvideo 机器可访问的目录
  • 方式 B：传 source_job_id，collector-service 会把 upload_video 或已完成的 video_link 源素材自动上传到 Windows cutvideo，再继续发起任务
  • 如果走方式 B，大文件上传超时由 CUTVIDEO_UPLOAD_TIMEOUT_SEC 控制

预期：

  • 任务创建成功
  • 如果用了 source_job_id，任务 artifacts.cutvideo_upload 会记录 Windows staging 结果
  • n8n 调用 collector-service 内部 real-cut step
  • 后端记录 provider_task_id
  • 最终任务写回 cutvideo_run

已验证样例：

  • job_5ebd829c3f2144bca5c941183e75bdcd
  • job_01a6f283cbda42e4ae692b268b811a50 (source_job_id 自动 staging，本机 cutvideo 联调)
  • Windows 返回 task_id=8d8f4a0cd5d9
  • 运行目录 20260318-093520-Windows cutvideo 联调样例

8. huobao-drama AI 视频链路验证

调用 POST /v2/pipelines/ai-video

推荐方式：

  • 先完成一个分析任务
  • 再把该分析任务的 source_job_id 传给 AI 视频任务

预期：

  • 创建 drama
  • 每个分镜生成首帧、尾帧
  • 每个分镜生成视频
  • 最终 job.result.rendered_scenes 有完整结果

已验证样例：

  • job_01828c40377747cf914b51be360cc333
  • provider_task_id=10
  • video.task_id=qvideo-1380265978-1773799215825814468
  • 最终视频已回写到 job.result.rendered_scenes[0].video.video_url

9. 当前已知卡点

  • Windows 机器上的 cutvideo 还需要部署带 POST /api/uploads 的新分支版本
  • 抖音 / 小红书账号级内容源还未做真实平台验证
  • huobao-drama 目前跑通依赖本地旧改版中的 qnaigc 兼容补丁，下一步要迁到 upstream 仓库