OmniCS

OmniCS - 企业级电商智能客服系统

🦞 Powered by Lobster

项目简介

OmniCS 是一个企业级多平台电商智能客服系统，支持淘宝(千牛)、京东(京麦)、拼多多、闲鱼、小红书、微信等多个电商平台。

核心特性

• 多角色支持: 老板、销售、客服、财务、运营、剪辑、售后、人力
• 多平台适配: 淘宝、京东、拼多多、闲鱼、小红书、微信
• 智能回复: 知识库检索 + 大模型生成
• 敏感词检测: 多层级敏感词/违禁词检测
• 关键词触发: 自动转接、告警、自动回复
• 自动化操作: OCR识别 + 模拟点击 (千牛弹窗模式)

技术栈

快速开始

环境要求

• Node.js >= 20
• PostgreSQL >= 15
• Redis >= 7

安装依赖

# 后端
cd backend
npm install

# 前端
cd frontend
npm install

# Electron 客户端
cd electron
npm install

配置环境变量

cd backend
cp .env.example .env
# 编辑 .env 填入配置

初始化数据库

# 创建数据库
createdb omics

# 运行迁移
npm run db:migrate

# 初始化种子数据
npm run db:seed

启动服务

# 后端 (端口 3001)
cd backend
npm run dev

# 前端 (端口 3000)
cd frontend
npm run dev

# Electron 客户端
cd electron
npm run dev

Docker 部署

docker-compose up -d

默认账号

• 用户名: admin
• 密码: admin123

项目结构

OmniCS/
├── backend/          # Node.js 后端
│   ├── src/
│   │   ├── entities/   # 数据实体
│   │   ├── services/   # 业务服务
│   │   ├── routes/     # API路由
│   │   ├── middleware/ # 中间件
│   │   └── socket/     # WebSocket
│   └── ...
├── frontend/         # React 前端
│   ├── src/
│   │   ├── pages/      # 页面组件
│   │   ├── stores/     # 状态管理
│   │   ├── api/        # API封装
│   │   └── layouts/    # 布局组件
│   └── ...
├── electron/         # Electron 客户端
│   ├── src/
│   │   ├── automation/ # 自动化控制
│   │   └── services/   # 服务层
│   └── ...
└── docs/             # 文档

核心流程

客户消息
    │
    ▼
关键词检测 ──触发──▶ 转人工/告警/自动回复
    │
    │ 未触发
    ▼
┌─────────────────────┐
│  并行处理            │
│  ┌─────────┐ ┌─────┐│
│  │知识库检索│ │AI   ││
│  └────┬────┘ │生成 ││
│       │      └──┬──┘│
└───────┼─────────┼───┘
        │         │
        ▼         ▼
   知识库有答案? ─用知识库→
        │
        │ 无
        ▼
   使用AI生成
        │
        ▼
   敏感词检测 ─通过→ 发送消息
        │
        │ 未通过
        ▼
   重新生成+提示

API 文档

认证

POST /api/auth/login
POST /api/auth/register
GET  /api/auth/me

会话管理

GET  /api/conversations
GET  /api/conversations/:id
POST /api/conversations/:id/transfer
POST /api/conversations/:id/close

消息管理

GET  /api/conversations/:id/messages
POST /api/conversations/:id/messages
POST /api/conversations/:id/messages/ai-generate

知识库

GET  /api/knowledge/bases
POST /api/knowledge/bases
GET  /api/knowledge/bases/:id/items
POST /api/knowledge/bases/:id/items
POST /api/knowledge/search

许可证

MIT License

---

🦞 龙虾出品