使用 Laravel 对 Mux Robots Directives 进行队列化处理
内容提要
文章介绍在视频流应用 RoboTube 中，使用 Laravel Queues 配合 Mux Robots Directives 处理上传后的 AI 工作流。Directives 负责视频专属的依赖编排，例如等待字幕就绪后再生成章节和关键时刻；Laravel 队列负责触发任务、处理 Webhook、将结果同步到 Convex 并恢复丢失事件。作者将审核与结构化增强拆分为两个 Directive，审核失败即停止后续流程。动态翻译因参数不固定，仍使用独立队列任务。
延伸解读
职责分离：Directives 与 Laravel 队列各司其职
文章强调，Mux Robots Directives 并未取代 Laravel 队列，而是改变了队列的职责。Directives 负责视频专属的依赖编排，例如等待字幕就绪后再生成章节和关键时刻；Laravel 队列则专注于触发任务、处理 Webhook、将结果同步到 Convex 以及恢复丢失事件。这种分离让 Mux 管理视频智能工作流，Laravel 提供与应用程序其余部分的持久集成，从而降低应用层代码的复杂度。
为何拆分为两个 Directive：审核与结构化增强
RoboTube 刻意使用两个 Directive：一个仅包含审核工作流，另一个负责结构化增强（摘要、关键时刻、最佳缩略图）。这样拆分是为了用户体验：如果审核拒绝视频，结构化增强流程就不会启动。这简化了基础设施代码、节省成本，并自动保护用户免受不当内容影响。Laravel 只需编排这两个目的不同的 Directive，职责清晰。
持久化与恢复：Directive ID 与轮询器的作用
当 Mux Robots 接受 Directive 运行后，会返回 Directive ID，应用将其存储为凭据。每次重试都会先检查该凭据，如果远程运行已存在，Laravel 会进行协调而不是重复创建。此外，由于 Webhook 可能丢失或队列工作器可能重启，作者添加了轮询器来获取 Directive 运行状态，恢复子任务 ID，并通过与 Webhook 处理器相同的状态转换处理结果，确保成功与失败的定义一致。
动态翻译为何仍用独立队列任务
文章指出，RoboTube 允许用户请求多种语言的字幕或音频翻译，这种工作流不适合使用 Directives，因为用户可以选择任意目标语言。Directive 定义中存储了工作流参数，为每种可能的翻译场景创建 Directive 并不合理。因此，动态翻译仍作为独立的 Mux Robots 队列任务处理。这体现了根据用户行为类型选择不同技术方案的思路：稳定产品行为用 Directive，动态输入用独立任务。
Q&A
在 RoboTube 中，Mux Robots Directives 和 Laravel Queues 各自负责什么？
Mux Robots Directives 负责视频专属的工作流依赖编排，例如等待字幕就绪后再生成章节和关键时刻，并管理并行任务。Laravel Queues 负责应用层的持久化工作，包括可靠地触发 Directives、处理 Mux Webhooks、将结果同步到 Convex 以及恢复丢失的事件。
为什么 RoboTube 将审核和结构化增强拆分成两个 Directive？
因为如果用户上传的视频未通过审核，就不应启动后续的结构化增强流程。拆分后，审核失败会直接停止后续流程，这样既简化了基础设施代码，又节省了成本，并自动保护用户免受不当内容影响。
Laravel Queues 在 Directives 架构下如何避免重复执行昂贵的远程任务？
当 Mux Robots 接受 Directive 运行后，会返回一个 Directive ID，应用会存储这个凭证。每次重试时，Laravel 会先检查该凭证：如果远程运行已存在，则进行协调而不是重新创建，从而避免盲目启动相同的昂贵工作。
为什么 RoboTube 仍然使用独立的 Laravel 队列任务处理动态翻译？
因为动态翻译的目标语言由用户在请求时选择，参数不固定，而 Directive 的工作流参数是存储在定义中的。为每种可能的翻译场景创建 Directive 不现实，因此动态翻译仍作为独立的 Mux Robots 队列任务处理。
RoboTube 如何恢复丢失的 Webhook 事件？
RoboTube 添加了一个轮询器（poller）。它获取 Directive 运行以恢复子 Mux Robots 任务 ID，然后获取任何完成 Webhook 可能丢失的子任务，并将这些结果通过 Webhook 处理器使用的相同状态转换进行处理，确保两者对成功和失败的判断一致。
使用 Mux Robots Directives 后，Laravel 队列还承担哪些职责？
Laravel 队列仍然负责在应用边界进行重试、退避和速率限制，可靠地触发审核和结构化增强两个 Directive，处理 Mux Webhooks，将结果同步到 Convex，以及从丢失的事件中恢复。
