脚本拆解

功能定位

脚本拆解用于把视频资源送入本地执行链路，完成场景切分、语音转写和结果组装，再由本地网关回写到云端。

执行链路

当前链路分为两段：

• 云端后台：发起任务、记录任务状态、接收回调结果
• 本地网关：受理任务、调用 Python worker、落地中间结果、回调云端

本地执行能力

本地 worker 负责：

• 源视频解析
• 场景检测
• WhisperX 转写
• 结果拼装
• 回调云端接口

业务侧需要关注什么

• 原始视频是否已经到达共享盘可访问目录
• 当前任务是处理中、成功还是失败
• 拆解结果是否已经成功回写
• 本地机器模型和依赖是否完整

常见异常

任务长时间处理中

优先检查本地网关和 worker 是否都在线。

有回调但结果为空

优先检查输入视频是否有效、场景检测是否产出片段、转写模型是否正常执行。

本地无法启动

优先检查 Python 依赖、ffmpeg 和模型配置。