爱优AI智能体技术方案
编写时间：2026-05-15
状态：仅方案，待执行
第一章：需求概述
1.1 项目目标
将爱优五金零售系统改造为移动端AI智能体，用户通过聊天方式（文本、语音、图片）即可完成：
- 界面功能导航与操作
- 数据查询与统计
- 业务操作（开单、收款、打印等）
- 报表分析与导出
1.2 设计原则
| 原则 | 说明 |
|---|---|
| 对话即服务 | 所有功能通过自然语言触发，无需记忆路径 |
| 所见即所得 | 返回结果包含操作界面截图/示意图，确认后再执行 |
| 轻量化 | 移动端优先，响应速度 < 3秒 |
| 安全优先 | 操作需二次确认，关键操作需验证 |
1.3 涉及文档基础
本方案基于以下已分析的文档构建：
- 爱优五金零售系统界面清单（170个界面）
- 会员储值卡设置分析、营销设置分析、商品管理设置分析
- 打印配送设置分析、系统设置分析报告
- 订单销售设置分析、财务统计设置分析
- 爱优Application结构
第二章：技术架构
2.1 整体架构图
┌─────────────────────────────────────────────────────────────┐
│ 移动端（微信小程序/H5） │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 文本输入 │ │ 语音输入 │ │ 图片输入 │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ └─────────────┴─────────────┘ │
│ │ │
│ ┌───────▼───────┐ │
│ │ 对话引擎 │ │
│ │ (消息路由) │ │
│ └───────┬───────┘ │
└──────────────────────┼───────────────────────────────────────┘
│ HTTPS/WebSocket
┌──────────────────────▼───────────────────────────────────────┐
│ API网关层 │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 意图识别引擎（Intent Engine） │ │
│ │ • 自然语言理解（NLU） │ │
│ │ • 实体提取（门店/商品/客户/金额/日期） │ │
│ │ • 意图分类（查询/操作/统计/打印/导航） │ │
│ └─────────────────────────────────────────────────────┘ │
└──────────────────────┬───────────────────────────────────────┘
│
┌──────────────────────▼───────────────────────────────────────┐
│ 业务能力层 │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 界面导航 │ │ 数据查询 │ │ 业务操作 │ │ 报表分析 │ │
│ │ Agent │ │ Agent │ │ Agent │ │ Agent │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 打印输出 │ │ 支付能力 │ │ 消息推送 │ │ 附件生成 │ │
│ │ Agent │ │ Agent │ │ Agent │ │ Agent │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
└──────────────────────┬───────────────────────────────────────┘
│
┌──────────────────────▼───────────────────────────────────────┐
│ 爱优现有系统层 │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 爱优五金PHP │ │ Python零售云│ │ Java零售云 │ │
│ │ (lingshou) │ │(python-api) │ │(RetailCloud)│ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ └────────────────┼────────────────┘ │
│ ┌──────▼──────┐ │
│ │ 爱优MySQL │ (CynosDB) │
│ │ ls_hnjiuheng_cn │
│ └─────────────┘ │
└───────────────────────────────────────────────────────────────┘
2.2 技术栈选型
| 层级 | 技术选型 | 说明 |
|---|---|---|
| 移动端 | 微信小程序 + H5 | 覆盖移动端用户 |
| 前端框架 | Vue3 + Vant4 | 轻量级移动UI组件库 |
| 实时通信 | WebSocket | 聊天消息实时推送 |
| 后端框架 | Python FastAPI | 高性能API + 异步支持 |
| LLM模型 | MiniMax-M2.7-highspeed | 当前爱优系统已在用 |
| 意图识别 | RAG知识库 | 基于已分析的12个文档构建向量库 |
| 语音识别 | 微信同声传译 | 集成微信JSSDK |
| 图片识别 | 腾讯云OCR | 商品条码/单据识别 |
| 数据库 | MySQL (现有CynosDB) | 复用爱优现有数据库 |
2.3 核心Agent设计
┌──────────────────────────────────────────────────┐
│ 爱优AI智能体 │
├──────────────────────────────────────────────────┤
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 导航 │ │ 查询 │ │ 操作 │ │
│ │ Agent │ │ Agent │ │ Agent │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │
│ "打开 │ "查询今天 │ "收款100 │ │
│ 商品管理"│ 销售报表" │ 元" │ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ 返回界面截图 返回数据表格 返回操作结果 │
│ +操作指引 +统计卡片 +二次确认 │
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 打印 │ │ 统计 │ │ 导出 │ │
│ │ Agent │ │ Agent │ │ Agent │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │
│ "打印 │ "本月销售 │ "导出Excel"│ │
│ 小票" │ 分析" │ │ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ 返回打印预览 返回图表分析 返回文件下载 │
│ │
└──────────────────────────────────────────────────┘
2.4 数据流设计
用户输入（文本/语音/图片）
│
▼
┌───────────────────┐
│ 消息预处理 │
│ • ASR语音转文本 │
│ • OCR图片识别 │
│ • 敏感词过滤 │
└────────┬──────────┘
│
▼
┌───────────────────┐
│ 意图识别 │
│ • 实体提取 │
│ (门店ID/商品 │
│ /客户/金额) │
│ • 意图分类 │
│ • 置信度判断 │
└────────┬──────────┘
│
▼
┌───────────────────┐
│ 意图分发 │
│ ┌─────────────┐ │
│ │ 置信度≥0.8 │ │──▶ 执行对应Agent
│ │ 置信度<0.8 │ │──▶ 反问确认
│ └─────────────┘ │
└────────┬──────────┘
│
▼
┌───────────────────┐
│ 结果生成 │
│ • 结构化回复 │
│ • 界面截图/数据 │
│ • 操作建议 │
└────────┬──────────┘
│
▼
┌───────────────────┐
│ 输出适配 │
│ • 文本 → 文本 │
│ • 语音 → TTS播放 │
│ • 图片 → 图片 │
└───────────────────┘
第三章：前端UI样式方案
3.1 整体视觉风格
| 属性 | 方案 |
|---|---|
| 设计语言 | 轻量化对话式设计，减少界面层级 |
| 配色方案 | 爱优品牌蓝 1890FF + 辅助色 |
| 圆角风格 | 12px圆角，卡片式布局 |
| 字体 | 微信默认字体，14px正文，16px标题 |
| 间距 | 8px基准网格，16px标准间距 |
3.2 聊天界面布局
┌────────────────────────────────────┐
│ 爱优AI智能体 ⋮ │ ← 标题栏
├────────────────────────────────────┤
│ │
│ ┌────────────────────────────┐ │
│ │ 👋 你好！我是爱优AI助手 │ │ ← AI欢迎消息
│ │ 可以这样问我： │ │
│ │ • "今天卖了多少钱" │ │
│ │ • "打开商品管理" │ │
│ │ • "打印销售小票" │ │
│ └────────────────────────────┘ │
│ │
│ ┌────────────────────────────┐ │
│ │ 我想查一下今天的销售业绩 │ │ ← 用户消息（右对齐）
│ └────────────────────────────┘ │
│ │
│ ┌────────────────────────────┐ │
│ │ 📊 今日销售统计 │ │ ← AI回复（卡片式）
│ │ ──────────────────────── │ │
│ │ 销售额 │ ¥15,800 │ │
│ │ 订单数 │ 1 笔 │ │
│ │ 毛利 │ ¥2,180 │ │
│ │ 毛利率 │ 13.9% │ │
│ │ ──────────────────────── │ │
│ │ [查看详情] [导出报表] │ │ ← 快捷操作按钮
│ └────────────────────────────┘ │
│ │
├────────────────────────────────────┤
│ 📎 💬 🎤 ➕ │ ← 快捷入口栏
│ [ 输入框... ] 发送 │ ← 输入区
└────────────────────────────────────┘
3.3 返回类型UI模板
3.3.1 数据卡片（查询结果）
┌────────────────────────────┐
│ 📊 [标题] [时间] │
│ ───────────────────────── │
│ 指标1 │ 数值/内容 │
│ 指标2 │ 数值/内容 │
│ 指标3 │ 数值/内容 │
│ ───────────────────────── │
│ [操作按钮1] [操作按钮2] │
└────────────────────────────┘
3.3.2 界面预览（导航结果）
┌────────────────────────────┐
│ 🖼️ 界面预览 │
│ ┌────────────────────────┐ │
│ │ │ │
│ │ [界面截图/示意图] │ │
│ │ │ │
│ └────────────────────────┘ │
│ ───────────────────────── │
│ 功能说明：xxxxx │
│ ───────────────────────── │
│ [打开此界面] [返回首页] │
└────────────────────────────┘
3.3.3 操作确认（执行结果）
┌────────────────────────────┐
│ ⚠️ 操作确认 │
│ ───────────────────────── │
│ 操作：收款 │
│ 客户：张三 │
│ 金额：¥1,280.00 │
│ 支付方式：微信支付 │
│ ───────────────────────── │
│ 请确认以上信息是否正确？ │
│ [确认收款] [修改金额] [取消]│
└────────────────────────────┘
3.3.4 图表分析（统计结果）
┌────────────────────────────┐
│ 📈 [图表标题] │
│ ┌────────────────────────┐ │
│ │ │ │
│ │ [柱状图/折线图/饼图] │ │
│ │ │ │
│ └────────────────────────┘ │
│ ───────────────────────── │
│ 解读：xxxxx │
│ ───────────────────────── │
│ [查看更多] [导出数据] │
└────────────────────────────┘
3.4 快捷入口设计
| 入口 | 图标 | 功能 |
|---|---|---|
| 📎 | 附件 | 发送图片/文件 |
| 💬 | 模板 | 快捷话术模板 |
| 🎤 | 语音 | 语音输入 |
| ➕ | 加号 | 更多功能菜单 |
3.5 底部Tabbar设计
┌────┬────┬────┬────┐
│首页│工作│报表│我的│
│🏠 │💼 │📊 │👤 │
└────┴────┴────┴────┘
第四章：聊天交互设计
4.1 输入方式
| 输入方式 | 技术实现 | 适用场景 |
|---|---|---|
| 文本输入 | 键盘直接输入 | 精确指令、搜索 |
| 语音输入 | 微信JSSDK录音→ASR | 移动场景、口述数据 |
| 图片输入 | 微信选图→OCR | 商品扫码、单据识别 |
4.2 语音输入流程
用户点击🎤
│
▼
┌───────────────────┐
│ 录音中... │ ← 显示录音动画
│ ●●●●○○○○ │
│ [松开结束/上滑取消] │
└────────┬──────────┘
│
松开/超时
│
▼
┌───────────────────┐
│ 识别中... │
└────────┬──────────┘
│
▼
┌───────────────────┐
│ "查询今天销售业绩" │ ← 显示识别结果
│ [发送] │
└───────────────────┘
4.3 图片输入流程
用户点击📎选择图片
│
▼
┌───────────────────┐
│ 图片预处理 │
│ • 压缩（<2MB） │
│ • 识别类型 │
└────────┬──────────┘
│
▼
┌───────────────────┐
│ 内容识别 │
│ • 条码→商品信息 │
│ • 单据→数据提取 │
│ • 截图→界面分析 │
└────────┬──────────┘
│
▼
┌───────────────────┐
│ 返回结果 │
│ • 商品信息卡片 │
│ • 或 操作建议 │
└───────────────────┘
4.4 意图分类与处理
| 意图类别 | 关键词示例 | 返回类型 | 处理方式 |
|---|---|---|---|
| 界面导航 | "打开xxx" "进入xxx" "找xxx" | 界面预览+截图 | 返回截图+deep_link |
| 数据查询 | "查xxx" "看看xxx" "xxx多少" | 数据卡片+表格 | 执行查询SQL |
| 业务操作 | "收款" "开单" "退货" "退款" | 操作确认卡片 | 二次确认+执行 |
| 统计分析 | "分析xxx" "xxx报表" "对比xxx" | 图表+解读 | 执行统计SQL |
| 打印输出 | "打印xxx" "小票" "标签" | 打印预览 | 调用打印API |
| 导出数据 | "导出xxx" "下载xxx" | 文件下载 | 生成文件返回 |
| 帮助引导 | "怎么用" "帮我xxx" "推荐xxx" | 建议卡片 | 返回引导话术 |
4.5 多轮对话设计
用户：今天卖了多少？
AI：📊 今日销售
销售额：¥15,800
[还想看什么？昨日对比/分类统计/TOP商品]
用户：和昨天对比一下
AI：📈 今日 vs 昨日
今日：¥15,800（1单）
昨日：¥89,092（5单）
下降82.3%，主要减少原因是...
[查看原因分析] [导出报表]
用户：导出这个报表
AI：正在生成Excel...
✅ 已生成，点击下载：[今日销售报表.xlsx]
[查看更多报表]
4.6 错误处理
| 错误类型 | AI回复示例 |
|---|---|
| 无法识别意图 | "没理解您的意思，您可以试试：'打开商品管理'、'查询今日销售'、'打印小票'" |
| 数据不存在 | "没有找到相关数据，您可以：1）检查筛选条件 2）尝试其他关键词" |
| 操作失败 | "操作失败了（原因：库存不足），您可以：1）减少数量 2）联系供应商" |
| 权限不足 | "您没有权限进行此操作，请联系管理员开通权限" |
第五章：核心功能模块
5.1 界面导航Agent
能力：根据用户描述，找到对应界面并提供操作入口
知识库：基于爱优五金零售系统界面清单（170个界面）构建
示例对话：
用户：打开商品管理
AI：🖼️ 商品管理界面
[界面截图]
功能：商品增删改查、分类管理、标签管理
[直接打开] [查看所有功能]
5.2 数据查询Agent
能力：查询数据库，返回结构化数据
知识库：基于12个设置分析文档，掌握所有字段含义
示例对话：
用户：查一下今天卖了哪些商品
AI：📦 今日销售商品（1笔订单）
商品名称 数量 金额
螺丝刀M8 10把 ¥120
螺母M8 50个 ¥25
─────────────────────────
合计 60件 ¥145
[查看详情] [打印小票]
5.3 业务操作Agent
能力：执行具体业务操作（收款、开单、退货等）
知识库：基于12个文档，掌握所有业务逻辑
示例对话：
用户：收到李四微信转账500元
AI：⚠️ 确认收款
客户：李四
金额：¥500.00
支付方式：微信支付
─────────────────────────
[确认收款] [修改金额] [取消]
5.4 报表分析Agent
能力：生成统计报表，提供数据解读
知识库：基于财务统计设置分析文档
示例对话：
用户：分析一下本月销售情况
AI：📈 本月销售分析
[近30天销售趋势图]
销售额：¥359,162（37单）
环比增长：+12.5%
TOP3品类：工具类/五金/建材
─────────────────────────
分析：本月销售额较上月增长12.5%，
主要增长来自工具类商品...
[查看完整报告] [导出数据]
5.5 打印输出Agent
能力：调用打印服务，生成小票/标签
知识库：基于打印配送设置分析文档
示例对话：
用户：打印刚才那笔销售小票
AI：🖨️ 打印预览
[小票预览图]
门店：月湖店
单号：XS20260515001
商品：螺丝刀M8 x10
─────────────────────────
[立即打印] [修改纸张] [取消]
第六章：知识库构建
6.1 向量数据库设计
| 文档来源 | 内容 | 向量化方式 |
|---|---|---|
| 爱优五金零售系统界面清单.md | 170个界面目录说明 | 按目录分块 |
| 会员储值卡设置分析.md | 会员相关所有字段 | 按文件分块 |
| 会员营销设置分析.md | 营销活动字段 | 按文件分块 |
| 商品管理设置分析.md | 商品字段 | 按文件分块 |
| 打印配送设置分析.md | 打印/配送配置 | 按文件分块 |
| 系统设置分析报告.md | 系统设置字段 | 按文件分块 |
| 订单销售设置分析.md | 订单/销售字段 | 按文件分块 |
| 财务统计设置分析.md | 财务/统计字段 | 按文件分块 |
| 零售功能设置分析.md | 功能类字段 | 按文件分块 |
| 零售设置分析.md | 零售设置字段 | 按文件分块 |
| 零售设置分析完整版.md | 完整设置字段 | 按文件分块 |
| 爱优Application结构.txt | 代码结构 | 按模块分块 |
6.2 实体词典
| 实体类型 | 示例 | 识别方式 |
|---|---|---|
| 门店名称 | 月湖店、星沙店 | 词典匹配 |
| 商品名称 | 螺丝刀M8、螺母M8 | 模糊匹配 |
| 客户名称 | 张三、李四 | 词典匹配 |
| 金额 | 100元、500、¥1200 | 正则匹配 |
| 日期 | 今天、昨天、本月、上周 | 规则匹配 |
| 操作类型 | 收款、开单、退货、打印 | 词典匹配 |
第七章：安全设计
7.1 权限控制
| 等级 | 说明 | 可执行操作 |
|---|---|---|
| 店员 | 基础权限 | 查询、收款、打印 |
| 店长 | 店员+管理 | 开单、退货、报表 |
| 管理员 | 店长+配置 | 所有操作 |
7.2 操作安全
| 安全措施 | 实现方式 |
|---|---|
| 敏感操作二次确认 | 收款、退货、删除等 |
| 操作日志记录 | 记录到operate_log表 |
| 异常操作告警 | 大额交易、频繁退款 |
第八章：开发计划（Kanban）
看板结构
爱优AI智能体开发计划
├── 第一阶段：基础能力（1-2周）
│ ├── 需求确认与细化
│ ├── 技术选型与架构设计
│ ├── 开发环境搭建
│ └── 对话引擎基础实现
│
├── 第二阶段：核心Agent（3-4周）
│ ├── 界面导航Agent
│ ├── 数据查询Agent
│ ├── 业务操作Agent
│ └── 知识库构建
│
├── 第三阶段：高级能力（5-6周）
│ ├── 报表分析Agent
│ ├── 打印输出Agent
│ ├── 语音识别集成
│ └── 图片识别集成
│
├── 第四阶段：测试与优化（7-8周）
│ ├── 功能测试
│ ├── 性能优化
│ ├── 用户体验优化
│ └── 安全审计
│
└── 第五阶段：上线与迭代（9-10周）
├── 小程序发布
├── 用户培训
├── 反馈收集
└── 版本迭代
任务卡模板
┌─────────────────────────────────────────┐
│ 任务：[具体任务名称] │
├─────────────────────────────────────────┤
│ 阶段：第一阶段 - 基础能力 │
│ 负责人：[分配人员] │
│ 预估工时：[X]天 │
│ 优先级：P0/P1/P2/P3 │
│ ──────────────────────────────────── │
│ 验收标准： │
│ 1. [具体可验收的条目] │
│ 2. [具体可验收的条目] │
│ 3. [具体可验收的条目] │
│ ──────────────────────────────────── │
│ 状态：待办 | 进行中 | 完成 | 阻塞 │
│ 备注：[备注信息] │
└─────────────────────────────────────────┘
详细任务拆解
第一阶段：基础能力
| 任务 | 负责人 | 工时 | 优先级 |
|---|---|---|---|
| 需求评审与细化 | 待分配 | 2天 | P0 |
| 技术架构设计评审 | 待分配 | 2天 | P0 |
| 开发环境搭建（Git/Docker/DB） | 待分配 | 2天 | P0 |
| 基础对话框架开发 | 待分配 | 5天 | P0 |
| 意图识别引擎开发 | 待分配 | 5天 | P0 |
| 实体提取开发 | 待分配 | 3天 | P1 |
| 消息路由开发 | 待分配 | 2天 | P0 |
| 基础UI组件开发 | 待分配 | 5天 | P1 |
第二阶段：核心Agent
| 任务 | 负责人 | 工时 | 优先级 |
|---|---|---|---|
| 知识库文档整理 | 待分配 | 3天 | P0 |
| 向量数据库搭建 | 待分配 | 2天 | P0 |
| 界面导航Agent开发 | 待分配 | 5天 | P0 |
| 数据查询Agent开发 | 待分配 | 5天 | P0 |
| 业务操作Agent开发 | 待分配 | 5天 | P0 |
| RAG检索优化 | 待分配 | 3天 | P1 |
| Agent调度引擎 | 待分配 | 3天 | P0 |
第三阶段：高级能力
| 任务 | 负责人 | 工时 | 优先级 |
|---|---|---|---|
| 报表分析Agent开发 | 待分配 | 5天 | P1 |
| 打印输出Agent开发 | 待分配 | 4天 | P1 |
| 微信语音识别集成 | 待分配 | 3天 | P1 |
| 图片OCR识别集成 | 待分配 | 3天 | P1 |
| 图表可视化组件 | 待分配 | 4天 | P2 |
| 多轮对话优化 | 待分配 | 3天 | P1 |
第四阶段：测试与优化
| 任务 | 负责人 | 工时 | 优先级 |
|---|---|---|---|
| 功能测试用例编写 | 待分配 | 3天 | P0 |
| 功能测试执行 | 待分配 | 5天 | P0 |
| 性能测试与优化 | 待分配 | 3天 | P1 |
| 安全测试与加固 | 待分配 | 3天 | P0 |
| UI/UX优化 | 待分配 | 3天 | P2 |
| 冒烟测试 | 待分配 | 2天 | P0 |
第五阶段：上线与迭代
| 任务 | 负责人 | 工时 | 优先级 |
|---|---|---|---|
| 小程序账号申请 | 待分配 | 2天 | P0 |
| 小程序发布审核 | 待分配 | 5天 | P0 |
| 用户手册编写 | 待分配 | 2天 | P1 |
| 用户培训 | 待分配 | 2天 | P1 |
| 线上问题收集 | 待分配 | 持续 | P0 |
| 版本迭代规划 | 待分配 | 持续 | P0 |
第九章：风险与挑战
| 风险 | 影响 | 应对措施 |
|---|---|---|
| LLM响应速度慢 | 用户体验差 | 增加本地缓存、优化Prompt |
| 意图识别不准确 | 操作错误 | 增加确认环节、持续优化 |
| 语音识别错误 | 指令误判 | 显示识别结果供用户确认 |
| 数据库压力大 | 系统不稳定 | SQL优化、读写分离 |
| 用户习惯改变 | 推广困难 | 提供传统界面兼容、培训 |
第十章：附录
10.1 相关文档索引
| 文档 | 路径 |
|---|---|
| 爱优五金零售系统界面清单 | 爱优新零售/界面功能/爱优五金零售系统界面清单.md |
| 会员储值卡设置分析 | 爱优新零售/界面功能/会员储值卡设置分析.md |
| 会员营销设置分析 | 爱优新零售/界面功能/会员营销设置分析.md |
| 商品管理设置分析 | 爱优新零售/界面功能/商品管理设置分析.md |
| 打印配送设置分析 | 爱优新零售/界面功能/打印配送设置分析.md |
| 系统设置分析报告 | 爱优新零售/界面功能/系统设置分析报告.md |
| 订单销售设置分析 | 爱优新零售/界面功能/订单销售设置分析.md |
| 财务统计设置分析 | 爱优新零售/界面功能/财务统计设置分析.md |
| 零售功能设置分析 | 爱优新零售/界面功能/零售功能设置分析.md |
| 零售设置分析 | 爱优新零售/界面功能/零售设置分析.md |
| 零售设置分析完整版 | 爱优新零售/界面功能/零售设置分析完整版.md |
| 爱优Application结构 | 爱优新零售/界面功能/爱优Application结构.txt |
10.2 待讨论事项
- 部署方式：独立部署 vs 复用现有api_server架构
- 模型选择：继续用MiniMax还是切换其他模型
- 微信小程序：使用现有小程序还是新建AI助手小程序
- 权限体系：是否复用现有门店权限还是新建AI权限
- 数据隔离：多商户数据隔离方案