AI Skill 大全

Cloudflare 持久对象开发

在 Cloudflare 上开发或评审 Durable Objects,涵盖 RPC、SQLite 存储、定时任务、WebSocket 和 wrangler 配置。

功能与用途

要在边缘上做有状态的东西——聊天室、多人对局、预订库存、按用户隔离的数据——普通 Workers 存不住状态,就得用 Durable Objects。这个能力把 DO 的写法讲清楚:一个协调原子对应一个 DO 而不是全局一个、用 getByName 做确定性路由、SQLite 建表放构造函数里、用 RPC 方法代替 fetch 处理器、持久化优先于内存缓存,还给了 alarms、WebSocket、Vitest 测试和 wrangler 迁移配置的写法与反模式清单。要求优先查官方文档,别靠记忆写 API。

适用场景

  • 做一款多人在线小游戏,需要按房间隔离状态并保持强一致,不能用:做一款多人在线小游戏,需要按房间隔离状态并保持强一致,不能用无状态 Workers 硬撑
  • 要上个预订系统,担心库存超卖,需要确定一个实体一个 DO 的:要上个预订系统,担心库存超卖,需要确定一个实体一个 DO 的建模方式与并发保护写法
  • 接手一版 DO 代码准备合并,需要按最佳实践查出内存状态未落:接手一版 DO 代码准备合并,需要按最佳实践查出内存状态未落盘、每个请求都套并发锁这类问题

适用人群

  • Cloudflare Workers 开发者
  • 做实时协作或多人应用的边缘开发工程师
  • 评审边缘架构的技术负责人

使用步骤

  1. 先说清协调需求属于哪类:聊天室、多人游戏、预订库存、按用户隔离数据还是长连接
  2. 按「一个协调原子一个 DO」建模,确定分片策略与路由标识(getByName / idFromString / newUniqueId)
  3. 实现 DO 类:构造函数里用 blockConcurrencyWhile 建表,RPC 方法处理业务,必要时补 alarm 或 WebSocket
  4. 在 wrangler 里配好 durable_objects 绑定与 migrations,存储优先用 SQLite 并启用 new_sqlite_classes
  5. 用 @cloudflare/vitest-pool-workers 写测试跑一遍,并对照反模式清单自查

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
专业
版本
main
最近更新
2026-09-18
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Create and review Cloudflare Durable Objects. Use when building stateful coordination (chat rooms, multiplayer games, booking systems), implementing RPC methods, SQLite storage, alarms, WebSockets, or reviewing DO code for best practices. Covers Workers integration, wrangler config, and testing with Vitest. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.

使用前准备

  • 需要 Cloudflare Workers 开发环境与 wrangler 配置能力,熟悉 TypeScript、SQLite 存储模型和边缘运行时约束

依赖与权限

  • 读取用户主动提供的内容

同类 Skill