# 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**: 0
- **Created**: 2026-04-19
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ops-Agent

> 企业级多场景 AI 智能体平台

## 提效

1. **多场景一键切换**：运维/投顾/合规/办公场景无缝切换，人设、技能、工具策略随场景自动适配，一个平台覆盖多条业务线
2. **跨角色能力共享**：标准化技能体系打破场景壁垒，一个场景沉淀的经验其他场景直接复用，团队整体能力持续提升
3. **技能一次构建全端复用**：统一 Skill 框架按需加载，用户自定义覆盖内置，避免重复建设
4. **自然语言即操作**：对话创建定时任务、执行运维命令、生成文档报告，分钟级完成传统数小时工作
5. **多端统一接入**：Electron 桌面、终端 TUI、命令行 CLI 同一引擎三种形态，按场景选择交互方式

## 安全

6. **6 层纵深防护**：工具策略→Shell 风险分级→文件权限→SSRF 防护→Docker 沙箱→审计日志，层层独立生效
7. **AI 执行人类决策**：Diff 预览、高危命令审批、凭证显式授权，关键操作始终由人类把控
8. **全链路审计溯源**：结构化日志覆盖调用与执行全过程，对话轨迹留存满足监管合规要求
9. **沙箱物理隔离**：Docker 容器独立运行，固定挂载卷隔离宿主，基础设施层面杜绝越界

## 可扩展

10. **场景分钟级上线**：新增业务场景只需配置人设、技能和工具策略，无需开发
11. **工具按需插拔**：标准化工具接口灵活组合，按业务需要启停扩展
12. **开放生态就绪**：MCP 协议框架已就绪可接入外部工具，多模型热切换不受厂商绑定（规划中）

## 智能

13. **分层记忆持续进化**：Agent 跨会话积累业务知识，自动提取经验整合为可复用技能，越用越懂业务
14. **企业数据智能入口**：通过 Shell/HTTP/浏览器工具直接对接现有系统，无需改造即可激活沉睡数据资产
15. **四级上下文压缩**：分页→滑动窗口→LLM 摘要→Token 截断，长任务语义连贯不衰减

## 架构概览

```
┌─────────────────────────────────────────────────────────────┐
│                    用户交互层                              │
│  CLI (命令行)    TUI (终端交互)    Electron GUI (桌面应用)   │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                    Agent 运行时                             │
│   Agent (状态管理)  ←→  AgentLoop (LLM调用 + 工具调度)       │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                      工具层                                 │
│  shell  file_read  file_write  file_edit  http_request  browser_*  skill_*  schedule  secret │
│  (内置 PDF/Word/Excel/CSV/XML 格式支持)                        │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                      安全层 (6层防护)                        │
│  L1:工具策略  L2:Shell风险分级  L3:文件权限  L4:HTTP SSRF   │
│  L5:沙箱隔离  L6:审计日志                                │
└─────────────────────────────────────────────────────────────┘
```

## 快速开始

```bash
# 1. 克隆并安装
git clone https://gitee.com/hnwlc/ops-agent.git && cd ops-agent && npm install

# 2. 配置 API Key
export ZHIPU_API_KEY=your_key
export ANTHROPIC_API_KEY=your_key  # 可选

# 3. 运行
npm run dev:cli       # 命令行模式
npm run dev:tui       # 终端交互模式
npm run dev:desktop   # 桌面 GUI
```

## 技术栈

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

## 文档

- [关键特性](docs/key-features.md) — 产品特性详情
- [演进路线图](docs/roadmap.md) — 阶段规划与进度
- [系统架构](docs/architecture.md) — 技术实现文档
- [设计文档](docs/index.md) — 全部设计规格

## 基于

Forked from [pi-mono](https://github.com/badlogic/pi-mono) by Mario Zechner. Browser automation via [agent-browser](https://github.com/vercel/agent-browser) by Vercel Labs. Security design inspired by [flocks](https://gitee.com/hnwlc/flocks).

## License

MIT