route-handlers

route-handlers 技能是为在 Next.js App Router 框架下工作的开发人员所提供的专家级助手。它旨在简化使用 Web Request 与 Response API 创建、配置与维护服务器端 API 端点的流程。通过提供上下文相关的模板与最佳实践，确保您定义在 route.ts 文件中的 API 路由既稳健、高效，又能正确处理各种服务器端需求。

• 完整支持包括 GET、POST、PUT、PATCH、DELETE、HEAD 与 OPTIONS 在内的标准 HTTP 方法，以定义清晰的端点行为。

• 内置处理多种请求负载的功能，例如 JSON 解析、表单数据提取与原始文本处理。

• 针对复杂 URL 的动态路由参数管理，允许通过路径区段进行高效的变量提取与数据库查询。

• 进阶响应处理功能，包括自定义 JSON 响应、HTTP 标头注入、Cookie 管理与状态码设定。

• 高效能流式传输能力，支持标准文本流以及使用 ReadableStream 的复杂 AI/LLM 集成模式。

• 集成 CORS 配置安全性模式，提供 OPTIONS 方法的样板以管理跨来源流量。

• 智能化缓存控制，提供关于通过 force-dynamic 等路由区段配置来启用或停用数据缓存的明确指导。

• 非常适合在 Next.js 框架上进行开发的后端工程师、全栈工程师与 API 架构师。

• 当您需要生成新的 API 路由、重构端点逻辑、实现中间件式逻辑或处理复杂的服务器端数据流时使用。

• 用户预期将获得符合最新 Next.js 13+ App Router 规范且可直接用于生产环境的代码片段。

• 请注意，此技能需要开发者具备异步 JavaScript 与 Web Fetch API 标准的基础知识，因为它大量依赖于原生的 Request 与 Response 对象。