# AI智能操作引导系统

**Repository Path**: yjsmyhome/OperAI-Guide

## Basic Information

- **Project Name**: AI智能操作引导系统
- **Description**: 让AI学习系统操作流程，然后教别人如何操作。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-17
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OperAI Guide

## 项目简介
OperAI Guide 是一套可嵌入现有业务系统的AI引导工具，实现"AI先学习业务操作→再向用户提供个性化引导"的核心能力，降低新员工上手成本、减少操作失误率，并沉淀业务系统操作知识。

## 核心功能

### 操作知识层
- 人工标注与自动化录制双模式采集操作数据
- 业务操作知识图谱构建与管理
- 知识的增删改查与版本管理

### AI推理层
- 基于BERT-Tiny的意图识别
- 操作学习引擎，挖掘高频操作路径
- 个性化引导流程生成
- 异常场景智能适配

### 交互引导层
- 步骤式高亮引导
- 智能问答
- 操作回放
- 实时异常提醒

### 集成部署层
- 插件式与嵌入式两种集成方式
- 标准化API接口
- Docker容器化部署

## 技术栈

| 层级 | 技术选型 | 版本 |
|------|----------|------|
| 操作知识层 | Neo4j | 5.x |
| 操作知识层 | MySQL | 8.x |
| 操作知识层 | ELK Stack | 8.x |
| AI推理层 | FastAPI | 0.100+ |
| AI推理层 | BERT-Tiny | - |
| AI推理层 | Drools | 8.x |
| AI推理层 | Python Pandas | 2.0+ |
| 交互引导层 | Vue.js | 3.x |
| 交互引导层 | Element Plus | 2.x |
| 交互引导层 | Intro.js | 7.x |
| 交互引导层 | RRWeb | 2.x |
| 交互引导层 | Electron | 25.x |
| 集成部署层 | Docker | 20.x+ |
| 集成部署层 | Jenkins | 2.300+ |
| 集成部署层 | Prometheus+Grafana | 2.0+ |

## 项目结构

```
OperAI-Guide/
├── backend/           # 后端服务
├── frontend/          # 前端应用
├── browser-extension/ # 浏览器扩展
├── desktop-app/       # 桌面应用
├── docs/              # 文档
└── README.md
```

## 快速开始

### 环境要求
- Python 3.10+
- Node.js 16+
- Docker 20+

### 安装步骤

1. **克隆仓库**
   ```bash
   git clone <repository-url>
   cd OperAI-Guide
   ```

2. **后端安装**
   ```bash
   cd backend
   pip install -r requirements.txt
   ```

3. **前端安装**
   ```bash
   cd frontend
   npm install
   ```

4. **启动服务**
   ```bash
   # 启动后端服务
   cd backend
   uvicorn main:app --reload
   
   # 启动前端服务
   cd frontend
   npm run dev
   ```

## 部署方式

### 插件式集成
1. 安装Chrome/Firefox浏览器扩展
2. 配置引导规则
3. 刷新业务系统页面，开始使用引导功能

### 嵌入式集成
1. 在业务系统中引入前端组件
2. 配置API地址
3. 初始化引导功能

## 开发流程

### 分支管理
- `main`：生产分支
- `develop`：开发分支
- `feature/*`：特性分支
- `hotfix/*`：热修复分支

### 提交规范
-  feat: 新功能
-  fix: 修复bug
-  docs: 文档更新
-  style: 代码格式调整
-  refactor: 代码重构
-  test: 测试用例更新
-  chore: 构建工具或依赖更新

## 文档

- [需求文档](./.trae/documents/operai_guide_requirements.md)
- [技术方案设计](./.trae/documents/operai_guide_design.md)
- [实施计划](./.trae/documents/operai_guide_tasks.md)

## 贡献

1. Fork 仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

[MIT License](LICENSE)

## 联系方式

- 项目负责人：[Your Name]
- 邮箱：[your.email@example.com]
- 团队：[Your Team Name]