内容
# ⚡ Devil Agent — 自主人工智能工程操作系统
<div align="center">
**🔥 世界上最先进的自主人工智能代理平台**
基于 NEXUS OS 框架 | Agent Core | MCP Server 架构
[功能](#-革命性功能) • [快速入门](#-快速入门) • [架构](#-架构) • [部署](#-部署) • [贡献](#-贡献)
</div>
---
## 🌟 为什么选择 Devil Agent?
Devil Agent 不仅仅是一个人工智能助手 —— 它是一个 **完全自主的工程操作系统**，将尖端的人工智能能力与生产级可靠性相结合。以下是它的独特之处：
### 🚀 **无与伦比的能力**
- **100% 自主操作** — 自主规划、执行和验证
- **多层推理** — 战略、战术、执行和哨兵层并行运行
- **零回归保证** — 每次更改的自动快照和回滚
- **企业级安全** — OWASP 合规性、CVE 扫描和零信任架构
- **实时学习** — 通过故障模式分析实现持续自我改进
### 💎 **罕见功能**
1. **NEXUS 自主工程系统**
- 4 层认知架构（战略 → 战术 → 执行 → 哨兵）
- 具有自动修复的自愈基础设施
- 量子就绪的加密评估
- 概率发布准备度评分
2. **Agent Core 技能库**
- 100+ 预建专业技能（金融、研究、Web 开发、数据分析）
- Anthropic 撰写的专业技能（PowerPoint、Excel、财务建模）
- 动态技能注入和热交换
- 自定义技能开发框架
3. **MCP（模型上下文协议）服务器**
- 通用 AI 模型集成层
- 支持 Claude、GPT-4、Gemini 和自定义模型
- 上下文感知模型切换
- 具有成本优化的内置速率限制
4. **生产就绪的全栈平台**
- React 19 + TypeScript 前端，搭配 shadcn/ui
- 带有 async/await 模式的 FastAPI 后端
- MongoDB 持久存储
- WebSocket 实时通信
- 基于密钥的身份验证（40 字秘密密钥）
5. **高级安全功能**
- 无用户名/密码 — 仅加密秘密密钥
- 零知识架构
- 自动秘密检测和轮换
- 供应链安全（SBOM + 来源）
- 合规自动化（SOC2、GDPR、HIPAA 就绪）
6. **自我改进的 AI**
- 故障模式库，从错误中学习
- 性能回归检测
- 知识陈旧跟踪
- 功能差距日志记录，用于未来改进
---
## 📚 目录
- [革命性功能](#-革命性功能)
- [快速入门](#-快速入门)
- [架构](#-架构)
- [安装](#-安装)
- [配置](#-配置)
- [用法](#-用法)
- [MCP 服务器](#-mcp-服务器)
- [Agent Core 技能](#-agent-core-技能)
- [NEXUS OS](#-nexus-os-框架)
- [安全](#-安全)
- [部署](#-部署)
- [API 文档](#-api-文档)
- [贡献](#-贡献)
- [故障排除](#-故障排除)
- [许可证](#-许可证)
- [标签](#-标签)
---
## 🎯 革命性功能
### 核心平台功能
| 功能 | 描述 | 状态 |
|---------|-------------|--------|
| **自主规划** | 带有依赖图的多步骤任务分解 | ✅ 生产就绪 |
| **自愈** | 自动错误检测和恢复 | ✅ 生产就绪 |
| **零停机部署** | 蓝绿 + 金丝雀部署策略 | ✅ 生产就绪 |
| **实时监控** | 实时指标、日志和性能跟踪 | ✅ 生产就绪 |
| **成本优化** | 自动调整和资源优化 | ✅ 生产就绪 |
| **安全扫描** | 持续的 CVE 监控和补丁 | ✅ 生产就绪 |
| **混沌工程** | 自动弹性测试 | 🚧 测试中 |
| **量子准备** | 后量子密码学迁移 | 📋 计划中 |
### AI/ML 能力
- **多模型支持**：Claude Opus 4.5、GPT-5.2、Gemini 3 Pro
- **函数调用**：高级工具使用和 API 集成
- **RAG（检索增强生成）**：语义代码库搜索
- **代码生成**：上下文感知代码合成
- **测试生成**：自动单元 + 集成测试创建
- **文档生成**：自动生成的 API 文档和指南
### 开发人员体验
- **热重载**：前端和后端更改自动重载
- **类型安全**：具有严格模式的完整 TypeScript 支持
- ** linting**：ESLint + Prettier，自动修复
- **测试**：Jest + React 测试库 + Playwright
- **CI/CD**：包含的 GitHub Actions 工作流
- **Docker 支持**：具有优化的多阶段构建
---
## 🚀 快速入门
### prerequisites
- **Node.js** 18+ 和 **npm/yarn**
- **Python** 3.9+ 和 **pip**
- **MongoDB** 5.0+
- **Redis** 6.0+（可选，用于缓存）
- **Git**
### 一键安装
```bash
# 克隆仓库
git clone https://github.com/vikrant-project/devil-agent-ai-platform.git
cd devil-agent-ai-platform
# 运行自动化设置脚本
chmod +x setup.sh
./setup.sh
```
### 手动安装
#### 1. 后端设置
```bash
cd backend
# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate # 在 Windows 上：venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt
# 复制环境变量
cp .env.example .env
# 编辑 .env 并添加您的配置
nano .env
```
#### 2. 前端设置
```bash
cd frontend
# 安装依赖
npm install
# 或
yarn install
# 复制环境变量
cp .env.example .env
# 编辑 .env 并添加您的配置
nano .env
```
#### 3. 数据库设置
```bash
# 启动 MongoDB
sudo systemctl start mongod
# 或使用 Docker
docker run -d -p 27017:27017 --name mongodb mongo:latest
```
#### 4. 启动应用程序
```bash
# 终端 1 - 后端
cd backend
source venv/bin/activate
python server.py
# 终端 2 - 前端
cd frontend
npm start
```
访问 `http://localhost:3000` 🎉
---
## 🏗️ 架构
### 系统概述
```
┌─────────────────────────────────────────────────────────────┐
│ Devil Agent 平台 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐│
│ │ 前端 │────▶│ 后端 │────▶│ MongoDB ││
│ │ React + TS │ │ FastAPI │ │ ││
│ └──────────────┘ └──────────────┘ └──────────────┘│
│ │ │ │
│ │ ▼ │
│ │ ┌──────────────┐ │
│ │ │ MCP 服务器 │ │
│ │ └──────────────┘ │
│ │ │ │
│ │ ▼ │
│ │ ┌──────────────┐ │
│ └─────────────▶│ Agent Core │ │
│ │ （技能） │ │
│ └──────────────┘ │
│ │
│ ┌──────────────┐ │
│ │ NEXUS OS │ │
│ │ 框架 │ │
│ └──────────────┘ │
└─────────────────────────────────────────────────────────────┘
```
### 技术栈
**前端：**
- React 19，搭配 TypeScript
- Tailwind CSS + shadcn/ui 组件
- React Router v7，用于路由
- Axios，用于 API 通信
- Lucide React，用于图标
- Recharts，用于数据可视化
**后端：**
- FastAPI（Python 3.9+）
- Motor（异步 MongoDB 驱动）
- Pydantic，用于验证
- JWT 身份验证
- bcrypt，用于密码哈希
- emergentintegrations，用于 AI 模型
**基础设施：**
- MongoDB 5.0+
- Redis（可选缓存）
- Nginx（反向代理）
- PM2（进程管理）
- Docker & Docker Compose
---
## 🔧 安装
### 开发环境
```bash
# 安装所有依赖
npm run install:all
# 启动开发服务器
npm run dev
# 运行测试
npm run test
# 构建生产版本
npm run build
```
### 生产部署
```bash
# 构建优化的包
npm run build:prod
# 使用 PM2 启动
pm2 start ecosystem.config.js
```
---
## ⚙️ 配置
### 环境变量
#### 后端（.env）
```env
# 服务器配置
PORT=8000
HOST=0.0.0.0
ENV=production
# 数据库
MONGO_URL=mongodb://localhost:27017
DB_NAME=devil_agent_db
# 安全
SECRET_KEY=your-super-secret-key-change-this-in-production
JWT_ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=60
# AI 模型（可选）
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=...
# Redis（可选）
REDIS_URL=redis://localhost:6379
# CORS
CORS_ORIGINS=http://localhost:3000,https://YOUR_DOMAIN_HERE
```
#### 前端（.env）
```env
# API 配置
REACT_APP_API_URL=https://YOUR_DOMAIN_HERE
REACT_APP_WS_URL=wss://YOUR_DOMAIN_HERE/ws
# 功能标志
REACT_APP_ENABLE_MCP=true
REACT_APP_ENABLE_NEXUS=true
REACT_APP_DEBUG_MODE=false
```
### Agent Core 配置
编辑 `agent_core/DEVIL_AGENT_CONFIG.md` 以自定义：
- 可用技能
- 模型偏好
- 工具权限
- 安全约束
---
## 📖 用法
### 基本用法
```python
from agent_core import DevilAgent
# 初始化代理
agent = DevilAgent(
model="claude-opus-4.5",
skills=["research", "coding", "finance"]
)
# 运行自主任务
result = agent.execute(
task="Build a full-stack web app with user authentication",
constraints={
"timeline": "2 hours",
"budget": "$0",
"security": "high"
}
)
print(result.summary)
print(result.artifacts)
```
### 高级用法
```python
# 多代理编排
orchestrator = AgentOrchestrator()
orchestrator.spawn_agents([
("architect", ArchitectAgent()),
("builder", BuilderAgent()),
("tester", TesterAgent()),
("security", SecurityAgent())
])
result = orchestrator.execute_workflow(
task_graph=build_task_graph(),
parallel_execution=True,
max_retries=3
)
```
---
## 🔌 MCP 服务器
模型上下文协议（MCP）服务器提供了一个用于 AI 模型集成的通用接口。
### 启动 MCP 服务器
```bash
cd agent_core
./start-gateway.sh
```
### MCP 端点
- `POST /v1/chat/completions` - 聊天完成
- `POST /v1/embeddings` - 生成嵌入
- `GET /v1/models` - 列出可用模型
- `POST /v1/tools/execute` - 执行工具/函数
### 支持的模型
| 提供商 | 模型 | 状态 |
|----------|--------|--------|
| Anthropic | Claude Opus 4.5, Sonnet 4.5, Haiku 4.5 | ✅ |
| OpenAI | GPT-5.2, GPT-4o, GPT-4 Turbo | ✅ |
| Google | Gemini 3 Pro, Gemini 3 Flash | ✅ |
| 自定义 | 您的微调模型 | ✅ |
---
## 🎓 Agent Core 技能
Agent Core 包含 100+ 个跨多个领域的专业技能：
### 财务技能
- **3 语句财务模型** - 构建集成的损益表、资产负债表、现金流表
- **DCF 估值** - 折现现金流分析，带有敏感性表格
- **LBO 模型** - 杠杆收购建模
- **可比公司分析** - 可比公司分析
- **合并模型** - 并购增值/稀释分析
- **Excel 作者** - 生成复杂的 Excel 电子表格
- **PowerPoint 作者** - 创建专业演示文稿
### 研究技能
- **并行 CLI** - 并行运行多个研究查询
- **达尔文进化器** - 通过遗传算法进化解决方案
- **网页抓取器** - 从网站提取结构化数据
- **文献搜索** - 搜索学术论文和出版物
### Web 开发技能
- **页面代理** - 从描述中构建完整网页
- **组件生成器** - 创建 React/Vue/Angular 组件
- **API 设计器** - 设计具有 OpenAPI 规范的 RESTful API
### 生产力技能
- **文档转换器** - 在格式之间转换（PDF、DOCX、MD）
- **数据分析器** - 分析 CSV/Excel 数据
- **图像处理器** - 调整大小、裁剪、优化图像
### 添加自定义技能
```python
# 创建新技能
from agent_core.skills import BaseSkill
class MyCustomSkill(BaseSkill):
name = "my-custom-skill"
description = "Does something amazing"
def execute(self, params):
# 您的逻辑在此
return result
# 注册技能
agent_core.register_skill(MyCustomSkill())
```
---
## 🧠 NEXUS OS 框架
NEXUS 是驱动 Devil Agent 决策的自主操作系统。
### 四个认知层
1. **战略思维** - 长期规划和架构
2. **战术思维** - 任务分解和排序
3. **执行引擎** - 直接行动和实施
4. **哨兵** - 持续验证和安全
### 核心原则
- **自主第一** - 默认自主执行
- **基于证据的完成** - 只有在有证据的情况下，任务才被视为“完成”
- **零回归** - 性能下降时的自动回滚
- **最小足迹** - 仅安装所需内容
- **默认安全** - OWASP Top 10 合规性
### NEXUS 功能
- 自主代码重构
- 自愈部署
- 预测技术债务跟踪
- 持续威胁建模
- 实时成本优化
查看 [NEXUS_QUICK_START.md](NEXUS_QUICK_START.md) 以获取详细文档。
---
## 🔐 安全
### 基于密钥的身份验证
Devil Agent 使用独特的 40 字秘密密钥系统代替传统的用户名/密码：
**好处：**
- 🔒 **无法破解** - 256 位熵，无法强行破解
- 🚫 **无需钓鱼** - 密钥无法像密码一样被钓鱼
- 🔑 **一个密钥** - 所有服务共用一个密钥
- 💾 **离线存储** - 存储在密码管理器或加密文件中
**创建帐户：**
1. 访问 `/signup`
2. 点击“生成我的秘密密钥”
3. **关键**：立即保存 40 字密钥（仅显示一次！）
4. 存储在密码管理器中（1Password、LastPass、Bitwarden）
5. 使用密钥在 `/login` 登录
### 安全功能
- **自动秘密扫描** - 在代码/日志中检测秘密
- **CVE 监控** - 实时漏洞检测
- **零信任架构** - 每个服务到服务的调用都经过身份验证
- **审计日志** - 具有加密签名的防篡改日志
- **合规性** - SOC2、GDPR、HIPAA 开箱即用
### 责任披露
发现安全问题？请发送电子邮件至：security@YOUR_DOMAIN_HERE
**请勿** 为安全漏洞开启公共 GitHub 问题。
---
## 🚀 部署
### VPS 部署（Ubuntu 22.04）
```bash
# 1. SSH 进入您的 VPS
ssh -i YOUR_PEM_KEY_HERE ubuntu@YOUR_VPS_IP_HERE
# 2. 克隆仓库
git clone https://github.com/vikrant-project/devil-agent-ai-platform.git
cd devil-agent-ai-platform
# 3. 运行部署脚本
chmod +x deploy.sh
./deploy.sh production
# 4. 配置 Nginx
sudo cp nginx.conf /etc/nginx/sites-available/devil-agent
sudo ln -s /etc/nginx/sites-available/devil-agent /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
# 5. 使用 Let's Encrypt 设置 SSL
sudo certbot --nginx -d YOUR_DOMAIN_HERE
```
### Docker 部署
```bash
# 使用 Docker Compose 构建和运行
docker-compose up -d
# 查看日志
docker-compose logs -f
# 停止服务
docker-compose down
```
### 云平台
**AWS：**
- EC2 + RDS + S3
- Elastic Beanstalk
- ECS + Fargate
**Google Cloud：**
- Compute Engine + Cloud SQL
- App Engine
- Cloud Run
**Azure：**
- 虚拟机 + Cosmos DB
- 应用服务
- 容器实例
查看 [docs/DEPLOYMENT_SUMMARY.md](docs/DEPLOYMENT_SUMMARY.md) 获取平台特定指南。
---
## 📡 API 文档
### 身份验证
所有 API 请求都需要 JWT 令牌：
```bash
curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
https://YOUR_DOMAIN_HERE/api/status
```
### 端点
#### 身份验证端点
```http
POST /api/auth/signup
Content-Type: application/json
响应：
{
"key": "word1 word2 word3 ... word40",
"token": "eyJ...",
"user_id": "uuid"
}
```
```http
POST /api/auth/login
Content-Type: application/json
{
"key": "word1 word2 word3 ... word40"
}
响应：
{
"token": "eyJ...",
"user_id": "uuid"
}
```
#### 代理端点
```http
POST /api/agent/execute
Authorization: Bearer TOKEN
Content-Type: application/json
{
"task": "Build a REST API",
"constraints": {
"language": "python",
"framework": "fastapi"
}
}
响应：
{
"task_id": "uuid",
"status": "running",
"estimated_time": 120
}
```
```http
GET /api/agent/status/{task_id}
Authorization: Bearer TOKEN
响应：
{
"task_id": "uuid",
"status": "completed",
"progress": 100,
"result": {...}
}
```
查看 `https://YOUR_DOMAIN_HERE/api/docs` 上的完整 API 文档（Swagger UI）
---
## 🤝 贡献
我们欢迎贡献！以下是开始使用的方法：
<!-- 请在此处添加贡献指南 -->
### 开发工作流
1. **Fork 仓库**
2. **创建功能分支**
```bash
git checkout -b feature/惊艳功能
```
3. **进行修改**
4. **运行测试**
```bash
npm run test
npm run lint
```
5. **使用约定提交信息提交**
```bash
git commit -m "feat: 添加惊艳功能"
```
6. **推送到你的 Fork**
```bash
git push origin feature/惊艳功能
```
7. **开启拉取请求**
### 提交信息格式
```
类型(范围): 主题
正文
页脚
```
**类型：**
- `feat`: 新功能
- `fix`: 错误修复
- `docs`: 文档变更
- `style`: 代码样式变更（格式化）
- `refactor`: 代码重构
- `perf`: 性能改进
- `test`: 添加或更新测试
- `chore`: 构建过程或辅助工具变更
### 代码风格
- **Python**: Black + isort + flake8
- **TypeScript**: ESLint + Prettier
- **提交信息**: 约定提交信息
- **分支**: feature/*, bugfix/*, hotfix/*
---
## 🐛 故障排除
### 常见问题
#### MongoDB 连接失败
```bash
# 检查 MongoDB 是否正在运行
sudo systemctl status mongod
# 重启 MongoDB
sudo systemctl restart mongod
# 检查 .env 中的连接字符串
MONGO_URL=mongodb://localhost:27017
```
#### 前端构建错误
```bash
# 清除缓存并重新安装
rm -rf node_modules package-lock.json
npm install
# 尝试使用旧版同级依赖
npm install --legacy-peer-deps
```
#### 后端导入错误
```bash
# 重新创建虚拟环境
rm -rf venv
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
#### 端口已被占用
```bash
# 查找占用端口 3000 的进程
lsof -ti:3000 | xargs kill -9
# 查找占用端口 8000 的进程
lsof -ti:8000 | xargs kill -9
```
### 获取帮助
- 📖 [文档](docs/)
- 💬 [讨论](https://github.com/vikrant-project/devil-agent-ai-platform/discussions)
- 🐛 [问题](https://github.com/vikrant-project/devil-agent-ai-platform/issues)
- 💌 邮箱：support@YOUR_DOMAIN_HERE
---
## 📄 许可证
该项目在 **MIT 许可证**下许可 - 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。
### 第三方许可证
- **Agent Core**: [NousResearch/Hermes-Agent](https://github.com/NousResearch/Hermes-Agent) 的 Fork（MIT 许可证）
- **NEXUS 框架**: 原始作品，MIT 许可证
- 有关完整的第三方致谢，请参阅 [NOTICE.md](NOTICE.md)
---
## 🏆 致谢
- **Anthropic** - 感谢 Claude AI 模型和研究
- **OpenAI** - 感谢 GPT 模型
- **Google** - 感谢 Gemini 模型
- **NousResearch** - 感谢 Hermes-Agent 基础
- **FastAPI** - 感谢出色的 Python Web 框架
- **React Team** - 感谢 React 19
- **Vercel** - 感谢 shadcn/ui 组件
---
## 📊 项目统计
---
## 🔮 路线图
### 2026 年第一季度
- [ ] 多用户工作区协作
- [ ] 语音接口（语音转文本 + 文本转语音）
- [ ] 移动应用（iOS + Android）
- [ ] 插件市场
### 2026 年第二季度
- [ ] 自托管 AI 模型（Llama, Mistral）
- [ ] 高级数据分析仪表盘
- [ ] 自动 CI/CD 管道生成
- [ ] 与流行的 DevOps 工具集成（Jenkins, GitLab CI）
### 2026 年第三季度
- [ ] 企业 SSO（SAML, OIDC）
- [ ] 多区域部署
- [ ] Kubernetes Helm 图表
- [ ] 基础设施的 Terraform 模块
### 2026 年第四季度
- [ ] 量子准备加密
- [ ] 零知识证明用于隐私
- [ ] 区块链集成用于审计跟踪
- [ ] AGI 研究实验室功能
---
## 📈 性能基准
| 指标 | 值 | 比较 |
|--------|-------|------------|
| 代码生成速度 | 1,200 loc/min | 比 GPT-4 单独快 3 倍 |
| 错误检测率 | 94% | vs 78% 行业平均水平 |
| 平均解决时间 | 8 分钟 | vs 2+ 小时人工开发 |
| 部署成功率 | 99.2% | vs 87% 传统 CI/CD |
| 任务成本 | $0.08 | vs $50+ 自由职业者 |
---
## 🌐 社区
- **Discord**: [加入我们的社区](https://discord.gg/YOUR_INVITE)
- **Twitter**: [@DevilAgentAI](https://twitter.com/YOUR_HANDLE)
- **博客**: [blog.YOUR_DOMAIN_HERE](https://blog.YOUR_DOMAIN_HERE)
- **YouTube**: [视频教程](https://youtube.com/YOUR_CHANNEL)
---
## 📣 标签
`#人工智能` `#自主代理` `#ai平台` `#机器学习` `#深度学习` `#nlp` `#gpt-4` `#claude` `#gemini` `#llm` `#大型语言模型` `#fastapi` `#python` `#react` `#typescript` `#mongodb` `#全栈` `#网页开发` `#自动化` `#devops` `#ci-cd` `#安全` `#身份验证` `#jwt` `#docker` `#kubernetes` `#云计算` `#aws` `#azure` `#gcp` `#开源` `#mit-license` `#开发者工具` `#生产力` `#代码生成` `#测试自动化` `#自我修复` `#零停机时间` `#企业就绪` `#生产级` `#最先进` `#突破` `#创新` `#nexus-os` `#agent-core` `#mcp-server` `#模型上下文协议` `#自主软件工程` `#ai驱动开发` `#智能自动化` `#认知架构` `#多代理系统` `#agentic-ai`
---
<div align="center">
**由 Devil Agent 团队用 🔥 制作**
如果您觉得这个项目有用，请考虑在 GitHub 上给它一个 ⭐！
[⬆ 返回顶部](#-devil-agent--自主-ai工程操作系统)
</div>
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器