---

## 🚀 Inicio rápido

### Opción 1: Despliegue con un solo comando (recomendado)

Usa la imagen Docker preconstruida, sin necesidad de clonar el código, y se inicia con un solo comando:```bash
curl -fsSL https://raw.githubusercontent.com/lintsinghua/DeepAudit/v3.0.0/docker-compose.prod.yml | docker compose -f - up -d

<details>
<summary>Extraer imagen manualmente (si necesita extraerla por separado) (haga clic para expandir)</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

> Primer inicio construirá automáticamente la imagen de la sandbox, puede tomar unos minutos.

---

## 🔧 Guía de desarrollo del código fuente

Ideal para que los desarrolladores realicen depuración y desarrollo secundario.

### Requisitos del entorno
- Python 3.11+
- Node.js 20+
- PostgreSQL 15+
- Docker (para sandbox)


### 1. Iniciar la base de datos manualmente```bash
docker compose up -d redis db adminer

### 3. Inicio del frontend```bash
cd frontend
# 配置环境
cp .env.example .env

pnpm install
pnpm dev

---

## 🤖 Multi-Agent Audit Inteligente

### Tipos de vulnerabilidades soportadas

<table>
<tr>
<td>

| Tipo de vulnerabilidad | Descripción |
|---------|------|
| `sql_injection` | Inyección SQL |
| `xss` | Cross-Site Scripting |
| `command_injection` | Inyección de comandos |
| `path_traversal` | Path Traversal |
| `ssrf` | Server-Side Request Forgery |
| `xxe` | Inyección de entidad externa XML |

</td>
<td>

| Tipo de vulnerabilidad | Descripción |
|---------|------|
| `insecure_deserialization` | Deserialización insegura |
| `hardcoded_secret` | Secreto hardcodeado |
| `weak_crypto` | Algoritmo criptográfico débil |
| `authentication_bypass` | Bypass de autenticación |
| `authorization_bypass` | Bypass de autorización |
| `idor` | Referencia directa insegura a objetos |

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

