用途:面向在 Cloudflare Workers 上开发 TypeScript 应用的技能,提供边缘优先的开发模式与最佳实践。
主要能力:覆盖 Workers API、Hono 框架、KV/D1/R2 存储、Durable Objects、Queues 及测试。核心原则包括默认无状态、全球 300+ 数据中心分发、V8 隔离毫秒级冷启动、每次调用处理一个请求。存储选型参考:KV 适合配置与缓存(最终一致,约 10ms);D1 适合关系数据与事务(单区域强一致,约 30-50ms);R2 适合文件与大型对象(强一致,约 50-100ms);Durable Objects 适合实时状态与 WebSocket(按对象强一致,约 50ms);Queues 适合异步处理与批处理(至少一次)。
使用方式:项目结构含 src/index.ts 入口、routes、services、types.ts、test、wrangler.toml 等。最小 wrangler.toml 需配置 name、main、compatibility_date、compatibility_flags。可用 Hono 定义路由与错误处理。常用命令:wrangler dev、wrangler dev --remote、wrangler deploy、wrangler d1 migrations apply my-database、wrangler secret put API_KEY、wrangler tail。
适用场景:边缘优先的 TypeScript 服务、需要全球低延迟的 API、实时协作与 WebSocket、异步任务处理。
限制与反模式:避免 Service Worker 格式(用 ES modules)、避免 await 缓存写入(用 waitUntil)、KV 值不超过 25MB(大文件用 R2)、WebSocket 用 ctx.acceptWebSocket() 而非 server.accept()、不要阻塞分析/日志、不要假设 KV 立即一致(一致性关键场景用 D1 或 DO)。相关技能:wrangler-coder(CLI 部署、密钥、测试、多环境)、cloudflare-coder(Terraform/OpenTofu 基础设施)。