استخدام الإضافات / بناء الإضافات
ثبّت حزمة للوكلاء الذين تستخدمهم، أو أنشئ حزمة Agent Plugins 1.0 قابلة للنقل تضم تعليمات وإعدادات أدوات.
استخدام الإضافات
باستخدام Node.js 22 أو أحدث:
npx universal-agent-plugins add context7تسألك واجهة CLI عن الوكلاء المتوافقين المطلوبين وتعرض أي خطوات تفعيل متبقية. للفحص والمعاينة أولًا:
npx universal-agent-plugins info context7
npx universal-agent-plugins add context7 --target codex,cursor --dry-runيوفر دليل التثبيت الأصلي أيضًا ملفات تنفيذية لأنظمة macOS وLinux وWindows. لا يحتاج المدير الأصلي إلى Node.js، لكن الإضافات قد تحتاج إلى بيئات تشغيل خاصة بها. تحقّق من npx universal-agent-plugins version عند استخدام npm، فقد توفر قناة مدير الحزم CLI أقدم. يتطلب الاختيار التلقائي أدناه 0.1.94؛ استخدم المثبّت الأصلي عند الحاجة. تعمل أوامر المشروع الصريحة في هذا الدليل أيضًا مع 0.1.93.
يحتفظ CLI 0.1.95 بنطاق المشروع الصريح والاختيار التلقائي في install الذي أُضيف في 0.1.94. ويضيف أيضًا واجهة API للإدارة المحلية وامتدادات Pi الأصلية. لمعاينة إضافة حزمة إلى مشروع:
npx universal-agent-plugins add context7 --target cursor --scope project \
--project-root /path/to/project --dry-runاختر مجلد مشروع موجودًا. تستخدم أوامر الإضافة والصيانة نطاق المستخدم افتراضيًا، لذا حدّد نطاق المشروع صراحةً. في 0.1.94، لا يختار install دون وسيطة مصدر المشروع إلا إذا احتوى المجلد الحالي نفسه على ملف عادي باسم uap.toml؛ وتكون الأولوية للنطاق الصريح ولا تُبحث المجلدات الأب. راجع الخطة قبل حذف --dry-run. يظل الاكتشاف الأصلي والثقة والمصادقة ونجاح استدعاءات MCP فحوصًا منفصلة عن كتابة ملفات الحزمة.
مسار التثبيت الكامل · توافق العملاء وحدود الاختبارات
استعد مجموعة اعتماديات محفوظة
افحص ما تسجله بيئة المستخدم المختارة:
npx universal-agent-plugins deps statusلتصدير زوج محفوظ من uap.toml وuap.lock، نفّذ من مجلد تبادل:
npx universal-agent-plugins deps exportانسخ المجلد إلى آلة أخرى، وثبّت العملاء المستهدفين عليها، وشغّل هناك:
npx universal-agent-plugins deps import
npx universal-agent-plugins install --locked --scope userلا يُنقل سوى الاتفاق والقفل بعد التحقق منهما. تبقى ملفات التعريف والإعدادات وبيانات الاعتماد والإيصالات وبيانات الإضافات منفصلة. لا يزال التثبيت يحتاج إلى المصادر الدقيقة أو الحزم المخزنة مؤقتًا التي جرى التحقق منها. للمشروع، احفظ الملفين في المستودع واستعد باستخدام install --locked --scope project صراحةً. راجع الصيانة والاستعادة لتفاصيل الاسترداد والنقل.
بناء الإضافات
تبدأ الحزمة المعيارية بملف plugin.json في الجذر، ويمكن أن تضم skills/<name>/SKILL.md أو mcp.json أو كليهما. يمكنك كتابة هذه الملفات يدويًا والتحقق من الحزمة بالمثبّت المنشور:
npx universal-agent-plugins validate ./my-plugin
npx universal-agent-plugins add ./my-plugin --target codex --dry-runتفترض هذه الأمثلة أن ./my-plugin يحتوي بالفعل على حزمة كاملة. يشرح دليل البناء إنشاء حزمة Skill صغيرة يدويًا وأدوات توليد الهيكل المبنية من المصدر.
توفر التأليف: لا يتضمن إصدار المثبّت الحالي من npm أو الإصدار الأصلي agentplugins author. ينفّذ المصدر الحالي توليد الهياكل والفحوص الساكنة واختبارات تشغيل MCP الصريحة ودورات التطوير وتهيئة الاعتماديات وصيانة JSON. استخدم إعداد البناء من المصدر لتلك الأوامر. تبقى أدلة إصدارات التأليف الأقدم مرتبطة بإصدارها الخاص؛ ولا تَعِد بما يتوفر في تنزيل المثبّت الحالي.
لا يثبت التحقق الساكن التشغيل أو OAuth أو التفعيل. يختلف دعم وسائل نقل MCP كذلك بحسب العميل؛ فمثلًا لا يدعم Codex نقل MCP المعلن عبر SSE. أبقِ متطلبات الحزمة والفحوص المتبقية واضحة في README.