📌 durable-objects 是什么?

边缘计算大多无状态,遇到"要共享状态、要强一致、要按对象隔离"的场景就抓瞎。Durable Objects 就是 Cloudflare 为此设计的,而 durable-objects 是官方技能,让 AI 帮你正确地用它。

它把"有状态的边缘计算"这件事,变成 AI 可执行的实现。

🧩 核心功能

对象建模:把业务实体映射成 Durable Object。

强一致状态:在边缘实现强一致的状态读写。

实时协作:用 WebSocket 做多端实时同步。

事务与迁移:处理存储、事务和数据迁移。

👍 优点

独特能力:边缘强一致。

低延迟:状态就近。

官方维护。

⚠️ 不足与局限

心智模型比普通 Worker 复杂。

简单场景用不上。

调试更复杂。

🙋 适合谁用

后端开发者:做实时协作、会话、计数器。

架构师:设计边缘有状态服务。

🛠️ 第一次安装

前提:电脑装了 Node.js(18+),有支持 Skill 的 AI 工具(如 Claude Code)。打开终端执行:

bash
npx skills add cloudflare/skills --skill durable-objects

CLI 会自动检测你装的 AI 助手,确认安装位置后即可使用。

✍️ 上手:几个真实例子

场景一:实时计数

提示词
帮我用 Durable Object 做一个实时在线人数统计,WebSocket 同步。

场景二:会话

提示词
帮我做一个基于 Durable Object 的会话管理。

场景三:协作

提示词
帮我实现一个多端实时协作的示例。

🎯 典型应用场景

实时协作:多端同步。

计数器:实时计数。

会话:会话管理。

有状态:边缘状态。

⚖️ 和类似方案对比

和"用 Worker + KV 硬做有状态"相比,Durable Objects 的价值是"强一致 + 就近"——每个对象有独立状态和一致性保证,还支持 WebSocket 实时通信。这是边缘计算里做有状态应用的正解。

💡 常见问题 FAQ

问:和 KV 什么区别?
KV 最终一致、简单;Durable Objects 强一致、可实时。

问:什么时候用?
需要强一致、实时、有状态时。

问:成本高吗?
比无状态贵,按需用。

问:能迁移数据吗?
能,注意事务处理。

📌 总结

总的来说,durable-objects 的价值在于把原本繁琐、重复、容易出错的工作,变成几句对话就能搞定。如果你正好是它的目标用户,装一个试试——成本很低,上手只要几分钟,带来的效率提升却实实在在。如果需求比较轻量,也可以先让 AI 演示一遍再决定是否长期使用。

🤖 适合哪些 AI 工具

Cloudflare 官方 Skill,Claude Code、Cursor、Codex 等支持 Skill 的工具都能装。