---
name: wuling-overseas-dealer-expansion
description: 为五菱汽车海外经销商拓展提供端到端自动化能力：使用 AdsPower/Playwright 搜索海外经销商线索，去重、评分并直接写入客户信息汇总表，生成邮件和社交建联预览，执行经确认的建联，读取匹配的 Facebook Messenger 对话、翻译成中文、分析合作意向、更新建联表、生成客户中台看板，并在配置后同步飞书云表格。Use when Codex needs to find overseas Wuling dealer leads, assess dealer fit, prepare/send confirmed outreach, synchronize Facebook replies, translate customer conversations, record unified Facebook reply status, update the outreach workbook, sync Lark/Feishu sheets, or build the customer dashboard.
---

# 五菱汽车海外经销商拓展

## 文件边界

这个目录是独立 skill 包，只放可复用文件：`SKILL.md`、`references/`、`assets/`、`scripts/`。不要把真实客户表、采集结果、发送日志、预览 HTML/JSON、截图、缓存、SMTP 授权码或账号凭证放进 skill 包。唯一允许放进 `assets/` 的 Excel 是空白兜底模板 `assets/blank_customer_outreach_workbook.xlsx`。

## 核心工作流

1. 先生成预览，再写表、发邮件或发社交私信。
2. 搜索和浏览器操作必须使用 AdsPower + Playwright；不得用截图坐标或系统级鼠标键盘模拟。脚本不得关闭 AdsPower 指纹浏览器。
3. 客户资料入表默认直接写入 `客户信息汇总表`，不再按 Facebook、LinkedIn、Google Maps、当地汽车网站等渠道分 Sheet 新增客户。
4. 旧渠道 Sheet 只作为历史数据和兼容输入读取；新采集结果写表时，渠道名只写入对应链接列或 `备注` 的来源证据。
5. 写表后如配置 `feishu_sync_config.json` 且 `enabled=true`，必须自动调用 WorkBuddy 飞书表格插件同步；未配置时说明“本地写表完成，飞书同步待配置”。
6. 对话流水仍单独写入 `Facebook对话记录`，它是消息事件表，不是客户资料渠道分表。

## 客户信息汇总表

所有新增、补充、状态更新和深搜补充，都以 `客户信息汇总表` 为主数据表。标准表头固定为：

`公司姓名、国家、城市、客户类型、官网链接、联系人、职位、个人邮箱、联系人电话、Facebook主页链接、linkined主页链接、google map链接、公共电话/WhatsApp、公共邮箱、客户属性、线索等级、需人工确认、建联状态、下次跟进、备注`

字段规则：

- `客户属性`：五大客户属性之一。
- `客户类型`：必须是对应客户属性下的细分客户类型。
- `线索等级`：`A/B/C`，用于判断线索质量。
- `需人工确认`：无风险写 `否`；有价值但缺少关键确认点时写具体原因，例如 `主体归属待确认；新车业务待确认`。
- `备注`：写中文结构化证据、来源、风险和批量采购潜力；专业词如 showroom、importation、fleet、location、vehicules neufs 可保留原文。
- 来源平台不新增独立列；来源通过 Facebook/LinkedIn/Google Maps 链接列和 `备注` 中的 `客户来源：...` 保存。

重复客户合并规则：优先按邮箱、电话、Facebook/LinkedIn/Google Maps 链接、官网链接匹配；其次按标准化公司名匹配。重复资料不新建行，只补充空字段，并将多个电话、邮箱、联系人、链接和备注用 `；` 去重合并。

## 客户分类

五大客户属性和细分客户类型必须严格使用下面的值：

| 客户属性 | 细分客户类型 |
|---|---|
| `汽车渠道合作伙伴` | `汽车进口商`、`全国代理商`、`全国分销商`、`区域分销商`、`多品牌经销商`、`商用车渠道商`、`中国品牌经销商`、`新能源或小型车渠道商` |
| `批量采购与运营客户` | `汽车租赁公司`、`长期租赁公司`、`企业车队`、`物流配送企业`、`政府或机构采购方` |
| `二手车转型候选` | `连锁二手车企业`、`实体二手车企业`、`进口二手车企业`、`新车与二手车综合企业` |
| `平台与行业渠道` | `汽车交易平台`、`汽车协会`、`商会`、`车商联盟`、`经销商资源引荐机构` |
| `生态支持资源` | `售后服务网络`、`备件供应与仓储企业`、`进口认证与上牌机构`、`金融保险机构`、`车辆物流企业` |

重点搜索 `汽车渠道合作伙伴` 和 `平台与行业渠道`。其他三类保留用于完整分层和后续触达。

## 汽车渠道筛选和评级

