workflow

用途：让使用 Vercel Workflow SDK（workflow / @workflow/*）构建的应用连接到自托管的 Platformatic Workflow Service，适配器为 @platformatic/world。不覆盖 Workflow Service 本身的部署，需假定用户已提供可访问的 PLT_WORLD_SERVICE_URL。前置条件为 Node.js v22.19.0+，本地服务通常由 npx @platformatic/workflow postgresql://... 启动在 http://localhost:3042，并需已有 package.json。核心安装：npm install workflow @platformatic/world。Next.js 下在根目录创建 instrumentation.ts，在 register() 中调用 createWorld() 与 world.start()，并设置 WORKFLOW_TARGET_WORLD=@platformatic/world 与 PLT_WORLD_SERVICE_URL 等环境变量；通用 Node 需在启动时显式调用 world.start()。Fastify 可选用 @platformatic/workflow-fastify 插件，先执行 npx workflow build --target standalone 生成 .well-known/workflow/v1/ 下的处理器与 manifest.json，再注册插件。触发用 workflow/api 的 start（可按导入引用或 workflowId 字符串），恢复钩子用 resumeHook。环境变量包括必填的 WORKFLOW_TARGET_WORLD、PLT_WORLD_SERVICE_URL，可选 PLT_WORLD_APP_ID、PLT_WORLD_DEPLOYMENT_VERSION、PORT。限制：world.start() 每进程须在接收流量前调用一次，K8s + ICC 下为空操作；standalone 构建目录不应提交；Next.js 无需 standalone 构建；服务需单独启动。具体价格与部署细节暂未提供。