Oversight (v0.5.9)

Oversight — это инструмент терминальной безопасности и интеллектуальный пейджер для кода, предназначенный для аудита shell-скриптов и потоков обновления пакетов до их выполнения в вашей системе. Он сокращает разрыв между слепым доверием и утомительным ручным аудитом с помощью эвристического анализа в реальном времени и интерактивного просмотра.

Oversight Demo

Ключевые возможности

Движок статического и эвристического аудита: анализирует буферы скриптов с помощью модульных regex-шаблонов и энтропии Шеннона для выявления обфусцированных строк, упакованных бинарников и подозрительных цепочек жизненного цикла.
Интеллектуальный резервный пейджер: если поток проходит анализ без флагов риска, Oversight работает как отзывчивый текстовый пейджер с плавной построчной прокруткой, постраничным переходом и поддержкой колеса мыши.
Разделение Git diff для нескольких пакетов: динамически изолирует пакетные потоки обновления в отдельные вкладки пакетов наряду с локальными файлами сборки, такими как PKGBUILD и скрипты .install.
Перехват в реальном времени в оболочке: опциональные лёгкие хуки для Zsh, Bash и Fish, которые перехватывают команды высокого риска и предлагают анализ перед выполнением.

Быстрая установка

Через Arch User Repository (AUR)

yay -S oversight-git

Из исходного кода

git clone https://github.com/Rakosn1cek/oversight.git
cd oversight
chmod +x install.sh
./install.sh

Быстрый старт

# Audit a local shell script
oversight ./install.sh

# Audit a remote script safely in memory
oversight https://raw.githubusercontent.com/example/repo/main/install.sh

# Pipe git diffs or manual pages directly
git diff | oversight

Интеграция с менеджером пакетов

Чтобы использовать Oversight в качестве пейджера diff при обновлении пакетов, добавьте алиас в профиль вашей оболочки:

# For Yay (~/.zshrc or ~/.bashrc)
alias yay="yay --diffpager oversight"

Для Paru добавьте следующие строки в ~/.config/paru/paru.conf:

[options]
Pager = oversight
CombinedUpgrade

Справочник основных элементов управления

Клавиша / ввод	Контекст	Действие
`↓` / `↑`	Режим пейджера / вкладки	Прокрутка области просмотра построчно
`↓` / `↑`	Просмотр находок	Переход между отмеченными находками
`j` / `k`	Все представления	Прокрутка области просмотра построчно
`PageDown` / `Space`	Все представления	Прокрутка области просмотра вниз на одну страницу
`PageUp` / `b`	Все представления	Прокрутка области просмотра вверх на одну страницу
`d` / `u`	Все представления	Прокрутка области просмотра вниз или вверх на половину страницы
`Home` / `g` / `←`	Все представления	Переход к началу потока
`End` / `G`	Все представления	Переход к концу потока
`Tab` / `0-9`	Несколько пакетов	Переключение или переход к вкладкам пакетов
`s`	Просмотр находок	Переключение подавления выбранной находки
Колесо мыши	Все представления	Плавная прокрутка области просмотра на 3 строки
`q` / `Esc`	Все представления	Выход из Oversight

Полная документация

Подробные руководства по архитектуре, создание собственных сигнатур (rules.json), настройку глобального системного пейджера и решение проблем см. на официальном сайте документации:

👉 https://rakosn1cek.github.io/oversight/

Сообщество и участие

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

Обсуждайте и задавайте вопросы в Discord (Rakosn1cek Hub)
Открывайте issue или обсуждение на GitHub

oversight

Популярное