🛡️ GuardScan

100% бесплатно и с открытым исходным кодом • Приватный CLI для сканирования безопасности и AI-ревью кода

  ____ _   _   _    ____  ____    ____   ____    _    _   _            ____ _     ___ 
 / ___| | | | / \  |  _ \|  _ \  / ___| / ___|  / \  | \ | |          / ___| |   |_ _|
| |  _| | | |/ _ \ | |_) | | | | \___ \| |     / _ \ |  \| |  _____  | |   | |    | |
| |_| | |_| / ___ \|  _ <| |_| |  ___) | |___ / ___ \| |\  | |_____| | |___| |___ | | 
 \____|\___/_/   \_\_| \_\____/  |____/ \____/_/   \_\_| \_|          \____|_____|___|

 Privacy-First AI Code Review & Security Scanning

---

🎉 Полностью бесплатно — без подписок и ограничений

GuardScan — на 100% бесплатный и открытый! Никакой системы кредитов, платных функций и подписок.

Что вы получаете (всё БЕСПЛАТНО)

• ✅ Неограниченный статический анализ — 9 сканеров безопасности + инструменты оценки качества кода
• ✅ Проверка кода с помощью ИИ — используйте собственный API-ключ (OpenAI, Claude, Gemini, Ollama)
• ✅ Полностью работает офлайн — для статического анализа интернет не требуется
• ✅ Приоритет конфиденциальности — исходный код никогда не загружается
• ✅ Без ограничений использования — сканируйте неограниченное количество строк кода и репозиториев

---

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

# Install globally via npm
npm install -g guardscan

# Initialize GuardScan
guardscan init

# Run comprehensive security scan (100% FREE, offline)
guardscan security

# Configure AI provider for enhanced review (optional, BYOK)
guardscan config

# Run AI-enhanced code review
guardscan run

# Check status
guardscan status

🐳 Docker / Alpine Linux

Для окружений Docker, особенно Alpine Linux:

# Install dependencies first
apk add --no-cache python3 make g++ pkgconfig cairo-dev pango-dev \
  libjpeg-turbo-dev giflib-dev pixman-dev freetype-dev build-base git

# Install GuardScan
npm install -g guardscan

# Set home directory (important for Docker)
export GUARDSCAN_HOME=/app/.guardscan

# Initialize
guardscan init

Документация:

• 📖 Полное руководство по Docker - Полное руководство для Linux, macOS и Windows
• 🐧 Краткий справочник по Docker и Alpine - Краткий справочник для Alpine Linux

---

📋 Основные возможности

🔒 Сканирование безопасности (БЕСПЛАТНО, офлайн)

GuardScan включает комплексные сканеры безопасности:

1. Обнаружение секретов - Поиск жестко закодированных API-ключей, паролей, токенов (20+ шаблонов)
2. Уязвимости зависимостей - Сканирование зависимостей npm, pip, Maven, Cargo
3. OWASP Top 10 - SQL-инъекции, XSS, небезопасные конфигурации, CSRF, XXE
4. Безопасность Docker - Сканирование Dockerfile и контейнеров
5. Инфраструктура как код - Безопасность Terraform, CloudFormation, Kubernetes
6. Безопасность API - Анализ конечных точек REST и GraphQL

📊 Качество кода и анализ (БЕСПЛАТНО, офлайн)

7. Метрики кода - Цикломатическая сложность, метрики Холстеда, индекс поддерживаемости
8. Запахи кода - 30+ антипаттернов (божественные классы, длинные методы, магические числа)
9. Соблюдение лицензий - Проверка лицензий зависимостей (MIT, GPL, Apache и др.)
10. Проверки соответствия - Сканирование соответствия GDPR, HIPAA, PCI-DSS
11. Интеграция линтеров - ESLint, Pylint, RuboCop и др.
12. Счетчик LOC - Подсчет строк с учетом языка (20+ языков)

🧪 Тестирование и производительность (БЕСПЛАТНО, офлайн)

13. Запуск тестов - Выполнение и анализ тестов Jest, pytest, JUnit
14. Мутационное тестирование - Проверка эффективности набора тестов (требуется Stryker - опционально)
15. Тестирование производительности - Нагрузочное тестирование и бенчмаркинг (требуется k6 - опционально)
16. Генерация SBOM - Программная спецификация компонентов (CycloneDX, SPDX)

Примечание: Тестирование производительности и мутационное тестирование требуют опциональных внешних инструментов.

🤖 Возможности с ИИ (BYOK - используйте свой ключ)

9 продвинутых возможностей на основе ИИ:

1. Объяснение кода (guardscan explain) - Понимание сложного кода
2. Ревью кода (guardscan review) - Комплексное ревью кода с ИИ
3. Генератор коммитов (guardscan commit) - Генерация сообщений коммитов
4. Генератор документации (guardscan docs) - Автоматическая генерация документации
5. Генератор тестов (guardscan test-gen) - Генерация модульных тестов
6. Предложения по рефакторингу (guardscan refactor) - Улучшение качества кода
7. Моделирование угроз (guardscan threat-model) - Анализ архитектуры безопасности
8. Помощник миграции (guardscan migrate) - Миграция фреймворков/языков
9. Интерактивный чат (guardscan chat) - Вопросы и ответы по кодовой базе на основе RAG

🌍 Поддержка нескольких языков

AST-парсеры для 7+ языков:

• TypeScript/JavaScript
• Python
• Java
• Go
• Rust
• Ruby
• PHP
• C#

🔌 Интеграции с поставщиками ИИ

Настройте любого предпочитаемого вами поставщика ИИ:

• OpenAI (GPT-4, GPT-4 Turbo, GPT-3.5)
• Anthropic Claude (Claude 3 Opus, Sonnet, Haiku)
• Google Gemini (Gemini Pro)
• Ollama (локальный, ориентированный на конфиденциальность — llama2, codellama, mistral)
• LM Studio (локальные модели)
• OpenRouter (доступ к нескольким моделям)

Вы платите поставщику ИИ напрямую - GuardScan не взимает никакой платы!

---

🛠️ Команды

Все команды 100% БЕСПЛАТНЫ без ограничений!

Команды настройки

Команда	Описание
guardscan init	Инициализировать конфигурацию, сгенерировать client_id
guardscan config	Настроить поставщика ИИ и параметры
guardscan status	Показать конфигурацию и информацию о репозитории
guardscan reset	Очистить локальный кэш и конфигурацию

Команды безопасности и анализа

Команда	Описание
guardscan security	Запустить комплексное сканирование безопасности (офлайн)
guardscan scan	Быстрое сканирование безопасности
guardscan run	Полное ревью кода с ИИ (BYOK)

Команды тестирования и качества

Команда	Описание
guardscan test	Запуск тестов и анализ качества кода
guardscan perf	Тестирование производительности и нагрузочное тестирование (требуется k6 — опционально)
guardscan mutation	Мутационное тестирование для оценки качества тестов (требуется Stryker — опционально)

Примечание: команды perf и mutation требуют опциональных внешних инструментов. См. Testing Tools Guide для получения сведений об установке и использовании.

Служебные команды

Команда	Описание
guardscan sbom	Генерация Software Bill of Materials
guardscan rules	Настраиваемый движок правил на основе YAML

Команды на основе ИИ (BYOK)