# 1688 智能采购自动化平台 — 项目汇报大纲

> 适用于向管理层/团队进行项目汇报的 PPT 结构化大纲

---

## 一、项目背景与目标（3~4 页）

### 1.1 业务痛点

- **采购物料数据质量参差不齐**：供应商提供的物料清单格式混乱，名称不统一，缺少关键参数
- **1688 平台搜索效率低下**：人工逐条搜索，关键词构造靠经验，搜索结果筛选耗时
- **供应商联系信息获取困难**：手动进入店铺页面提取电话/旺旺，重复劳动量大
- **询价沟通周期长**：逐个供应商手工询价，多轮沟通缺乏标准化流程
- **数据追溯无体系**：采购全链路缺少结构化记录，无法审计与复盘

### 1.2 项目目标

- 构建**端到端的采购自动化平台**，覆盖「物料导入 → 标准化 → 搜索 → 供应商提取 → 智能询价 → 结果汇总」全链路
- 利用 **LLM + RPA** 技术组合，大幅降低人工介入，提升采购效率
- 实现全流程**可追溯、可审计、可复盘**

### 1.3 核心价值

| 维度 | 传统方式 | 本系统方案 |
|------|---------|-----------|
| 物料标准化 | 人工协商补充 | LLM 联合研判 + 人工补充闭环 |
| 1688 搜索 | 人工逐条搜索 | 多轮渐进式搜索 + 图搜融合 |
| 供应商信息 | 手动复制粘贴 | Playwright RPA 自动提取 + OCR |
| 询价沟通 | 逐个人工聊天 | AI 聊天机器人 4+ 轮次自动询价 |
| 数据沉淀 | 无系统记录 | 结构化数据库 + 完整审计链路 |

---

## 二、系统架构总览（2~3 页）

### 2.1 整体架构图

```
┌─────────────────────────────────────────────────────────┐
│              前端 Web UI (React + Vite)                  │
│   Dashboard │ 物料管理 │ 标准化 │ 搜索结果 │ 智能询价    │
└──────────────────────────┬──────────────────────────────┘
                           │ HTTP / React Query
                           ▼
┌─────────────────────────────────────────────────────────┐
│            后端 API 层 (Express + Node.js)               │
│  CSV 上传 │ 任务调度 │ 状态轮询 │ LLM 配置管理           │
└──────────────────────────┬──────────────────────────────┘
                           │
          ┌────────────────┼────────────────┐
          ▼                ▼                ▼
┌──────────────┐  ┌───────────────┐  ┌──────────────────┐
│  自动化管道   │  │  LLM 服务集群  │  │  Supabase 数据库  │
│ (Playwright  │  │ OpenAI/DeepSeek│  │  PostgreSQL +    │
│  RPA 引擎)   │  │ 智谱/通义千问  │  │  Storage + Auth  │
└──────────────┘  └───────────────┘  └──────────────────┘
       │
       ▼
┌──────────────┐
│  1688.com    │
│  (目标平台)   │
└──────────────┘
```

### 2.2 技术栈一览

| 层级 | 技术选型 | 说明 |
|------|---------|------|
| 前端框架 | React 18 + TypeScript | 单页应用，组件化开发 |
| UI 组件 | shadcn/ui (Radix UI) + Tailwind CSS | 现代化 UI 设计体系 |
| 数据层 | TanStack React Query | 服务端状态管理与缓存 |
| 路由 | React Router 6 | 客户端路由 |
| 后端服务 | Express (Node.js) | 轻量级 API 服务 |
| 数据库 | Supabase (PostgreSQL) | 云端数据库 + 存储 + 认证 |
| 浏览器自动化 | Playwright | 1688 页面交互与数据采集 |
| AI/LLM | OpenAI / DeepSeek / 智谱 / 通义千问 | 多模型适配，按场景选型 |
| 构建工具 | Vite | 极速开发与构建 |
| 测试 | Vitest + Testing Library + Playwright | 单元测试 + 集成测试 + E2E |

---

## 三、核心业务流程（5~7 页）

