AIOPS

KO | EN

gitlite — search

#javascript #python #typescript #golang #go #deep-learning #docker #awesome #cli #kubernetes #awesome-list #pytorch #security #openai

(★ 43)

一个辅助运维的智能体，可以生成处理故障，和日常运维需求。前端为electron架构，可跨平台编译。

AIOPS 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AIOps 智能运维助手

基于 Electron + React + Python FastAPI + LangGraph 构建的跨平台桌面智能运维 Agent。  
支持 **Windows**、**Debian Linux** 和 **统信 UOS** 操作系统。

---

## ✨ 功能特性

### 🔧 运维模式（Ops Mode）
- 📧 **智能邮件处理**：连接 IMAP/SMTP、Exchange EWS、Microsoft Graph API，自动识别需要运维人员处理的邮件，智能分析优先级并起草回复
- 🎫 **工单自动处理**：对接 Jira、ServiceNow 或自定义工单系统，获取待办工单并生成处理方案
- 📋 **变更申请自动填写**：处理完工单后，自动构建变更申请表单内容并提交（需人工审批）

### 🛡️ 值班模式（Duty Mode）
- 🚨 **多系统告警接入**：支持 Zabbix、Prometheus Alertmanager、Grafana、自定义 Webhook
- 💻 **SSH 自动化排查**：Agent 自主登录告警主机执行诊断命令（df/top/ps/tail 等）
- 📊 **故障分析报告**：综合告警信息和系统日志，生成影响范围分析与处理/升级建议

### 🔐 安全与审批
- 所有关键操作（发送邮件、提交变更、执行危险命令）均需人工审批
- 支持预览和编辑内容后再批准
- 高风险操作有明确的红色风险警告

---

## 🏗️ 技术架构

```
┌─────────────────────────────────────────────────────┐
│                   Electron 桌面层                     │
│  React + TypeScript + Tailwind CSS + Framer Motion  │
│  Zustand 状态管理  ·  React Router  ·  ReactMarkdown │
└────────────────────┬────────────────────────────────┘
                     │ HTTP / SSE
┌────────────────────▼────────────────────────────────┐
│                Python 后端引擎                        │
│       FastAPI + uvicorn (127.0.0.1:18765)           │
│                                                      │
│  ┌──────────────────────────────────────────────┐   │
│  │  LangGraph ReAct Agent                       │   │
│  │  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────────┐   │   │
│  │  │ LLM  │ │Email │ │Ticket│ │ SSH/Alert│   │   │
│  │  │Client│ │Tools │ │Tools │ │  Tools   │   │   │
│  │  └──────┘ └──────┘ └──────┘ └──────────┘   │   │
│  └──────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────┘
```

---

## 🚀 快速开始

### 前置依赖

- **Node.js** >= 18.0
- **Python** >= 3.11
- **pip** 或 **conda**

### 1. 安装后端依赖

```bash
cd backend
pip install -r requirements.txt
```

### 2. 安装前端依赖

```bash
cd frontend
npm install
```

### 3. 开发模式运行

**启动后端（终端 1）：**
```bash
cd backend
python run.py --port 18765
```

**启动前端开发服务（终端 2）：**
```bash
cd frontend
npm run dev
```

**启动 Electron（终端 3）：**
```bash
cd frontend
npm run electron:dev
```

---

## 📦 打包构建

### Windows (.exe 安装包)

```bash
# 1. 打包 Python 后端为独立可执行文件
cd backend
pip install pyinstaller
pyinstaller --onedir --name aiops-backend --hidden-import=uvicorn.lifespan.on --hidden-import=uvicorn.lifespan.off run.py

# 2. 复制后端产物
cp -r dist/aiops-backend ../frontend/backend_dist

# 3. 构建前端并打包 Electron
cd ../frontend
npm run build
npm run electron:build:win
```

输出：`dist/AIOps智能体-Setup-1.0.0.exe`

### Linux Debian / 统信 UOS (.deb 包)

```bash
# 同上步骤 1-2（在目标平台执行）
cd backend
pip install pyinstaller
pyinstaller --onedir --name aiops-backend run.py
cp -r dist/aiops-backend ../frontend/backend_dist

cd ../frontend
npm run build
npm run electron:build:linux
```

