用途:在工作涉及 Cloudflare 服务时激活,用于搭建 Workers 或 Pages、使用 KV/R2/D1 存储、部署应用、配置 wrangler.toml 以及管理 Cloudflare 资源。
主要能力:覆盖五类服务——Workers(无服务器函数,用于 API 端点、中间件)、Pages(静态站点加函数,支持 SvelteKit、Next.js)、KV(键值存储,用于缓存、会话)、R2(对象存储,用于文件、图片、备份)、D1(SQLite 数据库,用于结构化数据)。可通过 wrangler CLI 或 MCP 服务器操作。资料还提到 Grove 使用的 @autumnsgrove/infra 可移植接口层(GroveDatabase、GroveStorage、GroveKV、GroveServiceBus),以 createCloudflareContext() 创建上下文;以及 Amber SDK 的 FileManager、QuotaManager 等,和 @autumnsgrove/lattice/server 的类型安全解析工具。
使用方式:安装 pnpm add -g wrangler,登录 wrangler login;初始化 wrangler init my-worker,本地开发 wrangler dev(--remote 使用真实资源),部署 wrangler deploy,查看日志 wrangler tail。KV 用 wrangler kv namespace create;R2 用 wrangler r2 bucket create;D1 用 wrangler d1 create 与 wrangler d1 execute。Pages 用 wrangler pages deploy ./build --project-name=my-site。密钥用 wrangler secret put API_KEY --name my-worker。
适用场景与限制:适合需要无服务器函数、静态站点和边缘存储的部署工作,建议先在 wrangler dev 本地测试、使用环境特定配置、用 wrangler tail 监控日志,避免硬编码账户 ID、跳过本地测试和提交含生产 ID 的 wrangler.toml。资料未提供更细的限制说明。