Hono

用一个 catch-all Route Handler 让 Hono 接管 Next.js 的健康检查、搜索、附件和 MCP API，解释为什么这里直接调用 app.fetch，而不是使用 hono/bun 启动第二个服务器，并为本地文件与对象存储保留替换边界。

在 Hono 项目中同时使用 Zod 校验、RPC 类型客户端和 OpenAPI 时，最容易出现路由能运行、客户端能编译、文档却已经漂移。本文用普通 Hono 路由配合 hono-openapi，说明请求 Schema、响应类型、错误契约和接口说明各自应该放在哪里。

API 文档只在开发环境注册，并不代表 Scalar、OpenAPI 生成器和文档路由已经从生产 Bundle 消失。本文以 Bun 构建为例，说明如何用动态导入、编译期常量与产物扫描真正移除文档代码，同时避免把运行时配置和密钥错误地一并内联。

一次普通的 400 错误，让我顺着客户端弹窗查到了服务端响应、共享错误码、RequestError、生产日志和 Hono RPC 类型生成。这里记录我怎样把错误链重新串起来，也说明为什么直接 import type 仍会读取服务端源码，以及我最后为何保留 dts-bundle-generator。

记录一次将小程序协议 Markdown 从源码内置改为运行时加载的开发过程：最初绕到对象存储、版本清单和 JSON 包装，最后收敛为启动 config 下发路径、Hono/Bun serveStatic 直接提供文件。文章也说明 MIME 类型、Docker 复制和旧客户端兼容这些容易漏掉的细节。