用途:为 Blink 项目提供自建后端,适合 Webhook、服务端密钥、第三方回调与重处理等场景;官方建议认证、数据库、存储、AI 等约 95% 的情况优先用 SDK,不要仅为 CRUD 创建后端,CRUD 应使用 blink.db。
主要能力:提供 MCP 工具 blink_backend_status、blink_backend_deploy、blink_backend_logs;后端入口为 backend/index.ts,必须导出 default 的 Hono app,可组织 routes、lib 等目录;部署时读取 backend/ 全部文件,经 esbuild 打包后部署到 Cloudflare Workers,并输出形如 https://{projectId8}.backend.blink.new 的地址。
使用方式:先用 blink backend status 检查 Pro/Max/Team 资格,创建 backend/index.ts,再执行 blink backend deploy 部署,blink backend logs 查看日志。前端可直接 fetch,或用 blink.functions.invoke("api/example", { body: {...} }) 调用;projectId8 为完整项目 ID 的后 8 位。JWT 校验可用 blink.auth.verifyToken(c.req.header("Authorization")) 判断 auth.valid。
环境与限制:BLINK_PROJECT_ID、BLINK_SECRET_KEY、BLINK_PUBLISHABLE_KEY 自动注入,禁止硬编码;第三方密钥作为用户密钥通过项目设置或 CLI 添加,以 c.env.MY_SECRET 读取。createClient 须用 secretKey 而非 publishableKey,并应添加 app.use("*", cors())。常见错误包括 BACKEND_REQUIRES_PRO、MISSING_ENTRYPOINT、CORS 错误及 401。其他细节暂未提供。