KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

AIOPS

★ 43 Open GitHub ↗

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

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

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README