---

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

### Способ 1: Развертывание одной командой (рекомендуется)

Используйте предварительно собранный образ Docker, не нужно клонировать код, запуск одной командой:```bash
curl -fsSL https://raw.githubusercontent.com/lintsinghua/DeepAudit/v3.0.0/docker-compose.prod.yml | docker compose -f - up -d

<details>
<summary>Ручное получение образа (при необходимости отдельного получения) (нажмите, чтобы развернуть)</summary>```bash
# 前端镜像
docker pull ghcr.nju.edu.cn/lintsinghua/deepaudit-frontend:latest

# 后端镜像
docker pull ghcr.nju.edu.cn/lintsinghua/deepaudit-backend:latest

# 沙箱镜像
docker pull ghcr.nju.edu.cn/lintsinghua/deepaudit-sandbox:latest

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

---

## 🔧 Руководство по разработке из исходного кода

Подходит для разработчиков для вторичной разработки и отладки.

### Требования к окружению
- Python 3.11+
- Node.js 20+
- PostgreSQL 15+
- Docker (для песочницы)

### 1. Ручной запуск базы данных```bash
docker compose up -d redis db adminer

### 3. Запуск фронтенда```bash
cd frontend
# 配置环境
cp .env.example .env

pnpm install
pnpm dev

---

## 🤖 Многоагентный интеллектуальный аудит

### Поддерживаемые типы уязвимостей

<table>
<tr>
<td>

| Тип уязвимости | Описание |
|---------|------|
| `sql_injection` | SQL-инъекция |
| `xss` | Межсайтовый скриптинг |
| `command_injection` | Инъекция команд |
| `path_traversal` | Обход пути |
| `ssrf` | Подделка серверных запросов |
| `xxe` | Внешняя сущность XML |

</td>
<td>

| Тип уязвимости | Описание |
|---------|------|
| `insecure_deserialization` | Небезопасная десериализация |
| `hardcoded_secret` | Жёстко заданный секрет |
| `weak_crypto` | Слабые криптографические алгоритмы |
| `authentication_bypass` | Обход аутентификации |
| `authorization_bypass` | Обход авторизации |
| `idor` | Небезопасная прямая ссылка на объект |

</td>
</tr>
</table>

