Violin ☤ — супервизируемый агентный профиль пентеста Hermes

31 плейбук · 10 справочников · 11 шаблонов · обязательный guard выполнения · нативный для Hermes

Violin — это нативный для Hermes агентный профиль пентеста для супервизируемых авторизованных тестов на проникновение — от разведки через безопасную валидацию эксплойтов до отчётности. Он использует встроенные наборы инструментов Hermes, три маршрутизируемых навыка и обязательный плагин violin-guard на границе выполнения целевых команд. Автономный CLI поддерживает проверки релизов, диагностику и административное восстановление; целевые команды выполняются через плагин. Violin не добавляет учётных данных, специфичных для профиля, и наследует провайдера и инструментальные бэкенды, уже настроенные в Hermes.

hermes profile install https://github.com/Strategic-Automation/violin
hermes -p violin

Возможности

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

# 1. Install the profile
hermes profile install https://github.com/Strategic-Automation/violin

# 2. Start a session
hermes -p violin

# 3. Let Violin ask scoping questions, then run your test
> Run a pentest against example.com

hermes profile use violin

Рабочий процесс вовлечения

flowchart LR
    A["1. Scoping"] --> B["2. Recon"]
    B --> C["3. Vuln Research"]
    C --> D["4. Exploitation"]
    D --> E["5. Reporting"]
    E --> F["6. Retrospective"]
    
    A -.->|"clarify"| G("Approval Gate")
    B -.->|"guard check"| G
    C -.->|"guard check"| G
    D -.->|"clarify + guard"| G

    style A fill:#1a1a2e,stroke:#e94560,stroke-width:2px
    style B fill:#16213e,stroke:#0f3460,stroke-width:2px
    style C fill:#1a1a2e,stroke:#e94560,stroke-width:2px
    style D fill:#16213e,stroke:#0f3460,stroke-width:2px
    style E fill:#1a1a2e,stroke:#e94560,stroke-width:2px
    style F fill:#16213e,stroke:#0f3460,stroke-width:2px
    style G fill:#2d2d2d,stroke:#ffd700,stroke-width:2px

Архитектура

graph TB
    subgraph "Your Machine"
        HE["Hermes Agent"]
        VI["Violin Profile"]
        GUARD["violin_guard execution + evidence"]
    end
    
    subgraph "Violin Skills"
        SK["pentest orchestrator"]
        WEB["web-attacks skill"]
        AC["access-control skill"]
        PB["31 Playbooks"]
        REF["10 References"]
        TEMP["11 Templates"]
    end
    
    subgraph "Configured Toolsets"
        T["terminal"]
        W["web"]
        B["browser"]
        F["file"]
        CE["code_execution"]
        S["skills"]
        CL["clarify"]
        D["delegation"]
        V["vision"]
        TD["todo"]
        VG["violin_guard"]
    end
    
    LLM["Your LLM Provider"]
    
    HE -->|"hermes -p violin"| VI
    VI -->|"loads"| SK
    VI -->|"requires"| GUARD
    SK -->|"routes to"| WEB & AC & PB
    WEB --> PB
    AC --> PB
    SK --> REF & TEMP
    HE -->|"calls"| T & W & B & F & CE & S & CL & D & V & TD & VG
    HE -->|"inherits"| LLM

    style HE fill:#2d2d2d,stroke:#ffd700,stroke-width:2px
    style VI fill:#1a1a2e,stroke:#e94560,stroke-width:2px
    style GUARD fill:#16213e,stroke:#0f3460,stroke-width:2px

Включённые наборы инструментов

11 наборов инструментов, настроенных в config.yaml (platform_toolsets.cli): 10 встроенных — terminal, web, browser, file, code_execution, skills, todo, clarify, delegation, vision — плюс набор инструментов guard-плагина violin_guard.

Изоляция беседы и памяти

• memory.memory_enabled: false — нет глобального чтения/записи памяти
• memory.user_profile_enabled: false — нет глобального доступа к профилю пользователя
• Непрерывность вовлечения хранится в файлах проекта (документы по scope, доказательства, отчёты)
• Ведите одну беседу Hermes на каждое вовлечение; после сжатия продолжайте в той же беседе, начиная с $ENG_DIR/state/

Модель безопасности

flowchart LR
    subgraph "Layer 1"
        A["9 Scoping Questions"]
        B["Written Authorisation"]
    end
    subgraph "Layer 2"
        C["violin_guard.py validate-scope"]
    end
    subgraph "Layer 3"
        D["violin_guard.py check-command"]
    end
    subgraph "Layer 4"
        E["clarify approval gate"]
    end
    subgraph "Layer 5"
        F["Standards & Blocked Actions"]
    end
    
    A --> B --> C --> D --> E --> F

