Затем начните с локальной лаборатории, CTF, собственного приложения или авторизованной цели.```text
/doctor
/mode appsec
/runbook run appsec-web-triage http://localhost:3000
/share

Важная часть: операция не существует только в чате. numasec сохраняет долговечную запись работы, чтобы агент мог продолжить, оператор мог просмотреть, а отчет мог основываться на том, что на самом деле произошло.

## Чем numasec отличается

Большинство инструментов ИБ на основе ИИ попадают в одну из двух ловушек: они либо только говорят, либо только оборачивают инструменты. numasec пытается сделать нечто иное: поддерживать рабочий процесс активным, пока агент работает.

| Сравнение с | Что обычно происходит | Что делает numasec |
| --- | --- | --- |
| **Обычные AI-чаты** | Хорошие советы, но оторванные от реальной работы. | Работает внутри терминального рабочего процесса с инструментами, памятью и состоянием операции. |
| **Обычные агенты кодирования** | Отлично подходят для репозиториев и тестов, но не ориентированы на работу в области безопасности. | Добавляет агентов безопасности, runbook'и, область охвата, находки, доказательства, воспроизведение и отчеты. |
| **Обертки сканеров** | Быстрый вывод, слабый контекст. | Превращает вывод инструментов в часть более крупной операции. |
| **Ручные заметки** | Гибко, но все расползается. | Удерживает находки, доказательства, воспроизведение и отчеты связанными. |
| **Серверы инструментов** | Предоставляют возможности, но оставляют рабочий процесс и память пользователю. | Добавляет рабочий процесс безопасности вокруг инструментов. |

## Команды

numasec создан для быстрой работы с клавиатуры: запустить операцию, переключить агентов, запустить рабочие процессы, проверить инструменты, усилить opsec, экспортировать работу и вернуться позже.```text
/doctor                        inspect local tool readiness
/mode appsec                   switch to the AppSec agent
/mode pentest                  switch to the Pentest agent
/agents                        open the agent switcher
/runbook list                  show available security workflows
/runbook run appsec-web-triage <target>
/runbook run web-surface <target>
/operations                    inspect, rename, resume or switch operations
/opsec strict                  tighten operation boundaries
/models                        switch provider or model
/share                         export the active operation bundle
/remediate <observation_id>    turn an observation into remediation guidance
/pwn <target>                  create a scoped pentest operation for a target

### Bun```bash
bun add -g numasec
numasec

### Из исходного кода```bash
git clone https://github.com/FrancescoStabile/numasec.git
cd numasec
bun install
cd packages/numasec
bun run build

Используйте `/doctor`, чтобы узнать, что доступно, работает с пониженной функциональностью или отсутствует на текущей машине.

## Модели и провайдеры

Используйте модель, которой доверяете. numasec не зависит от модели и оборачивает выбранную вами модель в рабочий процесс безопасности: терминал, инструменты, агенты, руководства действий, память операций, выводы, доказательства и отчёты.

Поддерживаемые семейства провайдеров включают OpenAI, Anthropic, Google, xAI, Bedrock, OpenRouter, Ollama, Vercel AI Gateway, совместимые с OpenAI конечные точки и других провайдеров, поддерживаемых через локальный стек моделей.

Смысл не в том, что одна модель магическим образом решает задачи безопасности. Смысл в том, что хорошие модели становятся гораздо полезнее, когда они работают в правильной среде безопасности.

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

