مدیریت Plugin‌ها

بیشتر گردش‌کارهای Plugin شامل چند فرمان هستند: جست‌وجو، نصب، راه‌اندازی دوباره Gateway، راستی‌آزمایی، و حذف نصب وقتی دیگر به Plugin نیاز ندارید.

فهرست Pluginها

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

برای اسکریپت‌ها از --json استفاده کنید. این خروجی شامل عیب‌یابی‌های registry و dependencyStatus ایستای هر Plugin است، زمانی که بسته Plugin، dependencies یا optionalDependencies را اعلام کند.

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

plugins list یک بررسی موجودی سرد است. نشان می‌دهد OmeniaClaw چه چیزهایی را می‌تواند از پیکربندی، manifestها و registry Plugin کشف کند؛ اما ثابت نمی‌کند که یک فرایند Gateway که از قبل در حال اجراست، runtime آن Plugin را import کرده است.

نصب Pluginها

# 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ای را که channelهای شما را سرویس می‌دهد دوباره راه‌اندازی کنید:

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

وقتی به اثبات نیاز دارید که Plugin سطح‌های runtime مانند ابزارها، hookها، سرویس‌ها، متدهای Gateway، یا فرمان‌های CLI متعلق به Plugin را ثبت کرده است، از inspect --runtime استفاده کنید.

به‌روزرسانی Pluginها

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

اگر یک Plugin از یک dist-tag در npm مانند @beta نصب شده باشد، فراخوانی‌های بعدی update <plugin-id> همان tag ثبت‌شده را دوباره استفاده می‌کنند. عبور دادن یک spec صریح npm، نصب ردیابی‌شده را برای به‌روزرسانی‌های آینده به همان spec تغییر می‌دهد.

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

فرمان دوم، وقتی یک Plugin قبلا به یک نسخه دقیق یا tag سنجاق شده باشد، آن را به خط انتشار پیش‌فرض registry برمی‌گرداند.

وقتی OmeniaClaw update روی channel بتا اجرا می‌شود، رکوردهای Plugin در خط پیش‌فرض npm و ClawHub ابتدا انتشار متناظر @beta آن Plugin را امتحان می‌کنند. اگر آن انتشار بتا وجود نداشته باشد، OmeniaClaw به spec پیش‌فرض/آخرینِ ثبت‌شده برمی‌گردد. برای Pluginهای npm، OmeniaClaw همچنین زمانی برمی‌گردد که بسته بتا وجود دارد اما اعتبارسنجی نصب آن شکست می‌خورد. نسخه‌های دقیق و tagهای صریح مانند @rc یا @beta حفظ می‌شوند.

حذف نصب Pluginها

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

حذف نصب، ورودی پیکربندی Plugin، رکورد index Plugin، ورودی‌های فهرست اجازه/رد، و در صورت کاربرد مسیرهای بارگذاری پیوندشده را حذف می‌کند. دایرکتوری‌های نصب مدیریت‌شده حذف می‌شوند مگر اینکه --keep-files را عبور دهید.

در حالت Nix (OmeniaClaw_NIX_MODE=1)، فرمان‌های نصب، به‌روزرسانی، حذف نصب، فعال‌سازی، و غیرفعال‌سازی Plugin غیرفعال هستند. به‌جای آن، این انتخاب‌ها را در منبع Nix مربوط به نصب مدیریت کنید؛ برای nix-OmeniaClaw، از شروع سریع agent-first استفاده کنید.

انتشار Pluginها

می‌توانید Pluginهای خارجی را در ClawHub، npmjs.com، یا هر دو منتشر کنید.

انتشار در ClawHub

ClawHub سطح اصلی کشف عمومی برای Pluginهای OmeniaClaw است. پیش از نصب، به کاربران فراداده قابل جست‌وجو، تاریخچه نسخه‌ها، و نتایج اسکن registry ارائه می‌دهد.

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

Pluginهای native npm باید شامل یک manifest Plugin و فراداده entrypoint مربوط به OmeniaClaw در package.json باشند.

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

npm publish --access public

کاربران حالت فقط npm را با این فرمان نصب می‌کنند:

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

اگر همان بسته در ClawHub هم موجود باشد، npm: جست‌وجوی ClawHub را رد می‌کند و resolution از npm را اجباری می‌کند.

انتخاب منبع

• ClawHub: زمانی استفاده کنید که کشف native برای OmeniaClaw، خلاصه‌های اسکن، نسخه‌ها، و راهنمایی‌های نصب را می‌خواهید.
• npmjs.com: زمانی استفاده کنید که از قبل بسته‌های JavaScript منتشر می‌کنید یا به گردش‌کارهای dist-tag/registry خصوصی npm نیاز دارید.
• Git: زمانی استفاده کنید که می‌خواهید مستقیما از یک branch، tag، یا commit نصب کنید.
• مسیر محلی: زمانی استفاده کنید که در حال توسعه یا آزمایش یک Plugin روی همان ماشین هستید.

مرتبط

• Pluginها - نمای کلی و عیب‌یابی
• OmeniaClaw plugins - مرجع کامل CLI
• ClawHub - عملیات انتشار و registry
• ساخت Pluginها - ایجاد یک بسته Plugin
• manifest Plugin - manifest و فراداده بسته