durable-objects

Durable Objects 技能是一个专门用于在 Cloudflare Edge 上构建有状态、可全局协调应用程序的专家助手。它专为需要维护强一致性、处理持久 WebSocket 连接，或为多人游戏、协作工具、预订系统及多租户 SaaS 平台管理实体存储的软件工程师与系统架构师所设计。此技能优先采用官方文档、架构模式及性能最佳实践，以确保您的有状态服务具有可扩展性、可靠性与高性能。

• 针对实现 Durable Object 类提供专家指导，包括使用 SQLite 进行状态管理、使用闹钟（Alarms）执行计划任务，以及使用 blockConcurrencyWhile 进行事务性存储。

• 支持 RPC 方法定义，以实现 Workers 与 Durable Objects 之间无缝的通信。

• 提供 wrangler.jsonc 或 wrangler.toml 的配置协助，涵盖迁移（Migrations）、SQLite 类初始化及绑定定义。

• 使用 @cloudflare/vitest-pool-workers 的全面测试策略，以验证您的逻辑、闹钟触发器及模拟环境中的存储操作。

• 架构设计建议，包含分片策略、父子对象关系，以及通过 getByName() 进行确定性路由的指南。

• 当您需要从无状态 Workers 转换至有状态的协调机制时，请使用此技能，确保您的实现避免常见的反模式，例如全局瓶颈或不正确的存储并发控制。

• 请务必优先从官方 Cloudflare Durable Objects API 文档中进行检索，而非仅依赖内部训练数据，以确保与最新平台更新兼容。

• 输入通常包含您现有的 Worker 或 DO 代码、wrangler 配置文件或架构需求；输出包括优化的代码块、重构建议、性能优化及调试步骤。

• 实际限制包括遵循每个实体单个对象的原则、避免会破坏性能的长时间 blockConcurrencyWhile 调用，并严格管理闹钟逻辑以防止重复执行。无论您是在构建实时聊天、协作文档还是游戏后端，此技能都能帮助您构建稳健的边缘状态服务。