用途:本技能围绕 Trigger.dev 的客户端与前端实时能力,帮助前端订阅任务运行(run)状态并消费实时数据,属于 SDK 随包附带的版本固定参考。
主要能力:运行订阅(runs.subscribeToRun)、React Hooks(@trigger.dev/react-hooks 的 useRealtimeRun)、流(streams)、前端触发,以及作用域令牌(scoped tokens)。
使用方式:完整参考随已安装的 @trigger.dev/sdk 一同提供,应优先阅读,因为它与项目中的 SDK 版本始终一致。技能文件位于 node_modules/@trigger.dev/sdk/skills/trigger-realtime-and-frontend/SKILL.md;文档位于 node_modules/@trigger.dev/sdk/docs/realtime/,可用 grep 检索具体 Hook。若路径不存在,说明尚未安装 @trigger.dev/sdk;在非扁平(non-hoisted)布局下可用 node -p "require.resolve('@trigger.dev/sdk/package.json')" 定位包,再读取旁边的 skills/ 与 docs/。
限制与常见错误:浏览器触发任务不能用 createPublicToken 生成的读令牌,须用 auth.createTriggerPublicToken("my-task") 生成一次性触发令牌;无作用域的令牌会导致所有订阅返回 403,应如 auth.createPublicToken({ scopes: { read: { runs: ["run_1234"] } } }) 指定作用域;不要用 useRun/SWR 轮询做实时更新,实时追踪应用 useRealtimeRun,若仍用 useRun 可设 refreshInterval: 0 停止轮询;实时/触发 Hook 不能用于服务端组件,使用它们的组件需加 "use client";不需渲染的 payload/output 可用 skipColumns: ["payload", "output"] 减少传输量;应在触发返回句柄后再订阅,并加 enabled: !!handle 作为守卫。
适用场景:需要在 React 前端实时展示任务进度、状态徽章或流式数据的应用。资料未提供收费、价格与平台等信息。