> 📖 Подробную документацию см. в **[Руководство по аудиту агента](https://github.com/lintsinghua/deepaudit/blob/HEAD/docs/AGENT_AUDIT.md)**

---

## 🔌 Поддерживаемые LLM-платформы

<table>
<tr>
<td align="center" width="33%">
<h3>🌍 Международные платформы</h3>
<p>
OpenAI GPT-4o / GPT-4<br/>
Claude 3.5 Sonnet / Opus<br/>
Google Gemini Pro<br/>
DeepSeek V3
</p>
</td>
<td align="center" width="33%">
<h3>🇨🇳 Китайские платформы</h3>
<p>
Tongyi Qianwen Qwen<br/>
Zhipu GLM-4<br/>
Moonshot Kimi<br/>
Wenxin Yiyan · MiniMax · Doubao
</p>
</td>
<td align="center" width="33%">
<h3>🏠 Локальное развертывание</h3>
<p>
<strong>Ollama</strong><br/>
Llama3 · Qwen2.5 · CodeLlama<br/>
DeepSeek-Coder · Codestral<br/>
<em>Код не покидает внутреннюю сеть</em>
</p>
</td>
</tr>
</table>

💡 Поддержка API-прокси для решения проблем с сетевым доступом | Подробная конфигурация → [Поддержка LLM-платформ](https://github.com/lintsinghua/deepaudit/blob/HEAD/docs/LLM_PROVIDERS.md)

---

## 🎯 Матрица функций

| Функция | Описание | Режим |
|------|------|------|
| 🤖 **Глубокий аудит агента** | Сотрудничество нескольких агентов, самостоятельная оркестрация стратегии аудита | Agent |
| 🧠 **Усиление знаний с помощью RAG** | Понимание семантики кода, поиск по базе знаний CWE/CVE | Agent |
| 🔒 **Проверка PoC в песочнице** | Изолированное выполнение в Docker, проверка действенности уязвимости | Agent |
| 🗂️ **Управление проектами** | Импорт из GitHub/GitLab/Gitea, загрузка ZIP, поддержка 10+ языков | Общий |
| ⚡ **Мгновенный анализ** | Анализ фрагментов кода за секунды, вставь и используй | Общий |
| 🔍 **Пятимерное обнаружение** | Ошибки · Безопасность · Производительность · Стиль · Сопровождаемость | Общий |
| 💡 **What-Why-How** | Точное определение + объяснение причины + рекомендации по исправлению | Общий |
| 📋 **Правила аудита** | Встроенный OWASP Top 10, поддержка пользовательских наборов правил | Общий |
| 📝 **Шаблоны подсказок** | Визуальное управление, поддержка двух языков (китайский/английский) | Общий |
| 📊 **Экспорт отчетов** | Экспорт PDF / Markdown / JSON одним нажатием | Общий |
| ⚙️ **Конфигурация во время выполнения** | Настройка LLM в браузере, без перезапуска службы | Общий |

## 🦖 Дорожная карта развития

Мы продолжаем развиваться, в будущем будет поддерживаться больше языков и более мощные возможности агентов.

- [x] Базовый статический анализ, интеграция Semgrep
- [x] Внедрение базы знаний RAG, поддержка безопасной песочницы Docker
- [x] **Архитектура совместной работы нескольких агентов** (Текущая)
- [ ] Поддержка более реалистичной имитации сервисной среды для более достоверного процесса проверки уязвимостей
- [ ] Оптимизация песочницы с function_call до интеграции в стабильный MCP-сервис
- [ ] **Автоисправление (Auto-Fix)**: Агент напрямую отправляет PR для исправления уязвимости
- [ ] **Инкрементальный аудит PR**: Непрерывное отслеживание изменений PR, интеллектуальный анализ уязвимостей и интеграция с CI/CD
- [ ] **Оптимизация RAG**: Поддержка пользовательских баз знаний

---

## 🤝 Вклад и сообщество

### Руководство по внесению вклада
Мы приветствуем ваш вклад! Будь то отправка Issue, PR или доработка документации.
Подробнее см. в [CONTRIBUTING.md](https://github.com/lintsinghua/deepaudit/blob/HEAD/CONTRIBUTING.md).

### 📬 Связаться с автором

<div align="center">

**Приглашаю всех к общению и обсуждению! Будь то технические вопросы, предложения по функциям или намерение сотрудничать, жду общения с вами~**
(Платформенная настройка, услуги аудита кода, технические консультации, переговоры о сотрудничестве — пожалуйста, связывайтесь по электронной почте)

| Контактная информация | |
|:---:|:---:|
| 📧 **Почта** | **[email protected]** |
| 🐙 **GitHub** | [@lintsinghua](https://github.com/lintsinghua) |

</div>

## 📄 Лицензия

Этот проект с открытым исходным кодом под лицензией [AGPL-3.0 License](https://github.com/lintsinghua/deepaudit/blob/HEAD/LICENSE).

## 📈 Популярность проекта

<a href="https://star-history.com/#lintsinghua/DeepAudit&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=lintsinghua/DeepAudit&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=lintsinghua/DeepAudit&type=Date" />
   <img alt="Star History Chart" src="https://assets.kitploit.com/production/public/readmes/placeholders/f0fc86cfe65f76d40e15aaec61704ec8220a56dc89d4be03c46f67cb31b9fa8c.svg" />
 </picture>
</a>

---

<div align="center">
  <strong>Сделано с ❤️ от <a href="https://github.com/lintsinghua">lintsinghua</a></strong>
</div>

---

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

Благодарим за поддержку следующие проекты с открытым исходным кодом:

[FastAPI](https://fastapi.tiangolo.com/) · [LangChain](https://langchain.com/) · [LangGraph](https://langchain-ai.github.io/langgraph/) · [ChromaDB](https://www.trychroma.com/) · [LiteLLM](https://litellm.ai/) · [Tree-sitter](https://tree-sitter.github.io/) · [Kunlun-M](https://github.com/LoRexxar/Kunlun-M) · [Strix](https://github.com/usestrix/strix) · [React](https://react.dev/) · [Vite](https://vitejs.dev/) · [Radix UI](https://www.radix-ui.com/) · [TailwindCSS](https://tailwindcss.com/) · [shadcn/ui](https://ui.shadcn.com/)

---

## ⚠️ Важное заявление о безопасности

### Заявление о соответствии законодательству
1. Запрещено** любое несанкционированное тестирование уязвимостей, пентесты или оценка безопасности**
2. Данный проект предназначен только для академических исследований, обучения и изучения кибербезопасности
3. Строго запрещено использовать этот проект в любых незаконных целях или для несанкционированного тестирования безопасности

### Ответственность за сообщение об уязвимостях
1. При обнаружении любой уязвимости безопасности, пожалуйста, своевременно сообщайте через легальные каналы
2. Строго запрещено использовать обнаруженные уязвимости для незаконной деятельности
3. Соблюдайте национальные законы и нормативные акты в области кибербезопасности, поддерживайте безопасность киберпространства

### Ограничения использования
- Только для образовательных и исследовательских целей в авторизованной среде
- Запрещено использовать для тестирования безопасности неавторизованных систем
- Пользователь несет полную юридическую ответственность за свои действия

### Отказ от ответственности
Автор не несет ответственности за любые прямые или косвенные убытки, возникшие в результате использования этого проекта. Пользователь несет полную юридическую ответственность за свои действия.

---

## 📖 Подробная политика безопасности

Подробную информацию о политике установки, отказе от ответственности, конфиденциальности кода, безопасности использования API и сообщении об уязвимостях см. в файлах [DISCLAIMER.md](https://github.com/lintsinghua/deepaudit/blob/HEAD/DISCLAIMER.md) и [SECURITY.md](https://github.com/lintsinghua/deepaudit/blob/HEAD/SECURITY.md).

### Краткая справка
- **Предупреждение о конфиденциальности кода**: Ваш код будет отправлен на сервер выбранного LLM-провайдера
- **Обработка конфиденциального кода**: Используйте локальные модели для обработки конфиденциального кода
- **Требования соответствия**: Соблюдайте законы и нормативные акты по защите данных и конфиденциальности
- **Сообщение об уязвимостях**: При обнаружении проблем безопасности сообщайте через легальные каналы