# ops-agent

**Repository Path**: hnwlc/ops-agent

## Basic Information

- **Project Name**: ops-agent
- **Description**: 基于pi-mono的企业级agent
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-19
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ops-Agent

> 企业级多场景 AI 智能体平台 — v0.9

Ops-Agent 是一个面向企业的 AI 助手平台，通过自然语言与各类系统交互。它提供桌面端（Electron）、终端 TUI、命令行 CLI 三种形态，内置 Shell、文件读写、HTTP 请求、浏览器自动化等工具，支持多模型切换和多场景适配。

## 安装

### Windows 便携版（推荐）

从 [Releases](https://gitee.com/hnwlc/ops-agent/releases) 下载 `Ops Agent-x.x.x-win.zip`，解压后运行 `OpsAgent.exe` 即可。

> Windows 可能提示 SmartScreen，点击"更多信息"→"仍要运行"即可。

### 从源码构建

```bash
# 前置要求: Node.js 18+, npm 9+
git clone https://gitee.com/hnwlc/ops-agent.git
cd ops-agent
npm install

# 构建所有依赖包
npm run build

# 桌面版（Windows zip）
cd packages/ops-agent-desktop
npm run package:win    # 输出到 release/Ops Agent-x.x.x-win.zip

# 或直接运行开发模式
npm run dev:desktop    # 桌面 GUI（热重载）
npm run dev:tui        # 终端交互
npm run dev:cli        # 命令行
```

> 首次运行桌面版需约 200MB 下载（Electron + Chromium）。

## 快速上手

### 1. 配置 API Key

桌面版：设置 → LLM → 添加 API Key（支持智谱 GLM、Anthropic Claude、OpenAI、Google Gemini 等）。

命令行：
```bash
export ZHIPU_API_KEY=your_key
export ANTHROPIC_API_KEY=your_key
```

### 2. 选择一个场景

Ops-Agent 内置多个业务场景（运维、投顾、合规等），每个场景有独立的人设、技能和工具策略。启动后默认进入 `ops` 场景，可直接开始对话。

### 3. 开始对话

在输入框描述你的需求，Agent 会自动选择合适的工具执行：

- `帮我查一下 192.168.1.1 能不能 ping 通`
- `读取 /etc/hosts 文件内容`
- `浏览这个网页并把内容保存到文件`
- `每天上午 9 点执行一次服务器健康检查`

## 功能概览

| 功能 | 说明 |
|------|------|
| 多场景 | 运维/投顾/合规/办公场景一键切换，人设技能自动适配 |
| Shell 执行 | 执行 CLI 命令，支持风险分级审批和审计日志 |
| 文件读写 | 支持文本、PDF、Word、Excel、CSV、XML 格式 |
| HTTP 请求 | 内置 SSRF 防护，安全发送 API 请求 |
| 浏览器自动化 | 自动浏览网页、填写表单、登录保持、自动恢复会话 |
| 技能市场 | SkillHub 远程搜索、安装、发布标准化技能 |
| 定时任务 | 自然语言创建 cron 任务，到点自动执行，支持飞书/Session 通知 |
| 凭证管理 | 主口令加密存储 + Agent 读取权限控制 |
| 会话搜索 | 全量会话全文搜索，匹配片段预览 |
| 场景 UI | 新建会话时卡片式场景选择，显示人设和工具差异 |
| 上下文管理 | 消息分页、滑动窗口、四级压缩策略，长对话语义不衰减 |
| 审计日志 | 全链路结构化日志，满足合规要求 |

## 安全架构

```
L1: 工具策略      → 按场景控制可用工具列表
L2: Shell 风险分级 → 高危/中危命令需用户确认
L3: 文件权限      → 敏感文件路径保护
L4: SSRF 防护     → 私有 IP 阻断
L5: 沙箱隔离      → Docker 容器独立运行（可选）
L6: 审计日志      → 全链路可追溯
```

## 技术栈

| 层级 | 技术 |
|------|------|
| AI 引擎 | 智谱 GLM / Anthropic Claude / OpenAI / Google Gemini |
| 桌面端 | Electron + Lit + TypeScript |
| 终端端 | Node.js + TypeScript（零依赖 TUI） |
| 沙箱 | Docker + WSL2 |
| 加密 | AES-256-GCM |
| 测试 | Vitest + Playwright |

## 目录结构

```
ops-agent/
├── packages/
│   ├── ops-agent-desktop/    # Electron 桌面应用
│   ├── ops-agent-core/       # 核心 Agent 运行时 + 工具集
│   ├── ai/                   # AI 引擎适配层（多模型支持）
│   ├── browser/              # 浏览器自动化引擎
│   ├── node/                 # Node.js 运行时入口
│   ├── cloud/                # 云服务管理
│   ├── mcp/                  # MCP 协议框架
│   ├── pi-tui/               # 终端 TUI 界面
│   └── pi-web-ui/            # Web UI（实验性）
├── docs/                     # 设计文档与路线图
└── scripts/                  # 构建与工具脚本
```

## 文档

- [更新日志](CHANGELOG.md) — 近期新增特性与变更记录
- [演进路线图](docs/roadmap.md) — 阶段规划与进度
- [系统架构](docs/architecture.md) — 技术实现文档
- [设计文档](docs/index.md) — 全部设计规格

## 开发

```bash
# 安装依赖
npm install

# 全量构建
npm run build

# 全量检查（Lint + TypeScript）
npm run check

# 运行测试
npm test

# 桌面端开发（热重载）
npm run dev:desktop
```

## License

MIT

---

*Forked from [pi-mono](https://github.com/badlogic/pi-mono). Browser automation via [agent-browser](https://github.com/vercel/agent-browser).*