Входной текст пуст — нечего переводить.```text
Scanning 118 file(s)...

── claude-code ──────────────────────────────────────────────
/home/ross/.claude/history.jsonl  (13 finding(s))
[CRITICAL] Anthropic API key (anthropic)
    /home/ross/.claude/history.jsonl:1005:13
    sk-ant-api03***...***
[CRITICAL] PyPI API token (pypi)
    /home/ross/.claude/history.jsonl:125:94
    pypi-AgEIc***...***
[CRITICAL] GitHub fine-grained PAT (github)
    /home/ross/.claude/history.jsonl:2306:13
    github_pat_11A***...***
[HIGH]     HuggingFace token (huggingface)
    /home/ross/.claude/history.jsonl:3387:13
    hf_JOi***...***
...

Total: 13 credentials across 1 file(s).
Report:  /home/ross/.medusa/secrets-scan/secrets-20260519-074452.json

- **Глубокие OSINT-расследования** - Включает инструменты для **инструментов Darknet**, **Tor**, **I2P** и **Freenet** для исследования глубокой сети.  
  
> [!TIP] Этот список невероятно большой. Используйте функцию «Найти» вашего браузера (Ctrl+F или Cmd+F), чтобы быстро найти нужные инструменты или ключевые слова!```text
[CRITICAL] PyPI API token  (pypi)
    /home/ross/.claude/history.jsonl:125:94
    pypi-AgEIc***...***
  redact?  [y/n/s/a/q/?]: y

[CRITICAL] Anthropic API key  (anthropic)
    /home/ross/.claude/history.jsonl:1005:13
    sk-ant-api03***...***
  redact?  [y/n/s/a/q/?]: y
...

✓ /home/ross/.claude/history.jsonl  (13 redacted)
    backup → /home/ross/.medusa/secrets-scan/backups/20260519-074452/home/ross/.claude/history.jsonl

### Что обнаруживается (21 источник)

**AI-провайдеры**: Anthropic, OpenAI, HuggingFace, Replicate, Cohere
**Реестры пакетов**: PyPI, npm
**Форжи исходного кода**: GitHub PAT (classic + fine-grained + OAuth + App), GitLab PAT
**Облако**: ключи доступа AWS, JSON сервисных учётных записей GCP
**Платежи / коммуникации**: live/restricted-ключи Stripe, токены Slack (бот/пользователь), SendGrid, Twilio, вебхуки Discord
**Криптография**: PEM-закодированные приватные ключи (RSA, DSA, EC, OpenSSH, PGP)

### Свойства безопасности

- **Только локально.** Отчёты сохраняются в `~/.medusa/secrets-scan/` с режимом `0o600`. Никакой сети, никакой телеметрии, никогда не записываются в деревья проекта.
- **Резервная копия перед записью.** Каждому редактированию предшествует байт-идентичная резервная копия. `cp` восстанавливает её.
- **Безопасно для JSONL.** Маркер редактирования не содержит символов, небезопасных для JSON; затронутые строки повторно разбираются после записи.
- **Отказ при расхождении.** Если исходный файл изменился между сканированием и очисткой, очиститель отказывается выполнять действие, чтобы не затереть правку.
- **Атомарная запись.** Временный файл + подмена через `os.replace`. Либо перезапись выполняется, либо оригинал остаётся.

