حزم Plugin

يمكن لـ OmeniaClaw تثبيت Plugins من ثلاثة أنظمة بيئية خارجية: Codex وClaude وCursor. وتُسمى هذه حِزمًا — وهي حِزم محتوى وبيانات وصفية يربطها OmeniaClaw بميزات أصلية مثل Skills والخطافات وأدوات MCP.

لماذا توجد الحِزم

تُنشر العديد من Plugins المفيدة بتنسيق Codex أو Claude أو Cursor. وبدلًا من مطالبة المؤلفين بإعادة كتابتها كـ Plugins OmeniaClaw أصلية، يكتشف OmeniaClaw هذه التنسيقات ويربط محتواها المدعوم بمجموعة الميزات الأصلية. وهذا يعني أنه يمكنك تثبيت حزمة أوامر Claude أو حزمة Skills من Codex واستخدامها فورًا.

تثبيت حزمة

# Local directoryOmeniaClaw plugins install ./my-bundle # ArchiveOmeniaClaw plugins install ./my-bundle.tgz # Claude marketplaceOmeniaClaw plugins marketplace list <marketplace-name>OmeniaClaw plugins install <plugin-name>@<marketplace-name>

OmeniaClaw plugins listOmeniaClaw plugins inspect <id>

OmeniaClaw gateway restart

ما الذي يربطه OmeniaClaw من الحِزم

لا تعمل كل ميزة في الحِزم داخل OmeniaClaw اليوم. إليك ما يعمل وما يُكتشف لكنه لم يُوصّل بعد.

مدعوم الآن

محتوى Skills

• تُحمّل جذور Skills في الحزمة كجذور Skills عادية في OmeniaClaw
• تُعامل جذور commands في Claude كجذور Skills إضافية
• تُعامل جذور .cursor/commands في Cursor كجذور Skills إضافية

وهذا يعني أن ملفات أوامر markdown في Claude تعمل عبر محمّل Skills العادي في OmeniaClaw. وتعمل ملفات markdown لأوامر Cursor عبر المسار نفسه.

حِزم الخطافات

• تعمل جذور الخطافات في الحزمة فقط عندما تستخدم تخطيط حزمة الخطافات العادي في OmeniaClaw. واليوم تكون هذه أساسًا حالة التوافق مع Codex:
  • HOOK.md
  • handler.ts أو handler.js

MCP لـ Pi

• يمكن للحِزم المفعّلة المساهمة بتهيئة خادم MCP
• يدمج OmeniaClaw تهيئة MCP الخاصة بالحزمة داخل إعدادات Pi المضمنة الفعالة باسم mcpServers
• يعرض OmeniaClaw أدوات MCP المدعومة من الحِزم أثناء أدوار وكيل Pi المضمن عبر تشغيل خوادم stdio أو الاتصال بخوادم HTTP
• يتضمن ملفا تعريف الأدوات coding وmessaging أدوات MCP الخاصة بالحِزم افتراضيًا؛ استخدم tools.deny: ["bundle-mcp"] لإلغاء الاشتراك لوكيل أو Gateway
• تظل إعدادات Pi المحلية للمشروع مطبقة بعد افتراضيات الحزمة، لذا يمكن لإعدادات مساحة العمل تجاوز إدخالات MCP الخاصة بالحزمة عند الحاجة
• تُفرز كتالوجات أدوات MCP الخاصة بالحِزم بشكل حتمي قبل التسجيل، بحيث لا تؤدي تغييرات ترتيب listTools() من المصدر إلى اضطراب كتل أدوات ذاكرة التخزين المؤقت للمطالبات

وسائل النقل

يمكن لخوادم MCP استخدام نقل stdio أو HTTP:

Stdio يشغّل عملية فرعية:

{  "mcp": {    "servers": {      "my-server": {        "command": "node",        "args": ["server.js"],        "env": { "PORT": "3000" }      }    }  }}

HTTP يتصل بخادم MCP قيد التشغيل عبر sse افتراضيًا، أو streamable-http عند طلب ذلك:

{  "mcp": {    "servers": {      "my-server": {        "url": "http://localhost:3100/mcp",        "transport": "streamable-http",        "headers": {          "Authorization": "Bearer ${MY_SECRET_TOKEN}"        },        "connectionTimeoutMs": 30000      }    }  }}

• يمكن تعيين transport إلى "streamable-http" أو "sse"؛ وعند حذفه يستخدم OmeniaClaw القيمة sse
• يُعد type: "http" شكلًا تابعًا أصليًا لـ CLI؛ استخدم transport: "streamable-http" في تهيئة OmeniaClaw. يقوم OmeniaClaw mcp set وOmeniaClaw doctor --fix بتطبيع الاسم المستعار الشائع.
• لا يُسمح إلا بمخططات URL http: وhttps:
• تدعم قيم headers استيفاء ${ENV_VAR}
• يُرفض إدخال الخادم الذي يحتوي على كل من command وurl
• تُحجب بيانات اعتماد URL (معلومات المستخدم ومعلمات الاستعلام) من أوصاف الأدوات والسجلات
• يتجاوز connectionTimeoutMs مهلة الاتصال الافتراضية البالغة 30 ثانية لكل من نقلي stdio وHTTP

تسمية الأدوات

