> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 6. Leads

Leads 是线索收件箱，回答"这段时间谁进来了、什么时候进来的、AI 判断他走到哪一步、意向高不高、有没有人在跟"。它不是第二个客户页或任务页，具体执行去 Tasks。

## 1 Leads 工作台

### 1.1 顶部工具栏：日期、搜索、排序与分页

按页面从左到右使用：

| 元素              | 含义与操作                                                                       |
| --------------- | --------------------------------------------------------------------------- |
| 日期范围            | 选择线索的 Received（收到时间）窗口，如截图中的 Today。没有链接参数或已保留的日期选择时，默认最近 7 天                |
| Reset           | 清除 Status、Lead Source、重复提交、Purchase Intent、Lead Line、Task 等筛选；不重置日期、搜索文字或排序 |
| 搜索框             | 按电话号码、客户名或姓查找线索                                                             |
| Sort: Received  | 按收到时间排序，默认最新在前；旁边的上下箭头切换升序或降序                                               |
| Sort: Lead Line | 门店启用 Lead Line 后可用，按自动回拨状态排序                                                |
| `1–16 of 16`    | 当前页显示范围及符合条件的总人数；每页 100 条，用左右箭头翻页                                           |

日期选择影响“哪些人是在这段时间进来的”，不代表这些人的全部活动都发生在该时间段内。

### 1.2 表头筛选

筛选入口位于带下拉箭头的列名处，可以组合使用。选项旁的数量表示在当前其他条件下，该选项匹配的人数。

| 列头              | 筛选内容                                                                            |
| --------------- | ------------------------------------------------------------------------------- |
| Status          | New、Attempted、Connected、Booked 等线索阶段，以及 Stale（超过 5 天没有活动）                       |
| Lead Source     | Email lead / Call/SMS lead；同一菜单中的 Duplicate Status 可选 Duplicate / Not duplicate |
| Purchase Intent | High / Medium / Low / Unknown                                                   |
| Task            | Task Status：Open / Closed / No task；Task Type：按关联任务类型筛选                         |
| Lead Line       | 门店启用后显示，按自动回拨状态筛选                                                               |

同一人重复提交不会拆成多行；Duplicate 筛选帮助找出重复提交的人。

### 1.3 线索列表：一行代表谁

**一行 = 当前门店的一个电话号码对应的人，不是一次提交。** 同一个人在选定窗口内提交多次，仍只占一行。

“本窗口收到”包括窗口内的邮件表单提交，以及窗口内创建的电话/短信线索任务。与 Dashboard Lead Funnel 对照时，需保持门店、日期和下钻条件一致；额外添加页面筛选后，列表人数会进一步缩小。

| 列               | 显示内容                                                                |
| --------------- | ------------------------------------------------------------------- |
| #               | 当前列表中的序号                                                            |
| Lead            | 头像首字母和客户姓名；没有姓名时显示电话。点击进入 Contacts 并展开该联系人                          |
| Phone           | 客户电话；姓名位置已使用电话时，这一列可显示 `—`，避免重复                                     |
| Status          | AI 根据通话、短信判断的线索阶段；没有状态时显示 `—`                                       |
| Lead Source     | Email lead 或 Call/SMS lead；邮件线索多次提交时显示 `Email lead · N submissions` |
| Purchase Intent | AI 判断的购买意向 High / Medium / Low；没有判断时显示 Unknown                      |
| Received        | 当前窗口内最新一次进线的时间，按门店时区显示；老客户重新提交显示本次窗口内的进线时间                          |
| Last Activity   | 联系人记录上的最近活动时间，不一定与 Received 相同；没有记录时显示 `—`                          |
| Lead Line       | 自动回拨状态，仅门店启用 Lead Line 后显示                                          |
| Task            | 关联任务类型标签，例如 Lead Outreach；点击跳到 Tasks。存在本窗口跟进缺口或没有线索任务时显示 No task    |

截图中的 `Email lead · 4 submissions` 表示提交次数，不是四位客户，也不代表四条任务。

### 1.4 Status 与 Purchase Intent 怎么看

| Status 取值      | 含义                            |
| -------------- | ----------------------------- |
| New            | 还没有实质接触                       |
| Attempted      | 员工尝试过但没接通                     |
| Connected      | 接通并有进行中的销售对话（留言、自动回复不算）       |
| Booked         | 已约体验课，到场和成交未知                 |
| Unreachable    | 员工尝试 ≥2 次从未接通，可以放手            |
| Neglected      | 员工尝试 \<2 次而显得搁置——是员工执行缺口，不能放手 |
| Lost Contact   | 曾接通、之后 ≥2 次跟进无回复              |
| Bad Timing     | 客户给出具体的条件型原因（太贵、太远、时间不合）      |
| Not Interested | 明确拒绝                          |
| Stale          | 不是真实状态，是横切条件："5 天以上没有任何活动"    |

