用途
该技能用于在 Cloudflare Workers 上集成现代前端/全栈框架,帮助开发者构建全栈应用。适用于使用 Hono、Remix、Next.js、Astro、SvelteKit、Qwik 或 Nuxt 在 Workers 上开发的场景,覆盖路由、SSR 等内容。
主要能力
- 框架选型指引:提供框架对照表(Hono、Remix、Next.js、Astro、SvelteKit、Qwik、Nuxt),标注各自适用的场景、是否支持 SSR/静态、以及 Workers 原生支持方式(Native、Adapter、OpenNext、Nitro)。
- 框架决策树:按需求引导选择,例如仅需 API 时推荐 Hono;构建完整应用时按 React(Next.js/OpenNext 或 Remix)、Vue(Nuxt)、Svelte(SvelteKit)、内容型(Astro)、极致性能(Qwik)分流。
- 常见错误排查:列出 Top 10 框架错误,包含错误信息、涉及框架、原因与解决方案,例如导出格式错误、CPU 超限、缺少 context、Node.js 全局变量、CJS 与 ESM 混用、响应体已锁定、绑定缺失、静态资源 404、水合不匹配、循环引用等。
- Hono 快速上手:给出完整示例代码,包含中间件(logger、cors)、路由定义、D1 数据库查询与插入、以及 wrangler.jsonc 配置(compatibility_date、nodejs_compat、d1_databases 绑定)。
- 静态资源配置:展示 wrangler.jsonc 中 assets 目录与 binding 配置,以及通过 ASSETS.fetch 实现静态资源回退的写法。
- 跨框架通用模式:汇总各框架访问环境绑定的写法(Hono 的 c.env、Remix 的 context.cloudflare.env、Astro 的 Astro.locals.runtime.env、SvelteKit 的 platform.env、Nuxt 的 useRuntimeConfig 或 event.context.cloudflare.env),以及通用错误处理模式。
- 性能建议:包括包体积控制在 1MB 压缩以内、减少顶层代码以降低冷启动、使用流式 SSR、利用 Cache API 与 CDN、按路由动态导入做代码分割。
- 参考文档加载指引:按用户场景提示加载对应框架参考文档(references/hono.md、remix.md、nextjs.md、astro.md、sveltekit.md、qwik.md、nuxt.md)。
使用方式
该技能以参考文档形式组织,按用户正在使用的框架加载对应参考文件。示例代码展示了 Hono 的完整项目结构与 wrangler.jsonc 配置,其他框架通过通用模式章节说明环境绑定与错误处理的写法。
适用场景
- 在 Workers 上构建 API 或微服务(Hono)。
- 构建全栈 React 应用(Remix 或 Next.js via OpenNext)。
- 构建内容站点、博客、文档、营销页面(Astro)。
- 构建 Svelte、Vue 3、Qwik 应用。
- 排查框架在 Workers 上的常见运行错误。
限制
资料未提供各框架的版本要求、具体安装命令、收费或价格信息、性能基准数据,以及除 Hono 外其他框架的完整代码示例。相关细节暂未提供。