الواجهات الداخلية لمعمارية Plugin

​

مسار التحميل

1. اكتشاف جذور Plugin المرشحة
2. قراءة بيانات manifest للحزم الأصلية أو المتوافقة وبيانات package الوصفية
3. رفض المرشحين غير الآمنين
4. تطبيع إعدادات Plugin (plugins.enabled, allow, deny, entries, slots, load.paths)
5. تحديد حالة التمكين لكل مرشح
6. تحميل الوحدات الأصلية الممكّنة: تستخدم الوحدات المجمّعة المبنية مُحمّلًا أصليًا؛ وتستخدم Plugins الأصلية غير المبنية jiti
7. استدعاء خطافات register(api) الأصلية وجمع التسجيلات داخل سجل Plugin
8. إتاحة السجل لأسطح الأوامر/وقت التشغيل

​

سلوك manifest أولًا

• تحديد Plugin
• اكتشاف القنوات/Skills/مخطط الإعدادات المصرّح بها أو قدرات الحزمة
• التحقق من plugins.entries.<id>.config
• تعزيز التسميات/العناصر النائبة في واجهة Control
• عرض بيانات التثبيت/الفهرس الوصفية
• الحفاظ على واصفات تفعيل وإعداد منخفضة الكلفة دون تحميل وقت تشغيل Plugin

• يضيّق تحميل CLI إلى Plugins التي تملك الأمر الأساسي المطلوب
• يضيّق إعداد القناة/تحليل Plugin إلى Plugins التي تملك معرّف القناة المطلوب
• يضيّق تحليل الإعداد/وقت التشغيل الصريح للمزوّد إلى Plugins التي تملك معرّف المزوّد المطلوب

​

ما الذي يخزّنه المُحمّل مؤقتًا

• نتائج الاكتشاف
• بيانات سجل manifest
• سجلات Plugins المحمّلة

• اضبط OPENCLAW_DISABLE_PLUGIN_DISCOVERY_CACHE=1 أو OPENCLAW_DISABLE_PLUGIN_MANIFEST_CACHE=1 لتعطيل هذه الذواكر المؤقتة.
• اضبط نوافذ الذاكرة المؤقتة باستخدام OPENCLAW_PLUGIN_DISCOVERY_CACHE_MS و OPENCLAW_PLUGIN_MANIFEST_CACHE_MS.

​

نموذج السجل

• سجلات Plugin (الهوية، والمصدر، والمنشأ، والحالة، والتشخيصات)
• الأدوات
• الخطافات القديمة والخطافات المكتوبة
• القنوات
• المزوّدات
• معالجات Gateway RPC
• مسارات HTTP
• مسجّلات CLI
• الخدمات الخلفية
• الأوامر المملوكة لـ Plugin

• وحدة Plugin -> التسجيل في السجل
• وقت التشغيل الأساسي -> استهلاك السجل

​

استدعاءات ربط المحادثة

export default {
  id: "my-plugin",
  register(api) {
    api.onConversationBindingResolved(async (event) => {
      if (event.status === "approved") {
        // توجد الآن عملية ربط لهذا Plugin + هذه المحادثة.
        console.log(event.binding?.conversationId);
        return;
      }

      // تم رفض الطلب؛ امسح أي حالة انتظار محلية.
      console.log(event.request.conversation.conversationId);
    });
  },
};

• status: "approved" أو "denied"
• decision: "allow-once" أو "allow-always" أو "deny"
• binding: الربط المحسوم للطلبات الموافق عليها
• request: ملخص الطلب الأصلي، وتلميح الفصل، ومعرّف المرسل، و بيانات المحادثة الوصفية

​

خطافات وقت تشغيل المزوّد

• بيانات manifest الوصفية لبحث منخفض الكلفة قبل وقت التشغيل: providerAuthEnvVars, وproviderAuthAliases, وproviderAuthChoices, وchannelEnvVars.
• خطافات وقت الإعداد: catalog (الاسم القديم discovery) بالإضافة إلى applyConfigDefaults.
• خطافات وقت التشغيل: أكثر من 40 خطافًا اختياريًا تغطي المصادقة، وتحليل النموذج، وتغليف البث، ومستويات التفكير، وسياسة الإعادة، ونقاط نهاية الاستخدام. راجع القائمة الكاملة ضمن ترتيب الخطافات واستخدامها.

​

ترتيب الخطافات واستخدامها

​

مثال على مزوّد

