用途:使用 Zod 构建类型安全的表单与 API 校验,覆盖客户端与服务端校验、API 请求/响应载荷校验、可复用校验 schema,以及从 schema 自动推断 TypeScript 类型。
主要能力:单一数据源(定义一次 schema 到处复用)、类型推断、运行时校验、用户友好的错误格式化、可组合 schema、API 集成;支持嵌套对象与数组校验、自定义校验器、schema 组合、部分更新(partial)、默认值、条件校验(discriminatedUnion)、转换与校验(transform/pipe)。
使用方式:先安装依赖 npm install zod(或 pnpm add zod)。在 lib/validation.ts 中定义 schema,例如 emailSchema、urlSchema、timestampSchema、youtubeUrlSchema、videoIdSchema、transcriptSegmentSchema,以及 generateTopicsRequestSchema、chatRequestSchema、createNoteSchema、registerSchema 等,并用 z.infer 导出类型。可编写 formatValidationError 与 formatZodErrors/getFieldError 格式化错误。API 路由中用 schema.parse(body) 校验,捕获 z.ZodError 返回 400 与错误详情;表单中配合 react-hook-form 与 @hookform/resolvers/zod 的 zodResolver 使用。
适用场景:注册/登录等表单、API 请求响应校验、复杂嵌套对象与数组、多步骤表单、支付等条件校验、PATCH 部分更新。
限制:资料未提供该技能的收费、价格、平台支持范围与效果数据;示例基于 Zod 与 React Hook Form/Next.js,其他框架的适配方式暂未提供。