繁中
English繁中

VibeSDK是一個用於構建、運行和託管應用程式的平台

作者: /

Cloudflare VibeSDK允許您通過簡單地用自然語言描述您的需求來創建基於AI的Web應用程式。它是一款在Cloudflare平台上運行的開源工具，提供安全、隔離的環境，使您只需單擊即可快速構建、預覽和部署應用程式。您可以自定義人工智慧的行為模式、治理代碼範式並保護數據隱私。
它非常適合企業、初創公司和各種團隊-即使團隊成員沒有深厚的編碼技能，它也可以用它構建應用程式，大大提高開發效率，並使非技術人員輕鬆構建他們需要的工具。此外，該平台支持實時預覽、基於聊天的交互模式，並可以與GitHub集成以實現流暢的工作流程協作。

您是如何搭建「人工智慧應用生成+運行+託管」的完整平台的？

雖然許多人工智慧項目仍處於「模型調優API」階段，但Cloudflare已經開源 VibeSDK - 一個工程級項目，顯然不僅僅關心模型，而是直接針對「人工智慧產品形態」。

它不是一個簡單的SDK或單個功能庫，而是一組 自建AI Web App生成平台模板:
自然語言輸入分階段生成代碼|人工智慧|沙箱實時預覽|一鍵部署到Cloudflare平台，整個流程連接。

本文 從原始碼目錄結構開始 並分解VibeSDK背後隱藏的系統設計。

一句話就明白什麼是VibeSDK

VibeSDK是「人工智慧應用生成平台」的完整實現，而不是模型SDK。

它解決的問題不是 人工智慧是否會生成代碼，但是：

如何將人工智慧生成的代碼轉化為可以運行、預覽、部署和多租戶的Web應用程式。

該項目是開源的， Cloudflare ，其底層與Cloudflare的Workers、Durable Objects、D1、R2、AI Gateway、Workers for Platforms和其他功能有著深度綁定。

在查看原始碼之前，建立總體系統視角

從REAUTE和存儲庫結構中，我們可以抽象出 四大核心子系統 VibeSDK：

  1. Web控制台（UI）
    用戶輸入需求、查看構建進度、實時預覽並單擊部署
  2. AI Agent後台
    將自然語言分解為階段任務（規劃/構建/完善）以維護會話狀態
  3. 沙盒運行時
    在隔離環境中安裝依賴項、運行構建項目並提供預覽URL
  4. 基於平台的部署層
    將構建應用程式部署到Workers for Platforms作為多租戶託管的「用戶項目」

接下來，我們直接使用原始碼目錄來比較這個結構。

頂級目錄概述：每個文件夾對應哪個系統？

從存儲庫根目錄的角度來看，VibeSDK的結構非常「平台化」，而不是普通的前端和後台項目。

1.產品的主要應用（您實際訪問的網絡平台）

SRC/
公共/
工人/

這三者共同構成了VibeSDK的「主要應用程式」。

  • SRC/
    前端代碼（React + Vite）負責：
    • 用戶輸入提示
    • 顯示生成階段
    • 顯示實時日誌、預覽iframe
    • 觸發部署操作
  • 公共/
    靜態資源，例如圖標、公共文件
  • 工人/
    Cloudflare Workers後台：
    • API路由
    • 人工智慧呼叫
    • 會話管理
    • 耐用對象定義
    • 與沙盒/平台資源互動

這一點很重要： VibeSDK的「後台」不是傳統的伺服器，而是完全在Workers上運行。

2. SDK和共享類型（準備二次開發）

sdk/
分享/類型/
  • sdk/
    官方的TypScript SDK提供了類似的功能：const客戶端=新PhasicClient（.）const會話= await client.build（提示）await會話.wait. deplenable（） 它公開了一個「階段會話對象」，而不是簡單的HTTP包。
  • 分享/類型/
    前端和後台共享的類型定義保證：
    • API數據結構一致
    • 會話/階段/事件類型是統一的

這表明VibeSDK的設計假設是：
平台功能旨在「以編程方式調用」，而不僅僅是針對UI。

3.數據層：D1 + Drizzle的工程選擇

移民/
drizzle.config.local.ts
drizzle.config.remote.ts

VibeSDK使用 Cloudflare D1（SQLite）+ Drizzle ORM.

從工程角度來看，這是一個非常「平台友好」的選項：

  • D1：
    • 原生於邊緣
    • 部署成本低
    • 足以支持會議/項目/審計數據
  • 毛毛雨：
    • 強類型
    • 易於與TS前端和後台共享模型
    • 以清晰可控的方式遷移文件

本地/遠程兩組毛毛雨，通常用於：

  • 本地開發構建遷移
  • 遠程Cloudflare D1實例應用程式遷移

4.沙盒和收件箱：生成代碼不僅僅是「編寫它」

貨櫃/
SandboxDockerfile
debug-tools/

這是許多人工智慧項目 根本沒有，但VibeSDK明確以其為核心。

  • SandboxDockerfile
    定義預覽收件箱的基本圖像：
    • 節點/包管理器
    • 構建工具
    • 運行權限限制
  • 貨櫃/
    與沙箱運行、預覽環境調度相關的實現

為什麼你必須這樣做？

因為VibeSDK不只是生成代碼，它可以：

  • 安裝依賴項
  • 啟動開發伺服器
  • 公開預覽網址
  • 隔離用戶代碼以避免安全問題

這一步決定了「生成器」和「產品」之間的本質區別。

5.工程和自動化工具鏈

劇本/
測試/
vitest.config.ts
.github/
.哈士奇/

這些目錄使VibeSDK更像是 長期維護平台項目:

  • 自動腳本（本地啟動、遷移、部署）
  • 維泰斯特
  • CI /吉特胡克斯
  • 代碼規範和質量控制

6.部署和平台配置：真正充分利用Cloudflare的能力

wrangler.jsonc
wrangler.test.jsonc
.dev.vars.example
vite.config.ts
worker-configuration.d.ts

這是 最「雲耀斑味」的部分 VibeSDK。

 wrangler.jsonc 在中，您通常可以看到：

  • 持久對象綁定（會話/代理狀態）
  • D1資料庫綁定
  • R2 Bucket（模板，生成產品）
  • KV數據空間（輕量級狀態/緩存）
  • AI網關配置
  • 平台工人調度命名空間

最後一點意味著：

用戶生成的應用程式作為「子工作者」部署到平台，而不是在主應用程式中運行。

這是VibeSDK成為多租戶平台的關鍵。

完整的呼叫如何在系統中流動？

從原始碼結構中，可以恢復典型的連結：

  1. 用戶在前端輸入需求
  2. 工人/ 創建或恢復會話（持久對象）
  3. AI Agent分階段代碼生成（規劃、構建、完善）
  4. 構建項目被發送到沙箱運行
  5. 前端實時顯示預覽URL
  6. 用戶單擊部署
  7. 項目通過Workers for Platforms作為獨立應用程式發布

整個過程，無需傳統伺服器。

VibeSDK真的很強大

  • 這不是演示，這是 平台級參考實現
  • 它將人工智慧生成的問題分解為：
    • 狀態機
    • 生命周期
    • 隔離操作
    • 平台託管
  • 它清楚地回答了一個問題：
    「人工智慧應用如何規模化和產品化？"

GitHub：https://github.com/cloudflare/vibesdk
管材：

返回頂端