SuperAPI AI 工具集

cloudflare-worker-builder

部署与运维

查看项目

更新于 10-15 23:31

技能介绍

用途:从简短描述出发,生成一个可部署的 Cloudflare Worker 项目,包含 Hono 路由、Vite 开发服务器和 Static Assets。

主要流程:先确认应用类型(纯 API、SPA+API、落地页)、数据存储(D1、R2、KV 或无)、是否需要认证(Clerk、better-auth 或无)以及域名方式;随后用 npm create cloudflare@latest my-worker -- --type hello-world --ts --git --deploy false --framework none 脚手架,并安装 npm install hono 与 npm install -D @cloudflare/vite-plugin vite;再从技能的 assets/ 复制并定制 wrangler.jsonc、vite.config.ts、src/index.ts、package.json、tsconfig.json、public/index.html。

绑定与部署:在 wrangler.jsonc 按需添加 d1_databases、r2_buckets、kv_namespaces(Wrangler 4.45+ 首次部署会自动创建资源,需显式指定名称)。开发用 npm run dev(http://localhost:8787),上线用 wrangler deploy。

关键模式与限制:使用 export default app,避免 export default { fetch: app.fetch };开启 SPA 回退时须设 run_worker_first: ["/api/*"],否则 API 路由会被 index.html 拦截;wrangler.jsonc 必须设置 main 字段;添加 cron 时改用显式 export(fetch 与 scheduled)。更多排错见 references/common-issues.md、architecture.md、deployment.md。价格、平台支持范围等资料暂未提供。