自动报价机器人系统 — 开发者架构文档

1. 引言

1.1 目的

本文档定义“自动报价机器人”系统的技术架构、数据流与部署方案。系统围绕 “主服务器为大脑，分支服务器为业务员” 设计，面向汽配报价场景，支持操作人员通过 Web 页面输入 车架号 + 配件名称/OEM码，自动完成车型解码、精准 OEM 锁定、服务站及 ERP 信息聚合，输出报价。文档涵盖纯本地、混合云及全云部署方案，并提供成本对比。

1.2 读者对象

· 后端开发、运维、AI 工程师
· 产品与项目经理
· 客户 IT 决策者

1.3 术语定义

术语 说明
主服务器 大脑节点，运行 DeepSeek 8B 与知识引擎，负责推理、学习
分支服务器 业务执行节点，接入 ERP/EPC/DMS，受理报价请求并调用主 AI
DeepSeek 8B 本地/云上免费部署的大语言模型
v4 API DeepSeek 云端收费接口，高难度场景自动切换
EPC 加密狗 客户自行购买提供的硬件锁，插入分支服务器 USB 口以访问电子零件目录
软件登录点 按实例的在线授权，与加密狗无关
汽修宝 第三方 VIN 初步车型解码服务
EPC 电子零件目录，用于精准车型确认与 OEM 锁定

2. 系统总体架构

2.1 纯本地部署（内网）

“`
[操作者电脑] [分支服务器群(本地)] [主服务器(本地)]
Web 浏览器 ──HTTP──> 分支-1 (插EPC加密狗) ──RPC──> 主服务器(GPU,8B)
│ 调用汽修宝、EPC、DMS
└ 本地ERP客户端
“`

所有节点仅限局域网通信，数据不出内网。

2.2 混合云部署（推荐扩展方案）

“`
[客户局域网] [云 VPC]
├─分支-1 (本地,插EPC加密狗)──VPN──云主服务器(GPU,8B)
├─分支-2 (本地,插EPC加密狗)──VPN──┘
└─操作者PC
“`

· 主服务器上云，享受弹性算力，免除昂贵硬件采购。
· 分支服务器保留本地以确保 EPC 加密狗直插和 ERP 低延迟。

2.3 全云部署（可选，适用于高弹性、无本地硬件场景）

“`
[操作者任意终端]──互联网──[云负载均衡]
├─云分支-1 (需连接远程EPC加密狗)
├─云分支-2 (需连接远程EPC加密狗)
└─云主服务器(8B)
“`

· 主服务器、分支服务器均租赁云主机。
· EPC 加密狗问题：由于云主机无法直接插入物理 USB，需在客户机房部署一台 USB over IP 设备，将物理加密狗共享至云端分支服务器。软件层需安装对应驱动，网络延迟需控制在 10ms 内。此方案增加少量硬件成本和配置复杂度，但可实现分支完全上云。

3. 硬件与软件清单

3.1 各部署模式组件表

组件 纯本地 混合云 全云
主服务器 自建 GPU 服务器 租赁云 GPU 实例，月付 同混合云
分支服务器 本地工控机 本地工控机 租赁云主机，月付（配置按需）
EPC 加密狗 客户提供，插本地分支 客户提供，插本地分支 客户提供 + USB over IP 设备
软件登录点 主1点+每分支1点，同左 同左
DeepSeek 8B 本地免费 云端免费 云端免费
v4 API 可选按量付费 可选按量付费 可选按量付费
汽修宝/EPC/DMS 账号 客户自行采购 客户自行采购 客户自行采购
网络 局域网 VPN/专线 公网/专线 + USB over IP 网络

3.2 云服务器参考规格及月费（2025年市场均价）

角色 推荐配置 月费范围
云主服务器 GPU 实例（T4 16G 显存）、8核32G、200G SSD
云分支服务器 通用型 4核8G、50G SSD、出网带宽 5Mbps
USB over IP 设备 单端口加密狗共享器

以上为按量/包月参考价，实际费用与云厂商、地域、承诺使用时长有关。分支服务器数量按需租赁，月费随数量线性增加。

4. 核心业务流程（优化版）

4.1 输入规范

· 必填：车架号（VIN）
· 二选一：配件名称（自然语言） 或 OEM 码

4.2 增强型双阶段车型解码与报价流程

设计理念：先通过汽修宝快速完成 VIN 基础解析（品牌、车系、年款），再进入 EPC 进行高精度车型配置确认与 OEM 零件锁定，避免因单一源数据不全导致的匹配错误。

“`
操作者 分支服务器 汽修宝 EPC (加密狗) DMS/ERP 主服务器
│ │ │ │ │ │
├─提交VIN+配件──>│ │ │ │ │
│ ├─初步车型解码─────>汽修宝 │ │ │
│ │<──品牌/车系/年款/发动机───────────┤ │ │
│ ├─精准车型确认及OEM锁定───────────────>EPC(插入加密狗)│ │
│ │<──完整车型配置+精准OEM列表+替换件─────────────────────┤ │
│ ├─服务站查询─────────────────────────────>DMS │ │
│ │<──指导价/库存/促销─────────────────────────────────┤ │
│ ├─内部采销查询─────────────────────────────>ERP │ │
│ │<──成本/历史售价/现库存─────────────────────────────┤ │
│ ├─AI报价决策──────────────────────────────────────────────>主服务器│
│ │<──报价建议+自然语言话术────────────────────────────────────────┤
│<──最终结果+话术─┤ │ │ │ │
“`

