SuperAPI AI 工具集

cloudflare-full-stack-scaffold

部署与运维

查看项目

更新于 10-15 22:39

技能介绍

用途:该技能提供一个可直接复制、定制并部署的 Cloudflare 全栈起步项目,用于在数分钟内搭建 React 19 + Cloudflare Workers + Hono 应用,并预置 AI SDK 与核心 Cloudflare 服务,减少配置与集成错误。

主要能力:前端为 React 19 + Vite + Tailwind v4 + shadcn/ui,后端为 Hono Worker;预配置 D1、KV、R2、Workers AI,并含 D1 迁移、类型化查询助手与示例 CRUD 路由。AI 部分支持三种方式:直接 Workers AI 绑定、AI SDK + workers-ai-provider、以及 AI SDK 接入 OpenAI/Anthropic/Gemini 等外部提供商,可一行切换模型。可选功能通过脚本启用:Clerk 认证(npm run enable-auth)、AI 聊天界面(npm run enable-ai-chat)、Queues(npm run enable-queues)、Vectorize(npm run enable-vectorize)。项目还包含 docs 规划文档与 SCRATCHPAD.md 会话交接协议。

使用方式:复制 scaffold 目录后执行 npm install,运行 ./scripts/init-services.sh 初始化 D1、KV、R2,执行 npm run d1:local 建表,再 npm run dev 启动。部署使用 npm run build 与 npx wrangler deploy,生产数据库迁移用 npx wrangler d1 execute my-app-db --remote --file=schema.sql,密钥用 npx wrangler secret put 设置。前端与 Worker 由 Vite 插件运行在同一端口,应使用相对 URL 请求 /api。

适用场景:需要快速启动 Cloudflare 全栈项目、构建带聊天/RAG/工具调用的 AI 应用、或希望统一前后端校验(Zod + React Hook Form + TanStack Query)的开发者。

限制:资料未提供具体收费、价格与性能数据;部分功能默认以注释形式存在,需运行对应脚本启用;Clerk、外部 AI 提供商等需自行提供 API 密钥。