### 3.1 全链路业务流程图

```
采购清单CSV ──→ ① 物料导入 ──→ ② 标准化 ──→ ③ 关键词生成
                                                    │
          ⑥ 结果汇总 ←── ⑤ 智能询价 ←── ④ 搜索执行 ←┘
```

### 3.2 阶段一：物料导入与解析

- **输入**：采购清单 CSV / Excel 文件
- **处理**：
  - 字段名规范化映射
  - 重复 material_id 检测
  - 数据预览与确认机制
- **输出**：结构化物料记录写入 `procurement_materials` 表

### 3.3 阶段二：AI 标准化

- **目标**：统一物料名称、补全缺失参数、判断是否可搜 1688
- **实现**：
  - **在线模式**：逐条调用 LLM（OpenAI / DeepSeek / 智谱），适合小批量
  - **离线批处理**：智谱 BigModel Batch API，适合百条以上大批量
  - **联合研判**：LLM 同时输出标准名、建议关键词、可搜判断、缺失字段
- **人工补充闭环**：
  - 标准化失败时自动生成补充提示（缺少哪些字段、建议如何补充）
  - 用户在前端填写补充信息后触发重试
  - 重试记录与原记录通过 `retry_of_item_id` 关联，形成完整链路

### 3.4 阶段三：关键词生成与融合

- **关键词生成算法**（多轮渐进式）：
  - 第 1 轮：完整搜索词（名称 + 核心参数 + 规格 + 修饰词，≤30 字）
  - 第 2~N 轮：渐进式降级（依次删除修饰词 → 参数 → 规格）
  - 最末轮：仅保留名称
- **多模态关键词融合**（创新点）：
  - 输入：原始物料图片 + 1688 搜索结果截图 + 标题列表
  - LLM 多模态推理（GPT-4o / GLM-4V 视觉模型）
  - 融合步骤：识别原图物料 → 分析搜索结果高频词 → 输出最优关键词

### 3.5 阶段四：自动搜索执行

- **多阶段搜索引擎**：
  - 文字搜索：按关键词优先级逐轮执行
  - 图片搜索：LLM 选择最佳参考图 → 上传 1688 图搜
- **搜索质量保障**：
  - 视觉有效性判定：LLM 审核搜索结果截图（排除登录页、空结果页）
  - 命中率计算：本地匹配 + LLM 语义复核，0~1 评分
  - 候选过滤：LLM 筛选与目标物料真正匹配的商品
- **联系方式提取**：
  - Playwright 自动进入供应商店铺页面
  - 提取电话、邮箱、QQ、旺旺等联系方式
  - OCR 识别图片中的电话号码

### 3.6 阶段五：AI 智能询价（聊天机器人）

- **4+ 轮次结构化对话**：

| 轮次 | 询问内容 | LLM 任务 |
|------|---------|---------|
| 第 1 轮 | 是否有现货 | 意图分类（有/无/询问中） |
| 第 2 轮 | 规格与起订量确认 | 技术参数提取 |
| 第 3 轮 | 价格与交期 | 实体提取（数字、时间） |
| 第 4 轮 | 国标与专票 | 布尔判断 |
| 第 5+ 轮 | 自定义补充问题 | 通用 LLM 理解 |

- **旺旺 RPA 自动化**：Playwright 控制旺旺客户端发送消息、接收回复
- **结果结构化**：每轮对话结果提取为标准字段，汇总为供应商评估报告

### 3.7 阶段六：结果聚合与输出

- 多阶段搜索结果去重合并
- 按阶段排序与评分
- 最终结构化数据写入 `standardized_results`
- 前端多维度展示 + Excel/CSV 导出

---

## 四、前端功能展示（4~6 页）

### 4.1 Dashboard（仪表板）

- 任务执行状态统计（进行中 / 已完成 / 失败）
- 最近活动流
- 快速入口导航

### 4.2 物料管理（Materials）

- 物料列表（分页、搜索、筛选）
- CSV/Excel 批量导入
- 单条编辑 + 批量操作
- 数据导出