汽车渠道合作伙伴必须满足：有实际新整车销售或分销业务；具有独立经营主体；存在新增品牌可能性；至少有一个可建联入口。纯维修、配件、轮胎、个人卖家不纳入；纯租车公司转入 `批量采购与运营客户 / 汽车租赁公司`；品牌当地分公司、官方主页、进口商直营网点及普通分店跳过。

评级标准：

- `A`：明确拥有进口、代理、分销、多品牌渠道、全国网络或平台/行业资源能力。
- `B`：明确是独立目标客户，但规模、覆盖或新增品牌权限证据较弱，例如独立单品牌新车经销商、区域 showroom、较小经销主体。
- `C`：客户有一定价值信号，但主体、新车业务、渠道作用或资料完整度仍无法确认。

人工确认不是低质量兜底。只有客户已经表现出目标价值，同时缺少关键确认点时，才在 `需人工确认` 写具体原因。低价值或无关客户应跳过或标低优先级，不要包装成“需人工确认”。

## 脚本入口

| 任务 | 脚本 | 入表规则 |
|---|---|---|
| Facebook 搜索/深搜 | `scripts/scraper/search_active_dealers.py`、`scripts/scraper/search_facebook.py`、`scripts/scraper/scrape_single_page.py` | `--write-excel` 时直接写 `客户信息汇总表` |
| LinkedIn 搜索 | `scripts/scraper/search_linkedin.py` | 默认写 `客户信息汇总表`，LinkedIn 链接进入 `linkined主页链接` |
| Google Maps 搜索 | `scripts/scraper/search_google_maps.py` | 默认写 `客户信息汇总表`，Maps 链接进入 `google map链接` |
| 当地汽车网站 | `scripts/scraper/search_auto_websites.py` | 默认写 `客户信息汇总表`，来源网站进入 `备注` |
| 总表修复/兼容导入 | `scripts/common/build_customer_summary.py` | 读取现有总表和历史渠道 Sheet，合并后重建总表 |
| 邮件预览/发送 | `scripts/email_outreach/prepare_outreach_emails.py`、`scripts/email_outreach/send_outreach_emails.py` | 按总表筛选、预览、确认后发送并更新总表 |
| Facebook 建联 | `scripts/social/prepare_facebook_outreach.py`、`scripts/social/run_facebook_follow_dm.py`、`scripts/social/send_facebook_outreach.py` | 从总表读取 Facebook 链接，确认后更新总表状态 |
| Facebook 回复同步 | `scripts/social/collect_facebook_conversations.py`、`scripts/social/write_facebook_conversations.py` | 对话进 `Facebook对话记录`，客户状态/摘要回写总表 |
| 客户中台看板 | `scripts/dashboard/build_dashboard.py` | 读取总表生成 HTML/JSON，不写 Excel |

旧命令里的 `--sheet Facebook`、`--sheet LinkedIn`、`--sheet Google Maps` 仍可兼容，但只作为来源标签；公共写表层会路由到 `客户信息汇总表`。

## Facebook 建联规则

Facebook 对外话术只用英文，中文只用于内部判断和预览。必须先在聊天框展示整批预览，用户确认一次后才允许 `--confirm --batch-confirmed` 批量执行，不再逐条确认。真实执行默认每轮 3 个客户，每日 Follow/DM 以账号账本控制。大层级操作等待 90-200 秒，小层级页面操作等待 30-90 秒，技术等待 0.5-8 秒。遇到验证、限流、异常活动或 Messenger 定位不匹配，立即停止，不关闭浏览器。

私信必须定位 Facebook Page 顶部 `Follow/追蹤` 和 `Message/發送訊息` 按钮，再定位匹配客户名称的 Messenger 小窗或 Messenger 页面输入框。禁止把帖子评论框、页面底部输入框或推荐区评论框当作私信目标。

## 邮件规则

邮件模板与社交话术分开。正式邮件固定使用 `Chris Chen`，社交私信才根据当前 Facebook/LinkedIn 账号询问 `sender_name`。发送邮件前必须生成 HTML 预览；模板图片应按邮件端尺寸控制，不能把 Markdown `**` 原样发给客户。SMTP 授权码只在本次发送中使用，不落盘。

## Facebook 对话同步

读取 Messenger 对话时只采集能可靠匹配到总表客户的线程。保存双方原文，翻译成中文，只分析客户回复。合作意向采用五级：`明确有意向`、`潜在意向`、`需澄清`、`暂不考虑`、`明确拒绝`。先展示同步摘要和高意向客户，再由用户确认是否写入。不得自动回复客户。

## 运行产物和模板

预览、搜索结果、发送日志和报告默认进入 `runs/YYYYMMDD/<run_id>/`；Excel 备份进入 `backups/YYYYMMDD/`；Facebook 额度账本进入 `logs/`。预览和 dry-run 不备份 Excel。空白模板仅在全新环境找不到建联表且用户明确写表时复制出来，禁止直接写入 skill 内模板。