• Только авторизованное тестирование — никакого зондирования до завершения определения границ
• Шлюзы одобрения — определение scope, активная разведка и эксплуатация требуют явного одобрения пользователя
• Guard-проверка — каждая команда, затрагивающая цель, проверяется через violin_exec или другой типизированный guard-инструмент. У violin_exec нет бинарного allowlist, поэтому любой установленный неинтерактивный CLI-инструмент Kali/Parrot может нацеливаться на явно указанный хост в пределах scope, пока действуют те же ограничители: scope, фаза, PTT, гипотеза, история, доказательства, таймаут и синхронизация. Хук плагина pre_tool_call в Violin универсально блокирует целевые литералы в сырых командах terminal вместо поддержания неполного списка имён инструментов. CLI предоставляет ту же проверку для диагностики (код выхода 0=разрешено, 1=заблокировано, 2=на ревью)
• Неразрушающий по умолчанию — эксплуатация ограничена безопасными, воспроизводимыми PoC
• Сначала доказательства — каждая находка подкреплена воспроизводимым выводом инструментов, скриншотами, парами запрос/ответ
• Валидация эксплойтом в первую очередь — ни одна гипотеза не переходит в статус Validated без команды проверки
• Восстановление с сохранением состояния — сводки по фазам и контрольные точки восстанавливают текущее вовлечение после сжатия контекста без начала новой беседы
• Самодокументирующийся guard — violin_status (или python scripts/violin_guard.py status --eng-dir "$ENG_DIR") показывает активную задачу и фазу, ожидающие команды и требуемые для них фазы, требования фаз, состояние навыков, блокировки и точные следующие действия без выполнения команд

Полная политика безопасности: skills/pentest/references/standards.md. Запрещённые действия: .hermes.md §Forbidden Behaviour.

Структура репозитория

violin/
├── .hermes.md              # Project-level agent context
├── SOUL.md                 # Agent identity — senior pentester persona
├── config.yaml             # Profile config (toolsets, safety, memory)
├── distribution.yaml       # Hermes distribution manifest
├── plugins/violin_guard/   # Required Hermes guard plugin and execution boundary
│   ├── bash_ast.py         # bashlex AST command tokenization and parsing
│   ├── terminal_policy.py  # AST-based best-effort blocks for target-touching raw terminal calls
│   ├── targets.py          # Scope enforcement using netaddr and yarl URL parsing
│   ├── schemas.py          # Pydantic v2 tool schemas and validation
│   └── code_execution_audit.py # Engagement audit contract for execute_code
├── scripts/                # CLI and release smoke helpers
│   ├── violin_guard.py     # Diagnostic/admin CLI over the plugin modules
│   ├── smoke-test.sh       # Linux/macOS release smoke
│   ├── smoke-test.ps1      # Windows supplemental smoke
│   └── kali.sh             # Docker Kali helper
└── skills/
    ├── pentest/            # Engagement orchestrator (23 playbooks, 10 refs, 11 templates)
    │   ├── SKILL.md
    │   ├── playbooks/      # 7 operational + 16 vulnerability-class playbooks
    │   ├── references/     # 10 reference files
    │   └── templates/      # 11 templates (reports, evidence, methodology, contracts)
    ├── web-attacks/        # Routed skill — 5 injection/web playbooks (SQLi, XSS, SSRF, cmdi, traversal)
    └── access-control/     # Routed skill — 3 auth/authorisation playbooks (auth-bypass, IDOR, JWT)

Проверка релиза

python scripts/violin_guard.py check-release

Проверяет манифест плагина и зарегистрированные инструменты, изолированный импорт плагина в стиле Hermes, устаревшие ссылки на навыки, Ruff и полный набор pytest.

Навыки Hermes загружаются по требованию и контролируются квитанциями Violin. Начните с pentest, затем используйте violin_record_ptt, чтобы выбрать навык, требуемый маршрутом. Первый вызов подготавливает реальное содержимое skill_view без изменения PTT; повторите тот же переход после того, как результат этого инструмента вернётся в модель, чтобы закрепить его. violin_status сообщает маршрут, привязку, генерацию контекста, действие по восстановлению и любые устаревшие legacy-маркеры. Активность по целям и браузеру блокируется только в том же вызове модели, что и доставка или привязка, а затем автоматически открывается при следующем продолжении цикла инструментов.

Опционально: Docker-контейнер Kali

docker pull kalilinux/kali-rolling
docker create -it --name kali-pentest \
  -v /path/to/violin/engagements:/engagements \
  kalilinux/kali-rolling bash
docker start kali-pentest
docker exec kali-pentest apt update
docker exec kali-pentest apt install -y kali-linux-headless

Участие в разработке

См. CONTRIBUTING.md: настройка окружения для разработки, процесс PR и стиль кода.

Безопасность

См. SECURITY.md: порядок сообщения об уязвимостях.

Лицензия

MIT — см. LICENSE.