api.registerProvider({
  id: "example-proxy",
  label: "Example Proxy",
  auth: [],
  catalog: {
    order: "simple",
    run: async (ctx) => {
      const apiKey = ctx.resolveProviderApiKey("example-proxy").apiKey;
      if (!apiKey) {
        return null;
      }
      return {
        provider: {
          baseUrl: "https://proxy.example.com/v1",
          apiKey,
          api: "openai-completions",
          models: [{ id: "auto", name: "Auto" }],
        },
      };
    },
  },
  resolveDynamicModel: (ctx) => ({
    id: ctx.modelId,
    name: ctx.modelId,
    provider: "example-proxy",
    api: "openai-completions",
    baseUrl: "https://proxy.example.com/v1",
    reasoning: false,
    input: ["text"],
    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
    contextWindow: 128000,
    maxTokens: 8192,
  }),
  prepareRuntimeAuth: async (ctx) => {
    const exchanged = await exchangeToken(ctx.apiKey);
    return {
      apiKey: exchanged.token,
      baseUrl: exchanged.baseUrl,
      expiresAt: exchanged.expiresAt,
    };
  },
  resolveUsageAuth: async (ctx) => {
    const auth = await ctx.resolveOAuthToken();
    return auth ? { token: auth.token } : null;
  },
  fetchUsageSnapshot: async (ctx) => {
    return await fetchExampleProxyUsage(ctx.token, ctx.timeoutMs, ctx.fetchFn);
  },
});

​

أمثلة مضمّنة

​

أدوات وقت التشغيل