输出：
- `dist/aiops-agent_1.0.0_amd64.deb`（Debian/UOS）
- `dist/AIOps智能体-1.0.0.AppImage`（通用 Linux）

### UOS 特别说明

统信 UOS 基于 Debian，直接安装 `.deb` 包即可：
```bash
sudo dpkg -i aiops-agent_1.0.0_amd64.deb
# 如有依赖问题：
sudo apt-get install -f
```

---

## ⚙️ 配置说明

首次启动后，点击左下角 **「系统配置」** 进入设置面板：

| 配置项 | 说明 |
|--------|------|
| 大模型 | 支持 OpenAI、Azure OpenAI、Anthropic、本地模型（Qwen/DeepSeek/Ollama）|
| 邮件系统 | IMAP/SMTP、Exchange EWS、Microsoft Graph API、Webhook |
| 工单/变更 | Jira、ServiceNow、自定义 REST API、演示模式 |
| 告警系统 | Zabbix、Prometheus、Grafana、自定义 Webhook、演示模式 |
| SSH 主机 | 密码/私钥认证，支持多主机配置和标签分组 |
| 值班配置 | 值班人信息、自动升级阈值、上报联系人；**排班/变更 API 地址与 Token** |
| 开网工单 | NASP-ACL 防火墙工单系统地址、账号、网段规则 |

> 💡 **无需真实系统也可体验**：在「工单/变更」和「告警系统」中选择「演示模式 (Mock)」，即可使用内置的模拟数据体验完整的 Agent 流程。

> ⚠️ **内网地址不内置**：代码中不包含任何内网 IP、域名或访问令牌。所有对接内网系统的地址（值班排班 API、当日变更 API、开网工单系统、webmail 地址等）都必须在设置界面手动填写，保存在本机数据目录，不随代码入库。未配置时相关接口会返回明确的提示信息。

---

## 🔒 安全注意事项

1. **凭据存储**：API Key、密码等敏感信息存储在本机 Electron Store 中（用户数据目录），不会上传任何服务器
2. **本地通信**：前后端通过 `127.0.0.1:18765` 通信，不对外暴露端口
3. **人工审批**：高风险操作（发邮件、提交变更、执行 SSH 命令）强制弹窗审批，不会自动执行
4. **SSH 安全**：默认对 `rm`、`kill`、`reboot`、`shutdown` 等危险命令要求人工二次确认

---

## 📁 项目结构

```
AIOPS/
├── frontend/                 # Electron + React 前端
│   ├── electron/            # Electron 主进程
│   │   ├── main.ts         # 主进程：窗口管理、后端进程启动
│   │   └── preload.ts      # 预加载脚本：安全暴露 API
│   └── src/
│       ├── components/
│       │   ├── common/     # 公共组件（TitleBar, ChatPanel, Sidebar...）
│       │   └── settings/   # 设置面板组件
│       ├── store/          # Zustand 全局状态
│       ├── types/          # TypeScript 类型定义
│       └── utils/          # API 客户端、工具函数
├── backend/                  # Python FastAPI 后端
│   ├── app/
│   │   ├── core/           # 配置管理、LLM 工厂
│   │   ├── agents/         # LangGraph Agent 引擎
│   │   ├── tools/          # 工具集（邮件/工单/SSH/告警）
│   │   └── main.py         # FastAPI 应用入口
│   ├── requirements.txt
│   └── run.py
├── electron-builder.yml      # 打包配置
└── README.md
```

---

## 🤝 扩展开发

### 添加新工具

在 `backend/app/tools/` 下新建工具文件，使用 `@tool` 装饰器：

```python
from langchain_core.tools import tool

@tool
def my_custom_tool(param: str) -> str:
    """工具说明（LLM 会读取此文档字符串来理解何时使用此工具）"""
    return f"执行结果: {param}"
```

然后在 `backend/app/main.py` 的 `OPS_TOOLS` 或 `DUTY_TOOLS` 列表中注册即可。

### 切换大模型

在设置面板选择「OpenAI 兼容接口」并填写任何兼容 OpenAI Chat API 格式的模型地址（Qwen、DeepSeek、Ollama 等均支持）。

AIOPS

AIOPS 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

AIOPS

AIOPS 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README