@hile/http-next

本文档是面向 AI 编码模型和人类开发者的 代码生成规范，阅读后应能正确地使用本库编写符合架构规则的代码。

1. 架构总览

@hile/http-next 是 @hile/http（Koa + find-my-way）与 Next.js 的桥接层。它将 Next.js 作为渲染引擎嵌入 Koa 服务，同时保留 @hile/http 的文件系统路由与中间件能力。

核心职责：

• 创建 Koa HTTP 服务并启动 Next.js（共享同一 httpServer）
• 通过 koa-static 提供 public 与 .next/static 的静态资源
• 加载 *.controller.ts 文件系统路由，挂载到 /- 前缀下
• 将所有未匹配请求转发给 Next.js request handler

请求流向：