SuperAPI AI 工具集

cloudflare-workers

部署与运维

查看项目

更新于 10-16 02:36

技能介绍

用途:为构建与调试 Cloudflare Workers 应用提供专家级模式,涵盖 Durable Objects 有状态协调、KV/R2/D1 存储分层、Workers AI 推理和 AI Gateway 的 LLM 路由。

主要能力:Workers 脚本结构(Env 绑定、fetch 处理、路由到 Durable Object);Durable Objects 用于实时协作、限流与每实体状态,推荐 state.acceptWebSocket() 休眠 API、state.storage.transaction() 原子写入,新 DO 使用 SQLite SQL API;存储选型:KV 适合配置与缓存(最终一致,约 1ms 读)、R2 适合文件与大对象、D1 为边缘 SQLite、DO Storage 为每实体状态;Workers AI 支持文本生成、流式响应、嵌入与图像分类;AI Gateway 提供缓存、限流与可观测性,支持 openai、anthropic、google-ai-studio、azure-openai、workers-ai 等提供方。

使用方式:通过 Skill({ skill: 'cloudflare-workers' }) 调用。配置 wrangler.toml 绑定 KV、R2、D1、Durable Objects 与 AI,并设置迁移;常用命令包括 wrangler dev、wrangler deploy、wrangler types(编辑配置后必须运行以生成 Env 类型)、wrangler kv:key put/get、wrangler r2 object put、wrangler d1 execute、wrangler secret put、wrangler tail。测试使用 Vitest 与 @cloudflare/vitest-pool-workers,命令为 pnpm vitest run --pool @cloudflare/vitest-pool-workers。

适用场景:边缘 API、实时协作、限流、AI 推理与 LLM 网关路由、边缘存储与查询。

限制与注意:Workers 无状态,不可依赖请求间内存;禁止 setTimeout/setInterval,改用 Cron Triggers 或 DO alarms;KV 有每 Worker 约 1000 读/秒软限制,避免热循环读取;D1 高吞吐写入应批处理或走队列;脚本不超过 128MB;不要用 passThroughOnException();不要手写 Env 接口;安全令牌用 crypto.randomUUID() 或 crypto.getRandomValues()。资料未提供具体收费与价格信息。