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) 进行精确无效化，而非大范围路径清除。