### 4.3 标准化结果（Standardized）

- 标准化任务列表与状态
- 成功/失败/待补充三态展示
- 人工补充表单（缺失字段高亮提示）
- 重试机制与链路追溯

### 4.4 搜索结果（Search Results）

- 搜索阶段对比视图
- 命中率可视化
- 商品详情与供应商信息展示
- 结果筛选与导出

### 4.5 供应商管理（Merchants）

- 供应商联系信息库
- 自动去重分组
- 联系质量评分

### 4.6 智能询价（Smart Inquiry）

- 聊天机器人交互面板
- 多轮对话实时展示
- 结构化提取结果预览

### 4.7 批次管理（Batch Management）

- 批次级别的任务编排
- 批次状态跟踪
- 批次间数据关联

---

## 五、技术亮点与创新（3~4 页）

### 5.1 多模型适配架构

- 统一 OpenAI API 兼容接口，同时支持 OpenAI / DeepSeek / 智谱 / 通义千问
- 按场景动态选择最优模型（标准化用 DeepSeek 性价比高，视觉任务用 GPT-4o）
- `llm_config` 表实现模型参数热配置，无需重启服务

### 5.2 提示词远程管理（Prompt Store）

- 所有 LLM 提示词集中管理到独立 Supabase 项目
- 支持版本化（draft → active → archived）
- 支持环境隔离（prod / staging / dev）
- 支持模型适配（不同模型可用不同提示词版本）
- 代码与提示词完全解耦，运营人员可直接调优提示词

### 5.3 渐进式搜索策略

- 从完整关键词到最简关键词的多轮降级搜索
- 结合文字搜索与图片搜索双通道
- 命中率实时评估，自动决策搜索是否继续
- 有效避免「搜不到」和「搜太多」两种极端情况

### 5.4 人工补充闭环设计

- 标准化失败不终止流程，而是进入「待补充」状态
- 自动生成人工补充提示（缺哪些字段、建议如何填写）
- 补充后重试，重试链路完整记录（retry_of_item_id → resolved_by_task_id）
- 人机协作的最佳实践：AI 处理 80%，人工兜底 20%

### 5.5 离线批处理能力

- 大批量物料（100+）使用智谱 BigModel Batch API
- 异步提交 → 轮询状态 → 批量回收结果
- 成本更低、吞吐更大、无超时限制

---

## 六、数据架构（2~3 页）

### 6.1 核心数据模型

```
procurement_materials (采购物料主表)
       │
       ├── standardization_tasks (标准化任务)
       │       └── standardization_task_items (标准化明细)
       │               └── standardized_results (标准化结果)
       │
       ├── search_tasks (搜索任务)
       │       └── search_task_items (搜索明细)
       │               ├── keyword_process (关键词分析)
       │               ├── search_rounds (搜索轮次)
       │               └── keyword_selection (关键词融合)
       │
       ├── image_search_results (图搜结果)
       │
       ├── wangwang_contacts (旺旺联系记录)
       │
       └── merchant_dedup_groups (供应商去重分组)
```

### 6.2 关键表说明

| 表名 | 功能 | 关键字段 |
|------|------|---------|
| `procurement_materials` | 采购物料主表 | material_id, name, specs, batch_id |
| `standardization_task_items` | 标准化明细 | analysis_result, patched_fields, status |
| `keyword_process` | 关键词分析 | keyword_input, search_plans, ai_keyword_analysis |
| `search_rounds` | 搜索轮次 | stage_order, primary_keyword, keyword_hit_rate |
| `wangwang_contacts` | 旺旺联系记录 | conversation_rounds, extracted_data |
| `llm_config` | LLM 模型配置 | provider, model, temperature, max_tokens |
| `prompt_templates` / `prompt_versions` | 提示词管理 | prompt_key, payload_json, status |

---

## 七、部署与运维（1~2 页）

### 7.1 部署架构

- **前端**：Vite 构建静态资源，可部署到 CDN / Nginx
- **后端**：Node.js Express 服务，systemd 管理进程
- **数据库**：Supabase 云端（生产）/ 本地 Docker（开发）
- **自动化**：Playwright 浏览器实例，支持 headless 与 headed 模式