状态可进可退（Lost Contact 的人回复了可回到 Connected）。Purchase Intent：High = 明确购买信号（问价格、问怎么开始、想报名、想约课）；Medium = 有兴趣但没准备好；Low = 信号很弱。

Status 是线索阶段，Task 标签是工作阶段，Lead Source 是来源，三者分别回答不同问题。Stale 是按最近活动判断的筛选条件，不是独立的线索阶段。

### 1.5 查看客户与处理任务

Leads 页面以列表为主，不在这里展开任务处理面板：

| 入口        | 去哪里、做什么                                           |
| --------- | ------------------------------------------------- |
| 客户姓名      | 进入 Contacts，查看客户资料与历史                             |
| Task 类型标签 | 进入 Tasks 对应任务，继续跟进或查看处理记录；优先关联未关闭的线索任务，没有时可关联历史任务 |
| No task   | 提醒检查跟进缺口；即使存在历史任务，本次进线没有对应跟进时也可能显示 No task        |

日常可以先筛选 No task 检查遗漏，再查看高意向且任务仍 Open 的线索，或用 Duplicate 核对重复提交。处理活动、排期与关闭结果在 [Tasks](/funding-strategy/02-产品说明书/03-tasks.md) 完成。

## 2 线索从哪来、怎么去重

| 规则             | 说明                                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| 邮件线索接入         | 三条路径最终走同一套写入：邮件路由直接唤醒处理程序（主路径）、每 12 小时一次的兜底扫描、旧的轮询链（已停，仅留作重放）。每条被接纳的线索：建或更新联系人、生成一条 Lead Outreach 任务、写时间线                      |
| 去重             | 联系人按（电话 + 门店）合并；同一联系人同时最多只有一条未关闭的线索类任务。开着任务时又来一次提交，新任务判为重复（不是错误），但会把正在跟的那条任务截止时间收紧、清掉下次行动时间，让它立刻浮到队列前面                         |
| 不算线索的          | 标记 Do Not Contact 的人不建任务、不改紧急度；结构上不可能拨通的号码（区号以 0/1 开头、位数不对）不算线索                                                                |
| 不按 Lifecycle 筛 | 2026-07-04 决策：Lifecycle（Lead / Member / Churned）是 AI 随时可改的状态，用它筛会让同一窗口的结果随状态翻转漂移（人中途变会员就从收件箱消失）。会员回流重新提交也算"收到"，是否已是会员留给任务关单时判断 |

## 3 与 Dashboard、Tasks 的关系

- **Lead Funnel 下钻**：点 Email Unique / Call/SMS Unique / Leads Without Task 会带着条件落到本页，落地行数与卡片数字一致。
- **Tasks**：本页不做执行。Task 列的药丸跳到 Tasks 里那条任务；Lead Outreach 任务由邮件接入生成，本页只展示它的存在与状态。
- 任务类型标签（Lead Outreach / Lead Follow-up / Post-Intro Follow-up）是"工作阶段"，不是线索来源；来源看 Lead Source 列。

## 4 当前限制

- 页面没有 Help 弹窗或说明文字，只有悬停文案和 Stale 旁的 "No activity for 5+ days"。
- AI 可以写入 showed / trialed / converted 三个状态，但列头筛选没有这三项；这些行的状态徽章仍会显示。
- 接口返回汇总数字（总数、需处理、No task 数），页面自 #676 简化后不再显示 KPI 卡。
- Lead Line 排序需要先把全部页加载到本地再排，大门店可能要等一下。

## 5 实现依据

本篇按本地代码核查，页面实际启用情况以部署版本为准。

[线索收件箱页面](https://github.com/retaintive/callytics-infrastructure/blob/main/apps/web/src/pages/leads-v3/index.vue) · [列表口径与筛选](https://github.com/retaintive/callytics-infrastructure/blob/main/apps/api/src/routes/v3/leads.ts) · ["本窗口收到"的定义](https://github.com/retaintive/callytics-infrastructure/blob/main/packages/task-engine/src/metrics/lead-intake-window.ts) · [线索接入与去重](https://github.com/retaintive/callytics-infrastructure/blob/main/lambda/shared/lead/persist-downstream.ts) · [Lead status / Purchase intent 判定规则](https://github.com/retaintive/callytics-infrastructure/blob/main/lambda/contacts-analyzer/src/core/prompts/contact/profile-policy.ts)