CodeReview/README.md

9.8 KiB
Raw Blame History

DeepAudit - AI 驱动的智能代码安全审计平台 🛡️

DeepAudit Logo

Version License: MIT React TypeScript FastAPI Python Ask DeepWiki

Stars Forks

🚀 v3.0.0 新特性

DeepAudit v3.0.0 带来了革命性的 Multi-Agent 智能审计系统

  • 🤖 Multi-Agent 架构 — Orchestrator 编排决策Analysis/Recon/Verification 多智能体协作
  • 🧠 RAG 知识库增强 — 代码语义理解 + CWE/CVE 漏洞知识库,精准识别安全风险
  • 🔒 沙箱漏洞验证 — Docker 安全容器自动执行 PoC验证漏洞真实有效性
  • 🛠️ 专业安全工具集成 — Semgrep、Bandit、Gitleaks、TruffleHog、OSV-Scanner

💡 这是什么?

你是否也有这样的困扰?

  • 😫 人工审计的无力:哪怕我不吃不睡,也追不上代码迭代的速度
  • 🤯 传统工具的噪音:每天都在清理误报,感觉自己像个垃圾分类员
  • 😰 代码隐私的风险:想用 AI 却不敢"裸奔",生怕源码泄露给云端
  • 🥺 外包项目的隐患:不知道里面藏了多少雷,却不得不签字验收

DeepAudit 来拯救你! 🦸‍♂️

  • 全自动智能审计AI 驱动的 Multi-Agent 系统自主编排审计策略
  • 上下文精准理解RAG 增强的代码语义理解,大大降低误报率
  • 沙箱验证漏洞:自动生成 PoC 并在隔离环境验证,确保漏洞真实有效
  • 支持本地私有部署:支持 Ollama 本地模型,代码数据可以不出内网

🎬 眼见为实:

智能仪表盘 即时分析
仪表盘 即时分析
一眼掌握项目安全态势 粘贴代码/上传文件,秒出结果
Agent 审计 审计报告
Agent审计 审计报告
Multi-Agent 深度安全分析 专业报告,一键导出
审计规则管理 提示词模板管理
审计规则 提示词管理
内置 OWASP Top 10支持自定义规则 提示词可视化管理,支持在线测试

为什么选择我们?

🤖 Multi-Agent 智能协作

  • Orchestrator Agent: 统筹编排,自主决策审计策略
  • Recon Agent: 信息收集,识别技术栈和入口点
  • Analysis Agent: 深度分析,挖掘潜在安全漏洞
  • Verification Agent: 沙箱验证,确认漏洞真实有效

🧠 RAG 知识库增强

  • 代码语义理解,不只是关键词匹配
  • CWE/CVE 漏洞知识库集成
  • 精准漏洞识别,大幅降低误报

🎯 What-Why-How 三步修复

  • What: 精准定位问题所在
  • Why: 解释为什么这是个问题
  • How: 给出可直接使用的修复建议

🔒 沙箱安全验证

  • Docker 隔离容器执行 PoC
  • 资源限制 + 网络隔离 + seccomp 策略
  • 自动验证漏洞可利用性

🛠️ 专业安全工具集成

  • Semgrep: 多语言静态分析
  • Bandit: Python 安全扫描
  • Gitleaks/TruffleHog: 密钥泄露检测
  • OSV-Scanner: 依赖漏洞扫描

🔌 10+ LLM 平台任你选

OpenAI、Claude、Gemini、通义千问、DeepSeek、智谱AI... 还支持 Ollama 本地私有化部署!

🚀 快速开始

Docker Compose 一键部署(推荐)

# 1⃣ 克隆项目
git clone https://github.com/lintsinghua/DeepAudit.git && cd DeepAudit

# 2⃣ 配置你的 LLM API Key
cp backend/env.example backend/.env
# 编辑 backend/.env填入你的 API Key

# 3⃣ 一键启动!
docker compose up -d

🎉 搞定! 打开 http://localhost:3000 开始体验吧!

