用途:帮助 AI 构建 Hono Web 应用并零配置部署到 Vercel,也解答 Hono 的 API、路由、中间件、JSX、校验、测试、流式响应等问题。若配置了 hono-docs MCP server,优先使用其工具获取最新文档。
主要能力:
- 路由:app.get/post/put/delete/patch/options/all/on,支持路径参数、可选参数、通配符、正则约束与链式路由;用 app.route() 或 basePath() 分组。
- 上下文与请求:c.text/json/html/redirect/body/notFound,c.status/header,c.set/get/var 传递请求级数据;c.req 提供 param、query、queries、header、json、text、formData、parseBody 等。
- 中间件:内置 cors、logger、basicAuth、bearerAuth、jwt、csrf、secureHeaders、compress、cache、etag、bodyLimit、requestId 等;可用 createMiddleware 自定义,按注册顺序执行。
- 校验:zValidator(Zod)或 sValidator(Valibot/Standard Schema),支持 json/form/query/header/param/cookie。
- JSX:tsconfig 设 jsx 为 react-jsx、jsxImportSource 为 hono/jsx,文件须用 .tsx 后缀;支持组件、异步组件、Fragment 与 jsxRenderer。
- 流式:stream、streamText、streamSSE。
- 测试:app.request() 无需启动 HTTP 服务,或用 npx hono request [file] -P /path 测试端点。
- RPC 客户端:路由必须链式定义,导出 AppType,用 hc() 获得类型安全客户端。
部署与使用:Hono 应用在 Vercel 上零配置部署,服务器路由自动成为 Vercel Functions(默认 Fluid compute)。默认导出 app 即可,文件可放在 app/index/server 或 src/ 下的相应 JS/TS 变体;Vercel 上无需 @hono/node-server,仅供不使用 vc dev 的本地开发,建议放在单独文件。静态资源放在 public/,Vercel 上 serveStatic() 被忽略。流式在 Vercel Functions 支持,stream 等可直接使用。Hono 中间件与应用内路由前的 Vercel Routing Middleware 可同时使用。
限制与注意:不要在 CLI 参数中直接传凭证,敏感值用环境变量;JSX 文件必须为 .tsx,否则编译失败;RPC 类型推断依赖链式路由;未提供的内容(如具体收费、价格、性能数据)暂未提供。