步骤详解：

1. 初步车型解码：分支服务器调用汽修宝 API，传入 VIN，获取基础车型信息（品牌、车系、年款、发动机型号等）。此步速度快，覆盖 95% 以上常见车型。
2. 精准车型确认与 OEM 锁定：将汽修宝返回的车型关键字段传入 EPC（通过加密狗认证），EPC 返回该车辆精确配置（如变速器类型、驱动形式、生产区间），并直接给出目标配件的精准 OEM 码、替换关系链及零件位置图。对于输入为自然语言配件名的情况，本步骤中主服务器已提前介入语义标准化（调用 /ai/parse_accessory）辅助 EPC 检索。
3. 聚合市场与内部数据：用精准 OEM 查询 DMS 服务站价格与库存，查询本地 ERP 成本与历史成交。
4. AI 报价决策：主服务器结合车型、配件、市场行情、内部成本及历史报价知识库（Excel），生成报价区间、加价建议及操作者话术。
5. 返回结果：分支服务器渲染 Web 页面，操作者直接使用或复制回答顾客。

5. 主服务器详细设计

5.1 AI 路由策略

同前版本，本地/云端 8B 优先，高复杂度自动切换 v4 API。

5.2 数据存储与学习（Excel 知识库）

· 知识库完全基于 不加密的 Excel 文件（.xlsx），存放于主服务器共享目录。
· 文件列表及内容：
· 车型映射库.xlsx：VIN 规则片段、汽修宝车型 ID 与 EPC 车型代码映射。
· OEM_知识库.xlsx：OEM、适用车型、替换关系、别名。
· 报价案例库.xlsx：历史报价记录（VIN、OEM、成本、售价、时间、地区）。
· 学习引擎每日通过计划任务更新 Excel，从 EPC 同步增量数据，并吸收分支反馈的成交价格。
· AI 推理时，从 Excel 检索相关行作为 Prompt 上下文（轻量 RAG）。

5.3 对外 API

与 v2.0 一致。

6. 分支服务器详细设计

6.1 本地分支（插加密狗）

· 工控机或普通 PC，成本低。
· 插入客户提供的 EPC 加密狗，驱动已集成。
· Web 界面供操作者访问，所有外部适配器（汽修宝、EPC、DMS）本地调用。

6.2 云分支（需远程加密狗）

· 云主机租赁，按需创建。
· EPC 加密狗接入：客户需在本地机房部署 USB over IP 设备（如 AnywhereUSB、VirtualHere），将物理加密狗映射到云分支服务器的 USB 端口。该设备需分配固定内网 IP，并通过 VPN 与云分支网络连通。
· 优势：分支服务器零维护、可弹性伸缩；劣势：依赖网络稳定性，加密狗映射有一定延迟，适合 EPC 查询频率不极度敏感的场景。

6.3 软件许可证检查

· 启动时在线验证软件登录点，每台分支均需一个登录点。
· EPC 加密狗缺失或映射失败时，EPC 功能自动禁用，系统会提示操作者。

7. 部署模式选择建议（关键）

企业规模 推荐方案 理由
小规模企业（日均报价<200次，1-3 个操作员） 纯本地部署一次性硬件投入；本地 8B 模型足够应对；数据全内网安全。长期总成本最低。
中型企业 混合云部署 主服务器上云免去 GPU 硬件投入，弹性应付高峰；本地分支保留加密狗，月费约（1 主+3 分支），长期成本可控。
大型企业/平台（海量并发，多地分布） 全云部署 所有节点弹性伸缩，分支按需租赁；需配套 USB over IP 解决加密狗；月费高，但获得极致弹性和灾备能力。

成本趋势：本地部署一次性投入大，但 1~2 年后总成本开始低于云方案；云方案按月支付，长期总费用高，适合追求轻资产、弹性扩展的企业。

8. 许可证与费用汇总

资源 成本类型 备注
软件登录点 主服务器及每台分支各需 1 点
云主服务器 按配置计费
云分支服务器 按需数量
USB over IP 设备 仅全云方案需要，客户购买
EPC 加密狗 客户自行解决 不属于本系统成本
汽修宝/EPC/DMS 账号 客户自行采购 年费或按次

9. 部署拓扑与网络

· 纯本地：主、分支、操作者均在同一局域网，出站白名单仅放行汽修宝、DMS。
· 混合云：主服务器部署于云 VPC，通过 IPsec VPN 或专线与客户局域网连通，分支服务器可通过内网地址访问云主 AI 端口。
· 全云：所有服务器在同一个云 VPC 内，客户操作者通过 HTTPS 访问云分支 Web 界面；USB over IP 设备需在客户侧设置 VPN 客户端接入云 VPC。

10. 安全与运维

· Web 登录鉴权、API Token + IP 白名单。
· Excel 文件仅服务账户可读写，不直接暴露。
· 监控：本地用 Prometheus，云上利用云监控。
· 告警：加密狗异常（本地/远程）、登录点到期、Excel 文件损坏、报价失败率。