macOS / Linux (Homebrew)```bash

Homebrew

brew install depsguard

Или загрузите вручную через PowerShell:```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

Требуется цепочка инструментов Rust с cargo.

Менеджеры пакетов (когда опубликованы вашим поставщиком)

Если ваша организация распространяет DepsGuard через Homebrew, Scoop или WinGet, используйте их инструкции. Настройка или автоматизация этих каналов (PR для Homebrew core, buckets, PR для WinGet, секреты CI) относится к документации мейнтейнера; см. AGENTS.md в разделе Релиз и распространение.

Магазины приложений / менеджеры пакетов

Обновление до последней версии

Используйте тот канал, с помощью которого вы устанавливали:

Проверить установленную версию можно в любое время с помощью depsguard --version, а последнюю версию можно найти на странице релизов.

Сборка из исходников```bash

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

Как использовать

1. Установите – выберите вашу платформу выше.
2. Запустите depsguard, чтобы открыть интерактивный TUI. Он просканирует вашу систему и покажет таблицу результатов. Нажмите любую клавишу, чтобы перейти к выбору исправлений. Поиск конфигураций уровня репозитория начинается с текущей директории и идёт вниз. Используйте depsguard scan для отчёта только для чтения или depsguard --no-search, чтобы пропустить рекурсивный поиск файлов и проверять только конфиги пользовательского уровня.

   Примечание: некоторые настройки требуют определённой минимальной версии. Если ваша версия слишком старая, вы увидите: ℹ min-release-age – requires npm ≥ 11.10 (have 10.2.0). Обновитесь с помощью npm install -g npm@latest и запустите снова.

3. Навигация и выбор – используйте ↑ ↓ для перемещения по списку (^u ^d для пролистывания). Нажмите Space, чтобы включить или отключить исправление. Используйте клавиши быстрой фильтрации для массового выбора по файлу: a – всё, n – .npmrc, u – uv.toml и т.д. – нажмите один раз для выбора, ещё раз для отмены, третий раз для очистки фильтра. Нажмите f, чтобы показать только выбранные исправления.
4. Предпросмотр – нажмите d, чтобы увидеть diff того, что изменится, прежде чем что-либо применять.
5. Применение – нажмите Enter, чтобы применить выбранные исправления. Перед записью любого файла создаётся резервная копия с меткой времени.
6. Повторное сканирование – DepsGuard автоматически запускает повторное сканирование после применения, чтобы вы могли убедиться, что всё в порядке.
7. Восстановление – выполните depsguard restore в любое время, чтобы откатиться из списка резервных копий. Нажмите q или Esc для выхода.

Что проверяется

Расположение конфигурационных файлов

Конфигурационные файлы пользовательского уровня читаются из стандартных расположений (включая пути на основе XDG, если инструмент их поддерживает). Конфиги уровня репозитория обнаруживаются путем поиска вниз от текущей директории, пропуская известные большие каталоги (node_modules, .git, target, Library, .cache и другие), чтобы сканирование оставалось быстрым. Ищутся .npmrc, .yarnrc.yml, pnpm-workspace.yaml, конфиги Renovate и Dependabot на уровне репозитория. Настройки pnpm могут находиться в ~/.npmrc (только pnpm <= 10; pnpm >= 11 читает из .npmrc только настройки аутентификации/реестра), глобальном конфигурационном файле pnpm (rc для pnpm <= 10, config.yaml для pnpm >= 11) или pnpm-workspace.yaml; DepsGuard проверяет все три расположения независимо. Для pip, uv и poetry DepsGuard определяет единственный действующий конфиг пользовательского уровня и сообщает только о нём, а не помечает отдельно скрытые файлы. pip и poetry объединяют свои конфигурационные файлы по приоритету (файл с наивысшим приоритетом, задающий время задержки, побеждает, или предпочтительное расположение, если ни один не задаёт); uv читает один пользовательский файл ($XDG_CONFIG_HOME/uv/uv.toml, если XDG_CONFIG_HOME задан, иначе ~/.config/uv/uv.toml), а не объединяет оба. Для bun, если существует несколько конфигурационных файлов пользовательского уровня (например, и путь XDG, и путь в домашней директории), DepsGuard проверяет каждый существующий файл отдельно. aube читает тот же ~/.npmrc, что и npm/pnpm (minimumReleaseAge, в минутах), и также проверяется в обнаруженных файлах .npmrc на уровне репозитория; pip и poetry сканируются в своих конфигах пользовательского уровня (pip.conf / pypoetry/config.toml).

Срочное исправление безопасности

Если пропатченная версия новее, чем ваш период задержки, добавьте узкое исключение, установите исправление, а затем удалите исключение.

Отдавайте предпочтение исключению для конкретного пакета, а не снижению глобальной задержки. Это сохранит задержку для всех остальных зависимостей.

Перед обходом задержки:

1. Проверьте, действительно ли CVE влияет на ваше использование.
2. Проверьте, доступна ли уже заведомо рабочая старая версия. Возможно, откат будет безопаснее.
3. Удалите временные исключения после обновления.

Резервные копии и восстановление

Перед изменением файла DepsGuard создаёт резервную копию в ~/.depsguard/backups/.

Выполните depsguard restore, чтобы вывести список резервных копий и восстановить одну из них.

Как это работает```

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