快速开始
环境要求
- Node.js >= 18
- npm >= 9 或 pnpm >= 8
- Git
安装
克隆仓库
bash
git clone https://github.com/gitcoffee-os/aisolv.git
cd aisolv安装依赖
bash
npm install
# 或
pnpm install开发
启动开发服务器
bash
npm run dev
# 或
pnpm dev开发服务器启动后，访问 http://localhost:3000 即可预览。
构建生产版本
bash
npm run build
# 或
pnpm build构建产物将输出到 dist 目录。
项目结构
aisolv/
├── apps/ # 应用目录
│ ├── admin/ # 管理后台
│ ├── mobile/ # 移动端应用
│ ├── miniapp/ # 小程序应用
│ └── web/ # Web 端应用
├── packages/ # 共享包
│ ├── ui/ # UI 组件库
│ ├── sdk/ # 工单 SDK
│ ├── workflow/ # 工作流引擎
│ └── shared/ # 共享工具
├── server/ # 服务端
│ ├── gateway/ # 网关服务
│ ├── ticket/ # 工单服务
│ ├── workflow/ # 工作流服务
│ ├── ai/ # AI 服务
│ └── notify/ # 通知服务
├── docs/ # 文档
└── scripts/ # 脚本配置说明
基础配置
在项目根目录创建 .env 文件：
env
# 服务端地址
VITE_API_BASE_URL=http://localhost:8080
# WebSocket 地址
VITE_WS_URL=ws://localhost:8080/ws
# 应用名称
VITE_APP_NAME=AiSolv多端配置
管理端
env
# apps/admin/.env
VITE_PLATFORM=admin
VITE_ENABLE_AI=true
VITE_AI_API_KEY=your_ai_key移动端
env
# apps/mobile/.env
VITE_PLATFORM=mobile
VITE_ENABLE_PUSH=true
VITE_PUSH_APP_KEY=your_push_key小程序
env
# apps/miniapp/.env
VITE_PLATFORM=miniapp
VITE_ENABLE_VOICE=true使用示例
初始化 SDK
typescript
import { AiSolvSDK } from '@aisolv/sdk'
const sdk = new AiSolvSDK({
apiBaseUrl: 'http://localhost:8080',
wsUrl: 'ws://localhost:8080/ws',
appKey: 'your_app_key'
})
await sdk.connect()AI 智能建单
typescript
const ticket = await sdk.createTicketByAI({
description: '服务器CPU使用率持续超过90%，需要紧急处理'
})
console.log('AI 创建工单:', ticket)查询工单
typescript
const tickets = await sdk.getTickets({
status: 'open',
assignee: 'me',
page: 1,
pageSize: 20
})监听工单事件
typescript
sdk.onTicketCreated((ticket) => {
console.log('新工单:', ticket)
})
sdk.onTicketAssigned((ticket) => {
console.log('工单已派发:', ticket)
})
sdk.onTicketStatusChanged((ticket) => {
console.log('工单状态变更:', ticket)
})常见问题
Q: 如何切换开发环境？
A: 使用 .env.development、.env.production 等文件来配置不同环境。
Q: 如何自定义工作流？
A: 在管理后台的工作流设计器中，通过拖拽节点即可可视化编排工单流转规则。
Q: 如何配置 AI 派单策略？
A: 在系统设置的派单策略中，可以配置基于技能、工作量、历史表现等多维度的智能匹配规则。
Q: 如何接入通知渠道？
A: 在系统设置的通知渠道中，支持配置企业微信、钉钉、邮件、短信等通知方式。