SuperAPI AI 工具集

tmdb-codegen

编程与开发

查看项目

更新于 10-16 04:54

技能介绍

用途:为 TMDB API 集成项目提供自动代码生成与选择性 Zod schema 生成的工作流,在修改端点配置后重新生成服务端函数与类型。

主要能力:根据 tooling/tmdb-codegen/endpoints-config.js 中的端点配置,生成服务端函数与 TypeScript 类型;仅对标记 needsZodSchema: true 的端点生成 Zod schema,供使用 OpenAI Structured Outputs 的 AI 工具使用;自动为生成的 schema 应用 .nullable().optional() 以兼容 OpenAI;资料称该选择性方案使 Zod schema 从 16000+ 行降至约 200 行,减少 98.7%。

必要用法:不要手动编辑 src/_generated/tmdb-server-functions.ts,该文件为自动生成;修改配置后运行 pnpm codegen:tmdb。相关命令:pnpm codegen(完整流程)、pnpm codegen:tmdb(仅重新生成 TMDB 服务端函数)、pnpm codegen:zod(仅快速重新生成 Zod schema)。导入方式示例:import { searchMovies, getMovieDetails } from "@/utils/tmdb-server-functions";import { movieSearchSchema } from "@/utils/tmdb-zod-schemas"。新增端点需先在 endpoints-config.js 中配置,再运行 pnpm codegen:tmdb。生成的 tmdb-server-functions.ts 与 tmdb-zod-schemas.ts 被 git 忽略,克隆后须重新生成。

适用场景:新增或变更 TMDB 端点配置、克隆仓库后重建生成文件、需要为 AI 工具补充 Zod schema 时。

限制:仅覆盖 TMDB codegen 工作流相关内容;其他功能、收费、价格与平台信息暂未提供。