[**📖 Полное руководство по secrets-scanner →**](https://github.com/pantheon-security/medusa/blob/main/docs/SECRETS_SCANNER.md)

---

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

### Установка```bash
# Install MEDUSA (works on Windows, macOS, Linux)
pip install medusa-security

# Run your first scan - that's it!
medusa scan .

**Примечания по платформам:**
- **Windows**: Используйте `py -m medusa`, если команда `medusa` не найдена
- **macOS/Linux**: Должно работать из коробки

### Сканирование любого репозитория GitHub```bash
# Scan a remote repo for AI supply chain attacks
medusa scan --git https://github.com/org/repo

# Shorthand - just user/repo
medusa scan --git org/repo

# Scan a specific branch
medusa scan --git https://github.com/org/repo/tree/main

### Опционально: внешние линтеры

MEDUSA автоматически обнаруживает внешние линтеры, если они установлены (bandit, eslint, shellcheck и т.д.), и использует их для расширения покрытия сканирования.

**[См. руководство по установке →](https://github.com/pantheon-security/medusa/blob/main/docs/OPTIONAL_TOOLS.md)** для инструкций по конкретным платформам.

> **Примечание:** Внешние линтеры необязательны. Встроенные правила MEDUSA (40 000+) работают и без них. За поддержкой по установке обращайтесь к документации соответствующего поставщика инструментов.

### Демонстрация

<div align="center">

![MEDUSA в действии](https://assets.kitploit.com/production/public/readmes/49181/80281d742fbec3c1bf5c3cb62999af22a9fcfb2bdb89ba79eec5d27b80716e7a.gif)

</div>

### 📊 Форматы отчётов

MEDUSA создаёт красивые отчёты в нескольких форматах:

**JSON** — машиночитаемый формат для интеграции с CI/CD```bash
medusa scan . --format json

**Markdown** - Удобен для документации на GitHub/вики```bash
medusa scan . --format markdown

---

## 📚 Поддержка языков

MEDUSA поддерживает **79 типов сканеров**, охватывающих безопасность ИИ/МО, все основные языки программирования и форматы файлов:

### Backend-языки (9)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| Python | Bandit | `.py` |
| JavaScript/TypeScript | ESLint | `.js`, `.jsx`, `.ts`, `.tsx` |
| Go | golangci-lint | `.go` |
| Ruby | RuboCop | `.rb`, `.rake`, `.gemspec` |
| PHP | Встроенные правила (+ PHPStan опционально) | `.php` |
| Rust | Встроенные правила (+ Clippy опционально) | `.rs` |
| Java | Checkstyle | `.java` |
| C/C++ | cppcheck | `.c`, `.cpp`, `.cc`, `.cxx`, `.h`, `.hpp` |
| C# | Roslynator | `.cs` |

### JVM-языки (3)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| Kotlin | ktlint | `.kt`, `.kts` |
| Scala | Scalastyle | `.scala` |
| Groovy | CodeNarc | `.groovy`, `.gradle` |

### Функциональные языки (5)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| Haskell | HLint | `.hs`, `.lhs` |
| Elixir | Credo | `.ex`, `.exs` |
| Erlang | Elvis | `.erl`, `.hrl` |
| F# | FSharpLint | `.fs`, `.fsx` |
| Clojure | clj-kondo | `.clj`, `.cljs`, `.cljc` |

### Мобильная разработка (2)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| Swift | SwiftLint | `.swift` |
| Objective-C | OCLint | `.m`, `.mm` |

### Frontend и стилизация (3)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| CSS/SCSS/Sass/Less | Stylelint | `.css`, `.scss`, `.sass`, `.less` |
| HTML | HTMLHint | `.html`, `.htm` |
| Vue.js | ESLint | `.vue` |

### Инфраструктура как код (4)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| Terraform | tflint | `.tf`, `.tfvars` |
| Ansible | ansible-lint | `.yml` (плейбуки) |
| Kubernetes | kubeval | `.yml`, `.yaml` (манифесты) |
| CloudFormation | cfn-lint | `.yml`, `.yaml`, `.json` (шаблоны) |

### Файлы конфигурации (4)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| JSON | встроенный | `.json` |
| TOML | taplo | `.toml` |
| XML | xmllint | `.xml` |
| Protobuf | buf lint | `.proto` |

### Shell и скрипты (4)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| Bash/Shell | ShellCheck | `.sh`, `.bash` |
| PowerShell | PSScriptAnalyzer | `.ps1`, `.psm1` |
| Lua | luacheck | `.lua` |
| Perl | perlcritic | `.pl`, `.pm` |

### Документация (2)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| Markdown | markdownlint | `.md` |
| reStructuredText | rst-lint | `.rst` |

### Другие языки (5)
| Язык | Сканер | Расширения |
|----------|---------|------------|
| SQL | SQLFluff | `.sql` |
| R | lintr | `.r`, `.R` |
| Dart | dart analyze | `.dart` |
| Solidity | solhint | `.sol` |
| Docker | hadolint | `Dockerfile*` |

**Всего: 79 типов сканеров — 41 сканер языков/инструментов + 38 сканеров безопасности ИИ/МО — покрывающих более 100 расширений файлов**

---

## 🚨 Обнаружение CVE React2Shell (НОВОЕ в v2025.8)

MEDUSA теперь обнаруживает **CVE-2025-55182 «React2Shell»** — уязвимость RCE с рейтингом CVSS 10.0, затрагивающую React Server Components и Next.js.```bash
# Check if your project is vulnerable
medusa scan .

# Vulnerable versions detected:
# - React 19.0.0 - 19.2.0 (Server Components)
# - Next.js 15.0.0 - 15.0.4 (App Router)
# - Various canary/rc releases

### Быстрое ИИ-сканирование безопасности```bash
# Scan AI configuration files
medusa scan . --ai-only

# Example output:
# 🔍 AI Security Scan Results
# ├── .cursorrules: 3 issues (1 CRITICAL, 2 HIGH)
# │   └── AIC001: Prompt injection - ignore previous instructions (line 15)
# │   └── AIC011: Tool shadowing - override default tools (line 23)
# ├── mcp-config.json: 2 issues (2 HIGH)
# │   └── MCP003: Dangerous path - home directory access (line 8)
# └── rag_config.json: 1 issue (1 CRITICAL)
#     └── AIR010: Knowledge base injection pattern detected (line 45)

### Команды установки```bash
# Check tool status
medusa install --check

# Install AI tools (modelscan for ML model scanning)
medusa install --ai-tools

# Show detailed output
medusa install --ai-tools --debug

### Дополнительные команды```bash
# Uninstall modelscan
medusa uninstall modelscan

# Check for updates
medusa version --check-updates

# Show current configuration
medusa config

# Override scanner for specific file
medusa override path/to/file.yaml YAMLScanner

# List available scanners
medusa override --list

# Show current overrides
medusa override --show

# Remove override
medusa override path/to/file.yaml --remove

### Генерация конфигурации по умолчанию```bash
medusa init

### Claude Code

**Что создаёт:**
- `CLAUDE.md` - Файл контекста проекта
- `.claude/agents/medusa/agent.json` - Конфигурация агента
- `.claude/commands/medusa-scan.md` - Слэш-команда сканирования
- `.claude/commands/medusa-install.md` - Слэш-команда установки

**Использование:**```
Type: /medusa-scan
Claude: *runs security scan*
Results: Displayed in terminal + chat

### OpenAI Codex

**Что создает:**
- `AGENTS.md` - контекст проекта (корневой уровень)

**Использование:**```
Ask: "Run a security scan"
Codex: *executes medusa scan .*

### Умное кэширование

Кэширование на основе хэшей пропускает неизменённые файлы:```bash
# First scan
📂 Files scanned: 145
⏱️  Total time: 47.28s

# Second scan (no changes)
📂 Files scanned: 0
⚡ Files cached: 145
⏱️  Total time: 2.15s  # 22× faster!

---

## 📊 Пример рабочего процесса

### Настройка нового проекта```bash
# 1. Initialize
cd my-awesome-project
medusa init

🐍 MEDUSA Initialization Wizard

✅ Step 1: Project Analysis
   Found 15 language types
   Primary: PythonScanner (44 files)

✅ Step 2: Scanner Availability
   Available: 6/79 scanners
   Missing: 73 tools

✅ Step 3: Configuration
   Created .medusa.yml
   Auto-detected IDE: Claude Code

✅ Step 4: IDE Integration
   Created .claude/agents/medusa/agent.json
   Created .claude/commands/medusa-scan.md

✅ MEDUSA Initialized Successfully!

# 2. First scan
medusa scan .

🔍 Issues found: 23
   CRITICAL: 0
   HIGH: 2
   MEDIUM: 18
   LOW: 3

# 3. Fix issues and rescan
medusa scan . --quick

⚡ Files cached: 142
🔍 Issues found: 12  # Progress!

  - name: Set up Python
    uses: actions/setup-python@v4
    with:
      python-version: '3.11'

  - name: Install MEDUSA
    run: pip install medusa-security

  - name: Run security scan
    run: medusa scan . --fail-on high

> **Примечание**: Установка инструмента не требуется — более 40 000 встроенных правил MEDUSA работают немедленно.

---

## 🏗️ Архитектура

### Паттерн сканера

Все сканеры следуют единому паттерну:```python
class PythonScanner(BaseScanner):
    """Scanner for Python files using Bandit"""

    def get_tool_name(self) -> str:
        return "bandit"

    def get_file_extensions(self) -> List[str]:
        return [".py"]

    def scan_file(self, file_path: Path) -> ScannerResult:
        # Run bandit on file
        # Parse JSON output
        # Map severity levels
        # Return structured issues
        return ScannerResult(...)

### Сопоставление уровней серьёзности

Единые уровни серьёзности для всех инструментов:

- **CRITICAL** - Уязвимости безопасности, фатальные ошибки
- **HIGH** - Ошибки, предупреждения безопасности
- **MEDIUM** - Предупреждения, проблемы качества кода
- **LOW** - Проблемы стиля, соглашения
- **INFO** - Предложения, возможности рефакторинга

---

## 🧪 Тестирование и качество

### Результаты Dogfooding

MEDUSA сканирует саму себя — и реальные проекты:```
Self-scan (473 files):
  ✅ Issues found: 114 (pre-filter) → 0 (post-filter)
  ✅ FP reduction: 100% on own codebase
  ⏱️  Time: 8.2s

OpenClaw benchmark (4,124 files, 751K LOC):
  🔍 Issues found: 825 (post-filter)
  ✅ FPs filtered: 11,436 (93.9% reduction)
  ⏱️  Time: 3.3 hours (79 scanners)

### Добавление новых сканеров

См. `docs/development/adding-scanners.md` для руководства по добавлению поддержки новых языков.

---

## 📜 Лицензия

AGPL-3.0-or-later - См. файл [LICENSE](https://github.com/pantheon-security/medusa/blob/main/LICENSE)

MEDUSA — это бесплатное программное обеспечение с открытым исходным кодом. Вы можете свободно использовать, изменять и распространять его, но любые модификации или производные работы (включая развертывания SaaS) также должны быть выпущены под лицензией AGPL-3.0.

По вопросам коммерческого лицензирования обращайтесь: [email protected]

---

## Скоро

MEDUSA Professional добавляет **защиту во время выполнения** для производственных LLM-приложений — блокируя попытки внедрения промптов, джейлбрейков и эксфильтрации данных в реальном времени до того, как они достигнут ваших моделей.

| Функция | Open Source | Professional | Enterprise |
|---------|-------------|--------------|------------|
| Статическое сканирование (40,000+ паттернов) | Да | Да | Да |
| Прокси-фильтры времени выполнения (1,100+) | - | Да | Да |
| REST API и вебхуки | - | Да | Да |
| Пользовательские правила и SSO | - | - | Да |
| **Цена** | Бесплатно | $99/dev/mo | $499/50 devs/mo |

Прокси времени выполнения в настоящее время находится в закрытой бета-версии. Если вы защищаете производственные LLM-приложения и хотите получить ранний доступ, свяжитесь по адресу **[email protected]**.

---

## 🙏 Благодарности

**Разработка:**
- Pantheon Security
- Claude AI (Anthropic) - разработка с помощью ИИ

**Создано с помощью:**
- Python 3.10+
- Click - CLI-фреймворк
- Rich - форматирование терминала
- Bandit, ESLint, ShellCheck и 39+ других инструментов безопасности с открытым исходным кодом

**Вдохновлено:**
- Bandit (безопасность Python)
- SonarQube (многоязычный анализ)
- Semgrep (безопасность на основе паттернов)
- Mega-Linter (комплексный линтинг)

---

## 📖 Руководства

- **[Быстрый старт](https://github.com/pantheon-security/medusa/blob/main/docs/guides/quick-start.md)** - Начните работу за 5 минут
- **[Сканирование безопасности ИИ](https://github.com/pantheon-security/medusa/blob/main/docs/AI_SECURITY.md)** - Полное руководство по безопасности ИИ/LLM (OWASP 2025, MCP, RAG)
- **[Обработка ложных срабатываний](https://github.com/pantheon-security/medusa/blob/main/docs/guides/handling-false-positives.md)** - Уменьшайте шум, находите реальные проблемы
- **[Интеграция с IDE](https://github.com/pantheon-security/medusa/blob/main/docs/guides/ide-integration.md)** - Настройка Claude Code, Gemini, Copilot

---

## 📞 Поддержка

- **GitHub Issues**: [Сообщить об ошибках или запросить функции](https://github.com/Pantheon-Security/medusa/issues)
- **Эл. почта**: [email protected]
- **Документация**: https://docs.pantheonsecurity.io
- **Discord**: https://discord.gg/medusa (скоро)

---

## 📈 Статистика

**Версия**: 2026.5.5
**Дата выпуска**: 2026-04-03
**Паттерны обнаружения**: 40,000+ правил безопасности ИИ
**Анализаторы**: 79 специализированных сканеров
**Паттерны фильтров ложных срабатываний**: 514 интеллектуальных фильтров (снижение на 96.8%)
**Покрытие CVE**: 200 критических уязвимостей (37+ CVE для ИИ-редакторов)
**Отравление репозитория**: 28+ типов файлов конфигурации ИИ-редакторов обнаружено
**Покрытие языков**: 46+ типов файлов
**Поддержка платформ**: Linux, macOS, Windows
**Интеграция ИИ**: Claude Code, Gemini CLI, GitHub Copilot, Cursor, OpenAI Codex
**Стандарты**: OWASP Top 10 для LLM 2025, MITRE ATLAS
**Загрузки**: 11,500+ на PyPI

---

## 🌟 Почему MEDUSA?

### vs. Bandit
- ✅ 40,000+ паттернов (не только безопасность Python)
- ✅ Покрытие безопасности ИИ/ML
- ✅ Не требует настройки
- ✅ Интеграция с IDE

### vs. SonarQube
- ✅ Более простая настройка (`pip install && scan`)
- ✅ Не требует сервера
- ✅ Ориентация на безопасность ИИ в первую очередь
- ✅ Бесплатно и с открытым исходным кодом

### vs. Semgrep
- ✅ Встроенные правила для ИИ/ML
- ✅ Безопасность MCP, RAG и агентов
- ✅ Лучшая интеграция с IDE
- ✅ Не требуется настройка правил

### vs. Traditional SAST
- ✅ Работает сразу (без установки инструментов)
- ✅ Включает паттерны безопасности ИИ
- ✅ Параллельная обработка
- ✅ Умное кэширование

---

**🐍🐍🐍 MEDUSA - Многоязычный сканер безопасности 🐍🐍🐍**

**Одна команда. Полная безопасность.**```bash
medusa init && medusa scan .