numasec оборачивает модель в рабочий процесс безопасности. Модель может рассуждать и действовать; numasec хранит операционный контекст вокруг неё: инструменты, руководства действий, события, факты, доказательства, воспроизведение, выводы и результаты.```mermaid
flowchart TB
  operator["Operator"] --> console["Terminal console"]
  console --> control["Permissioned / auto execution"]
  control --> agents["Cyber agents"]
  agents --> runbooks["Runbooks"]

  subgraph tool_layer["Tool layer"]
    browser["Browser"]
    http["HTTP"]
    scanner["Scanner"]
    shell["Shell"]
    knowledge["Knowledge broker"]
    vault["Vault"]
  end

  runbooks --> browser
  runbooks --> http
  runbooks --> scanner
  runbooks --> shell
  runbooks --> knowledge
  runbooks --> vault

  subgraph kernel["Cyber operation kernel"]
    ledger["Ledger"]
    facts["Facts"]
    relations["Relations"]
    evidence["Evidence"]
    replay["Replay"]
    workflow["Workflow"]
  end

  browser --> evidence
  http --> evidence
  scanner --> evidence
  shell --> evidence
  knowledge --> facts
  vault --> facts

  ledger --> facts
  facts --> relations
  evidence --> replay
  facts --> workflow

  facts --> lifecycle["Finding lifecycle"]
  relations --> lifecycle
  replay --> lifecycle
  workflow --> deliverables["Reports / share bundles / remediation"]
  lifecycle --> deliverables

  classDef top fill:#04130d,stroke:#00ff88,color:#eafff4,stroke-width:2px;
  classDef tool fill:#061014,stroke:#00c2ff,color:#eaf9ff,stroke-width:1.5px;
  classDef state fill:#0b0f0a,stroke:#7affb2,color:#eafff4,stroke-width:1.5px;
  classDef proofNode fill:#151104,stroke:#ffcc66,color:#fff7df,stroke-width:1.5px;
  classDef findingNode fill:#190808,stroke:#ff5f6d,color:#fff0f0,stroke-width:1.5px;

  class operator,console,control,agents,runbooks top;
  class browser,http,scanner,shell,knowledge,vault tool;
  class ledger,facts,relations,workflow state;
  class evidence,replay,deliverables proofNode;
  class lifecycle findingNode;

Модели разрешено исследовать. Рабочий процесс не должен выдавать каждую идею за находку.

### Плейбуки вместо случайного спама инструментов

Агенты безопасности становятся шумными, когда могут вызывать инструменты без рабочего процесса. numasec использует плейбуки, чтобы направлять агента через узнаваемую форму задачи: картирование поверхности, триаж AppSec, ограниченный пенттест и будущие доменно-специфические рабочие процессы.

Самые сильные сегодня:

- `appsec-web-triage`
- `web-surface`
- `pwn` / начальный поток пенттеста

Поверхности с меткой зрелости:

- триаж AppSec репозитория
- работа с API и поверхностью аутентификации
- работа с сетевой поверхностью
- работа с целью OSINT
- CTF и лабораторные рабочие процессы
- облачные, контейнерные, IaC и бинарные триажи

## Создан, чтобы избежать ИИ-безопасностного мусора

numasec построен на простом правиле: **агент может помочь вам двигаться быстрее, но рабочий процесс не должен позволять ему преувеличивать.**

Вот почему numasec отслеживает объем, состояние операции, находки, доказательства, воспроизведение и выходные данные отчета.

Зрелый фокус:

- AppSec
- Пенттест

Другие киберповерхности существуют или планируются, но они пока не позиционируются как одинаково зрелые.

numasec не претендует на замену авторизации, суждения оператора, ручной проверки или специализированных инструментов.

Эта честность — не маркетинговая скромность. Это часть продукта. Инструменты безопасности теряют доверие, когда путают уверенность с доказательством.

## Дорожная карта

Долгосрочное видение простое:

**открытый агент безопасности ИИ, который может расти вместе с сообществом.**

В краткосрочной перспективе numasec сохраняет фокус:

- лучшие рабочие процессы AppSec
- лучшие рабочие процессы пенттеста
- более мощные адаптеры локальных инструментов
- более качественный захват доказательств и воспроизведения
- более чистая генерация отчетов
- более полезные агенты
- лучшее совместное использование операций
- более четкие метки зрелости

В долгосрочной перспективе:

- рабочие процессы OSINT с происхождением
- CTF и лабораторные рабочие процессы
- облачный, контейнерный и IaC триаж
- командные операции
- проверка и передача
- более богатые пакеты знаний
- сообщественные плейбуки

Правило остается прежним: каждый зрелый домен нуждается в реальной поддержке рабочего процесса, а не просто в подсказке.

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

- [Операции](https://github.com/francescostabile/numasec/blob/HEAD/docs/OPERATIONS.md)
- [Справка по инструментам](https://github.com/francescostabile/numasec/blob/HEAD/docs/TOOLS.md)
- [Формат файла операции](https://github.com/francescostabile/numasec/blob/HEAD/docs/NUMASEC_FILE_FORMAT.md)
- [Журнал изменений](https://github.com/francescostabile/numasec/blob/HEAD/CHANGELOG.md)
- [Внесение вклада](https://github.com/francescostabile/numasec/blob/HEAD/CONTRIBUTING.md)
- [Безопасность](https://github.com/francescostabile/numasec/blob/HEAD/SECURITY.md)

## Разработка```bash
bun install
bun typecheck

cd packages/numasec
bun test --timeout 30000
bun run build

Не запускайте тесты пакетов из корня репозитория. numasec использует Bun-first на уровне пакетов.

## Участие

Наиболее ценные вклады делают numasec лучшим оператором:

- runbooks с чёткой областью действия и семантикой доказательств;
- парсеры, преобразующие вывод инструментов в факты с обоснованием происхождения;
- адаптеры для реальных инструментов безопасности;
- сценарии бенчмарков, которые сложно подделать;
- шаблоны отчётов, снижающие завышение результатов;
- доработка TUI, упрощающая чтение операций в условиях стресса.

Если изменение создаёт подтверждённое утверждение безопасности, оно требует доказательств. Если находка подлежит отчёту, она требует повторного воспроизведения или структурированного исключения.

## Сообщество

Лучший отзыв — это не «крутой проект».

Лучший отзыв:

- я попробовал его на таком-то авторизованном рабочем процессе
- эта часть ускорила меня
- эта часть мешала мне
- этот инструмент следует лучше поддерживать
- этот runbook должен существовать
- этот поток находок показался неправильным
- этот вывод отчёта был полезным или бесполезным

Используйте GitHub issues и discussions для сообщений об ошибках, отзывов о рабочих процессах, идей runbook, адаптеров и вопросов о релизах.

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

## Помогите сформировать numasec

numasec находится на ранней стадии, но направление ясно:

**сделать работу по безопасности более быстрой, точной и менее разрозненной с помощью AI-агента, который живёт в терминале.**

Если это кажется полезным, поставьте звезду репозиторию, попробуйте на авторизованном рабочем процессе и расскажите, где он ломается.

## Лицензия

[GNU Affero General Public License v3.0 или более поздняя](https://github.com/francescostabile/numasec/blob/HEAD/LICENSE). Используйте numasec для авторизованной работы по безопасности, исследований, обучения и оборонительных операций.

<p align="center">
  Создано <a href="https://www.linkedin.com/in/francesco-stabile-dev">Francesco Stabile</a>
  | <a href="https://x.com/Francesco_Sta">@Francesco_Sta</a>
  <br/><sub>Если numasec помогает вам, <a href="https://github.com/FrancescoStabile/numasec/stargazers">поставьте звезду</a> и поделитесь рабочим процессом.</sub>
</p>