feat: auto stage real-cut inputs to cutvideo

docs/AUDIT_2026-03-18.md

@@ -79,14 +79,16 @@
 - 仓库：`/Users/kris/code/cutvideo`
 - 具备清晰 API：
   - `POST /api/jobs`
+  - `POST /api/uploads`
   - `GET /api/tasks/{task_id}`
   - `GET /api/runs/{run_id}`
 - 适合集成为“由 StoryForge 后端授权调用的局域网剪辑能力”
 
-当前限制：
+当前状态：
 
-- 现有 `cutvideo` API 主要接受 `input_dir`
-- 对“用户上传实拍素材后直接推送到 Windows 机器”这一步，还缺一层文件转运方案
+- StoryForge 已支持把 `upload_video` 或已完成的 `video_link` 源素材自动上传到 `cutvideo`
+- `real-cut` 任务可直接传 `source_job_id`，由后端完成 staging 后再提交到剪辑服务
+- Windows 机器还需要部署带 `POST /api/uploads` 的 `cutvideo` 分支版本
 
 ### 4. `huobao-drama`
 

docs/LAN_E2E_GUIDE_2026-03-18.md

@@ -100,12 +100,14 @@ docker compose up -d --build
 
 当前 MVP 前提：
 
-- `input_dir` 必须是 Windows `cutvideo` 机器可访问的目录
-- 该目录中的素材已准备好
+- 方式 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`
@@ -113,6 +115,7 @@ docker compose up -d --build
 已验证样例：
 
 - `job_5ebd829c3f2144bca5c941183e75bdcd`
+- `job_01a6f283cbda42e4ae692b268b811a50` (`source_job_id` 自动 staging，本机 `cutvideo` 联调)
 - Windows 返回 `task_id=8d8f4a0cd5d9`
 - 运行目录 `20260318-093520-Windows cutvideo 联调样例`
 

docs/MVP_STATUS_2026-03-18.md

@@ -13,6 +13,7 @@
 - 本地 `ffmpeg` / `whisper` 风格入口封装
 - 本地大模型内容分析、二创文案、分镜生成
 - Windows `cutvideo` API 调度与结果回写接口
+- `upload_video -> source_job_id -> cutvideo` 自动 staging 闭环
 - 本机 `huobao-drama` API 调度、首尾帧生成、视频生成与结果回写接口
 - FastGPT 运行时依赖删除
 
@@ -20,6 +21,7 @@
 
 - 分析链路：`job_203bc8e9b20f4b1cbbc6cf7da79e46f4`
 - 实拍剪辑链路：`job_5ebd829c3f2144bca5c941183e75bdcd`
+- 实拍剪辑自动 staging 联调：`job_01a6f283cbda42e4ae692b268b811a50`
 - AI 视频链路：`job_01828c40377747cf914b51be360cc333`
 
 ## 已实现但仍待环境验证
@@ -28,14 +30,12 @@
 
 ## 尚未完全跑通
 
-- 用户上传实拍素材后，自动把素材转运到 Windows `cutvideo` 机器的闭环
 - 对“抖音 / bilibili / 小红书账号级内容源”的批量抓取与分析调度
-- `huobao-drama` 本地兼容补丁向 upstream 仓库的迁移、分支化和提交
+- Windows 机器上的 `cutvideo` 需要同步部署带 `POST /api/uploads` 的版本，当前自动 staging 已在本机联调通过
 
 ## 下一步优先级
 
-1. 把 `huobao-drama` 本地兼容补丁迁到 `/Users/kris/code/huobao-drama-upstream`
+1. 把 `cutvideo` 新上传接口部署到 Windows 机器
 2. 绑定你的真实 ASR 入口
-3. 决定实拍素材转运方案：共享目录优先，上传 API 作为备选
-4. 补账号级内容源抓取调度
-5. 把改动整理成提交并推送
+3. 补账号级内容源抓取调度
+4. 把改动整理成提交并推送