Hono接口搭建

解决什么问题

当你的 Cloudflare Worker 基础外壳搭建完成后，随着业务增长，直接将所有接口逻辑堆砌在单个 index.ts 中会导致代码迅速膨胀且难以维护。硬编码路由、遗漏请求校验和鉴权逻辑，往往是引发线上故障的直接原因。本技能专注于在项目已有“外壳”的基础上，注入一套结构化的 API 脚手架，确保路由、中间件与文档具备一致性。

核心能力与工作流

本技能模拟一名脚手架工程师，将资源划分为多个独立文件，利用 Hono 实例化应用并挂载到主入口。

• 路由生成与校验：为每个资源组创建独立的路由文件。针对写操作（如 POST），集成 zValidator 与 Zod 进行 JSON 校验；资源未命中时返回标准的 404，创建成功则返回 201。
• 中间件管理：通过 createMiddleware 实现 Bearer token 鉴权，利用 cors() 处理跨域请求，确保接口安全性。
• 类型与挂载：在 src/types.ts 中定义 Env 接口（包含 D1Database、KV 等绑定），并在主入口统一注册 onError 与 /api/health 健康检查。
• 文档产出：自动生成 API_ENDPOINTS.md，详细记录每个端点的参数形状与错误码。

适用边界

本技能的核心价值在于“生成代码骨架”。它不能替代业务逻辑实现，开发者仍需根据实际需求完善具体的字段校验规则与数据库查询逻辑。此外，它必须运行在已完成基础初始化的 Worker 项目之上。