macOS / Linux (Homebrew)```bash

Homebrew

brew install depsguard

Oder manuell über PowerShell herunterladen:```powershell $zip = "$env:TEMP\depsguard.zip" Invoke-WebRequest -Uri "https://github.com/arnica/depsguard/releases/latest/download/depsguard-x86_64-pc-windows-msvc.zip" -OutFile $zip Expand-Archive -LiteralPath $zip -DestinationPath "$env:TEMP\depsguard" -Force Copy-Item "$env:TEMP\depsguard\depsguard.exe" "$HOME\AppData\Local\Microsoft\WindowsApps\depsguard.exe" -Force depsguard.exe --help

Erfordert eine Rust-Toolchain mit cargo.

Paketmanager (wenn von Ihrem Anbieter veröffentlicht)

Falls Ihre Organisation DepsGuard über Homebrew, Scoop oder WinGet ausliefert, folgen Sie deren Anweisungen. Das Einrichten oder Automatisieren dieser Kanäle (Homebrew-Core-PRs, Buckets, WinGet-PRs, CI-Secrets) ist Dokumentation für Maintainer; siehe AGENTS.md unter Release & Distribution.

App-Stores / Paketmanager

Auf die neueste Version aktualisieren

Verwenden Sie den Kanal, mit dem Sie installiert haben:

Überprüfen Sie Ihre installierte Version jederzeit mit depsguard --version und sehen Sie die Releases-Seite für die neueste Version.

Aus dem Quellcode erstellen```bash

git clone https://github.com/arnica/depsguard.git cd depsguard cargo build --release

Verwendung

1. Installieren – wählen Sie Ihre Plattform oben.
2. Starten Sie depsguard, um die interaktive TUI zu starten. Es scannt Ihr System und zeigt eine Tabelle mit Ergebnissen. Drücken Sie eine beliebige Taste, um zum Fix-Auswahlmenü zu gelangen. Die Konfigurationserkennung auf Repository-Ebene beginnt im aktuellen Verzeichnis und sucht abwärts. Verwenden Sie depsguard scan für einen schreibgeschützten Bericht oder depsguard --no-search, um die rekursive Dateisuche zu überspringen und nur Benutzerkonfigurationen zu prüfen.

   Hinweis: Einige Einstellungen erfordern eine Mindestversion. Wenn Ihre Version zu alt ist, sehen Sie: ℹ min-release-age – erfordert npm ≥ 11.10 (vorhanden: 10.2.0). Führen Sie ein Upgrade mit npm install -g npm@latest durch und führen Sie den Vorgang erneut aus.

3. Navigieren und auswählen – verwenden Sie ↑ ↓, um sich durch die Liste zu bewegen (^u ^d zum Blättern). Drücken Sie Space, um einen Fix ein- oder auszuschalten. Verwenden Sie die Schnellfiltertasten, um bulk nach Dateien auszuwählen: a für alle, n für .npmrc, u für uv.toml usw. – einmal drücken zum Auswählen, erneut zum Abwählen, ein drittes Mal zum Löschen des Filters. Drücken Sie f, um nur aktuell ausgewählte Fixes anzuzeigen.
4. Vorschau – drücken Sie d, um einen Diff zu sehen, was sich ändern wird, bevor Sie sich festlegen.
5. Anwenden – drücken Sie Enter, um die ausgewählten Fixes anzuwenden. Vor dem Schreiben einer Datei wird ein Backup mit Zeitstempel erstellt.
6. Erneuter Scan – DepsGuard führt nach dem Anwenden automatisch einen erneuten Scan durch, damit Sie überprüfen können, ob alles grün ist.
7. Wiederherstellen – führen Sie jederzeit depsguard restore aus, um aus der Backup-Liste zurückzusetzen. Drücken Sie q oder Esc, um zu beenden.

Was wird geprüft

Speicherorte der Konfigurationsdateien

Benutzer-Konfigurationsdateien werden von ihren Standardorten gelesen (einschließlich XDG-basierter Pfade, sofern vom Tool unterstützt). Repository-Konfigurationen werden durch Abwärtssuche ab dem aktuellen Verzeichnis gefunden, wobei bekannte große Verzeichnisse (node_modules, .git, target, Library, .cache und andere) übersprungen werden, damit Scans schnell bleiben. Repository-weite .npmrc, .yarnrc.yml, pnpm-workspace.yaml, Renovate-Konfigurationen und Dependabot-Konfigurationen werden alle durchsucht. pnpm-Einstellungen können in ~/.npmrc (nur pnpm <= 10; pnpm >= 11 liest nur Auth-/Registry-Einstellungen aus .npmrc), der globalen pnpm-Konfigurationsdatei (rc bei pnpm <= 10, config.yaml bei pnpm >= 11) oder pnpm-workspace.yaml vorhanden sein; DepsGuard prüft alle drei Orte unabhängig. Für pip, uv und poetry löst DepsGuard die einzige effektive Benutzer-Konfiguration auf und meldet nur diese Datei, anstatt verdeckte Dateien separat zu markieren. pip und poetry führen ihre Konfigurationsdateien nach Priorität zusammen (die Datei mit der höchsten Priorität, die die Abkühlzeit setzt, gewinnt, oder der bevorzugte Ort, falls keine sie setzt); uv liest eine einzelne Benutzerdatei ($XDG_CONFIG_HOME/uv/uv.toml wenn XDG_CONFIG_HOME gesetzt ist, andernfalls ~/.config/uv/uv.toml) anstatt beide zusammenzuführen. Für bun, falls mehrere Benutzer-Konfigurationsdateien existieren (z. B. sowohl ein XDG-Pfad als auch ein Home-Verzeichnispfad), scannt DepsGuard jede vorhandene Datei separat. aube liest dieselbe ~/.npmrc wie npm/pnpm (minimumReleaseAge, in Minuten) und wird ebenfalls auf gefundenen Repository-weiten .npmrc-Dateien geprüft; pip und poetry werden auf ihrer Benutzer-Konfiguration (pip.conf / pypoetry/config.toml) gescannt.

Dringender Sicherheitsfix

Wenn die gepatchte Version neuer ist als Ihr Abkühlungsfenster, fügen Sie eine enge Ausnahme hinzu, installieren Sie den Fix und entfernen Sie dann die Ausnahme.

Bevorzugen Sie eine paketspezifische Ausnahme gegenüber einer Senkung der globalen Abkühlzeit. Dadurch bleibt die Verzögerung für alle anderen Abhängigkeiten erhalten.

Bevor Sie die Abkühlzeit umgehen:

1. Prüfen Sie, ob die CVE tatsächlich Ihre Nutzung betrifft.
2. Prüfen Sie, ob eine bekannte gute ältere Version bereits verfügbar ist. Ein Rollback kann sicherer sein.
3. Entfernen Sie temporäre Ausnahmen nach dem Upgrade.

Backups und Wiederherstellung

Vor dem Ändern einer Datei schreibt DepsGuard ein Backup nach ~/.depsguard/backups/.

Führen Sie depsguard restore aus, um Backups aufzulisten und eines wiederherzustellen.

Wie es funktioniert```

src/ main.rs CLI args, run loop term.rs Raw mode + input (Unix termios / Windows console FFI) manager.rs Detection, scanning, recommendations fix.rs Read/write .npmrc, TOML, YAML; backup/restore ui.rs Banner, tables, selector