route-handlers

此技能为使用 Next.js App Router 的开发人员提供了一个强大的框架，能高效地实现服务器端 API 逻辑。它简化了路由处理程序 (Route Handlers) 的创建过程，确保符合标准的 Web Request 与 Response API 惯例。无论您是在构建简单的 REST API、执行复杂的资料流，还是管理标头与 Cookie，此工具都能作为您在以前端为主的项目中进行后端开发的专家助手。

• 完整支援 HTTP 方法，包括 GET、POST、PUT、PATCH、DELETE、HEAD 与 OPTIONS。

• 自动化处理 app 目录结构内的 route.ts 文件惯例。

• 具备处理动态 URL 参数、查询字串解析以及复杂请求主体 (JSON, FormData, Text) 的能力。

• 进阶响应处理功能，例如设定自订标头、Cookie 管理以及实现安全的重新导向。

• 内建流式响应支援，包含标准文本流以及使用 ReadableStreams 的复杂 AI/LLM 集成模式。

• 集成 CORS 配置模板，确保端点间的跨来源通讯安全性。

• 自动化缓存策略管理，包含预设的静态行为以及使用动态强制 (dynamic force) 或标头的选择性退出机制。

• 使用此技能来初始化新的 API 路由，或将旧有的 API 模式重构为现代化的 App Router 架构。

• 非常适合开发人员在 Next.js 中处理授权逻辑、数据库集成或第三方服务挂钩 (例如 AI 模型流式传输)。

• 输入要求包含您想要的 HTTP 端点路径、目标功能 (例如身份验证检查) 以及预期的 HTTP 方法。

• 输出为简洁、符合生产环境标准的 TypeScript 代码，遵循 Next.js 最佳实践，减少样板代码并确保请求内容的类型安全。

• 请注意，路由处理程序是在服务器上执行的；请确保所有的数据库互动或敏感逻辑皆包含在适当的环境变量或服务器端公用程式函数中。