PartyKit 是运行在 Cloudflare 边缘的实时基础设施,提供带状态的 WebSocket 服务器、按需房间、全球分布与 Durable Objects 支持,用于构建实时多人应用,如协作应用、游戏和 AI 智能体。
主要能力:每个唯一房间 ID 创建独立的服务器实例,同一房间的连接共享实例;支持 onConnect、onMessage、onClose、onError、onRequest 等服务器事件;可通过 room.broadcast 广播消息(可排除发送者);支持 HTTP 请求处理;房间状态保存在服务器实例中,持久数据可写入 Durable Object storage,以在房间休眠后保留。
使用方式:用 npm create partykit@latest my-app 创建项目,npm run dev 本地运行,npx partykit deploy 部署到 PartyKit 云或 Cloudflare 账户。客户端使用 PartySocket,配置 host 与 room,支持自动重连,并提供 React 的 usePartySocket。可在 partykit.json 中配置多个 party 类型。AI 集成可使用 partykit-ai 的 Ai 类调用模型。环境变量用 npx partykit env add MY_SECRET 设置。
适用场景:聊天室、多人在线游戏状态同步、在线状态(谁在线)展示、AI 提示与响应等实时协作场景。
限制:资料未提供收费、价格、平台兼容性或性能上限等信息,本地开发与部署的具体配额也暂未提供,以上均需以官方资料为准。