skill
الكائنات الدائمة
بناء، تصحيح، أو مراجعة كود Cloudflare Durable Objects للحالة المستمرة والتنسيق.
نبذة
# Durable Objects
أنشئ تطبيقات منسقة وذات حالة على حافة Cloudflare باستخدام Durable Objects.
## مصادر الاسترجاع
قد تكون معرفتك بواجهات برمجة تطبيقات Durable Objects وتكوينها قديمة. **فضل الاسترجاع على التدريب المسبق** لأي مهمة تتعلق ب Durable Objects.
| المورد | URL | |----------|-----| | الوثائق | https://developers.cloudflare.com/durable-objects/index.md | | مرجع API | https://developers.cloudflare.com/durable-objects/api/index.md | | أفضل الممارسات | https://developers.cloudflare.com/durable-objects/best-practices/index.md | | الأمثلة | https://developers.cloudflare.com/durable-objects/examples/index.md | | الأدوار والصلاحيات | https://developers.cloudflare.com/workers/authorization/durable-objects/index.md |
احضر صفحة الوثائق ذات الصلة عند تنفيذ الميزات.
## متى تستخدم
- إنشاء فئات Durable Object جديدة للتنسيق ذي الحالة - تنفيذ أساليب RPC، أو التنبيهات (alarms)، أو معالجات WebSocket - مراجعة كود DO الحالي لأفضل الممارسات - تكوين wrangler.jsonc/toml لربط DO والترحيلات - كتابة الاختبارات باستخدام تكامل Vitest من Cloudflare - تصميم استراتيجيات التجزئة (sharding) والعلاقات بين الأصل والفرع
## وثائق المرجع
- `./references/rules.md` - القواعد الأساسية، التخزين، التزامن، RPC، التنبيهات - [مرجع الاختبار](./references/testing.md) - وثائق Vitest الحالية، خيارات الترحيل، واختيار الاختبار - [مرجع Workers](./references/workers.md) - معالجات Workers، الأنواع، التكوين، التتبع، والتصحيح المحلي
بحث: `blockConcurrencyWhile`, `idFromName`, `getByName`, `setAlarm`, `sql.exec`
## المبادئ الأساسية
### استخدم Durable Objects من أجل
| الحاجة | مثال | |------|---------| | التنسيق | غرف الدردشة، الألعاب متعددة اللاعبين، المستندات التعاونية | | الاتساق القوي | المخزون، أنظمة الحجز، الألعاب القائمة على الأدوار | | التخزين لكل كيان | SaaS متعدد المستأجرين، بيانات لكل مستخدم | | الاتصالات المستمرة | WebSockets، إشعارات الوقت الفعلي | | العمل المجدول لكل كيان | تجديد الاشتراكات، مهل الألعاب |
### لا تستخدم من أجل
- معالجة الطلبات عديمة الحالة (استخدم Workers العاديين) - أقصى احتياجات التوزيع العالمي - طلبات مستقلة ذات تفرع عال
## مرجع سريع
### تكوين Wrangler
```jsonc // wrangler.jsonc { "durable_objects": { "bindings": [{ "name": "MY_DO", "class_name": "MyDurableObject" }] }, "migrations": [{ "tag": "v1", "new_sqlite_classes": ["MyDurableObject"] }] } ```
### نمط Durable Object الأساسي
```typescript import { DurableObject } from "cloudflare:workers";
export interface Env { MY_DO: DurableObjectNamespace<MyDurableObject>; }
export class MyDurableObject extends DurableObject<Env> { constructor(ctx: DurableObjectState, env: Env) { super(ctx, env); ctx.blockConcurrencyWhile(async () => { this.ctx.storage.sql.exec(` CREATE TABLE IF NOT EXISTS items ( id INTEGER PRIMARY KEY AUTOINCREMENT, data TEXT NOT NULL ) `); }); }
async addItem(data: string): Promise<number> { const result = this.ctx.storage.sql.exec<{ id: number }>( "INSERT INTO items (data) VALUES (?) RETURNING id", data ); return result.one().id; } }
export default { async fetch(request: Request, env: Env): Promise<Response> { const stub = env.MY_DO.getByName("my-instance"); const id = await stub.addItem("hello"); return Response.json({ id }); }, }; ```
## قواعد حرجة
1. **النمذجة حول ذرات التنسيق** - Durable Object واحد لكل غرفة دردشة/لعبة/مستخدم، وليس Durable Object عالمي واحد 2. **استخدم `getByName()` للتوجيه الحتمي** - نفس المدخلات = نفس مثيل Durable Object 3. **استخدم تخزين SQLite** - قم بتكوين `new_sqlite_classes` في الترحيلات 4. **التهيئة في المنشئ (constructor)** - استخدم `blockConcurrencyWhile()` لإعداد المخطط فقط 5. **استخدم أساليب RPC** - وليس معالج fetch() (تاريخ التوافق >= 2024-04-03) 6. **الاستمرارية أولا، التخزين المؤقت ثانيا** - اكتب دائما إلى التخزين قبل تحديث الحالة في الذاكرة 7. **تنبيه واحد لكل Durable Object** - `setAlarm()` يستبدل أي تنبيه موجود
## التفويض
لا تحتوي Durable Objects على أدوار أو صلاحيات منفصلة؛ يتبع الوصول العامل (Worker) الذي ينفذها. استرجع [إرشادات تفويض Durable Objects](https://developers.cloudflare.com/workers/authorization/durable-objects/index.md) الحالية قبل منح إمكانية المراقبة أو الوصول إلى Data Studio، وحدد نطاق دور Workers للعامل المقصود أو منتج Workers.
## أنماط خاطئة (ممنوع أبدا)
- Durable Object عالمي واحد يتعامل مع جميع الطلبات (نقطة اختناق) - استخدام `blockConcurrencyWhile()` في كل طلب (يقتل الإنتاجية) - تخزين الحالة الحرجة في الذاكرة فقط (تفقد عند الإخلاء/التعطل) - استخدام `await` بين عمليات الكتابة ذات الصلة في التخزين (يكسر الذرية) - الاحتفاظ ب `blockConcurrencyWhile()` عبر `fetch()` أو الإدخال/الإخراج الخارجي
## إنشاء Stub
```typescript // حتمي - مفضل لمعظم الحالات const stub = env.MY_DO.getByName("room-123");
// من سلسلة ID موجودة const id = env.MY_DO.idFromString(storedIdString); const stub = env.MY_DO.get(id);
// ID فريد جديد - قم بالتخزين ```
التثبيت
شغل هذا الأمر
npx skills add cloudflare/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add cloudflare/skills`، أو استنسخ المستودع وانسخ مجلد `skills/durable-objects` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة الكائنات الدائمة؟
بناء، تصحيح، أو مراجعة كود Cloudflare Durable Objects للحالة المستمرة والتنسيق.
كيف أثبت الكائنات الدائمة؟
شغل هذا الأمر في الطرفية:
npx skills add cloudflare/skillsمع أي أدوات ذكاء اصطناعي تعمل الكائنات الدائمة؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور الكائنات الدائمة؟
طورها cloudflare.
هل الكائنات الدائمة مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى