# 飞书决策链自动化读写

## 核心发现

`决策链URL链接` 是飞书客户工作项（kh类型）的自定义表单字段。虽然 MQL `ORDER BY DESC LIMIT 500` 全量拉取时该字段为空，但通过 **WHERE 精确匹配客户名** 可以成功读写。

## 读取

```python
MQL = 'SELECT `客户名称`, `决策链URL链接` FROM `销售管理`.`客户` WHERE `客户名称` = "圣湘生物科技股份有限公司" LIMIT 1'
r = mcp('search_by_mql', {'project_key': SALES_PK, 'mql': MQL})
# → 返回 62字符的 Wiki URL
```

关键点：
- 必须用 WHERE 精确匹配客户名，不能在 ORDER BY 全量拉取中查找此字段
- URL为空时返回空字符串 `""`（非 `"None"`）
- 字段存在但 MQL `SELECT *` 不可用

## 写入/回填 — ⚠️ 表单模板字段限制

**重要发现（2026-07-11 实测）**：`update_field` 对表单模板自定义字段返回 `{"mcp_result": ""}`（看起来像成功），但**实际不持久化数据**。用 MQL WHERE 精确匹配读回验证，URL 仍为空。

```python
# ❌ 以下调用返回成功但不写入
r = mcp('update_field', {
    'project_key': SALES_PK,
    'work_item_id': '4420237299',
    'fields': [{'key': '决策链URL链接', 'value': 'https://...'}]
})
# → {"mcp_result": ""}  ← 表面成功，但读回验证 URL 仍为空

# 尝试 field_key、key、field_uuid 三种参数名均无效
```

### 原因

`决策链URL链接` 是飞书客户的**表单模板**字段（模板ID: 700371），不是标准工作项字段。`update_field` 仅支持标准字段和角色字段。

### 替代方案

1. **飞书 Open API**（需 App ID + App Secret + 飞书项目API权限）
2. **手动在飞书页面填写**
3. **AppleScript 操控 Chrome 自动填表**

### 可行性结论

- ✅ **读**：MQL WHERE 精确匹配 → 完全自动化
- ❌ **写**：MCP `update_field` → **不可用**（表面成功但不持久化）

### 集团复用模式

同集团客户可共享决策链URL。扫描缺失项后，先检查同集团是否有已填写的客户：
- 西安华伟（天隆集团）→ 复用苏州天隆的决策链 ✅
- 郑州玛特瑞斯（安图集团）→ 复用郑州安图的决策链 ✅

## 自动化工具

脚本路径：`~/Desktop/Hermes输出-工作类/manage_decision_chain.py`

| 命令 | 功能 |
|------|------|
| `scan [--limit N]` | 批量读取价格表中TOP N客户的决策链URL |
| `get 客户名` | 查询单个客户 |
| `set 客户名 URL` | 设置/更新（表单字段可能不持久化） |
| `clear 客户名` | 清空 |
| `missing` | 列出缺失决策链的客户（按金额降序） |
| `export [--format csv]` | 导出全量数据 |

## 客户档案全维度采集

脚本：`~/Desktop/Hermes输出-工作类/fetch_customer_profile.py`

```
python3 fetch_customer_profile.py 客户名称
```

拉取：决策链(MQL) + 定价(本地JSON) + 联系人(relation) + 活动(模糊匹配) + 项目 + 客诉
输出：`数据/profiles/{客户}.json` → 供 `工具/客户档案.html` 消费

## 集团复用（2026-07-11 验证）

| 缺失客户 | 集团 | 复用源 | 源URL |
|---------|------|--------|-------|
| 西安华伟(267万) | 天隆集团 | 苏州天隆(181万) | ✅ 已有 |
| 郑州玛特瑞斯(46万) | 安图集团 | 郑州安图(65万) | ✅ 已有 |

回填到飞书需 Open API 或手动操作。

## 扫描结果（2026-07-11，TOP50客户）

- 有决策链: 41家
- 缺失: 9家（深圳生科原316万/西安华伟267万/武汉九泽95万等）