Zarządzanie pluginami

Większość przepływów pracy z Plugin to kilka poleceń: wyszukanie, instalacja, ponowne uruchomienie Gateway, weryfikacja i odinstalowanie, gdy Plugin nie jest już potrzebny.

Lista Plugin

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

Użyj --json w skryptach. Zawiera diagnostykę rejestru oraz statyczny dependencyStatus każdego Plugin, gdy pakiet Plugin deklaruje dependencies lub optionalDependencies.

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

plugins list to zimne sprawdzenie inwentarza. Pokazuje, co OmeniaClaw może wykryć z konfiguracji, manifestów i rejestru Plugin; nie dowodzi, że już działający proces Gateway zaimportował środowisko uruchomieniowe Plugin.

Instalowanie 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

Po zainstalowaniu kodu Plugin uruchom ponownie Gateway obsługujący Twoje kanały:

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

Użyj inspect --runtime, gdy potrzebujesz dowodu, że Plugin zarejestrował powierzchnie środowiska uruchomieniowego, takie jak narzędzia, hooki, usługi, metody Gateway lub polecenia CLI należące do Plugin.

Aktualizowanie Plugin

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

Jeśli Plugin został zainstalowany z npm dist-tag, takiego jak @beta, późniejsze wywołania update <plugin-id> ponownie używają zapisanego tagu. Przekazanie jawnej specyfikacji npm przełącza śledzoną instalację na tę specyfikację dla przyszłych aktualizacji.

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

Drugie polecenie przenosi Plugin z powrotem do domyślnej linii wydań rejestru, gdy wcześniej był przypięty do dokładnej wersji lub tagu.

Gdy OmeniaClaw update działa w kanale beta, rekordy Plugin npm i ClawHub z domyślnej linii najpierw próbują dopasowanego wydania Plugin @beta. Jeśli takie wydanie beta nie istnieje, OmeniaClaw wraca do zapisanej domyślnej/najnowszej specyfikacji. W przypadku Plugin npm OmeniaClaw wraca też wtedy, gdy pakiet beta istnieje, ale nie przechodzi walidacji instalacji. Dokładne wersje i jawne tagi, takie jak @rc lub @beta, są zachowywane.

Odinstalowywanie Plugin

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

Odinstalowanie usuwa wpis konfiguracji Plugin, rekord indeksu Plugin, wpisy listy dozwolonych/zabronionych oraz połączone ścieżki ładowania, gdy ma to zastosowanie. Zarządzane katalogi instalacyjne są usuwane, chyba że przekażesz --keep-files.

W trybie Nix (OmeniaClaw_NIX_MODE=1) polecenia instalacji, aktualizacji, odinstalowania, włączania i wyłączania Plugin są wyłączone. Zarządzaj tymi wyborami w źródle Nix dla instalacji; w przypadku nix-OmeniaClaw użyj najpierw agenta Quick Start.

Publikowanie Plugin

Możesz publikować zewnętrzne Plugin w ClawHub, npmjs.com lub w obu miejscach.

Publikowanie w ClawHub

ClawHub to podstawowa publiczna powierzchnia odkrywania Plugin OmeniaClaw. Daje użytkownikom przeszukiwalne metadane, historię wersji i wyniki skanowania rejestru przed instalacją.

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]

Użytkownicy instalują z ClawHub za pomocą:

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

Forma bez prefiksu nadal najpierw sprawdza ClawHub.

Publikowanie w npmjs.com

Natywne Plugin npm muszą zawierać manifest Plugin oraz metadane punktu wejścia OmeniaClaw w package.json.

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

npm publish --access public

Użytkownicy instalują wyłącznie z npm za pomocą:

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

Jeśli ten sam pakiet jest również dostępny w ClawHub, npm: pomija wyszukiwanie w ClawHub i wymusza rozwiązywanie przez npm.

Wybór źródła

• ClawHub: użyj, gdy chcesz natywnego dla OmeniaClaw odkrywania, podsumowań skanowania, wersji i wskazówek instalacyjnych.
• npmjs.com: użyj, gdy już publikujesz pakiety JavaScript lub potrzebujesz przepływów pracy npm dist-tags/prywatnego rejestru.
• Git: użyj, gdy chcesz instalować bezpośrednio z gałęzi, tagu lub commita.
• Ścieżka lokalna: użyj, gdy rozwijasz lub testujesz Plugin na tej samej maszynie.

Powiązane

• Plugin - omówienie i rozwiązywanie problemów
• OmeniaClaw plugins - pełna dokumentacja CLI
• ClawHub - publikowanie i operacje rejestru
• Tworzenie Plugin - tworzenie pakietu Plugin
• Manifest Plugin - manifest i metadane pakietu