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 呼叫，並嚴格管理鬧鐘邏輯以防止重複執行。無論您是在建構即時聊天、協作文件還是遊戲後端，此技能都能協助您建構強健的邊緣狀態服務。