# 宝锐工作台数据管道脚本清单

所有脚本位于 `~/Desktop/Hermes输出-工作类/数据/`，使用 MCP Token `m-abfb29e8-3104-434f-9944-8d0bb592f8cd`。

## pull_complaints.py — 客诉
- **输入**：无（直拉 MCP）
- **输出**：`mcp_complaints.json`（313 条）
- **数据源**：售后管理(658288abfb8bd616b17025f1) → 客户反馈单(6669433056a98249604376de)
- **MQL 字段**：name, start_time, current_status_operator, work_item_id, work_item_status, field_9e2144, owner, field_3ce9fe
- **关键**：operator 必须是数组（不是逗号分隔字符串），否则页面 `.forEach()` 崩
- **调度**：`mcp_refresh.py` → `cb_sync.sh`（每 2h）

## pull_customers.py — 客户
- **输入**：无（直拉 MCP）
- **输出**：`mcp_customers.json`（1680 条）
- **数据源**：销售管理(6593cd71471290e3cc6be6e6) → 客户(65ae1e403c87b152f3365ca6)
- **MQL 字段**：name, field_c3224b, field_5ed7ab, field_c8e80d, field_17186c, field_8c870a, field_79aa0b, field_6415cf, work_item_id, field_e62869, owner
- **频率**：手动（IT 新增字段后），暂不在定时刷新中

## pull_contacts.py — 联系人
- **输入**：无（直拉 MCP）
- **输出**：`customer_contacts.json` — `{客户名: [联系人名称列表]}`，8804 联系人 → 1786 客户
- **数据源**：销售管理 → 联系人(65b8a6cacde27fd415d769ca)
- **MQL 字段**：name, field_6b3789（联系人关联客户）, work_item_id
- **逻辑**：按 `field_6b3789.label` 反向聚合到客户名
- **页面消费**：`adaptMcpFields()` 中 `contactsMap[c.name].length`

## pull_orders.py — 销售订单
- **输入**：`--days N`（默认 90）
- **输出**：`mcp_orders_input.json`
- **数据源**：销售管理 → 销售订单(662612aea6bb7089fea044ef)，全量 48459 条
- **MQL 字段**：name, start_time, field_96a245（物流单号）, field_e1001d（客户）, field_51d592（价税合计·double_value）, work_item_id
- **下游**：→ `shipment_pipeline.py` → `shipment_status.json` → 订单管理 Tab
- **注意**：旧单号顺丰返回"暂无数据"属正常（顺丰不保留历史轨迹）；今日订单无物流单号也正常（未发货）

## mcp_refresh.py — 调度入口
- **触发**：`cb_sync.sh`（每 2h）
- **步骤**：①拉活动 → ②`pull_complaints.py` → ③`mcp_pipeline.py`（仅阻塞）→ ④KPI + ERP + 上传 CloudBase
- **客诉**：已从 `list_todo` 改为 MQL 直查

## 旧管道（已废弃）
- `mcp_pipeline.py`：`list_todo` 方式，`TODAY = datetime(2026, 7, 9)` 硬编码，仅保留审批阻塞部分