server-actions

此技能為在 Next.js 應用程式中使用 App Router 實作 Server Actions 提供全面支援。專為構建強大、全端 React 應用程式的開發者所設計，無需傳統 API 路由的複雜性即可管理伺服器端資料變更。該技能涵蓋了伺服器端操作的整個生命週期，從使用 'use server' 指令的基本函式定義，到複雜的狀態管理與效能優化。這是確保資料處理一致性與高效用戶端-伺服器通訊的必要工具。

• 支援在伺服器元件與獨立模組中實作非同步 Server Actions。

• 利用 React 的 useFormState 與 useFormStatus Hook 進行進階表單管理，追蹤處理中狀態與錯誤回應。

• 整合 Zod 結構驗證，確保伺服器端表單提交處理的安全性。

• 透過 revalidatePath 與 revalidateTag 進行智慧快取管理，確保變更後的 UI 資料保持更新。

• 支援包含樂觀 UI 更新 (optimistic UI) 與程式化導向 (redirect) 的流暢使用者體驗模式。

• 使用者應視需求在檔案或函式範圍內使用 'use server' 指令定義動作。

• 適用於表單提交與資料庫寫入緊密結合的場景，例如用戶註冊、個人檔案更新或內容建立。

• 實作時，請確保敏感邏輯保留在伺服器端，並使用正確的錯誤處理模式將狀態物件回傳給用戶端。

• 此技能協助將表單資料 (FormData) 對應至後端邏輯，支援型別安全與結構化錯誤扁平化。

• 效能提示：請謹慎使用重新驗證策略以平衡資料新鮮度與快取命中率；盡可能使用標籤 (tags) 進行精確無效化，而非大範圍路徑清除。