用途：Workers KV 是 Cloudflare 边缘网络上快速、最终一致的全局键值存储，适合会话存储、认证令牌、缓存 API 响应、配置与功能开关、用户配置、A/B 测试、限流计数等读多写少场景。不适合强一致数据、关系查询、超过 25MB 的大文件或事务操作。
主要能力：提供 get、getWithMetadata、put、delete、list 等操作，支持字符串、JSON、ArrayBuffer、Stream 值类型，支持 TTL（expirationTtl 或绝对 expiration）、元数据与按前缀列举键。键上限 512 字节，值上限 25MB，元数据上限 1024 字节。list 每次最多返回 1000 个键，需用 cursor 分页。
使用方式：先用 wrangler kv namespace create MY_KV 创建命名空间，预览环境加 --preview；在 wrangler.jsonc 的 kv_namespaces 中配置 binding、id、preview_id，然后运行 wrangler types 生成类型。Worker 中通过 env.BINDING.get/put 等访问。写入可设置 expirationTtl，例如 3600 秒。键建议加前缀如 user:、session:、cache:、config:、rate: 便于管理。
限制：KV 为最终一致，写入后全局传播可能需数秒（通常 60 秒内），不能依赖立即读取到新值，强一致场景应使用 Durable Objects；关系型查询用 D1，大文件用 R2；不可用于锁或事务协调。读取不存在的键返回 null。写操作成本高于读操作，需优化写入模式。
更多高级模式、限制与测试细节见 references/patterns.md、references/limits.md、references/testing.md。