يسجل OmeniaClaw أدوات MCP الخاصة بالحِزم بأسماء آمنة للمزوّدين بالصيغة serverName__toolName. على سبيل المثال، الخادم ذي المفتاح "vigil-harbor" الذي يعرض أداة memory_search يُسجل باسم vigil-harbor__memory_search.

• تُستبدل الأحرف خارج A-Za-z0-9_- بـ -
• تحصل الأجزاء التي قد تبدأ بحرف غير أبجدي على بادئة حرف، بحيث تصبح مفاتيح الخوادم الرقمية مثل 12306 بادئات أدوات آمنة للمزوّدين
• تُحد بادئات الخوادم بـ 30 حرفًا
• تُحد أسماء الأدوات الكاملة بـ 64 حرفًا
• تعود أسماء الخوادم الفارغة إلى mcp
• تُميّز الأسماء المنقّاة المتصادمة بلاحقات رقمية
• يكون ترتيب الأدوات النهائي المعروض حتميًا حسب الاسم الآمن للحفاظ على ثبات ذاكرة التخزين المؤقت عبر أدوار Pi المتكررة
• يعامل ترشيح ملف التعريف كل الأدوات من خادم MCP واحد ضمن الحزمة كأنها مملوكة لـ Plugin باسم bundle-mcp، لذا يمكن لقوائم السماح وقوائم الرفض في ملفات التعريف تضمين أسماء الأدوات المعروضة الفردية أو مفتاح Plugin bundle-mcp

إعدادات Pi المضمنة

• تُستورد settings.json الخاصة بـ Claude كإعدادات Pi مضمنة افتراضية عندما تكون الحزمة مفعّلة
• ينقّي OmeniaClaw مفاتيح تجاوز shell قبل تطبيقها

المفاتيح المنقّاة:

• shellPath
• shellCommandPrefix

LSP لـ Pi المضمن

• يمكن لحِزم Claude المفعّلة المساهمة بتهيئة خادم LSP
• يحمّل OmeniaClaw ملف .lsp.json بالإضافة إلى أي مسارات lspServers معلنة في البيان
• تُدمج تهيئة LSP الخاصة بالحزمة داخل افتراضيات LSP الفعالة لـ Pi المضمن
• لا يمكن تشغيل إلا خوادم LSP المدعومة القائمة على stdio اليوم؛ وتظل وسائل النقل غير المدعومة ظاهرة في OmeniaClaw plugins inspect <id>

مكتشف لكنه غير منفّذ

هذه العناصر معروفة وتظهر في التشخيصات، لكن OmeniaClaw لا يشغّلها:

• agents في Claude، وأتمتة hooks.json، وoutputStyles
• .cursor/agents و.cursor/hooks.json و.cursor/rules في Cursor
• بيانات Codex الوصفية المضمنة/الخاصة بالتطبيق خارج تقارير القدرات

تنسيقات الحِزم

أسبقية الاكتشاف

يتحقق OmeniaClaw أولًا من تنسيق Plugin الأصلي:

1. OmeniaClaw.plugin.json أو package.json صالح مع OmeniaClaw.extensions — يُعامل كـ Plugin أصلي
2. علامات الحِزم (.codex-plugin/ أو .claude-plugin/ أو تخطيط Claude/Cursor الافتراضي) — تُعامل كـ حزمة

إذا احتوى دليل على كليهما، يستخدم OmeniaClaw المسار الأصلي. وهذا يمنع الحِزم مزدوجة التنسيق من التثبيت جزئيًا كحِزم.

تبعيات وقت التشغيل والتنظيف

• لا تحصل الحِزم المتوافقة التابعة لجهات خارجية على إصلاح npm install عند بدء التشغيل. يجب تثبيتها عبر OmeniaClaw plugins install وشحن كل ما تحتاجه في دليل Plugin المثبت.
• تكون Plugins المضمّنة المملوكة لـ OmeniaClaw إما مشحونة بخفة داخل النواة أو قابلة للتنزيل عبر مثبّت Plugin. لا يشغّل بدء تشغيل Gateway مدير حزم لها أبدًا.
• يزيل OmeniaClaw doctor --fix أدلة التبعيات المرحلية القديمة ويمكنه استرداد Plugins القابلة للتنزيل المفقودة من فهرس Plugin المحلي عندما تشير إليها التهيئة.

الأمان

للحِزم حد ثقة أضيق من Plugins الأصلية:

• لا يحمّل OmeniaClaw وحدات وقت تشغيل عشوائية من الحزمة داخل العملية
• يجب أن تبقى مسارات Skills وحِزم الخطافات داخل جذر Plugin (مع فحص الحدود)
• تُقرأ ملفات الإعدادات بفحوص الحدود نفسها
• قد تُشغّل خوادم MCP المدعومة عبر stdio كعمليات فرعية

وهذا يجعل الحِزم أكثر أمانًا افتراضيًا، لكن ينبغي لك مع ذلك التعامل مع حِزم الجهات الخارجية كمحتوى موثوق للميزات التي تعرضها.

استكشاف الأخطاء وإصلاحها

ذو صلة

• تثبيت Plugins وتهيئتها
• بناء Plugins — أنشئ Plugin أصليًا
• بيان Plugin — مخطط البيان الأصلي