البحث عن إضافة وتثبيتها

اختر حزمة تفهم مصدرها والغرض منها. تستخدم الأوامر التالية المثبّت المنشور؛ راجع تثبيت CLI إذا لم يكن agentplugins متاحًا بعد. استخدم --dry-run لمراجعة الخطة قبل تطبيق أي تغييرات.

اكتشف الحزمة

agentplugins search docs
agentplugins info context7

يأتي الاسم المختصر مثل context7 من Universal Agent Plugins Registry الموقّع. تساعدك نتائج البحث ومعلومات الحزمة على اختيار مرشح؛ ولا تنفّذ الحزمة أو تثبت توفر خدمتها. راجع الأدوات المعروضة وSkills ومتطلبات التشغيل وصلاحيات الحساب قبل التثبيت.

عاين اختيارًا صريحًا واحدًا

agentplugins add context7 --target codex,cursor --dry-run

راجع المصدر والأهداف المختارة والوجهات والنتائج الأمنية وما تبقى من أعمال التفعيل. يطبع هذا الأمر خطة من دون تطبيق التثبيت. ولا يختبر خادم MCP.

ثبّت بعد مراجعة الخطة

agentplugins add context7 --target codex,cursor

للاختيار التفاعلي، احذف --target. يمكن لواجهة CLI اختيار وكيل واحد مكتشَف تلقائيًا، أو عرض منتقي عند توفر عدة وكلاء. استخدم أهدافًا صريحة لاختيار قابل للتكرار وفي عمليات الأتمتة.

يجري المثبّت فحوصًا مسبقة للعملاء المختارين ويحمي الملفات التي لا يملكها. إذا أبلغت عملية عن فشل التراجع أو عن استرداد معلّق، فاحتفظ بالتقرير واتبع إرشادات الاسترداد قبل إعادة المحاولة.

أكمل التفعيل

أكمل الخطوات الخاصة بالعميل في النتيجة: قد يلزم إعادة تحميل، أو جلسة جديدة، أو ثقة بمساحة العمل، أو تسجيل دخول، أو تفعيل صريح. لا تثبت الملفات المجهزة والتسجيل الأصلي الناجح نجاح OAuth أو استدعاء الأدوات. استخدم تشخيص الحالة المُدارة إذا كانت ملفات التثبيت مفقودة أو تغيرت؛ وافحص المصادقة داخل العميل إذا كانت الحزمة موجودة لكنها غير متاحة.

استخدم حزمة محلية

اختر المجلد الذي يحتوي على plugin.json في جذره:

agentplugins validate ./my-plugin
agentplugins add ./my-plugin --target codex --dry-run

تظل سياسة الأمان مطبّقة في تحقق المثبّت وتخطيطه. وقد يجلب بيانات أمان وصفية أو ماسحًا مثبت الإصدار حتى للحزمة المحلية. يتجنب --dry-run تغييرات التثبيت المُدار، ولا يَعِد بأن العملية تعمل بلا اتصال.

بعد مراجعة الخطة، احذف --dry-run للتثبيت. يبقى تثبيت المجلد المحلي محليًا؛ ولا يصبح اعتمادية قابلة للنقل تستطيع آلة أخرى جلبها. اطلب من المؤلف أدلة تسليم الحزمة.

اختر مصدر GitHub دقيقًا

تتطلب صيغة GitHub غير القابلة للتغيير SHA كاملًا للالتزام من 40 محرفًا. استبدل هذا المثال بمستودع حقيقي ومراجعة جرى تدقيقها ومسار حزمة:

agentplugins add owner/repository@0123456789abcdef0123456789abcdef01234567//path/to/plugin --target codex --dry-run

ترفض صيغة owner/repository@... الفروع والوسوم وقيم SHA المختصرة. دون مسار، يختار المثبّت حزمة صالحة في الجذر أو المرشح المتداخل الصالح الوحيد. يتطلب وجود عدة مرشحين مسارًا صريحًا؛ وعند وجود أكثر من 16 حزمة محتملة، يلزم المسار قبل جلب المرشحين. يعيد الإصلاح استخدام المصدر المسجل. ونقل تثبيت غير قابل للتغيير إلى مصدر آخر عملية مستقلة لاختيار المصدر.

يقبل CLI 0.1.93 أيضًا Git مباشرًا عبر HTTPS وSSH وروابط المتصفح لمزوّدين مدعومين وأرشيفات كاملة عبر HTTPS أو محلية. استبدل هذه القيم التوضيحية بمصادر حزم راجعتها، مثلًا:

