# 客户概况提炼（按客户维度汇总客诉/订单/测试/活动）

触发：用户（或工作台AI助手）要求"XX名下客户概况""按客户汇总客诉/订单/测试单/活动""提炼客户360"。

## 数据源地图（哪些本地 JSON 按客户、哪些不按客户）

| 维度 | 文件 | 是否按客户 | 关键字段 |
|------|------|-----------|---------|
| 客户360（最富） | 数据/pricing/_key_customers.json | 是 | name/group/sales/total/orders/products/contacts/opps/projects/complaints/sales_2024/2025/2026 |
| 客诉 | 数据/mcp_complaints.json | 是 | items[].customer/name/urgency/status/days |
| 订单/测试单 | 数据/mcp_orders_input.json | 是 | 购货单位#/合同编号#(=测试即测试单)/金额 |
| 活动(MCP) | 数据/mcp_activities.json | 否(按部门/创建者聚合) | by_month/by_dept/by_creator/highlights |
| 活动(Excel) | 数据/daily_activities_mcp.json | 部分(基本无客户名) | — |
| 测试反馈 | 数据/test_feedback.json | 否(按课题组) | group=课题组/product/sales/tech |

关键结论：活动数据本地**未按客户归档**（按销售员/部门），无法给每客户活动次数，需从飞书活动台账按客户筛选补充。test_feedback.json 是生命科学部"课题组"维度，**不是**大客户部客户，别用它套诊断原料客户。

## _key_customers.json（客户360，最富信息源）

每个客户一个对象（~18行），字段：name, file, group, group_name, sales(销售员), salesperson, total(三年累计), orders(订单记录数), products, latest_date, contacts(联系人), opps(商机), projects, complaints, decision_url, sales_2024/2025/2026。

要点：
- 按 `salesperson=='某人'` 过滤即得该人名下客户全集（如刘子研23家）。
- `orders` 含 0 金额测试/送样行：**0销售但有大量 orders 的客户 = 正在送样测试阶段**（例：西安天隆49单、科华48单、艾德29单，三年销售均0）。
- 该文件 `complaints` 字段与 mcp_complaints.json 直接统计可能口径不一致，客诉数以 mcp_complaints.json 为准。

## 无 terminal 环境聚合技巧（read_file + search_files/ripgrep）

API server 会话常无 terminal/execute_code，聚合 JSON 用 ripgrep + read_file：

1. **计每客户记录数**：grep `"customer": "[^"]*(token)[^"]*"`（锚定字段名），content 模式返回的匹配行即每条记录，按行计数。
   - 坑：客户名带城市前缀（"杭州迪安"），token 只写"迪安"会漏匹配；用 `[^"]*token[^"]*` 形式，或完整前缀。
2. **提炼问题主题**：grep `"name": "[^"]*(token)[^"]*"`——客诉 title 形如 `YYYYMMDD-客户-货号-问题`，自带问题类型。
3. **取360对象**：先 grep `"name": "客户全名"` 拿到行号，再 read_file(offset=行号, limit=~18)。
4. **单行大文件**（mcp_orders_input.json 是 1.2MB 单行 JSON 数组）：grep/read 都整行截断，无法按客户提取——改用 _key_customers.json 的 orders 字段或走 MCP。

## 客诉归属坑：customer 字段 vs name 字段

客诉 title（name 字段）可能引用集团级实体（如只写"天隆"），而 customer 字段才是实际购买主体。天隆系（西安华伟/苏州天隆/西安天隆同属天隆集团）客诉 title 常写"天隆"但 customer 字段区分主体。**统计归属必须按 customer 字段，不能按 name 里的公司名**。

## 集团归并（客户概况建议按集团分层）

诊断原料大客户常见集团：丽珠系(丽珠/丽禾)、天隆系(华伟/苏州天隆/西安天隆)、佰奥莱博系(佰奥莱博/瑞佰/基灵动物/基灵生物/基灵西安)、海尔施系(海尔施/海壹)、东方基因系(丹威/东方基因)、复星系(复星诊断)。同集团客户放在一起呈现，能暴露"集团内一家流失/一家新开发"的结构性问题。