const clip = await api.runtime.tts.textToSpeech({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

const result = await api.runtime.tts.textToSpeechTelephony({
  text: "Hello from OpenClaw",
  cfg: api.config,
});

const voices = await api.runtime.tts.listVoices({
  provider: "elevenlabs",
  cfg: api.config,
});

• يعيد textToSpeech حمولة خرج TTS الأساسية العادية لأسطح الملفات/الملاحظات الصوتية.
• يستخدم إعداد messages.tts الأساسي واختيار المزوّد.
• يعيد مخزن PCM صوتيًا + معدل العيّنة. ويجب على Plugins إعادة أخذ العينات/الترميز للمزوّدات.
• listVoices اختياري لكل مزوّد. استخدمه لمنتقيات الأصوات أو تدفقات الإعداد المملوكة للمورّد.
• يمكن أن تتضمن قوائم الأصوات بيانات وصفية أغنى مثل اللغة المحلية، والجنس، ووسوم الشخصية لمنتقيات تراعي المزوّد.
• يدعم OpenAI وElevenLabs الاتصال الهاتفي اليوم. أما Microsoft فلا يدعمه.

api.registerSpeechProvider({
  id: "acme-speech",
  label: "Acme Speech",
  isConfigured: ({ config }) => Boolean(config.messages?.tts),
  synthesize: async (req) => {
    return {
      audioBuffer: Buffer.from([]),
      outputFormat: "mp3",
      fileExtension: ".mp3",
      voiceCompatible: false,
    };
  },
});

• أبقِ سياسة TTS، والرجوع الاحتياطي، وتسليم الردود داخل النواة.
• استخدم مزوّدي الكلام لسلوك التوليف المملوك للمورّد.
• يُطبَّع الإدخال القديم edge الخاص بـ Microsoft إلى معرّف المزوّد microsoft.
• نموذج الملكية المفضّل موجّه نحو الشركة: يمكن لـ Plugin واحد خاص بالمورّد أن يملك مزوّدي النص، والكلام، والصورة، ووسائط مستقبلية أخرى كلما أضاف OpenClaw عقود القدرات تلك.

api.registerMediaUnderstandingProvider({
  id: "google",
  capabilities: ["image", "audio", "video"],
  describeImage: async (req) => ({ text: "..." }),
  transcribeAudio: async (req) => ({ text: "..." }),
  describeVideo: async (req) => ({ text: "..." }),
});

• أبقِ التنسيق، والرجوع الاحتياطي، والإعدادات، وربط القنوات داخل النواة.
• أبقِ سلوك المورّد داخل Plugin المزوّد.
• يجب أن يظل التوسع الإضافي مكتوبًا: أساليب اختيارية جديدة، وحقول نتائج اختيارية جديدة، وقدرات اختيارية جديدة.
• يتبع توليد الفيديو النمط نفسه بالفعل:
  • تملك النواة عقد القدرة وأداة وقت التشغيل
  • تسجّل Plugins المورّد api.registerVideoGenerationProvider(...)
  • تستهلك Plugins الميزة/القناة api.runtime.videoGeneration.*

const image = await api.runtime.mediaUnderstanding.describeImageFile({
  filePath: "/tmp/inbound-photo.jpg",
  cfg: api.config,
  agentDir: "/tmp/agent",
});

const video = await api.runtime.mediaUnderstanding.describeVideoFile({
  filePath: "/tmp/inbound-video.mp4",
  cfg: api.config,
});

const { text } = await api.runtime.mediaUnderstanding.transcribeAudioFile({
  filePath: "/tmp/inbound-audio.ogg",
  cfg: api.config,
  // اختياري عندما لا يمكن استنتاج MIME بشكل موثوق:
  mime: "audio/ogg",
});

• يُعد api.runtime.mediaUnderstanding.* السطح المشترك المفضّل لفهم الصورة/الصوت/الفيديو.
• يستخدم إعداد الصوت الأساسي لفهم الوسائط (tools.media.audio) وترتيب الرجوع الاحتياطي للمزوّد.
• يعيد { text: undefined } عندما لا يُنتَج أي خرج نسخ (مثلًا إذا كان الإدخال متخطًى/غير مدعوم).
• يبقى api.runtime.stt.transcribeAudioFile(...) اسمًا بديلًا للتوافق.

const result = await api.runtime.subagent.run({
  sessionKey: "agent:main:subagent:search-helper",
  message: "Expand this query into focused follow-up searches.",
  provider: "openai",
  model: "gpt-4.1-mini",
  deliver: false,
});

• provider وmodel هما تجاوزان اختياريان لكل تشغيل، وليسا تغييرات جلسة دائمة.
• لا يطبّق OpenClaw حقول التجاوز هذه إلا للمستدعين الموثوقين.
• بالنسبة إلى عمليات الرجوع الاحتياطي المملوكة لـ Plugin، يجب على المشغّلين تفعيل ذلك صراحةً عبر plugins.entries.<id>.subagent.allowModelOverride: true.
• استخدم plugins.entries.<id>.subagent.allowedModels لتقييد Plugins الموثوقة بأهداف provider/model القياسية المحددة، أو "*" للسماح الصريح بأي هدف.
• تظل عمليات Subagent الخاصة بـ Plugins غير الموثوقة تعمل، لكن تُرفض طلبات التجاوز بدلًا من الرجوع الاحتياطي بصمت.

const providers = api.runtime.webSearch.listProviders({
  config: api.config,
});

const result = await api.runtime.webSearch.search({
  config: api.config,
  args: {
    query: "OpenClaw plugin runtime helpers",
    count: 5,
  },
});

• أبقِ اختيار المزوّد، وتحليل بيانات الاعتماد، ودلالات الطلبات المشتركة داخل النواة.
• استخدم مزوّدي البحث على الويب لطبقات النقل الخاصة بالمورّد.
• يُعد api.runtime.webSearch.* السطح المشترك المفضّل لPlugins الميزات/القنوات التي تحتاج إلى سلوك بحث من دون الاعتماد على غلاف أداة الوكيل.

​

api.runtime.imageGeneration

const result = await api.runtime.imageGeneration.generate({
  config: api.config,
  args: { prompt: "A friendly lobster mascot", size: "1024x1024" },
});

const providers = api.runtime.imageGeneration.listProviders({
  config: api.config,
});

• generate(...): يولّد صورة باستخدام سلسلة مزوّد توليد الصور المهيّأة.
• listProviders(...): يسرد مزوّدي توليد الصور المتاحين وقدراتهم.

​

مسارات HTTP الخاصة بـ Gateway

api.registerHttpRoute({
  path: "/acme/webhook",
  auth: "plugin",
  match: "exact",
  handler: async (_req, res) => {
    res.statusCode = 200;
    res.end("ok");
    return true;
  },
});

• path: مسار route ضمن خادم HTTP الخاص بـ Gateway.
• auth: مطلوب. استخدم "gateway" لطلب مصادقة Gateway العادية، أو "plugin" للمصادقة/التحقق من Webhook الذي يديره Plugin.
• match: اختياري. "exact" (الافتراضي) أو "prefix".
• replaceExisting: اختياري. يسمح لـ Plugin نفسه باستبدال تسجيل مساره الحالي.
• handler: أعِد true عندما يكون المسار قد عالج الطلب.

• أُزيل api.registerHttpHandler(...) وسيسبب خطأ في تحميل Plugin. استخدم api.registerHttpRoute(...) بدلًا منه.
• يجب على مسارات Plugin التصريح عن auth صراحةً.
• تُرفض تعارضات path + match المتطابقة ما لم يكن replaceExisting: true، ولا يمكن لـ Plugin واحد استبدال مسار Plugin آخر.
• تُرفض المسارات المتداخلة ذات مستويات auth المختلفة. أبقِ سلاسل التمرير exact/prefix ضمن مستوى المصادقة نفسه فقط.
• لا تتلقى مسارات auth: "plugin" نطاقات وقت تشغيل المشغّل تلقائيًا. فهي مخصّصة لـ Webhooks/التحقق من التوقيع الذي يديره Plugin، وليست لاستدعاءات Gateway المساعدة ذات الامتيازات.
• تعمل مسارات auth: "gateway" داخل نطاق وقت تشغيل طلب Gateway، لكن هذا النطاق متحفظ عمدًا:
  • تبقي مصادقة bearer بالمفتاح السري المشترك (gateway.auth.mode = "token" / "password") نطاقات وقت تشغيل مسار Plugin مثبتة عند operator.write، حتى لو أرسل المستدعي x-openclaw-scopes
  • أوضاع HTTP الموثوقة الحاملة للهوية (مثل trusted-proxy أو gateway.auth.mode = "none" على مدخل خاص) لا تكرّم x-openclaw-scopes إلا عندما يكون الرأس موجودًا صراحةً
  • إذا كان x-openclaw-scopes غائبًا في طلبات مسار Plugin الحاملة للهوية تلك، يعود نطاق وقت التشغيل إلى operator.write
• القاعدة العملية: لا تفترض أن مسار Plugin ذي مصادقة gateway هو سطح إدارة ضمني. إذا كان مسارك يحتاج إلى سلوك مخصص للمشرف فقط، فاشترط وضع مصادقة حاملًا للهوية ووثّق عقد الرأس x-openclaw-scopes الصريح.

​

مسارات استيراد Plugin SDK

• index.js — إدخال Plugin المجمّع
• api.js — برميل الأدوات/الأنواع
• runtime-api.js — برميل خاص بوقت التشغيل فقط
• setup-entry.js — إدخال Plugin الإعداد

​

مخططات أدوات الرسائل

• presentation لكتل العرض الدلالية (text, context, divider, buttons, select)
• delivery-pin لطلبات التسليم المثبّت

​

تحليل أهداف القنوات

• يحدد messaging.inferTargetChatType({ to }) ما إذا كان الهدف الموحّد يجب التعامل معه كـ direct أو group أو channel قبل البحث في الدليل.
• يوضح messaging.targetResolver.looksLikeId(raw, normalized) للنواة ما إذا كان الإدخال يجب أن يتجاوز مباشرة إلى التحليل الشبيه بالمعرّف بدلًا من البحث في الدليل.
• يمثّل messaging.targetResolver.resolveTarget(...) رجوع Plugin الاحتياطي عندما تحتاج النواة إلى تحليل نهائي مملوك للمزوّد بعد التطبيع أو بعد فشل البحث في الدليل.
• يملك messaging.resolveOutboundSessionRoute(...) إنشاء مسار الجلسة الخاص بالمزوّد بعد تحليل الهدف.

• استخدم inferTargetChatType لقرارات التصنيف التي يجب أن تحدث قبل البحث عن الأقران/المجموعات.
• استخدم looksLikeId لفحوصات “تعامل مع هذا على أنه معرّف هدف صريح/أصلي”.
• استخدم resolveTarget لرجوع التطبيع الاحتياطي الخاص بالمزوّد، وليس للبحث الواسع في الدليل.
• أبقِ المعرّفات الأصلية الخاصة بالمزوّد مثل معرّفات الدردشة، ومعرّفات السلاسل، وJIDs، والمقابض، ومعرّفات الغرف داخل قيم target أو البارامترات الخاصة بالمزوّد، لا في حقول SDK العامة.

​

الأدلة المعتمدة على الإعدادات

• أقران DM المعتمدين على allowlist
• خرائط القنوات/المجموعات المهيّأة
• بدائل دليل ثابتة ضمن نطاق الحساب

• تصفية الاستعلام
• تطبيق الحد
• أدوات إزالة التكرار/التطبيع
• بناء ChannelDirectoryEntry[]

​

فهارس المزوّدين

• { provider } لإدخال مزوّد واحد
• { providers } لعدة إدخالات مزوّدين

• simple: مزوّدات تعتمد على مفتاح API عادي أو على env
• profile: مزوّدات تظهر عندما توجد ملفات تعريف المصادقة
• paired: مزوّدات تُنشئ عدة إدخالات مزوّد مترابطة
• late: التمريرة الأخيرة، بعد بقية المزوّدين الضمنيين

• ما يزال discovery يعمل كاسم بديل قديم
• إذا سُجّل كل من catalog وdiscovery، يستخدم OpenClaw catalog

​

فحص القنوات للقراءة فقط

• resolveAccount(...) هو مسار وقت التشغيل. ويُسمح له بافتراض أن بيانات الاعتماد قد جرى تجسيدها بالكامل، ويمكنه الفشل سريعًا عند غياب الأسرار المطلوبة.
• لا ينبغي لمسارات الأوامر للقراءة فقط مثل openclaw status، وopenclaw status --all، وopenclaw channels status، وopenclaw channels resolve، وعمليات doctor/config repair أن تحتاج إلى تجسيد بيانات اعتماد وقت التشغيل لمجرد وصف الإعدادات.

• أعِد فقط حالة حساب وصفية.
• حافظ على enabled وconfigured.
• ضمّن حقول مصدر/حالة بيانات الاعتماد عند الاقتضاء، مثل:
  • tokenSource, tokenStatus
  • botTokenSource, botTokenStatus
  • appTokenSource, appTokenStatus
  • signingSecretSource, signingSecretStatus
• لا تحتاج إلى إعادة قيم الرموز الخام فقط للإبلاغ عن الإتاحة في القراءة فقط. يكفي إرجاع tokenStatus: "available" (وحقل المصدر المطابق) لأوامر نمط الحالة.
• استخدم configured_unavailable عندما تكون بيانات الاعتماد مهيأة عبر SecretRef لكن غير متاحة في مسار الأمر الحالي.

​

حِزم الحزم

{
  "name": "my-pack",
  "openclaw": {
    "extensions": ["./src/safety.ts", "./src/tools.ts"],
    "setupEntry": "./src/setup-entry.ts"
  }
}

• تسجيل القناة نفسه
• أي مسارات HTTP يجب أن تكون متاحة قبل أن يبدأ Gateway في الاستماع
• أي أساليب Gateway أو أدوات أو خدمات يجب أن توجد خلال تلك النافذة نفسها

• singleAccountKeysToMove
• namedAccountPromotionKeys
• resolveSingleAccountPromotionTarget(...)

{
  "name": "@scope/my-channel",
  "openclaw": {
    "extensions": ["./index.ts"],
    "setupEntry": "./setup-entry.ts",
    "startup": {
      "deferConfiguredChannelFullLoadUntilAfterListen": true
    }
  }
}

​

البيانات الوصفية لفهرس القنوات

{
  "name": "@openclaw/nextcloud-talk",
  "openclaw": {
    "extensions": ["./index.ts"],
    "channel": {
      "id": "nextcloud-talk",
      "label": "Nextcloud Talk",
      "selectionLabel": "Nextcloud Talk (مستضاف ذاتيًا)",
      "docsPath": "/channels/nextcloud-talk",
      "docsLabel": "nextcloud-talk",
      "blurb": "دردشة مستضافة ذاتيًا عبر روبوتات Webhook الخاصة بـ Nextcloud Talk.",
      "order": 65,
      "aliases": ["nc-talk", "nc"]
    },
    "install": {
      "npmSpec": "@openclaw/nextcloud-talk",
      "localPath": "<bundled-plugin-local-path>",
      "defaultChoice": "npm"
    }
  }
}

• detailLabel: تسمية ثانوية لأسطح الفهرس/الحالة الأكثر ثراءً
• docsLabel: تجاوز نص الرابط الخاص برابط الوثائق
• preferOver: معرّفات Plugin/قنوات ذات أولوية أقل يجب أن يتفوق عليها إدخال الفهرس هذا
• selectionDocsPrefix, selectionDocsOmitLabel, selectionExtras: عناصر تحكم نصية خاصة بسطح الاختيار
• markdownCapable: يعلّم القناة على أنها قادرة على استخدام Markdown لقرارات التنسيق الصادر
• exposure.configured: إخفاء القناة من أسطح سرد القنوات المهيأة عند ضبطه على false
• exposure.setup: إخفاء القناة من منتقيات الإعداد/التهيئة التفاعلية عند ضبطه على false
• exposure.docs: تعليم القناة على أنها داخلية/خاصة لأسطح التنقل في الوثائق
• showConfigured / showInSetup: أسماء بديلة قديمة ما تزال مقبولة للتوافق؛ ويفضّل استخدام exposure
• quickstartAllowFrom: يضم القناة إلى تدفق allowFrom القياسي في البدء السريع
• forceAccountBinding: يفرض ربط حساب صريحًا حتى عند وجود حساب واحد فقط
• preferSessionLookupForAnnounceTarget: يفضّل البحث عن الجلسة عند تحليل أهداف الإعلان

• ~/.openclaw/mpm/plugins.json
• ~/.openclaw/mpm/catalog.json
• ~/.openclaw/plugins/catalog.json

​

Plugins لمحرك السياق

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";

export default function (api) {
  api.registerContextEngine("lossless-claw", () => ({
    info: { id: "lossless-claw", name: "Lossless Claw", ownsCompaction: true },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },
    async compact() {
      return { ok: true, compacted: false };
    },
  }));
}

import {
  buildMemorySystemPromptAddition,
  delegateCompactionToRuntime,
} from "openclaw/plugin-sdk/core";

export default function (api) {
  api.registerContextEngine("my-memory-engine", () => ({
    info: {
      id: "my-memory-engine",
      name: "My Memory Engine",
      ownsCompaction: false,
    },
    async ingest() {
      return { ingested: true };
    },
    async assemble({ messages, availableTools, citationsMode }) {
      return {
        messages,
        estimatedTokens: 0,
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },
    async compact(params) {
      return await delegateCompactionToRuntime(params);
    },
  }));
}

​

إضافة قدرة جديدة

1. تعريف العقد الأساسي حدّد السلوك المشترك الذي ينبغي أن تملكه النواة: السياسة، والرجوع الاحتياطي، ودمج الإعدادات، ودورة الحياة، والدلالات المواجهة للقنوات، وشكل أداة وقت التشغيل.
2. إضافة أسطح تسجيل/وقت تشغيل مكتوبة لـ Plugin وسّع OpenClawPluginApi و/أو api.runtime بأصغر سطح قدرة مكتوب ومفيد.
3. ربط النواة + مستهلكي القنوات/الميزات يجب أن تستهلك القنوات وPlugins الميزات القدرة الجديدة من خلال النواة، لا عبر استيراد تنفيذ خاص بمورّد مباشرة.
4. تسجيل تنفيذات المورّدين بعد ذلك تسجّل Plugins المورّدين الواجهات الخلفية الخاصة بها مقابل القدرة.
5. إضافة تغطية للعقد أضف اختبارات حتى تبقى الملكية وشكل التسجيل واضحين مع مرور الوقت.

​

قائمة التحقق للقدرات

• أنواع العقد الأساسية في src/<capability>/types.ts
• المشغّل/أداة وقت التشغيل الأساسية في src/<capability>/runtime.ts
• سطح تسجيل Plugin API في src/plugins/types.ts
• ربط سجل Plugin في src/plugins/registry.ts
• كشف وقت تشغيل Plugin في src/plugins/runtime/* عندما تحتاج Plugins الميزات/القنوات إلى استهلاكه
• أدوات الالتقاط/الاختبار في src/test-utils/plugin-registration.ts
• تأكيدات الملكية/العقد في src/plugins/contracts/registry.ts
• وثائق المشغّل/Plugin في docs/

​

قالب القدرة

// العقد الأساسي
export type VideoGenerationProviderPlugin = {
  id: string;
  label: string;
  generateVideo: (req: VideoGenerationRequest) => Promise<VideoGenerationResult>;
};

// Plugin API
api.registerVideoGenerationProvider({
  id: "openai",
  label: "OpenAI",
  async generateVideo(req) {
    return await generateOpenAiVideo(req);
  },
});

// أداة وقت تشغيل مشتركة لPlugins الميزات/القنوات
const clip = await api.runtime.videoGeneration.generate({
  prompt: "Show the robot walking through the lab.",
  cfg,
});

expect(findVideoGenerationProviderIdsForPlugin("openai")).toEqual(["openai"]);

• تملك النواة عقد القدرة + التنسيق
• تملك Plugins المورّدين التنفيذات الخاصة بالمورّد
• تستهلك Plugins الميزات/القنوات أدوات وقت التشغيل
• تُبقي اختبارات العقد الملكية واضحة

​

ذو صلة

• معمارية Plugin — نموذج القدرات العام والأشكال
• المسارات الفرعية لـ Plugin SDK
• إعداد Plugin SDK
• بناء Plugins