Cloudflare Vibe SDK
开源的 AI 全栈应用生成平台，基于 Cloudflare 云服务栈构建，可一键部署到自己的基础设施。
- Star 数
- ★ 5.4k
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 42/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 高 · 需要较重的基础设施
- 开始前需要
- 典型场景
- 想要构建类似 Vibe coding 平台的公司，可以部署并定制 UI、AI 行为、组件库，同时保持数据在自己的基础设施内。
- 不适合
- 希望避免绑定 Cloudflare 平台的团队
- 不愿开通 Workers 付费计划与 Workers for Platforms 的用户
这个 Agent 能做什么，适合哪些场景？
Cloudflare Vibe SDK 是一个开源的 AI 全栈应用生成平台，用户可以用自然语言描述需求，AI 代理会生成并部署应用。它基于 Cloudflare 的完整生态：前端使用 React + Vite，后端使用 Workers 和 Durable Objects，数据库使用 D1（SQLite）和 Drizzle ORM，AI 通过 AI Gateway 接入多种大模型，预览在 Cloudflare Containers 中运行，存储用 R2 和 KV，部署用 Workers for Platforms。该平台提供一键部署按钮、可编程的 TypeScript SDK，以及详细的部署和配置指南。它适合想要构建自己的 AI 应用平台的开发者和企业。
该平台接收用户用自然语言描述的应用需求，通过 AI 代理分阶段生成代码（规划、基础、核心、样式、集成、优化），并在沙箱容器中进行实时预览。用户可以通过聊天界面进行迭代，最终生成的应用可一键部署到 Workers for Platforms。具体组件包括：PhasicClient（TypeScript SDK）用于程序化构建；CodeGeneratorAgent（Durable Object）管理有状态生成；部署使用 wrangler 命令（如 bun run deploy）；环境变量如 GOOGLE_AI_STUDIO_API_KEY、JWT_SECRET 等是必需的。
- 想要构建类似 Vibe coding 平台的公司，可以部署并定制 UI、AI 行为、组件库，同时保持数据在自己的基础设施内。
- 内部开发：非技术团队（如市场、销售、运营）通过自然语言描述，快速生成落地页、仪表盘或工作流工具，无需等待工程资源。
- SaaS 平台：允许客户通过描述自定义集成、专业工作流或定制界面来扩展产品功能，而无需学习 API 或编写代码。
- 开发者：使用
@cf-vibesdk/sdk以编程方式构建应用，集成到自己的 CI/CD 流程中。 - 希望探索 Cloudflare 全栈平台（Workers、Durable Objects、D1、R2、Containers）的开发者，可以通过此仓库学习如何构建复杂应用。
如何安装或部署这个 Agent？
安装需要 Cloudflare Workers 付费计划、Workers for Platforms 订阅和高级证书管理器（用于自定义域名）。获取 Google Gemini API 密钥（GOOGLE_AI_STUDIO_API_KEY）。最简单的方式是点击 README 中的“Deploy to Cloudflare”按钮，按照提示配置变量。也可以手动部署：克隆仓库，运行 npm install 或 bun install，执行 npm run setup 进行自动化配置，然后设置环境变量（CLOUDFLARE_API_TOKEN、CLOUDFLARE_ACCOUNT_ID 等），最后运行 bun run dev 或 bun run deploy。
如何使用这个 Agent？
部署后，用户通过 Web 界面输入自然语言描述，例如“创建一个带拖放和暗黑模式的待办列表”，AI 代理会生成应用并显示实时预览。通过聊天进行迭代优化。也可以使用 TypeScript SDK：npm install @cf-vibesdk/sdk，然后创建 PhasicClient，调用 client.build() 方法，传入提示词和选项，等待 session.wait.deployable() 获取预览 URL。
这个 Agent 有哪些优点和局限？
- 基于 Cloudflare 全栈，原生支持 Workers、Durable Objects、D1、R2、Containers，可扩展性好。
- 提供一键部署和自动化仪表盘流程，降低部署门槛。
- 支持多模型提供商（通过 AI Gateway），并提供了官方 TypeScript SDK。
- 生成的应用采用 React + TypeScript + Tailwind 现代技术栈，质量较高。
- 包含详细的部署、配置和故障排查文档，社区活跃（Discord、论坛）。
- 深度绑定 Cloudflare 平台，不利于迁移到其他云服务。
- 需要付费计划（Workers Paid、Workers for Platforms）等，成本较高。
- 配置复杂，需要设置多个 API 密钥、OAuth、DNS 通配符记录、高级证书管理器。
- 依赖 Google Gemini API 作为默认 AI 提供商，可能需要额外费用。
- 文档中某些链接（如 GitHub issues）指向占位符，可能存在不完整。
这个 Agent 与同类方案有什么区别？
该仓库未明确提及竞争产品，因此不提供对比。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Cloudflare Vibe SDK 当前 | 42 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 5.4k | 1 个月前 | TypeScript | — |
| moltworker：在 Cloudflare Workers 上运行 OpenClaw | 53 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 9.9k | 6 个月前 | TypeScript | — |
| Agent Kanban | 80 · 表现良好 | 自托管服务免费 | ★ 492 | 1 个月前 | TypeScript | — |
| MisakaNet 失败经验库 | 64 · 存在缺口 | MCP 服务器免费 | ★ 537 | 今天 | Python | ChatGPT · Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 描述了沙箱隔离、输入验证、速率限制等安全特性，但未提供具体实现细节；部署流程要求用户提供 API 密钥和令牌，但未明确最小权限原则；存在 GitHub Actions 工作流，其权限设置为 contents: read 和 NO_PUSH，体现了最小权限，但未涉及用户确认机制。扣分原因：缺少用户确认机制（如部署前确认）、数据流透明度不足（未说明数据如何流动）、敏感数据处理细节缺失（如加密方式）、依赖安全审查不足（未提及漏洞扫描）、外部影响未明确（如生成的代码可能执行任意操作）、回滚机制未提及、来源归属仅部分（README 提到 Cloudflare 但未验证）。
证据显示：README 和 package.json 中的脚本名称一致，如 setup、deploy、test 等，但存在不一致之处，如 README 提到 'bun run test' 而 package.json 中也有 test 脚本，但 README 中的 'bun run deploy' 与 package.json 中的 'bun run deploy' 一致；依赖列表完整，但未提供依赖可用性保证（如锁定文件）；故障消息在 README 的 Troubleshooting 部分有提供，但未覆盖所有场景。扣分原因：依赖可用性未验证（未提供 lockfile 或 CI 缓存策略）、故障消息覆盖不全（仅常见问题）。
证据显示：README 明确了目标受众（公司、内部开发、SaaS 平台）和场景（自然语言构建应用），并提供了示例提示；能力边界部分描述了功能（AI 代码生成、实时预览等），但未明确限制（如支持的模型、语言）；触发精度方面，README 描述了用户如何通过自然语言触发，但未明确触发条件；环境适配方面，README 提供了本地开发和部署指南，但未覆盖所有环境（如 Windows）。扣分原因：能力边界不清晰（未说明不支持的功能）、触发精度不足（未定义精确的触发词或条件）、环境适配有限（未提及跨平台支持）。
证据显示：README 结构清晰，包含快速部署、本地开发、架构、故障排除等章节；安装说明详细，包括前置条件和环境变量；命名一致性较好（如 VibeSDK、vibesdk），但存在不一致（如 README 中 'VibSDK' 拼写错误）；示例和 FAQ 提供了示例提示和常见问题；已知限制未明确列出；许可证为 MIT，符合标准；版本号在 package.json 中为 1.5.0，但未提供变更日志；维护责任未明确（未提及维护者或贡献指南）。扣分原因：命名不一致（拼写错误）、已知限制缺失、版本变更日志缺失、维护责任不明确。
证据显示：输出可用性方面，README 描述了生成的应用程序可部署到 Workers for Platforms，并提供了 SDK 示例；边际价值方面，该平台提供了独特的价值（自然语言构建应用），但可能与其他工具重叠；成本效益方面，需要付费计划（Workers Paid Plan）和 API 密钥，但未提供成本估算。扣分原因：成本效益未量化（未提供定价或资源消耗估算）、边际价值未与现有工具对比。
证据显示：README 中的声明（如功能、架构）未提供具体代码引用或测试证据；跨来源验证有限（仅 README 和 package.json，未提供其他文档）；事实与推断未明确分离（如 README 中的 'enterprise-grade security' 是断言而非事实）。扣分原因：声明缺乏可追溯性（未链接到代码或测试）、跨来源验证不足（仅两个文件）、事实与推断混淆（如安全声明未经验证）。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 部署需要付费的 Cloudflare Workers 计划，且需要多个 API 密钥，成本可能较高。
- README 中的安全声明（如 'enterprise-grade security'）未提供实现细节，需谨慎对待。
- 生成的代码可能执行任意操作，需在沙箱环境中运行并限制权限。
- 未提供回滚机制，部署失败时可能难以恢复。
- 依赖未锁定，存在供应链风险。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
[1.5.0](https://github.com/cloudflare/vibesdk/compare/v1.4.0...v1.5.0) (2026-02-03) Features * add app visibility check for preview deployment ([3c4f203](https://github.com/cloudflare/vibesdk/commit/3c4f2030d730e95fe0bd8deb17b1265cd5f20ecf)) * add phase timeline change subscription and event handling ([a1c7404](https://github.com/cloudflare/vibesdk/commit/a1c740411d7b183d26b334d4c5a2a80ab4905728)) * add phase timeline change subscription and event handling ([f8b14cd](https://github.com/cloudflare/vibesdk/commit/f8b14cde831e284d478633154189e5032dce3506)) …在 GitHub 查看 ↗ -
发布说明摘录
Release v1.4.0 Highlights - New Client SDK: Full TypeScript SDK (@cf-vibesdk/sdk) for programmatic interaction with the platform, enabling headless automation, CI/CD integration, and third-party tooling (#277) - Zero-Knowledge Vault: End-to-end encrypted user secrets storage with Argon2id/WebAuthn PRF key derivation for secure API key management (#267) - Enhanced Code Generation Safety: Pre-deploy AST-based static analysis detects and auto-fixes common React antipatterns like render loops and unstable selectors (#267) …在 GitHub 查看 ↗ -
发布说明摘录
[1.3.0](https://github.com/cloudflare/vibesdk/compare/v1.2.0...v1.3.0) (2025-12-08) Features * enforce template write-protection in simple code generator ([4f0dccf](https://github.com/cloudflare/vibesdk/commit/4f0dccf60661a6ae7ca09fd696270a0152316ea1)) * latest packages updated ([e5496e0](https://github.com/cloudflare/vibesdk/commit/e5496e0cfd2923acc25d7e4f2265b4a0d7fd69f8)) Bug Fixes * filter protected files ([ff3a302](https://github.com/cloudflare/vibesdk/commit/ff3a302bf8fa3059156c4f10efc30c55aa6f0455)) …在 GitHub 查看 ↗
常见问题
部署和运行成本如何？
需要哪些权限？
生成的应用部署在哪里？
如何添加用户登录功能？
.dev.vars 和 .prod.vars 中的 Google/GitHub OAuth 凭据，然后重新部署。