Agent 审计模式部署(可选)

如需使用 Multi-Agent 深度审计功能:

# 启动包含 Milvus 向量数据库的完整服务
docker compose --profile agent up -d

# 构建安全沙箱镜像(用于漏洞验证)
cd docker/sandbox && ./build.sh

演示账户

系统内置演示账户,包含示例项目和审计数据:

  • 📧 邮箱:demo@example.com
  • 🔑 密码:demo123

⚠️ 生产环境请删除演示账户或修改密码!

📖 更多部署方式请查看 部署指南

核心能力

功能 说明
🤖 Agent 审计 Multi-Agent 架构Orchestrator 自主编排决策,深度漏洞挖掘
🧠 RAG 增强 代码语义理解CWE/CVE 知识库检索,精准漏洞识别
🔒 沙箱验证 Docker 安全容器执行 PoC自动验证漏洞有效性
🗂️ 项目管理 GitHub/GitLab 一键导入ZIP 上传,支持 10+ 编程语言
即时分析 代码片段秒级分析,粘贴即用,无需创建项目
🔍 智能审计 Bug、安全、性能、风格、可维护性五维检测
💡 可解释分析 What-Why-How 模式,精准定位 + 修复建议
📋 审计规则 内置 OWASP Top 10、代码质量、性能优化规则集
📝 提示词模板 可视化管理审计提示词,支持中英文双语
📊 可视化报告 质量仪表盘、趋势分析、PDF/JSON 一键导出
⚙️ 灵活配置 浏览器运行时配置 LLM无需重启服务

🤖 支持的 LLM 平台

类型 平台
🌍 国际平台 OpenAI GPT · Claude · Gemini · DeepSeek
🇨🇳 国内平台 通义千问 · 智谱AI · Kimi · 文心一言 · MiniMax · 豆包
🏠 本地部署 Ollama (Llama3, CodeLlama, Qwen2.5, DeepSeek-Coder...)

💡 支持 API 中转站,解决网络访问问题

详细配置请查看 LLM 平台支持

🎯 未来蓝图

已完成

  • RAG 知识库 — 代码语义理解 + CWE/CVE 漏洞知识库集成
  • 多 Agent 协作 — Orchestrator/Analysis/Recon/Verification 多智能体架构
  • 沙箱验证 — Docker 安全容器自动执行 PoC 验证

🚧 开发中

  • 🔄 CI/CD 集成 — GitHub/GitLab 流水线自动审计PR 批量扫描
  • 🔄 自动生成补丁 — 基于漏洞分析自动生成修复代码
  • 🔄 跨文件分析 — 代码知识图谱,理解模块间调用关系

📋 计划中

  • 📋 混合分析 — AI 分析 + 传统 SAST 工具验证,减少误报漏报
  • 📋 多仓库支持 — Gitea、Bitbucket 等更多平台支持

💡 您的 Star 和反馈是我们前进的最大动力!有任何想法欢迎提 Issue 一起讨论~

📚 文档

文档 说明
部署指南 Docker 部署 / 本地开发环境搭建
Agent 审计 Multi-Agent 审计模块详解
配置说明 后端配置、审计规则、提示词模板
LLM 平台支持 各家 LLM 的配置方法和 API Key 获取
安全工具设置 安全扫描工具本地安装指南
常见问题 遇到问题先看这里
更新日志 版本更新记录
贡献指南 想参与开发?看这个
安全政策 / 免责声明 使用前建议读一下

🤝 贡献

开源项目离不开社区的支持!无论是提 Issue、贡献代码还是分享使用心得都非常欢迎。

有想和我一起让工具变得更好的佬友们,欢迎联系我,和我一起为开源做一点贡献

感谢每一位贡献者!

Contributors

📞 联系我们


如果这个项目对你有帮助,请给我们一个 Star
你的支持是我们持续迭代的最大动力 💪

📈 项目统计

Star History Chart


⚠️ 使用前请阅读 安全政策免责声明

Made with ❤️ by lintsinghua