VibeSDK：使用自然语言生成并部署全栈AI应用

Cloudflare VibeSDK 是一个开源的全栈AI应用生成平台。 它让开发者可以通过编写自然语言（“vibe coding”）的方式，来描述想要构建的应用，然后由AI智能体自动完成代码生成、测试和部署的完整流程。 这个平台本身构建在 Cloudflare 的开发者生态之上，集成了 Workers、Durable Objects、D1数据库和R2存储等多种服务。 用户部署自己的 VibeSDK 实例后，就能拥有一个让非技术人员也能通过对话式交互来创建网页应用、内部工具或自动化工作流的平台。 所有生成的应用都在隔离的沙箱容器中运行和预览，确保了安全性，最终可以一键部署到 Cloudflare 的全球网络上。

功能列表

• 自然语言应用生成: 用户只需用日常语言描述应用功能，AI智能体就会进行分析，并分阶段生成代码。
• 实时应用预览: 生成的应用会在安全的沙箱容器中立即运行，开发者可以通过预览链接实时查看应用效果并进行测试。
• 交互式聊天迭代: 可以通过对话的方式与AI智能体沟通，对应用进行修改和功能迭代，就像与一个开发人员对话一样。
• 一键部署: 完成开发的应用可以一键部署到 Cloudflare Workers for Platforms，实现全球访问。
• GitHub集成: 支持将生成的应用代码直接导出到指定的GitHub仓库，方便后续进行手动维护和二次开发。
• 现代技术栈: 自动生成的应用采用 React、TypeScript 和 Tailwind CSS 等现代前端技术栈。
• 完整的平台架构: VibeSDK 本身就是一个完整的参考实现，包含了前端、后端（Workers）、数据库（D1）、AI网关和容器化沙箱等模块。

使用帮助

部署和使用自己的VibeSDK实例，意味着你将拥有一个私有的、可以用自然语言生成应用的AI平台。整个过程主要分为平台部署和应用生成两个阶段。

第一阶段：部署VibeSDK平台

最简单的方式是使用Cloudflare官方提供的一键部署按钮。

1. 准备工作
在开始之前，你需要准备好以下几样东西：

• 一个Cloudflare账户，并且已订阅Workers付费计划。
• 一个Google Gemini API密钥，你可以从ai.google.dev获取。
• （必须）一个你在Cloudflare上配置好的自定义域名。

2. 一键部署

• 访问VibeSDK的GitHub仓库首页：https://github.com/cloudflare/vibesdk
• 点击页面上显眼的 “Deploy to Cloudflare Workers” 按钮。
• 页面会跳转到你的Cloudflare仪表板，并引导你创建一个新的项目。

3. 配置环境变量
在部署过程中，Cloudflare会要求你配置一些必要的环境变量，这些变量是让你的VibeSDK实例正常运行的关键。

• GOOGLE_AI_STUDIO_API_KEY: 填入你准备好的Google Gemini API密钥。
• JWT_SECRET: 用于会话管理的安全密钥。你可以使用在线密码生成器创建一个足够长且随机的字符串。
• WEBHOOK_SECRET: 用于Webhook认证的密钥，同样需要一个安全的随机字符串。
• SECRETS_ENCRYPTION_KEY: 用于加密存储密钥的加密密钥，也是一个安全的随机字符串。
• ALLOWED_EMAIL: 填入你的电子邮件地址。这是为了限制只有你才能使用这个平台，防止未授权的访问。
• CUSTOM_DOMAIN: 填入你准备好的自定义域名。这是必需的，否则应用无法正常工作。

完成配置后，点击部署按钮，Cloudflare会自动为你构建和部署整个VibeSDK平台。

第二阶段：使用VibeSDK生成应用

部署成功后，你就可以通过你的自定义域名访问VibeSDK的用户界面了。

1. 描述你的应用
主界面是一个聊天窗口。在这里，你可以开始描述你想要创建的应用。描述得越具体越好。
例如，你可以尝试输入以下提示词：

• “创建一个待办事项列表，支持拖拽排序和暗黑模式”
• “构建一个简单的绘图应用，可以调整画笔大小和颜色”
• “制作一个可以从图片生成调色板的工具”

2. 观察AI构建过程
提交描述后，AI智能体（Agent）会开始工作。它会首先分析你的需求，然后制定一个构建计划，并分阶段生成代码。你可以在界面上看到整个过程的实时日志，包括文件创建、代码生成、依赖安装等步骤。

3. 实时预览和迭代
代码生成后，VibeSDK会自动在一个隔离的沙箱容器中运行这个应用，并提供一个预览链接。你可以点击链接查看应用的实际效果。
如果应用不完全符合你的预期，你可以在聊天窗口继续输入指令进行修改。例如：

• “给待办事项增加一个删除按钮”
• “把页面背景色改成灰色”
• “增加一个清空所有事项的功能”
  AI会根据你的新指令，对代码进行修改并重新生成预览。

4. 部署应用
当你对预览的应用感到满意后，就可以将其正式部署。VibeSDK提供了将应用部署为Cloudflare Worker的选项。部署后，你的应用就会拥有一个公开的网址，可以在全球范围内被访问。

5. 导出代码
如果你希望对代码进行更深度的定制，可以选择将整个项目导出到你的GitHub仓库。这样你就可以像开发一个普通前端项目一样，在本地进行二次开发。

应用场景

1. 企业内部工具开发
   让市场、销售或运营等非技术团队能够通过自然语言描述，快速构建自己需要的数据看板、工作流自动化工具或简单的内部管理页面，而无需排队等待工程资源。
2. 加速原型验证
   产品经理或设计师可以快速将想法转化为可交互的应用原型，用于用户测试和收集反馈，极大地缩短了从概念到原型的验证周期。
3. SaaS平台功能扩展
   允许SaaS产品的客户通过自然语言为自己构建定制化的插件、工作流或界面，扩展SaaS平台的功能，而不需要学习复杂的API或编写代码。
4. 教育与编程入门
   作为一个学习工具，帮助编程初学者直观地理解一个应用是如何从简单的描述一步步被构建出来的，了解项目结构和代码组织方式。

QA

1. VibeSDK是如何保证AI生成的代码是安全的？
   所有由AI生成的应用都在一个完全隔离的沙箱容器（Cloudflare Containers）中运行和预览。 这些容器的网络访问受到严格限制，从而确保生成的代码不会访问到外部或内部的敏感资源，有效防止了安全风险。
2. VibeSDK支持哪些AI模型？
   它通过Cloudflare的AI Gateway连接多个大型语言模型（LLM）提供商，目前主要配置为使用Google的Gemini模型，但架构上支持切换和使用其他模型，如OpenAI或Anthropic的模型。
3. 生成的应用可以处理多大的访问量？
   最终部署的应用是作为Cloudflare Worker运行的。Worker本身是为高并发和大规模访问设计的，能够利用Cloudflare全球网络的优势自动扩展，因此可以从容应对从个人项目到企业级应用的不同流量规模。
4. 部署自己的VibeSDK实例成本高吗？
   成本主要来自于Cloudflare的Workers付费计划、D1数据库、R2存储以及AI模型的API调用费用。对于个人开发者和小团队，前期的使用成本相对较低。Cloudflare的AI Gateway还会缓存常见请求的响应，有助于进一步降低AI调用成本。