Bindings 说明文档

# Cloudflare 绑定（Bindings）技能参考 关于 Cloudflare Workers 绑定（Bindings）的专家指南——这是将 Workers 连接到 Cloudflare 平台资源的运行时 API。 ## 什么是绑定？ 绑定是 Workers 通过 `env` 对象访问 Cloudflare 资源（存储、计算、服务）的方式。它们在 `wrangler.jsonc` 中配置，通过 TypeScript 实现类型安全，且在运行时零开销。 ## 阅读顺序 1. **本文档** - 绑定目录与选择指南 2. **[api.md](api.md)** - TypeScript 类型与 env 访问模式 3. **[configuration.md](configuration.md)** - 完整的 wrangler.jsonc 示例 4. **[patterns.md](patterns.md)** - 最佳实践与常见模式 5. **[gotchas.md](gotchas.md)** - 关键陷阱与故障排除 ## 绑定目录 ### 存储绑定 | 绑定 | 使用场景 | 访问模式 | |---------|----------|----------------| | **KV** | 键值缓存，CDN 支持读取 | `env.MY_KV.get(key)` | | **R2** | 对象存储 (S3 兼容) | `env.MY_BUCKET.get(key)` | | **D1** | SQL 数据库 (SQLite) | `env.DB.prepare(sql).all()` | | **Durable Objects** | 协调，实时状态 | `env.MY_DO.get(id)` | | **Vectorize** | 向量嵌入搜索 | `env.VECTORIZE.query(vector)` | | **Queues** | 异步消息处理 | `env.MY_QUEUE.send(msg)` | ### 计算绑定 | 绑定 | 使用场景 | 访问模式 | |---------|----------|----------------| | **Service** | Worker 到 Worker 的 RPC | `env.MY_SERVICE.fetch(req)` | | **Workers AI** | LLM 推理 | `env.AI.run(model, input)` | | **Browser Rendering** | 无头 Chrome | `env.BROWSER.fetch(url)` | ### 平台绑定 | 绑定 | 使用场景 | 访问模式 | |---------|----------|----------------| | **Analytics Engine** | 自定义指标 | `env.ANALYTICS.writeDataPoint(data)` | | **mTLS** | 客户端证书 | `env.MY_CERT` (字符串) | | **Hyperdrive** | 数据库连接池 | `env.HYPERDRIVE.connectionString` | | **Rate Limiting** | 请求限流 | `env.RATE_LIMITER.limit(id)` | | **Workflows** | 长时间运行的工作流 | `env.MY_WORKFLOW.create()` | ### 配置绑定 | 绑定 | 使用场景 | 访问模式 | |---------|----------|----------------| | **Environment Variables** | 非敏感配置 | `env.API_URL` (字符串) | | **Secrets** | 敏感值 | `env.API_KEY` (字符串) | | **Text/Data Blobs** | 静态文件 | `env.MY_BLOB` (字符串) | | **WASM** | WebAssembly 模块 | `env.MY_WASM` (WebAssembly.Module) | ## 快速选择指南 **需要持久化 "