agentplugins add 'https://git.example.com/team/tools.git#refs/heads/main//plugins/demo' --target codex --dry-run
agentplugins add 'ssh://git@git.example.com/team/tools.git#main//plugins/demo' --target codex --dry-run
agentplugins add 'https://downloads.example.com/plugin.tar.gz' --target codex --dry-run

يستخدم Git بيانات الاعتماد الأصلية وثقة مضيف SSH الموجودتين. لا تستخدم أرشيفات HTTPS بيانات اعتماد، ويجب أن تحتوي على حزمة معيارية كاملة. يثبّت القفل مراجعات Git الدقيقة أو البايتات الأصلية للأرشيف، إلى جانب بصمات الحزم. يمكن تقديم مصدر متحرك عبر تحديث صريح؛ أما الاستعادة المقفلة فتحافظ على المرجع المثبت. تختلف مصادر الحزم الكاملة هذه عن جلب Skills منفردة. اقرأ مصادر الحزم الكاملة المباشرة لصيغ المزوّدين واختيار الحزمة والمجاميع الاختبارية وحدود الاستخراج.

ثبّت Agent Skills

استخدم مجموعة أوامر skills لجلب Skills منفردة من مستودع GitHub عام، أو مجلد، أو رابط SKILL.md، أو ناشر HTTPS يوفر فهرس Skills كاملًا ضمن .well-known:

agentplugins skills add owner/repository --ui

استبدل owner/repository بمصدر حقيقي. يفتح --ui منتقي المتصفح المضمّن ويتطلب طرفية تفاعلية. استخدم --no-ui للاختيار في الطرفية. وللاختيار الصريح:

agentplugins skills add owner/repository --skill review --skill pdf \
  --target codex,claude --no-ui --yes

• كرر --skill للأسماء الدقيقة. استخدم --path لمجلد Skill دقيق نسبةً إلى المستودع إذا كان الاسم ملتبسًا.
• يحدد --ref مرجع Git دقيقًا عندما يكون حد الرابط ملتبسًا.
• يعاين --dry-run التثبيت المختار.
• يتطلب استخدام JSON والوضع غير التفاعلي تحديد Skills والأهداف صراحةً وإضافة --yes، باستثناء المعاينة عبر --dry-run.
• لا يمكن الجمع بين --ui و--skill أو --target أو --dry-run.
• يتطلب ناشر HTTPS اسم --skill دقيقًا وفهرسًا يسرد كل ملف ضمن Skill تلك.

قد تمنع النتائج الأمنية الآلية التثبيت. يعرض --security-details هذه النتائج في المخرجات المقروءة؛ راجعها قبل تقرير مدى ملاءمة القبول الصريح عبر --accept-security-risk. تظهر Skills المثبّتة في agentplugins list وتستخدم أوامر الصيانة المعتادة.

ثبّت لمشروع واحد

يتوفر نطاق المشروع الصريح في CLI 0.1.93 وأحدث. اختر مجلدًا موجودًا وحدّد النطاق في كل أمر:

agentplugins add context7 --target cursor --scope project \
  --project-root /path/to/project --dry-run
agentplugins skills add owner/repository --ui --scope project \
  --project-root /path/to/project

يعاين الأمر الأول الخطة؛ احذف --dry-run عندما تصبح مستعدًا لتطبيقها. يفتح الثاني منتقيًا ضمن النطاق المحدد ويمكن أن يطبّق اختيار المستخدم. من دون --project-root، يستخدم نطاق المشروع الصريح مجلد تنفيذ الأمر، ولا يبحث في المجلدات الأب. تعمل أوامر الإضافة والصيانة افتراضيًا ضمن نطاق المستخدم في غير ذلك. في CLI 0.1.94، يختار install من دون وسيطة مصدر نطاق المشروع إذا وُجد ملف عادي باسم uap.toml في المجلد الحالي نفسه؛ وتكون الأولوية للنطاق الصريح. راجع قواعد الاستعادة لمعرفة سلوك القفل الصارم.

يجب أن يدعم الهدف مكونات المشروع المطلوبة. تثبيت مشاريع ChatGPT غير مدعوم صراحةً. يجهّز VS Code ملفات .github/skills وعناصر servers التي يملكها داخل .vscode/mcp.json لمجلد محلي واحد. وتبقى النتيجة Prepared: راجع ثقة مساحة العمل والخادم وافحص إعدادات العميل. لا تثبت ملاحظة البيانات الوصفية هذه بدء MCP أو استدعاء الأدوات أو استخدام النموذج.

اقرأ دليل تثبيت المشروع وحدود المشاريع لكل عميل للمسارات وحدود التفعيل. ثم انتقل إلى الصيانة والاستعادة.