### 7.2 运维能力

- systemd 服务自动重启
- 一键部署脚本（`deploy.sh`）
- 开发环境 Vite + Express 并行启动
- 数据库迁移管理

---

## 八、项目成果与数据（1~2 页）

> 根据实际运行数据填写

### 8.1 效率提升

| 指标 | 人工方式 | 自动化方式 | 提升幅度 |
|------|---------|-----------|---------|
| 单条物料标准化 | ~5 分钟 | ~10 秒 | **30x** |
| 单条物料搜索 | ~10 分钟 | ~2 分钟 | **5x** |
| 供应商联系提取 | ~3 分钟/家 | ~30 秒/家 | **6x** |
| 单供应商询价 | ~30 分钟 | ~5 分钟 | **6x** |

### 8.2 覆盖规模

- 已处理物料数量：_____
- 已搜索关键词数量：_____
- 已联系供应商数量：_____
- 已完成询价轮次：_____

---

## 九、后续规划（1~2 页）

### 9.1 短期计划

- [ ] 提示词远程管理（Prompt Store）全面上线
- [ ] 搜索质量持续优化（命中率提升）
- [ ] 聊天机器人更多轮次模板扩展
- [ ] 批次管理与调度增强

### 9.2 中长期规划

- [ ] 多平台扩展（京东工业品、拼多多等）
- [ ] 采购决策推荐引擎（基于历史数据）
- [ ] 供应商画像与评分体系
- [ ] 移动端适配

---

## 附录

### A. 项目目录结构

```
1688-autoprocurement/
├── src/                    # 前端源代码（React + TypeScript）
│   ├── pages/              #   8 个主页面
│   ├── components/         #   UI 组件（layout / shared / ui）
│   ├── services/           #   数据访问层（25+ 个 service）
│   ├── hooks/              #   自定义 React Hooks
│   ├── contexts/           #   全局状态（Auth / Queue）
│   └── types/              #   TypeScript 类型定义
├── automation/             # 自动化管道核心
│   ├── core/               #   类型定义与 CSV 解析
│   ├── internal/           #   Express 服务 / CLI / DB 层
│   ├── pipelines/          #   业务管道（行级 / 批级 / 同步）
│   ├── keywords/           #   关键词生成与融合
│   ├── standardization/    #   标准化 LLM 调用
│   └── playwright/         #   RPA 脚本（搜索 / 联系 / 旺旺）
├── chatbot/                # 聊天机器人模块
│   ├── src/                #   LLM 意图理解 / 模板 / RPA
│   └── docs/               #   设计文档
├── supabase/               # 数据库配置与迁移
├── docs/                   # 项目文档
└── scripts/                # 部署与工具脚本
```

### B. LLM 提示词清单（Prompt Store P0）

| Prompt Key | 用途 | 格式 |
|-----------|------|------|
| `automation.standardization.combined.system` | 联合标准化 | text |
| `automation.standardization.keyword_semantic.system` | 关键词语义 | text |
| `automation.search.keyword_fusion.bundle` | 多模态关键词融合 | multimodal_bundle |
| `automation.search.page_review.bundle` | 搜索页有效性审核 | multimodal_bundle |
| `automation.search.hit_rate_fallback.bundle` | 命中率 LLM 复核 | chat_bundle |
| `chatbot.intent.round_1~4.system` | 多轮询价意图理解 | text_template |

### C. 外部依赖服务

| 服务 | 用途 | 接口方式 |
|------|------|---------|
| 1688.com | 目标采购平台 | Playwright RPA |
| Supabase | 数据库 + 存储 + 认证 | REST API / SDK |
| OpenAI API | LLM 推理 | HTTP API |
| DeepSeek API | LLM 推理（性价比优选） | HTTP API |
| 智谱 BigModel | LLM 推理 + 离线批处理 + 视觉 | HTTP API |
| 通义千问 | LLM 推理 | HTTP API |
