安裝
npm install workflow適合誰
這份技能適合要在 TypeScript 或 JavaScript 裡寫「可持久」函式的人:官方寫明它會儲存工作流進度、重試失敗步驟,並提供內建可觀測性。它也適合已經在用 Next.js、準備在設定裡接入官方封裝的人。
它不適合只想在瀏覽器裡直接啟動工作流的人。原文把啟動位置限定在 API 路由、Server Action 或其他服務端程式碼。若你還不能執行 npm,或不能接受一次本機裝包,先停在閱讀說明。
裝包之後,編碼代理可以從 node_modules/workflow/docs 閱讀與目前版本匹配的指南。官方倉庫見
https://github.com/vercel/workflow
請按該頁已寫出的命令操作。
3 分鐘完成第一次嘗試
只走官方寫出的這一條安裝路徑。
前置條件:本機可以執行 npm,目前目錄是一個允許寫入依賴的專案。先確認:npm install workflow 會改依賴清單並下載套件。若你還不想改這個專案,不要執行。
安裝位置:在專案根目錄開啟終端,確認上述副作用後執行:
npm install workflow
低風險任務:裝包完成後,不要急著在現網路由裡啟動工作流。先讓編碼代理唯讀開啟 node_modules/workflow/docs,核對能否看到與目前版本匹配的本機指南,並找出 Next.js 應使用的匯入語句。不要寫入檔案,不要對外發請求。
成功訊號:專案依賴裡出現 workflow 套件,本機能開啟 node_modules/workflow/docs,並且代理能指出官方匯入 import { withWorkflow } from 'workflow/next'。若代理編造其他安裝命令,回到上面的官方命令重試。
使用案例
案例一:給 Next.js 專案接上官方封裝。原文給出的匯入是 import { withWorkflow } from 'workflow/next'。適合已經有 Next.js 專案、想先核對設定入口的人。可先讓代理唯讀標出應改的設定檔,確認後再寫入。原文沒有展開完整設定物件時,只做到「使用該匯入」,不要自行補未出現的選項。
案例二:從服務端啟動一段可持久的工作流。原文寫明隨後可以從 API 路由、Server Action 或其他服務端程式碼啟動工作流。適合已經裝好套件、並且有一處服務端入口的人。第一次請先讓代理指出準備從哪一個現有服務端入口啟動,不要新建未說明的用戶端入口。進度會持久化、失敗步驟會重試;至於重試次數和觀測面板怎麼開啟,原文沒有寫,不要補。
使用界線
官方安裝命令只有一條被原文寫出:npm install workflow。不要把未出現的安裝程式寫進主路徑。能力涵蓋 TypeScript 和 JavaScript 函式的持久化、失敗重試和內建可觀測性,沒有證明可用於其他語言。
啟動位置只寫到 API 路由、Server Action 或其他服務端程式碼。不要從瀏覽器或未點名的用戶端直接啟動。本機文件路徑是 node_modules/workflow/docs,供編碼代理閱讀與版本匹配的指南;它沒有給出用戶端名單,不能據此寫成某幾個助手獨佔。
金鑰、佇列後端和生產觀測帳號原文沒有展開。官方頁面是
https://github.com/vercel/workflow
若代理建議的命令與該頁不一致,以該頁為準。