# Crawl: 淘宝客户端交互模式数据

## 信息来源

- taobao_client Agent 工具定义 (agent.md, tools.md)
- 官方 Knowhow (knowhow.md)
- Benchmark 评测数据 (benchmark_v1.md)
- Good/Bad Testdata 测试案例

---

## 交互模式分析

### 模式 1: 搜索-详情-加购流程

```
用户输入关键词
    ↓
search_products → 返回商品列表
    ↓
用户选择商品
    ↓
get_product_skus → 获取 SKU 变体
    ↓
用户选择规格
    ↓
add_to_cart → 加入购物车
    ↓
验证成功
```

**成功率**: 75-85%
**失败点**: SKU 选择遗漏 (25%)

---

### 模式 2: 旺旺聊天降级流程

```
用户请求旺旺聊天
    ↓
open_chat → 尝试打开旺旺
    ↓
检查结果
    ├─ 成功 → send_chat_message
    └─ 失败 → 提示用户手动操作
```

**成功率**: 30-60%
**失败点**: 官方 API 不开放

---

### 模式 3: 页面交互流程

```
inspect_page → 诊断页面状态
    ↓
检查状态 (ready/loading/error)
    ├─ ready → 执行 click_element/input_text
    ├─ loading → wait 后重试
    └─ error → 输出诊断信息
```

**成功率**: 80-90%
**失败点**: 页面加载超时

---

## 核心交互参数

### 必传参数

| 参数 | 说明 | 示例 |
|------|------|------|
| sourceApp | 调用来源 | "LemonAI" |
| keyword | 搜索关键词 | "iPhone 15" |
| itemId | 商品 ID | "1234567890" |

### 可选参数

| 参数 | 说明 | 示例 |
|------|------|------|
| page | 页码 | 1 |
| size | 每页数量 | 20 |
| sort | 排序方式 | "sales" |
| sku | SKU 规格数组 | ["颜色:蓝色", "内存:256G"] |

---

## 页面状态码

| 状态码 | 含义 | 处理方式 |
|--------|------|---------|
| ready | 可交互 | 执行操作 |
| loading | 加载中 | 等待 1-2 秒 |
| error | 异常 | 输出诊断信息 |
| unknown | 未知 | inspect_page 诊断 |

---

## 成功案例摘要

### good_01_keyword_search (85分)

- ✅ 支持关键词、多条件筛选
- ✅ 返回完整字段 (title, price, pict_url, sales, shop)
- ✅ 支持分页和排序

### good_02_item_detail (92分)

- ✅ 完整商品详情
- ✅ SKU 变体支持
- ✅ 价格优惠信息

### good_03_cart_management (83分)

- ✅ 加购功能
- ✅ 数量修改
- ⚠️ 需先选 SKU

### good_04_order_list (88分)

- ✅ 订单列表查询
- ✅ 状态筛选
- ✅ 时间范围

---

## 失败案例摘要

### bad_01_wangwang_chat (55分)

- ❌ 旺旺 API 不对外开放
- ❌ 需要商家资质
- ❌ 第三方工具存在合规风险
- 💡 建议降级到手动操作

---

*数据来源: taobao_client 知识猎取 (2026-03-28)*