> 📖 Para documentación detallada, consulta la **[Guía de Auditoría con Agentes](https://github.com/lintsinghua/deepaudit/blob/HEAD/docs/AGENT_AUDIT.md)**

---

## 🔌 Plataformas LLM compatibles

<table>
<tr>
<td align="center" width="33%">
<h3>🌍 Plataformas internacionales</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>🇨🇳 Plataformas nacionales</h3>
<p>
通义千问 Qwen<br/>
智谱 GLM-4<br/>
Moonshot Kimi<br/>
文心一言 · MiniMax · 豆包
</p>
</td>
<td align="center" width="33%">
<h3>🏠 Despliegue local</h3>
<p>
<strong>Ollama</strong><br/>
Llama3 · Qwen2.5 · CodeLlama<br/>
DeepSeek-Coder · Codestral<br/>
<em>Código nunca sale de la red interna</em>
</p>
</td>
</tr>
</table>

💡 Soporta estación de retransmisión API para solucionar problemas de acceso a la red | Configuración detallada → [Soporte de plataformas LLM](https://github.com/lintsinghua/deepaudit/blob/HEAD/docs/LLM_PROVIDERS.md)

---

## 🎯 Matriz de funcionalidades

| Funcionalidad | Descripción | Modo |
|------|------|------|
| 🤖 **Auditoría profunda con Agent** | Colaboración multi-agente, orquestación autónoma de estrategias de auditoría | Agent |
| 🧠 **Mejora de conocimiento RAG** | Comprensión semántica del código, búsqueda en base de conocimiento CWE/CVE | Agent |
| 🔒 **Validación PoC en sandbox** | Ejecución aislada con Docker, verificación de la validez de la vulnerabilidad | Agent |
| 🗂️ **Gestión de proyectos** | Importación desde GitHub/GitLab/Gitea, subida ZIP, soporte para más de 10 lenguajes | General |
| ⚡ **Análisis instantáneo** | Análisis de fragmentos de código en segundos, pegar y usar | General |
| 🔍 **Detección en cinco dimensiones** | Bugs · Seguridad · Rendimiento · Estilo · Mantenibilidad | General |
| 💡 **Qué-Por qué-Cómo** | Localización precisa + explicación de la causa + sugerencias de reparación | General |
| 📋 **Reglas de auditoría** | OWASP Top 10 integrado, compatible con conjuntos de reglas personalizados | General |
| 📝 **Plantillas de prompts** | Gestión visual, compatible con chino e inglés | General |
| 📊 **Exportación de informes** | Exportación con un clic a PDF / Markdown / JSON | General |
| ⚙️ **Configuración en tiempo de ejecución** | Configurar LLM desde el navegador, sin necesidad de reiniciar el servicio | General |

## 🦖 Hoja de ruta

Estamos evolucionando continuamente; en el futuro se soportarán más lenguajes y capacidades de Agent más potentes.

- [x] Análisis estático básico, integración con Semgrep
- [x] Introducción de base de conocimiento RAG, soporte de sandbox de seguridad Docker
- [x] **Arquitectura de colaboración multi-agente** (Actual)
- [ ] Soporte de entornos de servicio simulados más realistas para flujos de verificación de vulnerabilidades más reales
- [ ] Optimizar el sandbox de `function_call` a un servicio MCP estable e integrado
- [ ] **Auto-reparación (Auto-Fix)**: El Agent envía directamente un PR para corregir la vulnerabilidad
- [ ] **Auditoría incremental de PR**: Seguimiento continuo de cambios en PR, análisis inteligente de vulnerabilidades e integración en el flujo CI/CD
- [ ] **Optimización de RAG**: Soporte de base de conocimiento personalizada

---

## 🤝 Contribuciones y comunidad

### Guía de contribución
¡Nos encanta tu contribución! Ya sea enviando un Issue, un PR o mejorando la documentación.
Consulta [CONTRIBUTING.md](https://github.com/lintsinghua/deepaudit/blob/HEAD/CONTRIBUTING.md) para más detalles.

### 📬 Contacto del autor

<div align="center">

**¡Todos son bienvenidos a conversar e intercambiar ideas conmigo! Ya sea sobre temas técnicos, sugerencias de funcionalidades o intenciones de colaboración, espero comunicarme contigo~**
(Personalización de plataforma, servicios de auditoría de código, consultoría técnica, colaboración comercial, etc., contáctame por correo electrónico)
| Método de contacto | |
|:---:|:---:|
| 📧 **Correo electrónico** | **[email protected]** |
| 🐙 **GitHub** | [@lintsinghua](https://github.com/lintsinghua) |

</div>

## 📄 Licencia

Este proyecto se distribuye bajo la [Licencia AGPL-3.0](https://github.com/lintsinghua/deepaudit/blob/HEAD/LICENSE).

## 📈 Popularidad del proyecto

<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>Hecho con ❤️ por <a href="https://github.com/lintsinghua">lintsinghua</a></strong>
</div>

---

## Agradecimientos

Agradecemos el apoyo de los siguientes proyectos de código abierto:

[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/)

---

## ⚠️ Aviso de seguridad importante

### Declaración de cumplimiento legal
1. Se prohíbe **cualquier prueba de vulnerabilidades, prueba de penetración o evaluación de seguridad no autorizada**
2. Este proyecto está destinado exclusivamente a la investigación académica, la enseñanza y el aprendizaje en ciberseguridad
3. Está estrictamente prohibido utilizar este proyecto con fines ilegales o para pruebas de seguridad no autorizadas

### Responsabilidad de reporte de vulnerabilidades
1. Si se descubre alguna vulnerabilidad de seguridad, repórtala de inmediato a través de canales legales
2. Está estrictamente prohibido explotar las vulnerabilidades descubiertas para actividades ilegales
3. Cumple con las leyes y regulaciones nacionales de ciberseguridad y mantén la seguridad del ciberespacio

### Limitaciones de uso
- Solo para fines educativos y de investigación en entornos autorizados
- Prohibido su uso para pruebas de seguridad en sistemas no autorizados
- El usuario asume toda la responsabilidad legal por sus propias acciones

### Descargo de responsabilidad
El autor no se hace responsable de ningún daño directo o indirecto derivado del uso de este proyecto. El usuario asume toda la responsabilidad legal por sus propias acciones.

---

## 📖 Política de seguridad detallada

Para obtener información detallada sobre la política de instalación, descargo de responsabilidad, privacidad del código, seguridad de uso de API y reporte de vulnerabilidades, consulta los archivos [DISCLAIMER.md](https://github.com/lintsinghua/deepaudit/blob/HEAD/DISCLAIMER.md) y [SECURITY.md](https://github.com/lintsinghua/deepaudit/blob/HEAD/SECURITY.md).

### Referencia rápida
- **Advertencia de privacidad del código**: Tu código será enviado al servidor del proveedor de LLM que elijas
- **Manejo de código sensible**: Usa modelos locales para procesar código sensible
- **Requisitos de cumplimiento**: Cumple con las leyes de protección de datos y privacidad
- **Reporte de vulnerabilidades**: Si encuentras un problema de seguridad, repórtalo a través de canales legales