# opspilot

**Repository Path**: auspicious-snow1224/opspilot

## Basic Information

- **Project Name**: opspilot
- **Description**: OpsPilot 是一款轻量级命令行运维工具，专为 Linux/Windows 服务器运维设计。它能自动采集系统全量信息，通过内置规则引擎 + AI 大模型进行智能诊断，输出风险告警和修复建议。

一句话：opspilot diagnose一条命令，看清服务器健康状况。

- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-17
- **Last Updated**: 2026-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpsPilot 智能终端运维领航员

> AI 驱动的智能运维 CLI 工具，让系统诊断像聊天一样简单。

***

## 这是什么？

OpsPilot 是一款轻量级命令行运维工具，专为 Linux/Windows 服务器运维设计。它能自动采集系统全量信息，通过内置规则引擎 + AI 大模型进行智能诊断，输出风险告警和修复建议。

**一句话：`opspilot diagnose`** **一条命令，看清服务器健康状况。**

***

## 核心功能

### 系统信息采集（17 模块）

| 模块    | 说明                                            |
| ----- | --------------------------------------------- |
| CPU   | 型号、核心数、使用率、Load 负载、核间均衡度                      |
| 内存    | 总量/已用/Swap/OOM 计数/缓存命中                        |
| 磁盘空间  | 各分区使用率、inode、挂载选项                             |
| 磁盘 IO | IOPS、吞吐量、响应时间                                 |
| 网络    | 流量、丢包、重传、TCP 连接状态                             |
| 网络信息  | IP/DNS/网关/监听端口                                |
| 进程    | Top5 CPU/内存消耗、线程数、句柄数                         |
| 系统信息  | OS 发行版、内核版本、架构、ulimits                        |
| 内核参数  | 关键 sysctl 参数检查                                |
| 容器    | Docker 容器/镜像/卷/网络、Podman、K8s Pod/Service/Node |
| K3s   | 安装检测、版本、服务状态、数据目录                             |
| 安全    | SSH/防火墙/SELinux/高危端口/空密码账户                    |
| 服务    | systemd 服务状态统计                                |
| 硬件    | RAID/内存条/主板BIOS/GPU/磁盘SMART                   |

### 智能诊断引擎（105+ 规则）

覆盖 CPU、内存、磁盘、网络、安全、容器、硬件 7 大类故障场景，输出：

- **风险等级**：严重 / 警告 / 正常
- **故障诊断**：问题原因分析
- **修复建议**：安全等级标记的可执行命令（safe/warning/danger）
- **AI 增强**：接入大模型，给出深度分析和优化方案

### 安全执行引擎

- 150+ 命令白名单
- 危险字符检测（防止注入）
- 命令执行审计日志
- 审计哈希链（防篡改）

### 其他功能

- Tab 命令补全（PowerShell / Bash / Zsh，全局生效）
- 命令简写（`opspilot c` → `opspilot collect`）
- JSON + 表格 双格式输出
- AI 运维问答（支持 SiliconFlow / Ollama / OpenAI）
- 数据脱敏（自动隐藏 IP/MAC/密码等敏感信息）

***

## 快速开始

```bash
# 安装
pip install -e .

# 采集系统信息
opspilot collect

# 智能诊断
opspilot diagnose

# 查看帮助
opspilot --help
```

***

## 跨平台支持

| 平台                      | 支持状态 |
| ----------------------- | ---- |
| Windows 10/11           | ✅    |
| Ubuntu / Debian         | ✅    |
| CentOS / RHEL           | ✅    |
| openEuler / Kylin / UOS | ✅    |
| K3s / Kubernetes        | ✅    |

***

## 项目结构

```
opspilot/
├── cli/              # 命令行入口
│   ├── main.py       # 根命令、补全安装
│   ├── collect.py    # 系统采集展示
│   ├── diagnose.py   # 规则 + AI 诊断
│   ├── fix.py        # 交互式修复
│   ├── ask.py        # AI 运维问答
│   └── audit.py      # 审计日志
├── core/
│   ├── collector/    # 17 个采集器
│   ├── rules/        # 规则引擎 + 105 条规则
│   ├── executor/     # 安全执行引擎
│   ├── audit.py      # 审计哈希链
│   └── ai/           # AI 服务层
└── utils/            # 数据脱敏、格式化
```

***

## 路线图

- [x] 系统全量信息采集（17 模块）
- [x] 规则引擎 + 105 条诊断规则
- [x] 安全执行引擎（白名单 + 审计）
- [x] AI 增强诊断（SiliconFlow / Ollama）
- [x] Docker/K3s/K8s 容器采集
- [x] 跨平台支持（Windows/Linux）
- [x] Tab 补全 + 命令简写
- [ ] Web Dashboard 可视化面板
- [ ] 批量多节点巡检
- [ ] 自定义规则导入
- [ ] Prometheus/Grafana 指标导出
- [ ] 告警通知（钉钉/飞书/企微）
- [ ] 历史趋势分析
- [ ] 运维知识库自动更新

***

## 适用场景

- **日常巡检**：一键采集全量信息，快速定位问题
- **故障排查**：规则引擎自动检测常见故障，输出修复建议
- **安全审计**：检查 SSH/防火墙/高危端口/空密码等安全风险
- **容器监控**：Docker/K3s/K8s 容器状态一目了然
- **硬件监控**：RAID/SMART/GPU/内存条等硬件健康检测
- **CI/CD 集成**：作为 Jenkins 流水线的一部分，自动诊断并输出报告

***

## 构建

```bash
# 本地构建 Linux 可执行文件
./build_linux.sh

# Docker 构建
docker build -f Dockerfile.build -t opspilot-build .

# 提取二进制文件
docker cp $(docker create opspilot-build):/output/opspilot ./dist/
```

***

## License

MIT

***

> 持续更新中，欢迎 Issue 和 PR。