SuperAPI AI 工具集

durable-objects

数据与分析

查看项目

更新于 10-16 09:30

技能介绍

该技能用于在 Cloudflare 边缘构建有状态、可协调的应用,或在实现与审查时参考最佳实践。由于 Durable Objects API 与配置可能已过时,任务中主张检索官方文档而非依赖预训练知识,涉及文档、API 参考、最佳实践与示例等来源。

适用场景:创建有状态协调的 Durable Object 类;实现 RPC、Alarms 或 WebSocket 处理器;审查现有 DO 代码;配置 wrangler.jsonc 的绑定与生命周期导出;使用 @cloudflare/vitest-plugin 编写测试;设计分片策略与父子关系。

适合用途包括协调(聊天室、多人游戏、协作文档)、强一致性(库存、预约、回合制游戏)、按实体存储(多租户 SaaS、用户数据)、持久连接(WebSockets、实时通知、订阅续订、游戏超时)。不适合无状态请求、最大全球分布或高扇出独立请求。

核心规则:以协调原子为单位建模,每个聊天室/游戏/用户一个 DO;用 getByName() 做确定性路由;配置 SQLite 存储;仅在构造函数中用 blockConcurrencyWhile() 初始化 schema;使用 RPC 方法而非 fetch()(兼容日期需 >= 2024-04-03);先持久化后缓存;每个 DO 仅一个 alarm,setAlarm() 会替换现有 alarm。

另提供规则、测试与 Workers 参考文档,以及 blockConcurrencyWhile、idFromName、getByName、setAlarm、sql.exec 等检索关键词。关于收费、价格与平台细节,资料暂未提供。