إدارة Plugins

معظم سير عمل Plugin عبارة عن بضعة أوامر: البحث، والتثبيت، وإعادة تشغيل Gateway، والتحقق، وإلغاء التثبيت عندما لا تعود بحاجة إلى Plugin.

عرض Plugins

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --json

استخدم --json مع السكربتات. فهو يتضمن تشخيصات السجل وحالة dependencyStatus الثابتة لكل Plugin عندما تعلن حزمة Plugin عن dependencies أو optionalDependencies.

OmeniaClaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list هو فحص مخزون بارد. يعرض ما يستطيع OmeniaClaw اكتشافه من الإعدادات والبيانات الوصفية وسجل Plugin؛ ولا يثبت أن عملية Gateway قيد التشغيل بالفعل قد استوردت وقت تشغيل Plugin.

تثبيت Plugins

# Search ClawHub for plugin packages.OmeniaClaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.OmeniaClaw plugins install <package> # Force one source.OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install npm:<package> # Install a specific version or dist-tag.OmeniaClaw plugins install clawhub:<package>@1.2.3OmeniaClaw plugins install clawhub:<package>@betaOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw plugins install npm:@OmeniaClaw/codex # Install from git or a local development checkout.OmeniaClaw plugins install git:github.com/acme/[email protected]OmeniaClaw plugins install ./my-pluginOmeniaClaw plugins install --link ./my-plugin

بعد تثبيت كود Plugin، أعد تشغيل Gateway الذي يخدم قنواتك:

OmeniaClaw gateway restartOmeniaClaw plugins inspect <plugin-id> --runtime --json

استخدم inspect --runtime عندما تحتاج إلى دليل على أن Plugin سجّل أسطح وقت التشغيل مثل الأدوات أو الخطافات أو الخدمات أو أساليب Gateway أو أوامر CLI المملوكة لـ Plugin.

تحديث Plugins

OmeniaClaw plugins update <plugin-id>OmeniaClaw plugins update <npm-package-or-spec>OmeniaClaw plugins update --all

إذا كان Plugin قد ثُبّت من وسم توزيع npm مثل @beta، فإن استدعاءات update <plugin-id> اللاحقة تعيد استخدام ذلك الوسم المسجل. تمرير مواصفة npm صريحة يبدّل التثبيت المتتبَّع إلى تلك المواصفة للتحديثات المستقبلية.

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-plugin

يعيد الأمر الثاني Plugin إلى خط الإصدار الافتراضي في السجل عندما كان مثبتًا سابقًا على إصدار دقيق أو وسم محدد.

عند تشغيل OmeniaClaw update على قناة beta، تحاول سجلات Plugin الافتراضية من npm وClawHub استخدام إصدار Plugin المطابق @beta أولًا. إذا لم يكن إصدار beta هذا موجودًا، يعود OmeniaClaw إلى المواصفة الافتراضية/الأحدث المسجلة. بالنسبة إلى Plugins من npm، يعود OmeniaClaw أيضًا عندما تكون حزمة beta موجودة لكنها تفشل في تحقق التثبيت. تُحفظ الإصدارات الدقيقة والوسوم الصريحة مثل @rc أو @beta.

إلغاء تثبيت Plugins

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw gateway restart

يزيل إلغاء التثبيت إدخال إعدادات Plugin، وسجل فهرس Plugin، وإدخالات قوائم السماح/الحظر، ومسارات التحميل المرتبطة عند الاقتضاء. تُزال أدلة التثبيت المُدارة ما لم تمرر --keep-files.

في وضع Nix (OmeniaClaw_NIX_MODE=1)، تكون أوامر تثبيت Plugin وتحديثه وإلغاء تثبيته وتمكينه وتعطيله معطلة. أدِر هذه الاختيارات في مصدر Nix الخاص بالتثبيت بدلًا من ذلك؛ بالنسبة إلى nix-OmeniaClaw، استخدم البداية السريعة المعتمدة على الوكيل أولًا.

نشر Plugins

يمكنك نشر Plugins خارجية إلى ClawHub، أو npmjs.com، أو كليهما.

النشر إلى ClawHub

ClawHub هو سطح الاكتشاف العام الأساسي لـ Plugins في OmeniaClaw. فهو يمنح المستخدمين بيانات وصفية قابلة للبحث، وسجل الإصدارات، ونتائج فحص السجل قبل التثبيت.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

يثبّت المستخدمون من ClawHub باستخدام:

OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install <package>

لا يزال الشكل المجرد يفحص ClawHub أولًا.

النشر إلى npmjs.com

يجب أن تتضمن Plugins الأصلية من npm بيان Plugin وبيانات وصفية لنقطة دخول OmeniaClaw في package.json.

{  "name": "@acme/OmeniaClaw-plugin",  "version": "1.0.0",  "type": "module",  "OmeniaClaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access public

يثبّت المستخدمون Plugins المتاحة عبر npm فقط باستخدام:

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw plugins install npm:@acme/[email protected]

إذا كانت الحزمة نفسها متاحة أيضًا على ClawHub، فإن npm: يتجاوز البحث في ClawHub ويفرض الحل عبر npm.

اختيار المصدر

• ClawHub: استخدمه عندما تريد اكتشافًا أصليًا لـ OmeniaClaw، وملخصات فحص، وإصدارات، وتلميحات تثبيت.
• npmjs.com: استخدمه عندما تكون قد بدأت بالفعل في شحن حزم JavaScript أو تحتاج إلى وسوم توزيع npm أو سير عمل السجلات الخاصة.
• Git: استخدمه عندما تريد التثبيت مباشرة من فرع أو وسم أو commit.
• مسار محلي: استخدمه عندما تطوّر أو تختبر Plugin على الجهاز نفسه.

ذات صلة

• Plugins - نظرة عامة واستكشاف الأخطاء وإصلاحها
• OmeniaClaw plugins - مرجع CLI الكامل
• ClawHub - عمليات النشر والسجل
• بناء Plugins - إنشاء حزمة Plugin
• بيان Plugin - البيان والبيانات الوصفية للحزمة