vibe-backend SDK
用自然語言,
寫出你的後端。
每個 API 只需要一個 Markdown 檔。vibe-backend 會把它編譯成經審核的 lock 檔與簽名 manifest,再以冷啟動方式在 serverless 上處理每一個請求。
運作方式
寫一個 Markdown 檔,得到一個真正的 API。
以下範例取自規格 §11.5:一個讀取用戶資料的 v2 端點。
# 取得用戶
GET,路徑 /users/v2/{id},id 為 uuid。
用 user.get 取得用戶,回傳 200 及 id、email、name;
找不到則回傳 404 NOT_FOUND。
v2 的 name 欄位改稱 display_name。
GET /users/v2/7d1e0c52-5b8a-4f0e-9a51-3c2f8e6b1a90
Authorization: Bearer <access token>
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "7d1e0c52-5b8a-4f0e-9a51-3c2f8e6b1a90",
"email": "ada@example.com",
"display_name": "Ada"
}
HTTP/1.1 404 Not Found
{ "error": { "code": "NOT_FOUND", "message": "…", "request_id": "…" } }
在兩者之間,編譯器會產生格式固定的 get-user.lock.md(包含 ## Route、## Request、## Response、## Transform、## Steps、## Errors 等區段)。執行階段只讀取已確認的 lock,從不解讀你寫的文字。
三個階段
從構想到上線。
- 01
Source
用自然語言撰寫
{feature}.md:說明用途、輸入、輸出、錯誤與權限。 - 02
Lock
編譯器產生結構化的
{feature}.lock.md,先由獨立的確定性驗證器檢查,再由 owner 在 PR 中確認。 - 03
Manifest
部署時,所有已確認的 lock 會合併成一份簽名 manifest,每個請求都以冷啟動方式在 serverless 上執行。
內建最佳實踐
安全機制,不必自己寫。
1 小時access token 最長效期;refresh token 每次使用都會輪換。
12+密碼最少字元數,並檢查是否為已外洩密碼。
5 次 / 15 分鐘登入失敗達此次數,帳戶即鎖定 15 分鐘。
< 1 秒每個請求的冷啟動 p95 目標。
開發動態
本月每日進度:2026 年 10 月
自 10 月 14 日開始
190已合併 pull request
+129,874新增行數
−23,947刪除行數
過去 12 個月每日已合併 pull request
以表格查看有活動的日子
| 日期 | 已合併 PR |
|---|---|
| 47 | |
| 6 | |
| 88 | |
| 31 | |
| 18 |
統計範圍:GitHub 組織 vibe-backend 旗下全部 6 個公開儲存庫—— .github, sample-envelope, sample-hello-world, sample-shop, sdk, vibe-backend.github.io. 日期以香港時間(UTC+8)及 PR 合併時間劃分;行數為各 PR 的新增與刪除行數。資料於建置時從 GitHub API 取得(2026-10-18 18:37 UTC)。