Open-Source-Antivirus für KI-Agenten: Blockiert riskante Tools, Secret-Zugriffe, Prompt-Injection, bösartige Pakete, MCP-Server, Plugins und Skills zur Laufzeit.
 | Stoppen Sie riskante KI-Aktionen, bevor sie Ihren Rechner kompromittieren. HOL Guard ist eine lokal-first-Sicherheitsschicht für KI-Agenten, Tools, Plugins, Skills, MCP-Server und Paketinstallationen. HOL Guard installieren Die Dokumentation lesen PyPI-Paket ( hol-guard)Ein Problem melden |
|---|
HOL Guard überprüft Agentenaktionen, bevor sie ausgeführt werden: Shell-Befehle, Dateizugriffe, Paketinstallationen und MCP-Tool-Aufrufe. Es erkennt Secret-Exposition, destruktive Operationen, Prompt-Injection und Supply-Chain-Risiken und erlaubt, blockiert oder fordert dann eine Genehmigung gemäß Ihrer Richtlinie an.
Führen Sie es lokal ohne Konto aus. Nutzen Sie die CLI und das lokale Dashboard, um den Schutz zu verwalten, Genehmigungen zu bearbeiten und den Entscheidungsverlauf einzusehen. Optionales Guard Cloud fügt gemeinsamen Verlauf, Team-Richtlinien und Flottenmanagement hinzu.
Erste Schritte · Unterstützte Agenten · Plugin-Scanner · Dokumentation · Eine Erweiterung beitragen · Entwicklung
Erfordert Python 3.10 oder neuer und pipx.```bash pipx install hol-guard hol-guard init
Der Erststart-Assistent erkennt unterstützte Agents und führt Sie durch die Einrichtung des Schutzes. Er fragt vor jeder Einrichtungsänderung nach, einschließlich des Öffnens des Dashboards, der Installation von Agent-Integrationen und der Verbindung optionaler Cloud-Dienste.
Überprüfen Sie Ihre Installation:```bash
hol-guard --version
hol-guard status
Um eine bestehende Installation zu aktualisieren:```bash hol-guard update
Für die manuelle Einrichtung siehe die [Installationsanleitung](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/get-started.md). Versionsdetails und Vorabversionen finden sich auf der [Releases-Seite](https://github.com/hashgraph-online/hol-guard/releases).
## Was HOL Guard schützt
| Oberfläche | Schutz |
| :--- | :--- |
| **Shell-Befehle und Dateizugriff** | Prüft destruktive Operationen, Zugriffe auf sensible Dateien, Offenlegung von Anmeldedaten und verdächtige ausgehende Befehle. |
| **Paketinstallationen** | Bewertet unterstützte Paketmanager-Operationen anhand von Supply-Chain-Informationen vor der Installation. |
| **Plugins, Skills und Agent-Konfiguration** | Erfasst lokale Artefakte und prüft neue oder geänderte Tools vor dem Start. |
| **MCP-Server und -Tools** | Untersucht die Serverkonfiguration und prüft Tool-Aufrufe über unterstützte Hooks und verwaltete Proxys. |
| **Prompts und Tool-Ergebnisse** | Überprüft unterstützte Ereignisse auf Prompt-Injection und sensible Inhalte. |
| **Genehmigungen und Nachweise** | Leitet Entscheidungen an native Prompts oder das Genehmigungszentrum weiter und zeichnet lokale Belege zur Überprüfung auf. |
Guard verbindet sich über native Agent-Hooks, verwaltete MCP-Proxys und Start-Integrationen. Die Abdeckung hängt von den Ereignissen ab, die jeder Agent bereitstellt; die [Support-Matrix](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/harness-support.md) dokumentiert Durchsetzung, Zustellung von Genehmigungen und Fehlerverhalten pro Integration.
## Unterstützte KI-Agenten
Codex, Claude Code, GitHub Copilot CLI, Cursor, Cline, Gemini CLI, Grok, Hermes, Kimi Code, Pi, oh-my-pi, OpenClaw, OpenCode, Antigravity und ZCode. [Paseo](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/paseo.md) wird über diese nativen Provider-Integrationen unterstützt, mit Abdeckung pro Provider.
Um beispielsweise Codex explizit einzurichten:```bash
hol-guard install codex
hol-guard run codex --dry-run
hol-guard run codex
Der Dry Run zeichnet den aktuellen Artefaktzustand vor dem Start auf. Für Codex installiert Guard native Pre-Tool-Hooks und verweigert einen verwalteten Start, wenn diese Hooks fehlen oder deaktiviert sind.
| Aufgabe | Befehl |
|---|---|
| Schutzstatus prüfen | hol-guard status |
| Eine Agent-Integration diagnostizieren | hol-guard doctor codex |
| Änderungen vor dem Start prüfen | hol-guard diff codex |
| Ausstehende Genehmigungen überprüfen | hol-guard approvals |
| Eine Anfrage genehmigen oder ablehnen | hol-guard approvals approve <request-id> / hol-guard approvals deny <request-id> |
| Entscheidungsverlauf lesen | hol-guard receipts |
| Verfolgte Artefakte auflisten | hol-guard inventory |
| Eine KI-Stückliste exportieren | hol-guard abom --format json |
| Workspace-Abhängigkeiten scannen | hol-guard supply-chain scan |
| Optionale Cloud-Synchronisierung verbinden | hol-guard connect |
Die Klassifizierung und die übereinstimmenden Regeln des Befehls prüfen:```bash hol-guard command test 'rm -rf ./build' hol-guard command explain 'git clean -ndx' hol-guard command extensions command.git --json
`command test` und `command explain` untersuchen den Befehl, ohne ihn auszuführen oder eine Genehmigung zu erstellen. Verwenden Sie `hol-guard approvals`, um eine ausstehende Anfrage aufzulösen, und `hol-guard receipts`, um die aufgezeichnete Entscheidung zu überprüfen.
Das [Extension-Verzeichnis](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extensions/README.md) listet die aus der Laufzeitregistrierung generierte Befehlsabdeckung auf. Externe Beiträge erfordern ein ausdrückliches Opt-in; erforderliche Kernschutzmaßnahmen bleiben aktiviert. Um die Abdeckung zu erweitern, folgen Sie dem [Extension-Beitragsleitfaden](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extensions/contributing.md).
### Ein Paket überprüfen```bash
hol-guard supply-chain sync
hol-guard supply-chain scan
hol-guard supply-chain explain [email protected] --ecosystem npm
Das Paket-Urteil enthält die verfügbaren Advisory-Belege und die Ökosystem-Abdeckung. Siehe den Erste-Schritte-Leitfaden für die Paketmanager-Interception und den Behebungsleitfaden für den Umgang mit False Positives.
Dieses Repository enthält außerdem plugin-scanner, ein CLI für Maintainer, die Sicherheits- und Qualitätsprüfungen vor der Veröffentlichung von Agent-Plugins, Skills und MCP-Integrationen durchführen möchten.```bash
pipx install plugin-scanner
plugin-scanner scan .
plugin-scanner lint .
plugin-scanner verify .
| Befehl | Zweck |
| :--- | :--- |
| `scan` | Sicherheitsbefunde und ein Qualitätsbericht über erkannte Paketoberflächen. |
| `lint` | Feedback auf Regelebene für Autoren. |
| `verify` | Prüfungen der Installationsoberfläche und der Laufzeitbereitschaft. |
| `submit` | Ein Einreichungsartefakt für ein Plugin-Paket. |
| `doctor` | Komponentendiagnose und Fehlerbehebungs-Bundles. |
Der Scanner erkennt die Paketformate von Codex, Claude Code, DeepSeek Harness, Gemini CLI, Kimi Code und OpenCode. Verwenden Sie `plugin-scanner --list-ecosystems`, um sie aufzulisten, oder `--ecosystem`, um eines auszuwählen. An einem Codex-Marketplace-Stammverzeichnis werden lokale Plugin-Einträge automatisch erkannt.
Die Prüfungen umfassen Manifeste, Secrets, MCP-Transport- und Befehls-Konfiguration, Genehmigungsvorgaben, Skills, Dependency-Lockfiles und GitHub-Actions-Berechtigungen. Optionale Cisco-Integrationen ergänzen Skill- und MCP-Analysen. Berichte unterstützen Text, JSON, Markdown und SARIF.```bash
plugin-scanner scan . --format sarif --output plugin-scanner.sarif
plugin-scanner scan . --fail-on-severity high
Qualitätsstufen verwenden die für jedes Paket anwendbaren Prüfungen. Die Vertrauensbewertung hat eine separate Herkunft und Gewichtung; siehe die Bewertungsreferenzen für Skill, MCP und Plugin.
Fügen Sie den Scanner zu einem Plugin-Repository hinzu:```yaml name: Plugin security on: [push, pull_request]
permissions: contents: read
jobs: scan: runs-on: ubuntu-latest steps: - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6 - uses: hashgraph-online/ai-plugin-scanner-action@fdb49f9d85321a2ced2933301b395dd3c1ce9c8f # v1.2.631 with: plugin_dir: "." min_score: 80 fail_on_severity: high
Siehe die [Aktionsdokumentation](https://github.com/hashgraph-online/ai-plugin-scanner-action) für SARIF-Uploads, Übermittlungs-Workflows und maschinenlesbare Ausgaben. Der Aktionsquellcode wird in [`action/`](https://github.com/hashgraph-online/hol-guard/blob/main/action) gepflegt.
<a id="install-the-package-you-need"></a>
<a id="resolver-safe-cisco-extra"></a>
### Optionale Cisco-Analyse
Die Basis-Pakete funktionieren ohne Cisco-Abhängigkeiten. Um Cisco-Skill-Scanning hinzuzufügen, verwenden Sie Python 3.11 bis 3.14 und installieren Sie das Extra in einer isolierten Umgebung:```bash
pipx install 'plugin-scanner[cisco]'
Für die Cisco-MCP-Analyse verwenden Sie das Docker-Image des Repositorys oder die Abhängigkeitsgruppe cisco-mcp:```bash
uv sync --extra dev --extra cisco --group cisco-mcp --python 3.13
uv run plugin-scanner scan . --cisco-skill-scan on --cisco-mcp-scan on
Das veröffentlichte `cisco`-Extra bietet Skill-Scanning; die separate `cisco-mcp`-Gruppe stellt den MCP-Scanner bereit. Abhängigkeitsversionen und Python-Einschränkungen werden in [`pyproject.toml`](https://github.com/hashgraph-online/hol-guard/blob/main/pyproject.toml) gepflegt.
## Ökosystem-Unterstützung
| Ökosystem | Erkennungsflächen |
| :--- | :--- |
| Codex | `.codex-plugin/plugin.json`, `marketplace.json`, `.agents/plugins/marketplace.json` |
| Claude Code | `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json` |
| DeepSeek Harness | `package.json` mit `dsh.bundle`, deklarierten Patches und Cordis `apply(ctx)`-Exporten, oder `dsh.bundle.mode` auf `"patch"` gesetzt für reine Patch-Bundles |
| Gemini CLI | `gemini-extension.json`, `commands/**/*.toml` |
| Kimi Code | `kimi.plugin.json`, `.kimi-plugin/plugin.json`, deklarierte Skills, Agents, Commands, Prompts und MCP-Server |
| OpenCode | `opencode.json`, `opencode.jsonc`, `.opencode/commands`, `.opencode/plugins` |
Verwenden Sie `--ecosystem auto`, um unterstützte Pakete in einem Repository zu erkennen, oder wählen Sie ein Ökosystem explizit aus:```bash
plugin-scanner scan ./plugins-repo --ecosystem claude
plugin-scanner scan ./dsh-plugin --ecosystem deepseek-harness
| Kategorie | Abdeckung |
|---|---|
| Manifest-Validierung | Erforderliche Felder, Versionen, deklarierte Pfade, Interface-Metadaten, Links und Assets. |
| Sicherheit | Hartcodierte Secrets, unsichere MCP-Befehle und -Transporte sowie riskante Genehmigungsvoreinstellungen. |
| Operative Sicherheit | GitHub-Actions-Berechtigungen und gepinnte Abhängigkeiten, privilegierte Checkout-Muster, Dependabot und Lockfiles. |
| Plugin-Paketierung | README- und Lizenzdateien, Skill-Frontmatter, Ignore-Regeln und versehentlich committete Umgebungsdateien. |
| Marketplace | Manifest-Gültigkeit, lokale Paketerkennung und sichere Quellpfade. |
| Skill- und MCP-Analyse | Analyzer-Verfügbarkeit, Befunde und Analysierbarkeit aus optionalen Cisco-Integrationen. |
| Codequalität | Dynamische Codeausführung und Shell-Injection-Muster. |
Plugin Scanner meldet eine Qualitätsnote zusammen mit der Vertrauensherkunft. Qualitätsbewertungen werden über alle anwendbaren Prüfungen normalisiert, sodass optionale Oberflächen die Note eines Pakets nicht künstlich erhöhen.
Skill-Vertrauen verwendet die HCS-28-Baseline-Adapter-IDs, Gewichtungen und Nennerregeln. MCP- und Codex-Plugin-Vertrauen verwenden explizite Adapter, Gewichtungen und Beitragsmodi, die in den lokalen Spezifikationen dokumentiert sind:
plugin-scanner scan ./my-plugin --format json --profile public-marketplace
plugin-scanner lint ./my-plugin --list-rules plugin-scanner lint ./my-plugin --explain README_MISSING
plugin-scanner lint ./my-plugin --fix --profile strict-security
plugin-scanner verify ./my-plugin --format json plugin-scanner verify ./my-plugin --online --format text
plugin-scanner submit ./my-plugin --profile public-marketplace --attest dist/plugin-quality.json
plugin-scanner doctor ./my-plugin --component mcp --bundle dist/doctor.zip
Für einen Repository-Marketplace können `scan`, `lint`, `verify` und `doctor` auf das Root-Verzeichnis abzielen. `submit` zielt auf ein einzelnes Plugin-Paket ab.
## Codex-Spezifikationsabgleich
Der Scanner erkennt Codex-Plugin-Manifeste, Interface-Metadaten, deklarierte Assets und Marketplace-Pakete:
- Lokale Manifest-Pfade verwenden `./`-Präfixe; `lint --fix` behält sie bei oder fügt sie hinzu.
- `.agents/plugins/marketplace.json` ist der bevorzugte Marketplace-Speicherort, wobei das Root-`marketplace.json` aus Kompatibilitätsgründen unterstützt wird.
- Die Interface-Validierung prüft deklarierte Links und Assets, ohne ein undokumentiertes `type`-Feld zu erfordern.
- `verify --online` prüft die HTTP-Remote-Erreichbarkeit. Die Ausführung des Stdio-Servers wird für die manuelle Überprüfung übersprungen.
Siehe die [Codex-Plugin-Dokumentation](https://developers.openai.com/codex/plugins) und die [Model Context Protocol-Spezifikation](https://modelcontextprotocol.io) für die Upstream-Formate.
## Konfigurations- und Baseline-Beispiel
Konfigurieren Sie den Scanner in `.plugin-scanner.toml`:```toml
[scanner]
profile = "public-marketplace"
baseline_file = "baseline.txt"
ignore_paths = ["tests/*", "fixtures/*"]
[rules]
disabled = ["README_MISSING"]
severity_overrides = { CODEXIGNORE_MISSING = "low" }
Die GitHub Action erfordert trust_repository_policy: true, bevor repository-eigene Konfiguration und Baselines ihr Urteil ändern können. Aktivieren Sie diese Option nur für Richtlinien, denen der Workflow vertrauen soll.
| Format | Verwendung |
|---|---|
text | Terminal-Zusammenfassungen mit Kategorie-Summen und Befunden. |
json | Strukturierte Berichte für Skripte und Integrationen. |
markdown | Review-fertige Berichte für Pull Requests und Issues. |
sarif | GitHub Code Scanning und Sicherheitsautomatisierung. |
Die AI Plugin Scanner Action unterstützt Sicherheits-Gates, SARIF-Uploads, Submission-Intake und Registry-Payloads. Ihr Quellcode liegt in action/, und der Veröffentlichungs-Workflow verteilt das Action-Bundle.
Die Legacy-HOL Codex Plugin Scanner Action bleibt für bestehende Workflows verfügbar.
Verwenden Sie submission_enabled: true, um ein Submission-Issue zu öffnen oder wiederzuverwenden, wenn ein Plugin den konfigurierten Schwellenwert erreicht. submission_token muss die Berechtigung haben, Issues im Ziel-Submission-Repository zu erstellen. Die Action gibt Submission-Status und Issue-URLs als Outputs aus.
Siehe die Input-Referenz der Action für submission_score_threshold, submission_token und die Ziel-Repository-Optionen.
Setzen Sie registry_payload_output, um ein maschinenlesbares Payload für eine Registry- oder Badge-Pipeline zu schreiben. Die Action stellt außerdem die Outputs score, grade, grade_label, max_severity und findings_total bereit und kann eine Job-Zusammenfassung schreiben.
Das HOL Registry Broker Plugin ist ein Beispiel für ein Agent-Plugin in der HOL Plugin Registry. Sein Registry-Eintrag bietet aktuelle Trust-Informationen.
KI-Agenten können innerhalb einer Sitzung Befehle ausführen, Abhängigkeiten installieren, Dateien lesen und externe Tools aufrufen. HOL Guard überprüft diese Aktionen an unterstützten Ausführungspunkten und hält die Richtlinienentscheidung, die Genehmigungsanfrage und den Beleg zusammen.
Verwenden Sie es für KI-Agenten-Sicherheit auf einem Entwicklerrechner, MCP-Sicherheit rund um verbundene Tools und Supply-Chain-Prüfungen für Pakete und Plugins. Teams können Guard Cloud für gemeinsame Genehmigungen und Richtlinienverwaltung hinzufügen, während der lokale Schutz erhalten bleibt.
HOL Guard ist Open-Source-Antivirus und Laufzeitschutz für KI-Agenten. Es überprüft unterstützte Tool-Aufrufe, Shell-Befehle, Dateizugriffe und Paketoperationen auf Risiken wie Secret-Exposure, Prompt-Injection, destruktive Aktionen und bösartige Abhängigkeiten.
Ja. Lokaler Schutz, CLI-Befehle, Genehmigungen und Belege funktionieren ohne Anmeldung. Guard Cloud ist optional und ergänzt synchronisierte Nachweise, Team-Kontrollen und Flotten-Sichtbarkeit. Siehe Local Guard vs. Guard Cloud für die Funktionsgrenze.
Guard enthält Adapter für Codex, Claude Code, GitHub Copilot CLI, Cursor, Cline, Gemini CLI, Grok, Hermes, Kimi Code, Pi, oh-my-pi, OpenClaw, OpenCode, Antigravity und ZCode. Paseo wird über diese nativen Provider-Integrationen unterstützt, mit Provider-spezifischer Abdeckung. Die Support-Matrix erklärt, welche Events und Enforcement-Pfade jeder Adapter unterstützt.
Installieren Sie hol-guard, um Agentenaktivität auf Ihrem Rechner zu schützen. Installieren Sie plugin-scanner, um Plugin-Pakete zu inspizieren und Sicherheits- und Qualitätsprüfungen in CI durchzusetzen. Dieses Repository baut und veröffentlicht beide Distributionen.
Guard inspiziert die MCP-Server-Konfiguration und überprüft unterstützte MCP-Tool-Aufrufe über Agent-Hooks und verwaltete Proxies. Plugin Scanner prüft die MCP-Konfiguration und HTTP-Remote-Erreichbarkeit; optionale Cisco-MCP-Analyse ergänzt statische Sicherheitsbefunde.
Die Aktion benötigt möglicherweise eine Genehmigung gemäß Ihrer aktiven Richtlinie, oder ihre Tools oder Artefakte haben sich geändert. Beginnen Sie mit hol-guard approvals, inspizieren Sie den Befehl mit hol-guard command explain '<command>' und verwenden Sie hol-guard receipts, um die aufgezeichnete Entscheidung zu überprüfen.
| Leitfaden | Inhalt |
|---|---|
| Erste Schritte | Installation, manuelles Setup, Paketschutz und gängige Befehle. |
| Agenten-Unterstützung | Integrationsabdeckung und Genehmigungsverhalten. |
| Architektur | Laufzeitkomponenten und Entscheidungsfluss. |
| Richtlinien-Spezifikation | GuardPolicy-Dokumentformat. |
| Richtlinien-Rezepte | Konfigurationsbeispiele für gängige Workflows. |
| Erweiterungen | Integrierte Befehlsregeln und Beitragsrichtlinien. |
| Eine Erweiterung beitragen | Eine neue Erweiterung mit der CLI generieren, prüfen, integrieren und testen. |
| Lokal vs. Cloud | Lokale Fähigkeiten und optionale Cloud-Dienste. |
| Fehlerbehebung | Diagnose und Wiederherstellung. |
| Sicherheit | Richtlinie zur Meldung und Offenlegung von Schwachstellen. |
Verwenden Sie die Extension Builder CLI, um exportierte Befehlsmetadaten oder ein MCP-Tool-Inventar in Beitragsdateien und Tests umzuwandeln. Sie funktioniert offline: Sie liest den Export, ohne das Ziel-Tool zu importieren oder auszuführen.
1. Die Abdeckung vorschlagen. Prüfen Sie das Erweiterungsverzeichnis auf bestehende Abdeckung. Für eine neue Fähigkeit öffnen Sie einen Erweiterungsvorschlag mit der vorgeschlagenen command.<name>-ID, unterstützten Operationen, destruktiven Beispielen, sicheren Gegenstücken und Upstream-Referenzen. Erweitern Sie eine bestehende Erweiterung, wenn diese die Operation bereits besitzt.
Folgen Sie dem Entwicklungs-Setup und führen Sie dann die folgenden Beispiele aus Ihrem HOL Guard-Checkout aus. uv run --no-sync verwendet die installierte Entwicklungsversion dieses Checkouts.
2. Ein Beitrags-Kit generieren. Dieses Beispiel verwendet das eingecheckte, synthetische samplectl-Inventar. Ersetzen Sie für Ihren eigenen Beitrag die Eingabe und Metadaten durch den Export Ihres Tools und die öffentlichen Publisher-Details.```bash
uv run --no-sync hol-guard extensions generate --from cli
--input docs/guard/extension-builder/examples/cli-surface.json
--slug samplectl --executable samplectl --name 'Sample CLI'
--publisher community.example --publisher-name 'Example Maintainer'
--homepage https://example.test/samplectl
--upstream-version 1.0.0 --output samplectl-kit
uv run --no-sync hol-guard extensions validate samplectl-kit
Das Ausgabeverzeichnis muss neu sein und ein vorhandenes übergeordnetes Verzeichnis haben. Das Kit enthält `discovery.json`, `review.json`, `report.json`, Beitrags-Metadaten, einen nativen Detektor, generierte Tests und ein Datei-Manifest.
Weitere Eingaben: `--from help` liest gespeicherte Befehls-Hilfe; `--from click` liest einen Click-`Context.to_info_dict()`-Export; `--from oclif` liest `oclif.manifest.json`; `--from mcp` liest ein vollständiges exportiertes `tools/list`-Ergebnis; und `--from snapshot` spielt `discovery.json` erneut ab. Das obige `cli`-Beispiel verwendet normalisiertes `guard.cli-surface.v1`-JSON.
Für MCP-Beiträge verwendet der Generator `--launcher` und `--package` anstelle von `--executable`. Siehe das [MCP-Kit-Beispiel](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/extension-builder/README.md#generate-an-mcp-kit) für einen vollständigen Befehl und die Anforderungen an die Paginierung.
**3. Überprüfen Sie die Operationen und generieren Sie neu.** Lesen Sie `report.json` und vergleichen Sie die entdeckten Operationen mit der Upstream-Implementierung. Kopieren Sie die Review-Datei vor der Bearbeitung:```bash
cp samplectl-kit/review.json samplectl-review.json
Bearbeite samplectl-review.json und lasse dabei die Discovery-Bindung und die Operations-IDs intakt. CLI-Operationen verwenden review oder block; die Root-Operation bleibt review. Setze reviewed: true für Einträge, die du bewertet hast, mit Begründung und einer öffentlichen HTTPS-Evidenzreferenz. Füge safeArgv nur für exakte, verifizierte sichere Aufrufe hinzu. Das Review-Format enthält ein vollständiges Beispiel für einen Eintrag.
Kompiliere aus dem gespeicherten Snapshot neu, anstatt generierte Detektoren oder Manifeste zu bearbeiten:```bash
uv run --no-sync hol-guard extensions generate --from snapshot
--input samplectl-kit/discovery.json
--review samplectl-review.json --output samplectl-reviewed
uv run --no-sync hol-guard extensions validate samplectl-reviewed uv run --no-sync hol-guard extensions diff samplectl-kit samplectl-reviewed
`diff` gibt `0` für gleiche Kits und `1` zurück, wenn gültige Kits sich unterscheiden. Wenn sich der Upstream-Export ändert, generieren und überprüfen Sie einen neuen Snapshot.
**4. Vorschau und Anwendung der Integration.** Zeigen Sie auf Ihrem Beitrags-Branch eine Vorschau der Änderungen am aktuellen Checkout an:```bash
uv run --no-sync hol-guard extensions apply samplectl-reviewed --repo .
Untersuchen Sie die aufgelisteten Pfade und generierten Dateien. Kopieren Sie den ausgegebenen Plan-Digest in den folgenden Befehl, bevor Sie ihn ausführen:```bash
uv run --no-sync hol-guard extensions apply samplectl-reviewed --repo .
--expected-plan THE_PRINTED_PLAN_DIGEST
--write
Der Schreibvorgang wendet den überprüften Plan auf Beitragsdateien, die externe Trust Map, die Katalogregistrierung, das Packaging und die Autorenschafts-Datensätze an. Vorhandene IDs oder in Konflikt stehende Dateien stoppen die Integration zur Überprüfung.
**5. Testen und einen Pull Request einreichen.** Für das `samplectl`-Beispiel:```bash
uv run --no-sync python scripts/release/stage_guard_cloud_review_artifacts.py
uv run --no-sync pytest -q tests/test_generated_cli_samplectl_extension.py
uv run --no-sync pytest -q \
tests/test_guard_extension_contribution.py \
tests/test_guard_extension_trust.py \
tests/test_guard_command_extension_registry.py
uv run --no-sync python scripts/render_command_extension_directory.py
uv run --no-sync python scripts/render_command_extension_directory.py --check
git diff --check
Verwende deinen generierten Testdateinamen für einen anderen Slug. Füge Fälle für destruktive Operationen, sichere Vorschauen, Aliase, neu angeordnete Flags, Quoting, fehlerhafte Eingaben und zusammengesetzte Befehle hinzu. Führe Lint- und Formatierungsprüfungen für geänderte Python-Dateien aus. Prüfe den finalen Diff, committe die Integration und das neu generierte Verzeichnis und öffne einen PR gegen main, der den Vorschlag und die Testergebnisse verlinkt. Füge die generierten Authoring-Datensätze hinzu; halte Scratch-Kit-Verzeichnisse und rohe Upstream-Exporte aus dem PR heraus.
Community-Beiträge bleiben External und standardmäßig deaktiviert. Tests müssen belegen, dass sie inaktiv sind, bis ein lokaler Administrator sie aktiviert. Das Generieren, Anwenden oder Mergen eines Beitrags aktiviert ihn nicht, und sein Detektor kann die von Guard erforderlichen Schutzmaßnahmen nicht abschwächen.
Vollständige Builder-Referenz · Anforderungen an die Beitragsprüfung · External-Erweiterungsvertrag · Builder-Validierung
Klone das Repository und installiere die Entwicklungsabhängigkeiten mit uv:```bash git clone https://github.com/hashgraph-online/hol-guard.git cd hol-guard uv sync --extra dev uv run ruff check src tests uv run ruff format --check src tests uv run pytest --tb=short uv build
Für optionale Cisco-Abdeckung verwenden Sie den Dependency-Group-Befehl oben. Siehe [CONTRIBUTING.md](https://github.com/hashgraph-online/hol-guard/blob/main/CONTRIBUTING.md) für Beitragsanforderungen und die [Testing-Matrix](https://github.com/hashgraph-online/hol-guard/blob/main/docs/guard/testing-matrix.md) für Integrationstests.
## Ressourcen
- [HOL Plugin Registry](https://hol.org/registry/plugins)
- [HOL Plugin Security dataset on Hugging Face](https://huggingface.co/datasets/HashgraphOnline/hol-plugin-security)
- [HOL Standards Documentation](https://hol.org/docs/standards)
- [OpenAI Codex Plugin Documentation](https://developers.openai.com/codex/plugins)
- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
- [Cisco AI Skill Scanner](https://pypi.org/project/cisco-ai-skill-scanner/)
- [Cisco AI MCP Scanner](https://pypi.org/project/cisco-ai-mcp-scanner/)
- [HOL GitHub Organization](https://github.com/hashgraph-online)
## Community
Betreut von [Hashgraph Online](https://github.com/hashgraph-online).
- [Melden Sie einen Fehler oder fordern Sie ein Feature an](https://github.com/hashgraph-online/hol-guard/issues)
- [Releases durchsuchen](https://github.com/hashgraph-online/hol-guard/releases)
- [Den Plugin-Sicherheitsdatensatz erkunden](https://huggingface.co/datasets/HashgraphOnline/hol-plugin-security)
## Lizenz
Lizenziert unter [Apache-2.0](https://github.com/hashgraph-online/hol-guard/blob/main/LICENSE).