StrixScripts/README.md

StrixScripts

Колекция от самостоятелни bash скриптове, организирани по функционални папки. Всеки скрипт има собствена .md документация до себе си с пълно описание, изисквания и примери.

За AI агенти, работещи в repo-то: виж AGENTS.md за задължителните конвенции при създаване на нов скрипт — структура, --help поведение, shellcheck, документация.

Структура

strixscripts/
├── lib/
│   └── common.sh          споделени helper функции (--help, error handling, logging)
├── templates/              шаблони за нов скрипт + неговия .md файл
├── examples/
│   └── hello-world.sh      работещ пример, демонстриращ пълната конвенция
├── HDD/
│   ├── repair-hdd.sh       презапис на диск и SMART extended self-test
│   └── erase-storage.sh    презапис на дял или Secure Erase/Sanitize на диск
├── System/
│   ├── network-diagnostic.sh подробна мрежова диагностика, топ 10 Wi-Fi мрежи и export
│   ├── system-report.sh     моментен системен отчет с TXT/HTML export
│   └── check-hardware-health.sh SMART здраве на дискове и температури на компонентите
├── Virtualisation/
│   └── virtualisation-check.sh проверка на инсталирани виртуализационни решения и инстанции
├── Web/
│   └── inspect-web-services.sh уеб сървъри, proxy, vhost и listeners на 80/443
└── <категория>/             функционална група скриптове (предстои)

Как се използва скрипт

Всеки скрипт поддържа --help:

./<категория>/<script-name>.sh --help

Категории

examples/ (референция, не production скриптове)

• hello-world.sh — демонстрационен скрипт, показващ конвенцията за нов скрипт в repo-то.

HDD/

• repair-hdd.sh — презаписва избран диск и изпълнява SMART extended self-test.
• erase-storage.sh — презаписва дял с един проход или използва поддържан Secure Erase/Sanitize за цял диск.

System/

• network-diagnostic.sh — показва физическите интерфейси, топ десетте Wi-Fi мрежи и виртуалните интерфейси в този ред; поддържа TXT, JSON и HTML отчет.
• system-report.sh — събира моментно състояние на системата, като групира Ethernet, Wi-Fi и виртуалните интерфейси, и предлага отчет във формат TXT, JSON или HTML.
• check-hardware-health.sh — проверява SMART състоянието и типа на дисковете и предупреждава за високи температури.

Virtualisation/

• virtualisation-check.sh — открива VM/container решения и отчита инсталираните и работещите им инстанции.

Web/

• inspect-web-services.sh — открива web servers/reverse proxies, слушатели на портове 80/443 и Apache/Nginx vhosts.