← Back to Skills Marketplace
28
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install deepsop-humabot-ai
Description
人机协作台技能。用户输入自然语言销售指令，AI自动分析拆解任务参数，调用 deepsop 平台接口提交任务，等待后查询结果并推送。触发场景：用户说「帮我找客户」「挖掘XXX行业客户」「找XXX个客户」「提交任务」等与客户挖掘、销售任务相关的指令；或用户说「创建电话场景」「新建外呼话术」「新建电话机器人」「提交场景...
README (SKILL.md)
\r \r
人机协作台（Human-AI Collaboration）\r
\r
功能简介\r
\r 人机协作台是基于 deepsop 平台的智能销售任务助手，能够：\r \r
- 理解自然语言指令：直接描述需求，如「帮我找50个美国做服装的客户」\r
- 智能任务拆解：自动识别目标数量、行业、地区、执行周期等参数\r
- 多员工协作：根据任务类型自动分配对应职能员工\r
- AiWa：客户挖掘（找客户、行业客户等）\r
- Frank：邮件销售\r
- Fran：电话销售\r
- Lisa：短信销售\r
- 自动提交任务：调用 deepsop API 提交任务，后台异步执行\r
- 定时查询结果：任务提交后询问用户期望等待时长，按用户指定时间自动查询并推送结果（默认 8 分钟）\r
- 生成 xlsx 报表：AiWa 客户数据自动生成带样式的 Excel 文件返回\r
- Frank 邮件统计：查询邮件发送总数、成功数、已读数、回复数、点击数，并展示发送详情（可与 AiWa 搭配，或在无 AiWa 协同时通过客户来源选择 xlsx 上传 / 公司搜索 指定客户）\r
- Fran 电话销售：自动查询号码池与场景库，由用户选择后提交电话销售任务（可与 AiWa 搭配，或在无 AiWa 协同时通过客户来源选择 xlsx 上传 / 公司搜索 指定客户）\r
- Lisa 短信统计：查询短信发送总数、成功数、失败数，并展示发送详情（可与 AiWa 搭配，或在无 AiWa 协同时通过客户来源选择指定客户）\r
- 电话场景创建/审核：用户可主动说「创建电话场景」「新建外呼话术」直接走 Step 1.7 子流程，也可在 Fran 提交时若无可用场景库时被引导即时创建并提交阿里云审核（场景+TTS+机器人 prompt 三合一）\r \r ---\r \r
前置条件：获取 API Key\r
\r 本技能需要 API Key 授权才能调用 DeepSOP 接口。请按以下步骤获取：\r \r
- 获取 API Key 入口：\r
- 已有账号 → 前往 https://ai.deepsop.com/login?source=3 登录获取\r
- 没有账号 → 前往 https://ai.deepsop.com/register?source=3 注册后获取\r
- 登录后进入「设置」或「API 管理」页面\r
- 新建 API Key，复制以
sk-开头的密钥\r - 在 OpenClaw 中配置环境变量：\r \r
DEEPSOP_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxx\r
```\r
\r
> 所有 API 请求头需携带：`x-api-key: $DEEPSOP_API_KEY`\r
> API Base URL：`https://ai.deepsop.com/prod-api/`\r
\r
---\r
\r
## ⛔ 接口路径强约束（最高优先级，所有 HTTP 请求必须遵守）\r
\r
> 🔒 **核心规则：** 调用任何接口时，**必须严格使用本文档对应步骤标注的完整 URL**，不得做任何形式的改写、简化、猜测或自创。\r
>\r
> **请求前自检流程（每一次 HTTP 请求都必须执行）：**\r
> 1. 在下方「**API 路径权威清单**」中找到对应步骤的接口；\r
> 2. 将即将发出的完整 URL（含 host、path、query key 名与顺序、`pageNum`/`pageSize`/`platform` 等参数值）与清单中的 `Path` 列**逐字符比对**；\r
> 3. 完全一致才允许发出请求；任何偏差立即停止，按清单中的路径修正后再重试；\r
> 4. 若某接口未在清单中列出 → **绝对禁止**自行编造路径，必须先向用户确认。\r
>\r
> **禁止行为：**\r
> - ❌ 把 `prod-api` 改成 `api` / `v1` / `prod` / `prodApi`\r
> - ❌ 把 camelCase 改成 snake_case 或全小写（如 `presetEmployee` ≠ `preset_employee` ≠ `presetemployee`）\r
> - ❌ 把 `outBound` 写成 `outbound`、`emailconfig` 写成 `emailConfig`、`authaccount` 写成 `authAccount`（这三个偏偏就是全小写，特别注意）\r
> - ❌ 用同义词替换路径段（`getCustomerPoolDetail` ≠ `customerPoolDetail` / `getCustomerDetail`；`collaborationCallResult` ≠ `callResult`）\r
> - ❌ 漏写或私自补加 query 参数（如漏 `platform=1` / `status=1`，或私自加 `pageSize=20` 改成 `pageSize=10`）\r
> - ❌ 凭"上一次调用记得"或"经验"猜测路径，不回到本文档对照\r
>\r
> **路径错误是最常见、最可避免、影响最大的事故，必须零容忍。**\r
\r
### 📋 API 路径权威清单（Base URL: `https://ai.deepsop.com/prod-api`）\r
\r
| # | 步骤 | 方法 | Path（不含 Base URL） |\r
|---|---|---|---|\r
| 1 | Step 1.5 数字员工可用性 | `GET` | `/ai/presetEmployee/list` |\r
| 1.1 | Step 1.5.1① 签约套餐列表 | `GET` | `/ai/setting/list?packageType=3` |\r
| 1.2 | Step 1.5.1② 人民币→K币汇率 | `GET` | `/system/config/configKey/CNY_TO_KCOIN` |\r
| 1.3 | Step 1.5.1③ K币余额查询 | `GET` | `/ai/vip/balance?userId={userId}` |\r
| 1.4 | Step 1.5.1④ 提交签约（扣K币） | `POST` | `/ai/order/purchaseIndependentPackageByKToken` |\r
| 2 | Step 3 提交任务 | `POST` | `/ai/presetEmployee/submitTask` |\r
| 3 | Step 3 前置 A-0 外呼实例 | `GET` | `/ai/outBound/describeInstance` |\r
| 4 | Step 3 前置 A-1 号码池 | `GET` | `/ai/outBound/callerNumber/list` |\r
| 5 | Step 3 前置 A-2 场景库 | `POST` | `/ai/outBound/listScripts` |\r
| 5.1 | Step 1.7 / 前置 A-2 兜底 创建+审核场景 | `POST` | `/ai/outBound/createOrModifyScriptAndSubmitScriptReview` |\r
| 5.2 | Step 1.7 轮询场景审核状态 | `POST` | `/ai/outBound/describeScript` |\r
| 5.3 | Step 1.7 修改场景时回填机器人设定 | `POST` | `/ai/outBound/getAgentProfile` |\r
| 5.4 | Step 1.7 辅 单独重新提交场景审核 | `POST` | `/ai/outBound/submitScriptReview` |\r
| 5.5 | Step 1.7 辅 撤销场景审核 | `POST` | `/ai/outBound/withdrawScriptReview` |\r
| 6 | Step 3 前置 B0 邮箱绑定检查 | `GET` | `/ai/emailconfig/list?pageSize=1000&pageNum=1&status=1` |\r
| 7 | Step 3 前置 B 用户 Profile | `GET` | `/ai/user/profile` |\r
| 8 | Step 3 前置 D-1 短信模板列表 | `GET` | `/ai/sms/querySmsTemplateList?pageNum=1&pageSize=20&pageNumber=1` |\r
| 12 | Step 5-A AiWa 客户池详情 | `POST` | `/ai/presetEmployee/getCustomerPoolDetail?pageNum=1&pageSize=10` |\r
| 13 | Step 5-B-1 Frank 邮件统计 | `GET` | `/ai/email/getTaskEmailCount?taskId={frankDagTaskId}` |\r
| 14 | Step 5-B-2 Frank 邮件列表 | `GET` | `/ai/email/taskList?pageNum=1&pageSize=2000&taskId={frankDagTaskId}` |\r
| 15 | Step 5-C-1 Fran 电话统计 | `GET` | `/ai/presetEmployee/collaborationTaskStatistics?taskId={franDagTaskId}&customerPoolId={franCustomerPoolId}` |\r
| 16 | Step 5-C-2 Fran 电话详情 | `POST` | `/ai/presetEmployee/collaborationCallResult?pageNum=1&pageSize=10` |\r
| 17 | Step 5-D-1 Lisa 短信统计 | `POST` | `/ai/sms/getTaskSmsCount` |\r
| 18 | Step 5-D-2 Lisa 短信详情 | `POST` | `/ai/sms/getSmsResultList?pageNum=1&pageSize=10` |\r
| 21 | Step 1.6 途径B 客户搜索（无 AiWa 销售任务） | `POST` | `/ai/customer/customerList?pageNum={pageNum}&pageSize=10` |\r
| 22 | Step 1.6 途径A xlsx 上传到 OSS | `POST` | `/system/fileUpload/upload`（multipart/form-data, 字段名 `file`） |\r
| 23 | Step 1.6 途径A 下载「公司导入」模板 | `POST` | `/ai/customer/template`（application/x-www-form-urlencoded, 空 body, 响应 blob） |\r
| 24 | Step 1.6 途径A 下载「地址簿导入」模板 | `POST` | `/ai/customer/contactImportTemplate`（application/x-www-form-urlencoded, 空 body, 响应 blob） |\r
\r
> 🔁 **本清单与下文各 Step 中"接口："标注的路径完全一致**。如发现两处不一致，**以下文 Step 中的标注为准**（本清单仅为快速比对索引），同时立即向用户报告该不一致以便修正。\r
\r
### 🛡️ 双轨强约束（本文档 + 代码）\r
\r
> 上述清单同时存在于 `scripts/api_paths.py`，构成"双轨强约束"：\r
>\r
> - **LLM 直接发请求时（curl/工具调用）：** 必须对照本文档清单逐字符比对路径。\r
> - **脚本调用 API 时（如 `submit_task.py`）：** 严禁脚本内硬编码 URL，必须从 `api_paths.py` 通过 `build_url("xxx")` 获取，并配合 `assert_url_matches()` 自检。\r
> - **新增/修改接口的强制流程：** 先改 SKILL.md 这张表 → 再改 `api_paths.py` → 然后才能在脚本里使用；遗漏任一步即视为 bug。\r
> - **漂移检测：** 运行 `python scripts/api_paths.py` 会扫描本文件中所有 `https://ai.deepsop.com/prod-api/...` 路径，若有未在 `api_paths.py` 登记的项目则非零退出。该命令应在每次修改路径后执行一次自检。\r
\r
---\r
\r
## 完整执行流程\r
\r
### Step 0：触发类型判断（每次进入技能必须首先执行）\r
\r
检查当前输入内容是否包含 `[DeepSOP-AutoQuery]` 标记：\r
\r
- **包含该标记**：这是 cron 定时回调。**不得询问用户是否继续，不得等待确认，不得说「我将开始查询」。立即从输入文本中解析变量（`taskId`、`aiwaDagTaskId`、`aiwaCustomerPoolId`、`frankDagTaskId`、`franDagTaskId`、`franCustomerPoolId`、`lisaDagTaskId`、`lisaCustomerPoolId`、`taskName`、`totalTarget`、`employeeList`、`feishuChatId`），跳过 Step 1～4 直接执行 Step 5 的全部内容（查询接口 → 生成 xlsx → 发送文件 → 回复文字摘要），直到所有参与员工的结果都处理完毕。\r
- **不包含该标记**：这是用户主动指令，继续执行 Step 1。\r
\r
---\r
\r
### Step 1：第一轮 AI 分析（任务拆解 + 意图分流）\r
\r
> 🔀 **意图分流前置（在跑下方拆解 prompt 之前先判断）：**\r
>\r
> 如果用户输入**明确**包含以下关键词之一且**不**带销售目标数量（如「找 N 个客户」「发邮件」「打电话推销」），判定为「场景创建意图」：\r
> - 「创建电话场景」「新建外呼话术」「新建电话机器人」「新建场景」「做一个外呼场景」\r
> - 「场景审核」「提交场景审核」「话术审核」「让阿里云审一下」\r
> - 「修改场景 / 修改话术 / 改一下场景库」（带或不带 scriptId）\r
> - 「撤销场景审核 / 撤回场景审核 / 取消场景审核」 → 走 [Step 1.7.6 辅助操作](#step-176场景审核辅助操作用户已有草稿审核中场景) 中的 `withdrawScriptReview` 分支\r
> - 「重新提交场景审核 / 重审已有场景」（用户明确说明是已有 scriptId、不要改内容） → 走 [Step 1.7.6 辅助操作](#step-176场景审核辅助操作用户已有草稿审核中场景) 中的 `submitScriptReview` 分支\r
>\r
> 命中此意图 → **跳过下方 Step 1 任务拆解 prompt + Step 1.5/1.6/2/3/3.5/4/5 的销售流程**，直接进入 [Step 1.7：电话场景创建/审核子流程](#step-17电话场景创建审核子流程独立入口)。\r
>\r
> 若用户句子里**同时**有销售意图（如「先建一个外呼场景，再用它给我打 50 个家纺客户的电话」），按以下顺序处理：\r
> 1. 先走 Step 1.7 完成场景创建+审核，拿到 `scriptId / agentProfileId`；\r
> 2. 再回到下方 Step 1 拆解销售意图，进入 Step 1.5/1.6/2/3 流程；\r
> 3. 进入 Step 3 前置 A-2 时，把 Step 1.7 拿到的 `scriptId / agentProfileId` 作为已选场景直接复用，**不要**再调 `listScripts` 让用户选。\r
>\r
> 未命中场景创建关键词 → 进入下方常规销售任务拆解。\r
\r
用以下 prompt 分析用户指令，严格返回 JSON，不含任何额外文字：\r
\r
```\r
根据【指令】描述，Json格式返回数据\r
不需要多余的描述，不要过度解读，没有提及的内容请不要擅自理解，识别结果除了Json数据其他文字不要出现\r
规则如下：{\r
"taskName": "根据描述总结出一个简洁的任务名称"\r
"executionMode": "判断描述中是否明确提及每日/每天/周期性，如果提及则返回周期性任务，未提及则返回定额任务"\r
"totalTarget": "提取描述中提及的数量（无单位纯数字）"\r
"employeeList": "首先将描述按逗号、顿号等分隔符拆分成多个子任务，然后为每个子任务匹配对应员工：\r
- 挖掘客户职能（AiWa）：匹配任何包含“找”、“开发”、“行业”、“客户”等与客户挖掘相关的描述，以及没有明确匹配其他职能的单子任务\r
- 邮件销售职能（Frank）：匹配包含“邮件”、“发邮件”等关键词的描述\r
- 电话销售职能（Fran）：匹配包含“电话”、“打电话”、“电话销售”等关键词的描述\r
- 短信销售职能（Lisa）：匹配包含“短信”、“发短信”等关键词的描述\r
- 生产视频职能（Jack）：匹配包含“视频”、“生产视频”等关键词的描述\r
- 智能SEO优化职能（Sophia）：匹配包含“SEO”、“优化”、“搜索引擎”等关键词的描述\r
- AI剪辑师职能（Alex）：匹配包含“剪辑”、“视频剪辑”等关键词的描述\r
- 独立站客服职能（Leo）：匹配包含“客服”、“客户服务”、“咨询”等关键词的描述\r
如果拆分后只有一个子任务且没有匹配上员工，则默认匹配挖掘客户职能（AiWa）\r
最后汇总所有匹配到的员工名称组成一个,拼接的字符串并返回（去重）",\r
"language": "判断描述中是否明确提及国家或地区，若提及了国家或地区但和中国没有关联则返回'英文'其他情况返回'中文'",\r
}\r
```\r
\r
解析结果字段（**注意：这些只是 SKILL 内部用的解析变量，不要原样塞到最终 API 请求体里**）：\r
- `totalTarget`：目标数量（数字）— 仅作为 `employeeParams.AiWa.totalTarget` 的值来源，**不得**作为根级字段\r
- `employeeList`：参与员工逗号字符串，如 `"AiWa"` 或 `"AiWa,Frank"` — **仅本 SKILL 内部用于决定要构造哪些 `employeeParams.{Name}` 子对象，绝不允许出现在最终请求体的任何层级**\r
- `language`：`"中文"` 或 `"英文"` — **仅作为 `employeeParams.Frank.language` 的值，不得挂到根级或其他员工子对象**\r
- `taskName`：任务名称（→ `collaborationSubmitTaskParam.taskName`）\r
- `executionMode`：中文字符串 `"定额任务"` 或 `"周期性任务"` — **这是 LLM 返回的内部变量，提交请求体时必须转换为数字**：\r
- 后端枚举：`"周期性任务" = 0`，`"定额任务" = 1`\r
- 🔒 **当前阶段强制规则：无论 LLM 识别结果是定额还是周期性，提交请求体时 `executionMode` 一律硬编码为数字 `1`（即按定额任务下达）**。\r
- **绝不允许**把中文字符串直接塞进请求体（如 `"executionMode": "定额任务"`），会被后端 schema 校验拒绝；也不得写成 `"1"`（带引号字符串）、`true`、`null`。\r
\r
**员工组合校验：**\r
\r
1. **不支持的员工拦截**：当 `employeeList` 包含 `Jack`、`Leo`、`Sophia`、`Alex` 中的任意一个时，**终止任务**，回复：\r
> ⚠️ 数字员工「{员工名}」尚未接入人机协作台，当前支持的员工为：AiWa、Frank、Fran、Lisa。请调整指令后重试。\r
\r
2. **销售员工无 AiWa 协同时必须指定客户来源**：当 `employeeList` 包含 `Frank`、`Fran`、`Lisa` 中的任意一个或多个，且**不包含** `AiWa` 时，**不再终止任务**；改为进入「Step 1.6 客户来源选择」流程，由用户通过「上传 xlsx 文件」或「搜索选择公司」两种方式指定要执行销售动作的客户来源，待客户来源确认完成（`fileList` / `addressFileList` / `suppurIds` 三者中至少一个非空）后再继续后续步骤。\r
- 若用户最终未提供任何客户来源（取消、放弃或多次留空），则终止任务并回复：\r
> ⚠️ 未指定任何客户来源，无法执行销售动作。请上传客户 / 地址簿 xlsx 文件，或搜索并选择目标公司后重试。\r
> （Frank / Fran / Lisa 三位销售员工均支持单独下任务，无需强制搭配 AiWa；如果你本来就想顺带做客户挖掘，也可以在指令里追加「找 N 个 XX 客户」让 AiWa 协同。）\r
\r
\r
---\r
\r
### Step 1.5：数字员工可用性校验（Step 1 完成后立即执行，所有任务均须）\r
\r
**接口：** `GET https://ai.deepsop.com/prod-api/ai/presetEmployee/list`\r
\r
**请求头：** `x-api-key: $DEEPSOP_API_KEY`\r
\r
响应 `data` 数组中每条记录关键字段：\r
- `name`：员工名称（与 employeeList 中的名称对应，如 `AiWa`、`Frank`、`Fran`、`Lisa`）\r
- `status`：启用状态，`0` = 启用，`1` = 禁用\r
- `remainingDays`：剩余可用天数（可为 null）\r
\r
**逐一检查 employeeList 中每个员工，规则如下：**\r
\r
1. **禁用状态（status = 1）→ 终止任务**，回复：\r
> ⚠️ 数字员工「{name}」当前处于禁用状态，无法执行任务。请联系管理员启用后再试。\r
\r
2. **未开通 / 已过期（status = 0 且 `remainingDays` 为 `null` 或 `remainingDays ≤ 0`）→ 进入签约流程（见下方 Step 1.5.1）**。签约完成后重新拉取 `/ai/presetEmployee/list` 校验，通过后继续；用户放弃或余额不足则终止任务。\r
\r
3. **剩余天数不足（status = 0 且 remainingDays > 0 且 remainingDays ≤ 7）→ 提醒用户，但允许继续**：\r
> ⚡ 提示：数字员工「{name}」剩余可用天数仅剩 **{remainingDays} 天**，建议尽快前往 https://ai.deepsop.com 续费，以免中断服务。\r
\r
4. **正常（status = 0 且 remainingDays > 7）→ 继续流程**\r
\r
**所有员工均通过校验后，方可继续后续步骤。任一员工触发规则 1 立即停止；规则 2 必须走完签约流程且成功后才能继续。**\r
\r
---\r
\r
#### Step 1.5.1：数字员工签约流程（仅在规则 2 触发时执行）\r
\r
按顺序执行，**每一步失败或用户放弃均立即终止任务**。\r
\r
**① 拉取套餐列表**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/setting/list?packageType=3`\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
响应 `data` 为数组，每项结构：\r
```\r
{\r
presetEmployeeId, // 关联员工 ID，用于匹配当前待签约员工\r
packageOptions: [\r
{\r
id, // optionId（提交签约用）\r
packageId, // 套餐 ID（提交签约用）\r
description, // 套餐名称文案（如"月度套餐"）\r
purchaseMonths, // 1 | 3 | 6 | 12\r
actualPrice, // 人民币实价（元）\r
discountRate, // 折扣率，100 = 无折扣\r
giftKToken // 赠送 K 币数量\r
}\r
]\r
}\r
```\r
\r
根据当前待签约员工的 `id` 匹配对应条目，取其 `packageOptions`。\r
\r
**② 展示套餐让用户选择**\r
\r
先获取人民币→K币汇率：\r
接口：`GET https://ai.deepsop.com/prod-api/system/config/configKey/CNY_TO_KCOIN`\r
响应 `msg` 即为汇率（记为 `rate`）。\r
\r
每个套餐的**应付 K 币**计算公式：\r
```\r
priceKCoin = actualPrice × (discountRate / 100) × rate\r
```\r
\r
向用户展示（格式示例）：\r
```\r
数字员工「{name}」尚未开通，请选择签约套餐（回复序号）：\r
1. {description}（{purchaseMonths}个月） — {priceKCoin} K币{折扣率≠100 时追加"（{discountRate/10}折）"}{giftKToken>0 时追加"，赠送 {giftKToken} K币"}\r
2. ...\r
\r
回复「取消」放弃签约。\r
```\r
\r
**等待用户回复序号**。用户选"取消"或无响应 → 终止任务并回复：\r
> 已取消签约，任务终止。\r
\r
**③ K 币余额校验**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/vip/balance?userId={userId}`\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
其中 `userId` 取自 Step 3 前置 B `/ai/user/profile` 返回的 `data.userId`（若此前未调用则先调用获取）。响应 `data` 即为当前 K 币余额。\r
\r
> 🔒 **强制实时查询规则（极其重要，避免使用缓存余额）：**\r
> - 每次进入本步骤 ③ 都**必须**重新调用一次 `/ai/vip/balance` 接口，**严禁**复用本会话中任何先前一次查询到的 `balance` 值。\r
> - 典型踩坑场景：一次任务里有多个员工需要连续签约（例如先给 AiWa 签约扣了 K 币，紧接着又要给 Frank 签约）；或同一员工首次提示余额不足、用户充值后让你重试 —— 此时上一轮的 `balance` 已经过时，**必须**重新发请求拿最新值，**不得**沿用记忆里的旧数字做判断或在话术中展示。\r
> - 同样地，在 ④ 提交签约扣款成功之后，如果还有下一个员工要走签约流程，回到本步骤 ③ 时也**必须**重新查询余额，不得用「旧余额 - priceKCoin」自行推算。\r
> - 用户口头告知"我已经充值了/余额已经够了"也**不能**作为跳过本接口的理由，必须以接口实时返回为准。\r
\r
取余额 `balance`（**本次接口调用的最新返回值**），与所选套餐的 `priceKCoin` 比较：\r
\r
- **`balance \x3C priceKCoin` → 余额不足，终止任务**，回复：\r
> ❌ 余额不足，签约失败。当前余额：**{balance} K币**，所需：**{priceKCoin} K币**。\r
> 请前往 https://ai.deepsop.com 登录后充值 K 币，充值完成后重新下达任务。\r
\r
**不要**尝试任何充值接口，直接终止流程。\r
\r
- **`balance ≥ priceKCoin` → 进入 ④**\r
\r
**④ 提交签约（扣 K 币）**\r
\r
接口：`POST https://ai.deepsop.com/prod-api/ai/order/purchaseIndependentPackageByKToken`\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
请求体：\r
```json\r
{\r
"packageId": "\x3C选中套餐的 packageId>",\r
"optionId": "\x3C选中套餐的 id>"\r
}\r
```\r
\r
- 成功 → 回复：\r
> ✅ 「{name}」签约成功！套餐：{description}，扣除 {priceKCoin} K币。\r
- 失败（含后端返回余额不足错误码）→ 按"余额不足"文案回复并终止。\r
\r
**⑤ 回到 Step 1.5 重新拉取 `/ai/presetEmployee/list` 校验**，该员工状态正常后继续剩余流程。\r
\r
> ⚠️ 如果剩余 employeeList 中还有其他员工需要走签约流程，回到 Step 1.5.1 处理下一个员工时，**步骤 ③ 必须重新调用 `/ai/vip/balance` 拉取最新余额**（因为本员工的 ④ 已经扣过 K 币，旧余额已失效）。**禁止**用「上一员工查到的 balance − 上一员工 priceKCoin」自行推算结果作为下一员工的余额判断依据。\r
\r
---\r
\r
### Step 1.6：客户来源选择（仅当 employeeList 含 Frank/Fran/Lisa 但**不含** AiWa 时执行）\r
\r
本步骤用于在没有 AiWa 协同的销售任务里，由用户直接指定本次销售动作要面向的客户池。所有数据最终写入 `collaborationSubmitTaskParam.sourceSettings` 对象（结构见本步骤末尾「最终装配规则」）。\r
\r
**触发条件回顾：** `employeeList` 不含 `AiWa`，且至少含 `Frank` / `Fran` / `Lisa` 之一。`employeeList` 含 `AiWa`（无论是否还含销售员工）时，**跳过本步骤**。\r
\r
**首次提问：让用户在两种来源中二选一（也可两者并用、累加生效）：**\r
\r
```\r
🧭 检测到本次任务无 AiWa 客户挖掘协同，请选择客户来源（可二选一，也可两种叠加）：\r
\r
1. 上传 xlsx 文件\r
- 客户管理（公司导入）模板：调用 API 清单 #23 `POST /ai/customer/template` 下载（详见下方「模板下载接口」小节）\r
- 地址簿（地址簿导入）模板：调用 API 清单 #24 `POST /ai/customer/contactImportTemplate` 下载（详见下方「模板下载接口」小节）\r
你可以直接上传 xlsx 文件，也可以以文字形式按模板格式提供客户/地址簿信息，由我代为整理成对应 xlsx 后上传。\r
\r
2. 搜索选择公司\r
通过关键词搜索系统内已存在的公司（客户），由你勾选若干条，对应的客户 ID 会进入 suppurIds。\r
\r
请回复「1」「2」或「1+2」，并附上你的具体输入。\r
```\r
\r
#### 途径 A：上传 xlsx 文件\r
\r
##### 模板下载接口（API 清单 #23 / #24）\r
\r
两个模板**不再**从写死的 OSS 链接获取，必须改为调用后端接口实时下载（与前端 Vue 项目 `handleDownloadTemplate` / 通用 `download(url, params, filename)` 行为一致）。\r
\r
**接口：**\r
```\r
POST https://ai.deepsop.com/prod-api/ai/customer/template # 公司导入模板（uploadType === 'fileList'）\r
POST https://ai.deepsop.com/prod-api/ai/customer/contactImportTemplate # 地址簿导入模板（uploadType !== 'fileList'）\r
```\r
\r
**请求头：**\r
- `x-api-key: $DEEPSOP_API_KEY`\r
- `Content-Type: application/x-www-form-urlencoded`\r
\r
**请求体：** 空 form（`params = {}`，序列化后为空字符串），**不要**带 JSON body。\r
\r
**响应：** `responseType: 'blob'`，二进制 xlsx 流。客户端按 `导入模板_${Date.now()}.xlsx` 命名保存即可。\r
\r
**Blob 校验规则（与前端 `blobValidate(data)` 一致）：**\r
- 若返回的 Blob 是真实 xlsx 二进制（首字节为 `PK..` zip 头）→ 视为成功，直接 `saveAs(blob, filename)`。\r
- 若 Blob 实为 JSON 文本（被错误包装成 blob 的错误响应）→ 读取 text 后 `JSON.parse`，把 `msg` 原样回给用户，**不要**当成 xlsx 保存。\r
\r
等价 curl（用于排查/手工取模板）：\r
```bash\r
curl --location --request POST 'https://ai.deepsop.com/prod-api/ai/customer/template' \\r
--header 'x-api-key: $DEEPSOP_API_KEY' \\r
--header 'Content-Type: application/x-www-form-urlencoded' \\r
--output '导入模板_company.xlsx'\r
\r
curl --location --request POST 'https://ai.deepsop.com/prod-api/ai/customer/contactImportTemplate' \\r
--header 'x-api-key: $DEEPSOP_API_KEY' \\r
--header 'Content-Type: application/x-www-form-urlencoded' \\r
--output '导入模板_contact.xlsx'\r
```\r
\r
> **禁止**继续向用户提供 `https://kocgo-ai-sales-test.oss-cn-hangzhou.aliyuncs.com/...公司导入模板.xlsx` / `...地址簿导入模板.xlsx` 这类硬编码 OSS 链接，模板内容以接口实时返回为准。\r
\r
---\r
\r
> 🛑 **【最优先】xlsx 文件回显总开关（在本步骤任何子步骤之前先读这一条）：**\r
>\r
> 从用户上传 xlsx **那一刻起**，到本任务结束为止，**所有**关于该 xlsx 的内容回显**只允许**出现在**唯一一个位置**：本步骤第 3 步「转 OSS 链接」上传成功之后、按"上传成功回复硬约束"输出的那一条消息里的「号源预览块」。除此以外的**任何**时机、任何形式的内容回显都属于 bug，包括但不限于：\r
> - ❌ "文件已经解析出来了，内容如下：列：xxx | yyy | zzz，数据：..."（**禁止的"解析预览"伪步骤**，SKILL.md 根本没有这一步）\r
> - ❌ 在追问用户文件归属（A/B 类型）之前先回显任何字段\r
> - ❌ "我看到文件里有：张三 / 李四 / 王五 / 杨总 ..." 这种姓名预览\r
> - ❌ "看列结构是 xxx，所以应该是地址簿对吧" 这种"先猜归属、再让用户确认"的反问 —— 必须直接按第 1 步原话反问，**不得**先暴露任何列名或行内容\r
> - ❌ 多列并排回显（无论是表格、管道符 `a | b | c`、JSON、还是自然语言枚举）\r
> - ❌ 用 `张三` / `李四` / `王五` / `示例` / `xxx` / `***` 等**占位符 / 脱敏 / 改写**版本"代替"回显 —— 占位符也算回显，且 100% 是幻觉\r
> - ❌ 在用户后续追问"刚才那个文件里第二行是谁"时再补回显\r
>\r
> **如果你（LLM）此刻有冲动想"让用户确认我解析对了"——立刻打住**。LLM 没有可靠的 xlsx 解析能力，任何"我解析出来是 X"的话术都有极高概率把行/列错位、或把真实姓名替换成训练语料里的高频占位名（张三/李四）。正确做法是**直接走第 1 步反问归属，不暴露任何列名/内容**；解析校验交给第 3 步上传成功后的"号源预览块"，并且严格遵守它的单列、原值、不超过 3 条、与员工渠道一一对应等约束。\r
>\r
> （事故复盘：用户上传的地址簿是 `杨总 + 13484093796 / 文总 + 16659106679`，AI 在文件类型确认**之前**插入了一段未授权的"解析预览"，把姓名整个换成了占位符 `张三 / 李四`，并把姓名+职务+电话三列一起回显。这就是本总开关要堵死的具体场景。）\r
\r
---\r
\r
1. **确认文件归属**：用户每上传一个 xlsx 文件，**必须**先反问其归属于哪种模板（**原话反问，不得在反问前/反问中夹带任何列名或行内容**）：\r
> 请确认本次上传的 xlsx 属于哪种类型？\r
> - A. **客户管理（公司导入）** —— 对应模板：`公司导入模板.xlsx`\r
> - B. **地址簿（地址簿导入）** —— 对应模板：`地址簿导入模板.xlsx`\r
\r
用户回复 A → 该文件归入「客户管理」；用户回复 B → 归入「地址簿」。**不得**自行猜测归属，**不得**用"我看列结构像是 B，对吧？"这种**带预设答案**的反问诱导用户。\r
\r
2. **文字形式补充**：如果用户没有上传文件、而是以文字方式描述客户/地址簿信息，应按对应模板的列结构整理成 xlsx 文件，再走相同的上传 / 归属确认流程。整理时遵循模板列顺序与字段名，**禁止**自行新增列或合并列。\r
\r
3. **转 OSS 链接**：调用 DeepSOP 的统一文件上传接口（API 清单 #22），后端会把文件落到阿里云 OSS 并返回公网可访问的 `https://...aliyuncs.com/...` 链接。\r
\r
**接口：**\r
```\r
POST https://ai.deepsop.com/prod-api/system/fileUpload/upload\r
```\r
\r
请求头：\r
- `x-api-key: $DEEPSOP_API_KEY`\r
- `Content-Type: multipart/form-data`（让 HTTP 客户端自动带 boundary，不要手填）\r
\r
请求体（form-data）：\r
- `file`：xlsx 文件本身（**字段名严格为 `file`，不得改成 `upload` / `xlsx` / `attachment`**）\r
\r
等价 curl：\r
```bash\r
curl --location --request POST 'https://ai.deepsop.com/prod-api/system/fileUpload/upload' \\r
--header 'x-api-key: $DEEPSOP_API_KEY' \\r
--form 'file=@"\x3C本地 xlsx 绝对路径>"'\r
```\r
\r
**成功响应示例：**\r
```json\r
{\r
"msg": "操作成功",\r
"code": 200,\r
"fileName": "公司导入.xlsx",\r
"url": "https://kocgo-ai-sales-test.oss-cn-hangzhou.aliyuncs.com/material/100/xxx.xlsx"\r
}\r
```\r
\r
**响应解析规则：**\r
- 当且仅当 `code === 200` 视为成功；其它 `code` 一律按上传失败处理，把 `msg` 原样回给用户并要求重试，**不得**继续。\r
- 取顶层 `url`（**不是** `data.url`，本接口的成功结构是平铺字段）作为 OSS 链接。\r
- 该 URL 必须满足：`https://` 开头 + 域名含 `aliyuncs.com`。不满足则视为上传失败，**不得**写入 `fileList` / `addressFileList`。\r
\r
> 🛑 **上传成功回复硬约束（强制，违反即视为 bug）：**\r
>\r
> 用户上传 xlsx 成功后，**只能**给用户回以下格式的话（基础句式 + 可选号源预览）：\r
>\r
> > ✅ 文件 `{fileName}` 上传成功，本次共导入 **{N}** 条{公司 / 联系人}数据。\r
>\r
> - `{N}` = 本地 xlsx 的**数据行数**（不含表头行）；如果当前运行环境无法读取本地 xlsx，就只回「文件上传成功」，**不要**自己编一个数字。\r
> - 类型 A（公司导入）→ 后缀「条公司数据」；类型 B（地址簿导入）→ 后缀「条联系人数据」。\r
>\r
> **号源预览规则（按下任务员工展示对应渠道字段）：**\r
>\r
> 在能可靠解析本地 xlsx 的前提下（如运行环境提供了 xlsx 解析能力，且能确定地读出表头列名），按本次任务的**销售执行员工**追加号源预览片段，**只展示与该员工渠道对应的那一列**前 3 条非空值，不展示其他任何字段：\r
>\r
> | 任务员工 | 展示列 | 列名匹配（命中任一即可，大小写不敏感） |\r
> |---|---|---|\r
> | **Frank**（邮件销售） | 邮箱 | `email` / `邮箱` / `邮件` |\r
> | **Fran**（电话销售） | 电话 | `phone` / `mobile` / `tel` / `电话` / `手机` / `手机号` |\r
> | **Lisa**（短信销售） | 电话 | 同上 |\r
>\r
> 命中后追加格式（注意：每条单独一行，前后用反引号包住，不带姓名/公司/序号以外的任何字段）：\r
>\r
> > 号源预览（仅展示 {Frank → 邮箱 / Fran/Lisa → 电话} 列前 3 条，供你核对，不代表全部）：\r
> > 1. `{value_1}`\r
> > 2. `{value_2}`\r
> > 3. `{value_3}`\r
>\r
> **强约束（违反即视为 bug，全部并列生效）：**\r
> - **只准展示当前员工对应的那一列**：Frank 不展示电话列，Fran/Lisa 不展示邮箱列；**绝对禁止**把同一行的姓名、公司、地址、岗位、行业、备注等其他字段拼进来。\r
> - **必须**严格按 xlsx 中该列的原始顺序取前 3 条非空值，**不得**重排、去重、改写、脱敏、截断或"美化"为占位符。\r
> - 同一任务命中多个销售员工（例如 Fran + Lisa）时，电话列只输出**一次**预览块；如果同时有 Frank 和 Fran/Lisa，则分别输出邮箱预览块与电话预览块（仍然各自只取该列前 3 条）。\r
> - **任何**无法可靠解析的情况一律退化为"只回文件名 + 条数"基础句式，**不得**输出号源预览块。包括但不限于：运行环境读不到本地 xlsx；找不到匹配的列名；该列前 3 行全部为空；列内容看起来与渠道不符（如声称是邮箱列但值里没有 `@`、声称是电话列但值里全是非数字字符）。\r
> - **绝对禁止**凭记忆 / 凭印象 / 凭用户聊天里提过的样例**编造**号码或邮箱。哪怕只多写一个数字、改一个字母，也按 bug 处理。\r
> - **绝对禁止**在号源预览块里出现**任何**人物姓名、公司名、阶段标签、星级、地区、备注；如果用户后续追问"这是谁的号码 / 哪个公司的邮箱"，统一回："导入的明细以 DeepSOP 后台为准，提交任务后可在客户管理 / 地址簿模块查看，本助手只对你核对的渠道列（电话/邮箱）做有限回显，不关联到具体人物或公司，以免错位。"\r
>\r
> **历史事故复盘（必读）：** 早期实现里 AI 在"上传成功"提示里把内容回显成了 `C 公司 + A 电话 / D 公司 + B 电话` 这种**行/列错位**结果（用户原文件其实是 `A 公司 + A 电话 / B 公司 + B 电话`），导致用户去删数据 / 重传 / 改任务。**根本原因**：LLM 没有可靠的跨字段对齐能力，只要同时回显 ≥2 个字段就有概率串行。所以本规则刻意**只允许单列回显、且是与当前员工渠道一一对应的那一列**——既能让用户核对号源到底有没有传对，又把 LLM 的错位风险压到最低。\r
\r
4. **落位规则**：\r
- 类型 A（客户管理 / 公司导入）→ 把上传接口返回的 `{ name, url }` **对象**追加到 `sourceSettings.fileList` 数组中。\r
- 类型 B（地址簿 / 地址簿导入）→ 把上传接口返回的 `{ name, url }` **对象**追加到 `sourceSettings.addressFileList` 数组中。\r
- 同一类型可累加多个文件，按上传顺序追加。\r
\r
> 🛑 **类型强约束（最常见、最高危错误）**：`fileList` / `addressFileList` 的元素**必须是 `ExcelFile` 对象**，对应后端 Java POJO：\r
>\r
> ```java\r
> public static class ExcelFile {\r
> String name; // 文件名（含 .xlsx 后缀），如 "公司导入.xlsx"\r
> String url; // 阿里云 OSS 公网 URL（来自上传接口顶层 url 字段）\r
> }\r
> ```\r
>\r
> 整体类型是 `ExcelFile[]`（即 `Array\x3C{name: string, url: string}>`）。两字段约束完全对称，**任一**写错都会导致后端解析失败或客户来源丢失。\r
>\r
> **元素装配规则：** 上传接口 `/system/fileUpload/upload` 成功响应的顶层字段：\r
> - `fileName` → 装到 ExcelFile 的 **`name`** 字段（注意：上传响应叫 `fileName`，但 ExcelFile 的字段叫 `name`，需要重命名）\r
> - `url` → 装到 ExcelFile 的 `url` 字段\r
>\r
> **`addressFileList`（地址簿 / 地址簿导入）**\r
>\r
> **正确：**\r
> ```json\r
> "addressFileList": [\r
> { "name": "地址簿导入.xlsx", "url": "https://kocgo-ai-sales-test.oss-cn-hangzhou.aliyuncs.com/material/100/xxx.xlsx" }\r
> ]\r
> ```\r
>\r
> **错误：**\r
> - ❌ `"addressFileList": ["https://..."]`（裸 URL 字符串数组 — 后端反序列化为 ExcelFile 失败）\r
> - ❌ `"addressFileList": [{ "url": "https://..." }]`（漏 `name`）\r
> - ❌ `"addressFileList": [{ "name": "...", "url": "...", "fileName": "..." }]`（多余 `fileName` 键 — 用 `name`，不要再带 `fileName`）\r
> - ❌ `"addressFileList": [{ "fileName": "...", "url": "..." }]`（key 写成 `fileName` — 必须是 `name`）\r
> - ❌ `"addressFileList": {}`（空对象 — 类型必须是数组）\r
> - ❌ `"addressFileList": [{}]`（空对象元素）\r
> - ❌ `"addressFileList": null` / 省略字段（无地址簿文件时写成空数组 `[]`，**不能**为 `null` 或缺省）\r
>\r
> **`fileList`（客户管理 / 公司导入）**\r
>\r
> **正确：**\r
> ```json\r
> "fileList": [\r
> { "name": "公司导入.xlsx", "url": "https://kocgo-ai-sales-test.oss-cn-hangzhou.aliyuncs.com/material/100/yyy.xlsx" }\r
> ]\r
> ```\r
>\r
> **错误：** 错误模式与 `addressFileList` 完全对称（裸字符串、漏 `name`、key 写成 `fileName`、`{}` / `null` / 缺省、空对象元素等），不再赘述。此外：\r
> - ❌ 把已经成功上传的 xlsx 文件 "忘了"放进去（最终请求体里 `fileList: []`，导致前端选了文件但后端实际收不到客户来源）\r
>\r
> **统一规则**：用户每上传一个 xlsx 并由其确认归属后，对应的 `{ name, url }` 对象（`name` 来自上传响应的 `fileName`，`url` 来自顶层 `url`）必须作为 ExcelFile 元素 push 进对应数组（A 类→`fileList`，B 类→`addressFileList`），并在最终提交前肉眼核对 `sourceSettings` 中两字段的元素数量与已确认归属的文件数一致。**禁止**在最终请求体里把已成功上传的文件丢失为 `[]`，更**禁止**把字段写成 `{}` / `null` / 字符串数组 / 漏 `name` 或 `url` 任一键。\r
\r
5. **`updateSupport`（仅 `fileList` 非空时生效）**：\r
- 含义：xlsx 中存在与系统内已有客户**公司名完全相同**时，是否覆盖更新已有客户信息。\r
- 取值：`1` = 更新（默认）；`0` = 不更新。\r
- 用户未明确说明时使用默认值 `1`；用户表达「不要覆盖 / 保留原数据 / 不要更新已有客户」等含义时改为 `0`。\r
\r
#### 途径 B：搜索选择公司（`sourceType === 'search'`）\r
\r
此途径对应前端 Vue 项目的「客户搜索栏」逻辑（`sourceType === 'search'` 分支），与前端共用同一个客户列表接口。\r
\r
**接口（API 清单 #21）：**\r
```\r
POST https://ai.deepsop.com/prod-api/ai/customer/customerList?pageNum={pageNum}&pageSize=10\r
```\r
\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
**Query 参数（与 body 中同名字段冗余传递，与前端 Vue 的 `params` 对齐）：**\r
- `pageNum`：从 `1` 开始的页码\r
- `pageSize`：**固定为 `10`，禁止改写**\r
\r
**Body（JSON）：**\r
```json\r
{\r
"pageNum": \x3C同上>,\r
"pageSize": 10,\r
"name": "\x3C公司名搜索关键词，无关键词时填空字符串 \"\">",\r
"searchSort": "\x3C排序字段：\"\" | \"email\" | \"phone\">",\r
"type": 0\r
}\r
```\r
\r
> 🔒 **Body 字段硬约束：**\r
> 1. `type` **恒为数字 `0`**（不是字符串、不是 `1`），来自前端 `getCustomerList` 中 `{ ...customerQueryParams, type: 0 }` 的硬编码。\r
> 2. `searchSort` 仅允许三种值：`""`（默认不排序）、`"email"`（按邮箱排序）、`"phone"`（按电话排序）。任何其他值都属于编造。\r
> 3. `name` 为空时必须显式传 `""`，**不要**省略键也不要传 `null`。\r
> 4. 同一次会话中，每次发起搜索都需把上述 5 个键全部带上，缺键属于错误。\r
\r
**响应字段：**\r
- `total`：搜索到的总条数（数字）\r
- `rows`：当前页的客户数组，每条至少含：\r
- `id`：客户唯一 ID（用于装入 `suppurIds`）\r
- `name`：公司名\r
- `countryName` / `countryValue`：国家中文名 / 国家代码（如 `cn`、`us`，前端用作国旗图片名）\r
- `email` / `phone`：联系邮箱 / 电话（可能为空，空时取 `aiCustomers[0]` 的对应字段）\r
- `stageLabel`：客户阶段对象 `{ stageLabel, backgroundColor, color }`（可空）\r
- `groupName` / `groupId`：客户分组（可空）\r
- `level`：客户星级（0–5）\r
- `aiSuppurLabels`：客户标签数组 `[{labelName, backgroundColor, color}, ...]`\r
- `aiCustomers`：联系人数组；当 `email` / `phone` 为空时，前端会取 `aiCustomers[0].email` / `aiCustomers[0].phone` 兜底（对齐 Vue 的 `handlePropLabel`）。\r
- `aiDynamics` / `aiEmails` / `aiPhoneCalls`：跟进动态 / 邮件 / 电话数组，**后端原始返回**，前端 `calculateLastFollowInfo` 用它们衍生出 `lastFollowInfo` 字段。\r
\r
> ℹ️ **`lastFollowInfo` 不是后端返回字段**，是前端纯展示衍生数据。SKILL 侧只需要 `id` 用于 `suppurIds`，无需复刻 `calculateLastFollowInfo` 的衍生逻辑；如需在对话里展示"最近动态"，可参考 Vue `calculateLastFollowInfo`：从 `aiDynamics` / `aiEmails`(`emailSubject` 当 content、`createTime` 当 time) / `aiPhoneCalls`(解析 `describeJobJson.body.job.contacts[0].phoneNumber + tasks[0].status`) 三个列表中各取最新一条，再按 `time` 取最大者作为该客户的"最近动态"。\r
\r
**交互流程：**\r
\r
1. **首次进入搜索**：用户选择途径 2 后，先以默认参数 `{ pageNum: 1, pageSize: 10, name: "", searchSort: "", type: 0 }` 拉取一次列表（与 Vue `watch.sourceType` 中 `if (newVal === 'search' && !this.customerTableData.length)` 行为一致），再让用户输入关键词。\r
\r
2. **关键词搜索**：用户给出公司名 / 关键词时，把它作为 `name` 重发请求，并把 `pageNum` 重置为 `1`（对齐 Vue 的 `handleCustomerQuery`）。\r
\r
3. **结果展示**：每次返回向用户输出：\r
> 共搜到 **{total}** 条数据，当前为第 **{pageNum}** 页 / 共 **{Math.ceil(total/10)}** 页（每页 10 条）。\r
>\r
> 1. {name} | {countryName} | {email or phone} | 阶段：{stageLabel?.stageLabel || '—'} | 等级：{level}星\r
> 2. ...\r
>\r
> 回复「页码 N」切换分页；回复「{name 关键词}」重新搜索；回复要选中的条目序号（多个用逗号分隔，如 `1,3,5`）或「全选当前页」加入选择；回复「清空选中」可重置已选；回复「确认」结束选择。\r
\r
4. **翻页**：用户回复「页码 N」时，保持 `name` / `searchSort` 不变，仅更新 `pageNum = N` 后重新调用接口。`N` 必须 ∈ `[1, ceil(total/10)]`，越界则回复并要求重输。\r
\r
5. **排序切换（可选）**：当用户表达"按邮箱排序" / "按电话排序"时，把 `searchSort` 设为 `"email"` / `"phone"`，否则保持 `""`（对齐 Vue 的 `handleCustomerSortChange`：再次点击同一列时回到 `""`）。\r
\r
6. **勾选 / 全选 / 清空**（对齐 Vue 的 `handleCustomerSelect` / `handleCustomerSelectAll` / `handleClearCustomerSelection`）：\r
- 单选：`selection` 数组中存在该 `id` 则移除，否则追加。\r
- 全选当前页：把当前 `rows` 中尚未在 `selection` 内的全部加进去；取消全选则把当前 `rows` 中已选的从 `selection` 移除（**只影响当前页**，不清掉其他页已选）。\r
- 清空：`selection` 置空。\r
- 翻页或重新搜索时**不要清空 `selection`**（Vue 中 `getCustomerList(false)` 的 `clearSelectionFlag=false` 路径），需要在新页面里把已勾选过的行用接口返回的 `id` 集合**回显**为已选。\r
\r
7. **同步到 `sourceSettings.suppurIds`**（对齐 Vue 的 `syncCustomerIds`）：每次 `selection` 变更立即执行：\r
```\r
sourceSettings.suppurIds = selection.map(item => item.id)\r
```\r
**字段名是 `suppurIds`（拼写：`suppur` 非 `supplier`），不得改写为 `supplierIds` / `customerIds`。** `id` 类型保持接口返回原样（数字或字符串），不做 toString / parseInt 转换。\r
\r
8. **结束选择**：用户回复「确认」（或表达完成选择的等价语义）后退出途径 B。**未确认前**不进入 Step 2/3。\r
\r
#### 最终装配规则\r
\r
完成客户来源选择后，本步骤产出的 `sourceSettings` **必须**严格采用以下结构（键集与示例一致，键序不限）：\r
\r
```json\r
{\r
"groupId": [],\r
"stageId": [],\r
"labelId": [],\r
"level": [],\r
"seasGroupIds": [],\r
"addressId": [],\r
"fileList": [],\r
"updateSupport": 1,\r
"addressFileList": [],\r
"suppurIds": []\r
}\r
```\r
\r
字段说明（仅 `fileList` / `updateSupport` / `addressFileList` / `suppurIds` 由本步骤填充，其余固定为空数组）：\r
\r
| 字段 | 类型 | 来源 | 说明 |\r
|---|---|---|---|\r
| `groupId` / `stageId` / `labelId` / `level` / `seasGroupIds` / `addressId` | `array` | 固定空数组 `[]` | 当前 SKILL 不暴露这些维度的选择，恒为 `[]` |\r
| `fileList` | `ExcelFile[]` | 途径 A 类型 A | 客户管理（公司导入）xlsx 文件对象列表，元素结构 `{ "name": "\x3C文件名>", "url": "\x3COSS URL>" }` |\r
| `updateSupport` | `0 \| 1` | 途径 A 用户确认 | 公司同名是否覆盖更新，默认 `1` |\r
| `addressFileList` | `ExcelFile[]` | 途径 A 类型 B | 地址簿（地址簿导入）xlsx 文件对象列表，元素结构同 `fileList` |\r
| `suppurIds` | `(string\|number)[]` | 途径 B | 用户搜索选中的客户 ID 列表 |\r
\r
**最终硬校验（继续后续步骤前必过）**：\r
- `fileList.length > 0` **或** `addressFileList.length > 0` **或** `suppurIds.length > 0`，三者**至少一个**非空。\r
- 若三者全空，回到本步骤开头重新询问用户；连续 2 次询问仍全空，按 Step 1「员工组合校验」第 2 条的终止文案结束任务。\r
\r
> 🔒 **本步骤产出的 `sourceSettings` 优先级最高**：当 `employeeList` 不含 AiWa 但含销售员工时，最终提交请求体中的 `sourceSettings` 必须是本步骤产出的对象，**禁止**使用 AiWa 联合场景下含 `cascader` / `aiMining` / `customerMining` / `seasMining` / `uploadMining` / `countryId` / `addressMining` 的旧版结构。\r
\r
---\r
\r
### Step 1.7：电话场景创建/审核子流程（独立入口）\r
\r
> 触发方式（**任一**）：\r
> - **A. 用户主动触发**：Step 1 意图分流命中"场景创建"关键词。\r
> - **B. Fran 流程兜底**：Step 3 前置 A-2 的 `listScripts` 返回空、或全部场景 `status` 都不是 `PUBLISHED`，且用户回复"创建/我自己建/帮我建一个"。\r
>\r
> 出口：拿到 `scriptId` + `agentProfileId`（场景已 PUBLISHED）。\r
> - 触发方式 A 完成后：直接回复用户"场景已发布，可用于后续电话销售任务"，**不再**自动进入销售流程；\r
> - 触发方式 B 完成后：把 `scriptId` / `agentProfileId` 当作前置 A-2 的选定结果，继续 Step 3 前置 B / D / 最终提交流程。\r
\r
#### Step 1.7.0：环境前置自检\r
\r
进入子流程前，先校验外呼实例可用性（与 Step 3 前置 A-0 同接口）：\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/outBound/describeInstance`，请求头 `x-api-key: $DEEPSOP_API_KEY`。\r
\r
- 实例并发数为 0：终止子流程，回复用户"外呼实例并发数为 0，请联系管理员开通后再尝试创建场景"；\r
- 实例可用：继续。\r
\r
#### Step 1.7.1：澄清场景基础信息\r
\r
向用户依次询问以下槽位。**每一轮只问 1～2 个槽位**，等用户回复后才追问下一组。**所有 `promptJson.*` 字段名与上限均与前端 Vue 表单严格对齐，超长会被后端拒绝或截断**：\r
\r
| 槽位 | 必填 | 默认 | 上限（字符） | 说明（与 Vue 表单 label 一致） |\r
|---|---|---|---|---|\r
| `industry` | 否 | `"通用"` | — | 行业（scriptParams.industry） |\r
| `scene` | 否 | `"通用"` | — | 场景（scriptParams.scene） |\r
| `scriptName` | 是 | — | ≤30 | 场景库名称（scriptParams.scriptName） |\r
| `promptJson.openingPrompt` 👋 开场白 | **是** | — | **200** | 开场白原文，直接对客户读出来的话 |\r
| `promptJson.goals` 🚩 目标 | **是** | — | **1000** | 此次呼叫的目的，如「调研上次服务的满意度情况」 |\r
| `promptJson.background` 📌 背景 | 否 | `""` | 2000 | 呼叫背景，活动信息、FAQ 等 |\r
| `promptJson.skills` 🛠️ 技能 | 否 | `""` | 1000 | 机器人能执行的具体事项（多条用编号） |\r
| `promptJson.workflow` 🧰 流程 | 否 | `""` | 4000 | 与客户交流的过程骨架 |\r
| `promptJson.constraint` 📦 约束 | 否 | `""` | 3000 | 对话约束/异常话术（专业用语、情绪识别等） |\r
\r
> ⛔ **禁止 LLM 自己脑补 `openingPrompt` 与 `goals`**：必须由用户至少给出大致内容；若用户说"你帮我编一个"，先草拟一版**展示给用户确认**，等待用户回复"确认/就这个"才能继续。\r
>\r
> ⛔ **禁止超长**：每个字段提交前自检 `len(value) ≤ 上限`；接近上限时（≥80%）主动提醒用户精简，避免脚本 pre-flight 校验报 `TOO_LONG`。\r
>\r
> ⛔ **不要再向用户索要 Vue 表单未暴露的字段**（如 `name` / `gender` / `age` / `role` / `communicationStyle` / `output` / `aiHangupOutput` / `aiSilenceTimeoutOutput`）。这些字段在 schema 里存在，但 Vue UI 不让用户填，本 SKILL 同样**统一以空字符串占位**，由后端使用其默认行为。\r
\r
线索字段（`agentForm.labelsJson`，对应 Vue 底部「线索收集管理」表格，非必填，可多次追加）：\r
让用户列出"这通电话需要收集的客户信息"，每条 3 列：\r
- **线索名称**（`name`）：要收集的字段名，如「客户兴趣」「能否到访」\r
- **线索描述**（`description`）：用于让机器人正确判定该线索的解释\r
- **线索关键词**（`valueList`）：候选取值数组（Vue UI 是"+ 关键词"逐个加 tag），如 `["有兴趣","没兴趣","待跟进"]`；用户可以不填，留空数组 `[]` 表示开放收集\r
\r
> 装配时 `valueList` 必须**先转成 JSON 字符串**（如 `"[\"有兴趣\",\"没兴趣\"]"`），这是阿里云 Chatbot 的格式硬要求；脚本内 `validate_script_params.py` 会强校验此点。\r
\r
变量字段（`agentForm.variablesJson`，非必填）：通话过程中需要替换的占位变量名（如 `customerName`），每条 `{name, description}`，最终也是 JSON 字符串。\r
\r
#### Step 1.7.2：TTS 音色配置\r
\r
向用户提供以下默认值，并允许用户调整：\r
\r
```\r
默认 TTS 配置：\r
- 发音人：CosyVoice:longcheng（女声 / 通用）\r
- 引擎：ali（阿里云标准 TTS）\r
- 音量：50（0–100）\r
- 语速：0（-500 ~ +500）\r
- 语调：0（-500 ~ +500）\r
- 全局可打断：开\r
- 服务类型：Managed\r
```\r
\r
用户可单点或整体替换；若选择克隆音色，引擎须改为 `bailian`。**禁止**让用户自由输入 `nlsServiceType` / `nluEngine` / `nluAccessType`，全部按下方"参数固定值"装配。\r
\r
#### Step 1.7.3：装配请求体（两段 JSON 字符串）\r
\r
待全部槽位收齐，按以下结构装配。**严格对齐 Vue 数据模型**：`promptJson` 内部包含全部 14 个 schema 字段，但只有 6 个用户可填字段会有值，其余字段统一使用空字符串占位。\r
\r
`agentParams.promptJson` / `labelsJson` / `variablesJson` / `scriptParams.ttsConfig` 都是**先建对象/数组再 `JSON.stringify` 一次**得到的字符串；其中 `labelsJson[*].valueList` 还要再 `JSON.stringify` 一次（**二次 stringify**）。\r
\r
构建步骤建议（按顺序，避免 LLM 拼错引号）：\r
\r
1. 先构造 promptJson 的 **对象**：\r
```json\r
{\r
"name": "", "gender": "", "age": "", "role": "", "communicationStyle": "",\r
"openingPrompt": "您好，我是XX公司客服助理...",\r
"goals": "邀约客户参加 4 月 20 日新品发布会",\r
"background": "",\r
"skills": "",\r
"workflow": "",\r
"constraint": "",\r
"output": "", "aiHangupOutput": "", "aiSilenceTimeoutOutput": ""\r
}\r
```\r
再 `JSON.stringify` 一次得到 `agentParams.promptJson` 字符串。\r
\r
2. 构造 labelsJson 的 **数组**（用户每条线索）：\r
```json\r
[\r
{ "name": "客户兴趣", "description": "客户对产品是否有兴趣的判断", "valueList": ["有兴趣", "没兴趣", "待跟进"] }\r
]\r
```\r
**遍历**对每个元素的 `valueList` 单独 `JSON.stringify`：\r
```json\r
[\r
{ "name": "客户兴趣", "description": "客户对产品是否有兴趣的判断", "valueList": "[\"有兴趣\",\"没兴趣\",\"待跟进\"]" }\r
]\r
```\r
再对整个数组 `JSON.stringify` 一次得到 `agentParams.labelsJson`。\r
\r
3. 构造 ttsConfig 的 **对象**，再整体 `JSON.stringify` 得到 `scriptParams.ttsConfig`：\r
```json\r
{\r
"voice": "CosyVoice:longcheng",\r
"voiceShow": [0, "CosyVoice:longcheng"],\r
"volume": 50,\r
"speechRate": 0,\r
"pitchRate": 0,\r
"globalInterruptible": true,\r
"engine": "ali",\r
"nlsServiceType": "Managed"\r
}\r
```\r
\r
4. 最终请求体（与 Vue `getProcessData()` 输出 1:1 对齐）：\r
```json\r
{\r
"agentParams": {\r
"model": "model_001",\r
"agentProfileId": "",\r
"promptJson": "\x3C上方第 1 步 stringify 后的字符串>",\r
"labelsJson": "\x3C上方第 2 步 stringify 后的字符串>",\r
"variablesJson": "[]"\r
},\r
"scriptParams": {\r
"scriptId": "",\r
"scriptName": "4月新品发布邀约",\r
"industry": "通用",\r
"scene": "通用",\r
"nluEngine": "Prompts",\r
"nluAccessType": "Managed",\r
"ttsConfig": "\x3C上方第 3 步 stringify 后的字符串>"\r
}\r
}\r
```\r
\r
> 🔒 **字段名零改写规则同样适用于本步骤**（参见 Step 3 总规约「字段名零改写规则」）：\r
> - `agentParams` ≠ `agent_params` / `AgentParams`；`scriptParams` ≠ `script_params`\r
> - `promptJson` / `labelsJson` / `variablesJson` 必须是 **JSON 字符串**（外层套引号、内层用 `\"`），**不得**直接放对象/数组\r
> - `ttsConfig` 同上，是 JSON 字符串而不是对象\r
> - `labelsJson` 元素里的 `valueList` 是**二次 stringify 过的字符串**（如 `"[\"v1\",\"v2\"]"`），不是数组\r
> - **修改场景**（Fran 流程兜底外的「编辑现有草稿」入口）需在 `agentParams.agentProfileId` 与 `scriptParams.scriptId` 填入既有值；新建场景这两个字段一律为空字符串 `""`，**禁止省略键名**\r
\r
> 🔡 **UTF-8 传输强约束**（这是脚本存在的核心理由）：\r
> - LLM 在 Windows 终端**禁止**直接用 `curl` / `Invoke-RestMethod` 提交以上请求体——cp936 代码页会把 `openingPrompt` / `goals` / `background` 等中文字段静默转码导致后端审核拒绝\r
> - **必须**通过 `python3 scripts/submit_script_review.py \x3C\x3C'SCRIPT_BODY_EOF' ... SCRIPT_BODY_EOF` 走脚本，脚本内部以 `bytes = json.dumps(body, ensure_ascii=False).encode("utf-8")` + `Content-Type: application/json; charset=utf-8` 显式发送字节，已和 `submit_task.py` 同级别强约束\r
\r
#### Step 1.7.4：提交并轮询审核\r
\r
把装配好的 body 通过 stdin 喂给 `scripts/submit_script_review.py`，**禁止**写 curl：\r
\r
```bash\r
python3 scripts/submit_script_review.py \x3C\x3C'SCRIPT_BODY_EOF'\r
{\r
"agentParams": { ... },\r
"scriptParams": { ... }\r
}\r
SCRIPT_BODY_EOF\r
```\r
\r
脚本内部串行执行：\r
1. UTF-8 解码 stdin；\r
2. 跑 `validate_script_params.py` 做结构/取值层 pre-flight 校验；\r
3. POST `/ai/outBound/createOrModifyScriptAndSubmitScriptReview` 提交场景+TTS+机器人设定；\r
4. 拿到返回中的 `scriptId` / `agentProfileId`；\r
5. 每 10s 轮询一次 `/ai/outBound/describeScript` 直到 `data.body.script.status === "PUBLISHED"` 或超时（默认 600s）。\r
\r
可选参数：\r
- `--no-poll`：提交完立即返回（不等审核），用于"先入库再异步等"的场景。\r
- `--max-wait-seconds N`：自定义最长等待时长（秒）。\r
- `--dry-run`：只跑校验，不发任何 HTTP。\r
\r
输出（stdout 单行 JSON）：\r
- 成功：`{"ok":true,"stage":"done","scriptId":"...","agentProfileId":"...","status":"PUBLISHED","elapsed_seconds":47}`\r
- 校验失败：`{"ok":false,"stage":"validate","summary":"...","errors":[{path,code,msg,suggestion}]}`\r
- 网络/服务端非 2xx：`stage` 为 `http`，含 `response`\r
- 审核未在超时内完成：`stage` 为 `polling`，含 `scriptId` 与最后一次 `status`\r
- 审核被驳回（status ∈ {`FAIL_REVIEW`,`REJECT`,`FAILED`}）：`ok:false`，须把错误信息原样回给用户后让其调整 prompt 后重试\r
\r
> ⛔ **退出码 0 才算成功**；非 0 必须把 `summary` / `errors` 原样回报用户，**禁止**绕过校验或假装成功。\r
\r
#### Step 1.7.5：审核完成后的处理\r
\r
- **触发方式 A**（用户主动）：回复\r
> ✅ 场景"{scriptName}"已通过阿里云审核（scriptId=`...`，agentProfileId=`...`），后续提交 Fran 电话任务时可直接选用。\r
\r
- **触发方式 B**（Fran 兜底）：把 `{scriptId, agentProfileId}` 当作前置 A-2 的最终选定结果，**不再**回调 `listScripts`，直接进入 Step 3 前置 B（若需要）或最终装配。在装配 Fran 子对象时：\r
- `scriptId` ← 本步骤拿到的字符串原值（不得改名、不得二次包裹引号）\r
- `agentProfileId` ← 本步骤拿到的字符串原值（不得改名为 `agentId` / `chatbotId` / `profileId`）\r
\r
#### Step 1.7.6：场景审核辅助操作（用户已有草稿/审核中场景）\r
\r
当用户**不是**要新建/编辑场景内容，而是想：\r
\r
- **重新提交既有草稿/已发布场景进入审核**（如已存在 `DRAFTED` / `ROLLBACK_FAILED` / `PUBLISH_FAILED` / 已 `PUBLISHED` 但想重审的场景）→ 用 5.4 `submitScriptReview`\r
- **撤销正在审核中的场景**（`TO_BE_REVIEWED` 等）→ 用 5.5 `withdrawScriptReview`\r
\r
**前置确认**（必须先做，禁止直接发请求）：\r
1. 调用 5 `listScripts`（请求体 `{"pageNumber":1,"pageSize":20,"scriptName":"\x3C可选关键词>"}`）拿到列表；\r
2. 将 `scriptName + status + 创建时间` 渲染给用户挑选；\r
3. 等用户明确选定后才取出对应 `scriptId`。\r
\r
**请求体**（两个接口结构一致）：\r
\r
```json\r
{\r
"scriptId": "\x3C上一步选定>",\r
"description": "提交审核"\r
}\r
```\r
\r
> 与 `submit_script_review.py` 不同，本步骤**不**走 pre-flight 校验（请求体足够简单），可以直接发送，但仍需通过 `python -c "import urllib.request,json; ..."` 或临时小脚本以 **UTF-8 字节路径**发出，**禁止** PowerShell 原生 `Invoke-RestMethod`（避免 cp936 影响 `description` 字段，虽然此处通常是固定文案）。\r
\r
成功后**必须**调用 `describeScript` 复查一次 `status` 再回复用户实际状态变化（如 `DRAFTED → TO_BE_REVIEWED`），不要凭返回 `code:200` 就声称"已通过审核"。\r
\r
---\r
\r
### Step 2：第二轮 AI 分析（仅当 employeeList 包含 AiWa）\r
\r
用以下 prompt 对同一用户指令做第二轮分析，严格返回 JSON。**该 prompt 的 JSON 字段名、结构、取值类型不得改写**——下游 `validate_employee_params.py` 与 `addressObjList` 的 `type=1/0` 构建逻辑都依赖此契约。\r
\r
```\r
根据【指令】描述，Json格式返回数据，其中所有数值部分一律以字符串输出（如 "50"，禁止输出数字 50），未提及的字段一律返回空字符串 ""（数组类字段除外，按字段说明处理）。\r
\r
【全局原则】\r
1. 只识别描述中明确出现的信息，禁止过度解读、补全、推断未提及的内容；不确定时一律返回空字符串。\r
2. 输出必须是合法 JSON，且除 JSON 外不得出现任何说明文字、Markdown 代码块标记、注释。\r
3. 字段顺序、键名、类型必须严格与下方"规则"完全一致。\r
\r
【数值区间通用规则（员工/门店等所有 RangeStart / RangeEnd 字段统一适用）】\r
- 仅当描述中明确出现"\x3C对象>X\x3C量词>\x3C比较词>"形态时才提取，三种比较词分别处理：\r
- "X以上" → Start = "X"，End = ""\r
- "X以下" → Start = ""，End = "X"\r
- "X左右" → Start = "X"，End = "X"\r
- "X到Y" / "X-Y" / "X至Y" → Start = "X"，End = "Y"\r
- 未出现比较词或仅出现单一具体数字（如"员工50人"无以上/以下/左右）→ Start/End 均为 ""。\r
- 描述中"找X家门店""开发X个客户""挖掘X家"等是**任务目标数量**，**不**写入 storeNumberRange* / employeeNumberRange*；任务目标已在 Step 1 的 totalTarget 处理，本步骤不重复提取。\r
\r
【国家 vs 七大洲互斥规则】\r
- 如果描述中提到任何具体国家（如"中国"、"英国"、"美国"），则 continent 必须为 ""，仅在 country / countryCodeList 中输出。\r
- 仅当描述中只提到大洲（如"亚洲眼镜店"）而未提到任何国家时，才在 continent 输出对应大洲名，country / countryCodeList 留空（country = ""，countryCodeList = ""）。\r
- 七大洲取值集合限定为：亚洲、欧洲、非洲、北美洲、南美洲、大洋洲、南极洲。\r
\r
【地址提取规则（addressObjList）】\r
- 第一步：识别并**排除**所有出现在公司名称、品牌名、企业全称、组织机构名、店铺名中的地理位置——例：【巨龙光学（福建）有限公司】中的"福建"、【XX上海分公司】中的"上海"、【杭州佬大食品】中的"杭州"，均不参与提取。\r
- 第二步：在剩余描述里提取明确出现的、国家层级之下的地理位置；中国地址按"一级（省/直辖市/自治区）→二级（市）→三级（区/县/镇）"拆分，**多级用英文逗号 `,` 拼接到同一字符串**（如"浙江宁波鄞州区" → "浙江,宁波,鄞州区"）。\r
- 第三步：非中国地址（英文国家/地区下的地理位置）一律以英文原文整段输出，不做层级拆分（如"London, UK" → "London, UK"）。\r
- 多个互不归属的地址：用英文分号 `;` 分隔多组（如"浙江宁波;广东深圳" → "浙江,宁波;广东,深圳"；"London, UK; Paris, France" → "London, UK; Paris, France"）。下游会按 `;` 切分为多个对象，再按是否含中文拆分到 `type=1`（结构化省市县）或 `type=0`（自由文本 address）。\r
- 如排除公司名后**无其他地理位置**，返回 ""（下游会构造占位 `type=1` 空对象，禁止你输出任何编造地址）。\r
\r
【关键词提取规则（keywordList）】\r
- 优先识别"客户挖掘"语义片段（包含"找/开发/挖掘/拓展/寻找/获客/开拓/对接"等动词），仅从该片段提取核心名词。\r
- 若整段描述无客户挖掘语义（如纯品牌运营/内容生产指令），则从整段提取核心业务名词。\r
- 必须**排除**所有地理位置词（省、市、区、县、镇、国家、大洲、城市/地区名），它们不属于关键词。\r
- 必须**排除**已写入 employeeNumberRange* / storeNumberRange* / industryList 等其他字段的纯量词、人数、家数。\r
- 提取后为每个核心名词补全中文同义词与对应英文翻译，最终用英文逗号 `,` 拼接（如"眼镜店" → "眼镜店,optical shop,眼镜零售,eyewear store"）；同义词去重，禁止保留分隔符前后空格。\r
\r
【行业推断规则（industryList）】\r
- 根据 keywordList 的核心业务语义推断 1~3 个一级行业标签，用英文逗号 `,` 拼接（如：服装、数码、家居、餐饮、美妆、医疗、教育、汽车、建材、机械、化工、能源、金融、物流、农业、零售、家纺）。\r
- 不可纯凭地理位置/数量推断行业；若 keywordList 完全无法确定行业，返回 ""。\r
\r
规则如下（**键名/顺序不可改**）：{\r
"keywordList": "按【关键词提取规则】产出的英文逗号分隔字符串。例：眼镜店,optical shop,眼镜零售,eyewear store",\r
"continent": "按【国家 vs 七大洲互斥规则】产出。仅在描述只提到大洲、未提到任何国家时才填；提到国家则必须为 \"\"。例：亚洲",\r
"country": "明确提及的国家，多个用英文逗号分隔。例：中国,英国",\r
"countryCodeList": "对应国家的 ISO 3166-1 alpha-2 代码，顺序与 country 一一对应，多个用英文逗号分隔。例：CN,GB",\r
"addressObjList": "按【地址提取规则】产出的字符串：单个地址内用 `,` 拼接层级，多个不同地址用 `;` 分隔；非中国地址保留英文原文不拆层级；无地址时为 \"\"。例：浙江,宁波;London, UK",\r
"employeeNumberRangeStart": "按【数值区间通用规则】仅在描述明确包含 '员工X人以上/以下/左右/到/至' 时提取最小值；否则为 \"\"。",\r
"employeeNumberRangeEnd": "按【数值区间通用规则】仅在描述明确包含 '员工X人以上/以下/左右/到/至' 时提取最大值；否则为 \"\"。",\r
"storeNumberRangeStart": "按【数值区间通用规则】仅在描述明确包含 '门店X家以上/以下/左右/到/至' 或 'X家门店以上/以下/左右' 时提取最小值；否则为 \"\"。'找X家门店' 不属于此字段。",\r
"storeNumberRangeEnd": "按【数值区间通用规则】仅在描述明确包含 '门店X家以上/以下/左右/到/至' 或 'X家门店以上/以下/左右' 时提取最大值；否则为 \"\"。'找X家门店' 不属于此字段。",\r
"industryList": "按【行业推断规则】产出，多个用英文逗号分隔。例：服装,数码,家居"\r
}\r
```\r
\r
> 📌 **`addressObjList` 字段升级说明**：本版本约定多个地址使用英文分号 `;` 分隔多组，组内用英文逗号 `,` 分级。下游 AiWa 参数构建规则（见后文「AiWa 参数构建规则」中 `addressObjList` 一节）将该字符串先按 `;` 切多个原子地址，再对每个原子地址按"是否包含中文"决定 `type=1`（中文结构化）或 `type=0`（英文自由文本）；空字符串仍走占位对象。\r
\r
---\r
\r
### Step 3：构建并提交任务\r
\r
> 🧷 **下任务参数总规约（最高优先级，所有员工通用）**\r
>\r
> 提交任务时 `collaborationSubmitTaskParam` 对象**有且仅有以下 5 个根级键**，键名、类型、取值规则严格如下：\r
>\r
> ```ts\r
> {\r
> "taskName": String, // AI 总结出的任务名称（来自 Step 1 的 taskName，非空字符串）\r
> "currentModule": "content",// 字符串字面量，永远是 "content"（不分员工组合，无任何例外）\r
> "executionMode": Number, // 永远写数字 1（当前阶段一律按定额任务下达；后端枚举：周期性=0、定额=1）\r
> "employeeParams": Object, // 见下方规约\r
> "taskDescription": String // 用户最初下达的原始任务描述，原文透传，不要改写/精简/翻译\r
> }\r
> ```\r
>\r
> 同时与 `collaborationSubmitTaskParam` **同级**必须再带：\r
> - `completed`: `true`（布尔字面量）\r
> - `sourceSettings`: 见下方「员工组合 → sourceSettings 对照表」（含 Fran/Lisa 时为完整对象，否则为 `null`）\r
>\r
> **`employeeParams` 规约：**\r
> - 是一个对象，key 为参与员工的 PascalCase 名称（`AiWa` / `Frank` / `Fran` / `Lisa`），value 为该员工自己的参数对象。\r
> - **包含哪些员工**由 Step 1 解析出的 `taskDescription` + `employeeList` 共同决定：任务里识别出几个员工，`employeeParams` 就有几个对应的 key，**多一个、少一个、错一个都不允许**。\r
> - 例：任务里同时有 AiWa 和 Frank → `employeeParams: { "AiWa": {...}, "Frank": {...} }`，两个员工的参数都是各自独立的对象，不得混合到同一个对象里，也不得只挂一个员工的参数。\r
>\r
> **每个员工子对象内部参数清单（按员工查阅下文「{员工} 参数构建规则」与「{员工} 结构强约束」获取必填键、固定值、示例）：**\r
> - `AiWa`: `totalTarget` / `incrementalTarget` / `upperLimitTarget` / `keywordList` / `continent` / `country` / `countryCodeList` / `addressObjList` / `industryList`（外加可选范围字段 `employeeNumberRangeStart` / `employeeNumberRangeEnd` / `storeNumberRangeStart` / `storeNumberRangeEnd`，仅当 Step 2 提取到值时才放入）。\r
> - `Frank`: `incrementalTarget` / `upperLimitTarget` / `senderEmail` / `language` / `templateId` / `emailPlanList`（`emailPlanList` 元素含 `delayDay` / `emailSubject` / `emailText` / `loading`）。\r
> - `Fran`: `priority` / `scriptId` / `callingNumber` / `agentProfileId` / `minConcurrency` / `ringingDuration` / `incrementalTarget` / `upperLimitTarget`。\r
> - `Lisa`: `signName` / `templateCode` / `templateType` / `templateContent` / `incrementalTarget` / `upperLimitTarget` / `qualificationName` / `templateParamList`。\r
>\r
> **必须遵守的硬规则（违反任意一条，后端立即拒绝）：**\r
> 1. `currentModule` 永远等于字符串 `"content"`，禁止写 `"analysis"` / `"Content"` / `null` / 省略。\r
> 2. `executionMode` 永远等于数字 `1`，禁止写 `0` / `2` / `"1"` / `true` / `"定额任务"` / `"周期性任务"`。\r
> 3. `taskDescription` 透传用户原始指令文本，禁止改写为 AI 总结后的简短描述（那是 `taskName` 的活儿）。\r
> 4. `employeeParams` 子键必须是 PascalCase 原样（`AiWa` / `Frank` / `Fran` / `Lisa`），不得改成 `aiwa` / `aiwaParam` / `aiwaParams` 等任何变体。\r
> 5. Step 1/Step 2 的内部解析变量（`employeeList` / `language` / 根级 `totalTarget`）一律不得出现在最终请求体中——它们只能流到对应员工子对象内的指定字段。\r
>\r
> **下方各员工的"参数构建规则"、"结构强约束"、"请求体示例"是上述规约的展开细节，构建请求体时必须先按本规约确定整体形状，再按对应员工的小节填充值。**\r
\r
**接口：** `POST https://ai.deepsop.com/prod-api/ai/presetEmployee/submitTask`\r
\r
**请求头：**\r
```\r
Content-Type: application/json; charset=utf-8\r
x-api-key: $DEEPSOP_API_KEY\r
```\r
\r
> ⚠️ **强制规则：** 请求体根级必须包含 `"completed": true`（布尔字面量）。**严禁省略、写成 `null`、`"true"` 字符串或 `false`**，否则后端会直接返回 500。该字段与 `collaborationSubmitTaskParam` 同级，不在其内部。\r
\r
> 🔒 **强制使用 `submit_task.py` 提交，禁止直接 `curl`：**\r
>\r
> ```bash\r
> python3 scripts/submit_task.py \x3C\x3C'TASK_BODY_EOF'\r
> {\r
> "completed": true,\r
> "collaborationSubmitTaskParam": { ...完整请求体... }\r
> }\r
> TASK_BODY_EOF\r
> ```\r
>\r
> 原因：直接在 bash 命令行写 `curl -d '{"taskName":"家纺..."}'` 会触发 Windows ANSI 代码页（cp936）与 UTF-8 之间的转码歧义，导致 `taskName` / `taskDescription` 含中文时**间歇性提交为乱码**。`submit_task.py` 通过 stdin 字节流 + 显式 UTF-8 解码 + `Content-Type: application/json; charset=utf-8` 显式声明，**彻底闭合编码链路**，并内置两层 pre-flight 校验（`validate_employee_params.py` + `validate_sms_template_params.py`），校验未过自动阻塞 HTTP 提交。\r
>\r
> 行为约束：\r
> - **必须**通过 heredoc（`\x3C\x3C'TASK_BODY_EOF'` ... `TASK_BODY_EOF`）把请求体喂给 stdin；**禁止**用 argv 传 JSON（如 `python3 submit_task.py "$(echo {...})"`），argv 仍受 shell 编码影响。\r
> - heredoc 定界符**必须用单引号包裹**（`'TASK_BODY_EOF'` 而不是 `TASK_BODY_EOF`），否则 bash 会做变量展开，破坏 JSON 中的 `$` 字符。\r
> - 若运行时不支持 heredoc（极少见），退路：用 `python3 -c` 把 body 写到 UTF-8 文件，再 `python3 scripts/submit_task.py --file /tmp/task_body.json`。\r
> - 脚本输出单行 JSON：`{ok, stage, status, summary, response, body_preview, errors?}`；退出码 `0`=成功、`1`=校验失败、`2`=网络失败、`3`=服务端非 2xx、`4`=输入格式错误。\r
> - 退出码 ≠ 0 时，**必须**把 `summary` + `errors`/`response` 原样回复给用户，不得直接重试或假装成功。\r
\r
> ⛔ **字段名零改写规则（极高优先级，违反必返回 500）：**\r
> 后端通过精确字段名解析参数，**所有键名必须与本文档示例 JSON 中的拼写完全一致（大小写、连写、单复数都不能改）**。在生成请求体时：\r
>\r
> 1. **不得做大小写转换**：`scriptId` ≠ `scriptID` ≠ `ScriptId` ≠ `script_id`；`agentProfileId` ≠ `agentProfileID` ≠ `AgentProfileId`。\r
> 2. **不得做命名风格转换**：禁止把 camelCase 改成 snake_case 或 kebab-case。\r
> - ❌ `template_param_list` / `template-param-list` → ✅ `templateParamList`\r
> - ❌ `email_plan_list` → ✅ `emailPlanList`\r
> - ❌ `country_code_list` → ✅ `countryCodeList`\r
> - ❌ `address_obj_list` → ✅ `addressObjList`\r
> - ❌ `industry_list` / `keyword_list` → ✅ `industryList` / `keywordList`\r
> - ❌ `account_config_list` → ✅ `accountConfigList`\r
> - ❌ `publish_templates` → ✅ `publishTemplates`\r
> - ❌ `current_module` → ✅ `currentModule`\r
> - ❌ `execution_mode` → ✅ `executionMode`\r
> - ❌ `task_name` / `task_description` → ✅ `taskName` / `taskDescription`\r
> - ❌ `source_settings` / `employee_params` → ✅ `sourceSettings` / `employeeParams`\r
> - ❌ `total_target` / `incremental_target` / `upper_limit_target` → ✅ `totalTarget` / `incrementalTarget` / `upperLimitTarget`\r
> - ❌ `sender_email` → ✅ `senderEmail`\r
> - ❌ `calling_number` / `ringing_duration` / `min_concurrency` → ✅ `callingNumber` / `ringingDuration` / `minConcurrency`\r
> - ❌ `template_code` / `template_content` / `template_type` / `sign_name` / `qualification_name` → ✅ `templateCode` / `templateContent` / `templateType` / `signName` / `qualificationName`\r
> - ❌ `variable_label` / `variable_attribute` / `variable_value` → ✅ `variableLabel` / `variableAttribute` / `variableValue`\r
> - ❌ `method_type` / `image_url_list` / `first_image_url` / `last_image_url` / `keep_original_sound` / `generate_audio` / `enhance_prompt` / `negative_prompt` / `prompt_extend` / `shot_type` / `duration_switch` / `person_generation` / `resize_mode` → 全部保持 camelCase\r
> - ❌ `account_id` / `privacy_level` / `comment_disabled` / `duet_disabled` / `stitch_disabled` / `disable_comment` / `disable_duet` / `disable_stitch` / `is_public_account` / `brand_content_toggle` / `brand_organic_toggle` → 全部保持 camelCase\r
> - ❌ `release_type` / `time_zone` / `interval_type` / `start_time` / `publish_count` / `publish_interval` → 全部保持 camelCase\r
> - ❌ `delay_day` / `email_subject` / `email_text` → ✅ `delayDay` / `emailSubject` / `emailText`\r
> - ❌ `country_id` / `address_id` / `file_list` / `update_support` / `seas_group_ids` / `group_id` / `stage_id` / `label_id` / `address_file_list` / `suppur_ids` → 全部保持 camelCase（`groupId` / `stageId` / `labelId` / `seasGroupIds` / `fileList` / `updateSupport` / `addressId` / `countryId` / `addressFileList` / `suppurIds`）。**注意：`suppurIds` 不是 `supplierIds` / `customerIds`，保持原拼写不得"修正"。**\r
> - ❌ `staff_id` / `video_items` → ✅ `staffId` / `videoItems`\r
> 3. **不得做单复数改造**：复数字段必须保留 `List` / 复数后缀，单数字段不得加 `s`。\r
> - `emailPlanList` 不得写成 `emailPlans` / `emailPlan`\r
> - `callingNumber` 不得写成 `callingNumbers`\r
> - `publishTemplates` 不得写成 `publishTemplate` / `publishTemplateList`\r
> - `accountConfigList` 不得写成 `accountConfigs`\r
> - `templateParamList` 不得写成 `templateParams`\r
> 4. **不得做语义改名**：禁止用同义词替换字段名。\r
> - `agentProfileId` ≠ `agentId` / `chatbotId` / `profileId` / `botId`\r
> - `senderEmail` ≠ `fromEmail` / `mailFrom` / `email`\r
> - `callingNumber` ≠ `callerNumber` / `phone` / `outboundNumber`\r
> - `templateCode` ≠ `smsTemplateCode` / `code`\r
> - `signName` ≠ `signature` / `signatureName`（注意：模板列表返回的字段叫 `signatureName`，但**提交时的字段名必须是 `signName`**）\r
> - `qualificationName` ≠ `qualification` / `qualifications`\r
> - `taskName` / `taskDescription` ≠ `name` / `description` / `title`\r
> 5. **校验流程**：构建完请求体后，**必须把 JSON 字符串与本文档对应的示例 JSON 逐字段对位检查一遍**——示例里有的键，请求体必须有；示例里键名怎么拼，请求体就照样拼；任何一个键名拼错都视为构建失败，重新构建后再提交。\r
>\r
> 不允许"我觉得 snake_case 更规范所以转一下"或"复数加 s 更自然"这类自作主张。\r
\r
**参数构建规则：**\r
\r
**前置 A：Fran 号码池与场景库查询（当 employeeList 包含 Fran 时必须先执行）**\r
\r
**0. 检查外呼实例可用性**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/outBound/describeInstance`\r
\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
检查 `data.body.instance.maxConcurrentConversation`：\r
- 大于 0：继续执行步骤 1（查询号码池）\r
- 等于 0：**终止任务**，回复用户：\r
> ⚠️ 当前外呼账号并发数为 0，无法提交电话销售任务，请联系管理员开通并发资源后再试。\r
\r
**1. 查询号码池**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/outBound/callerNumber/list`\r
\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
返回示例：\r
```json\r
{\r
"total": 1,\r
"rows": [\r
{\r
"id": 7,\r
"callNumber": "30350903",\r
"nickName": "Kocgo"\r
}\r
],\r
"code": 200,\r
"msg": "查询成功"\r
}\r
```\r
\r
处理规则：\r
- `rows` 为空（`total=0`）：**终止任务**，回复用户：\r
> ⚠️ 当前账号下没有可用的外呼号码，无法提交电话销售任务，请联系管理员开通号码后再试。\r
- `rows` 只有 1 条：自动选用该 `callNumber`，无需用户确认。\r
- `rows` 有多条：列出所有号码供用户选择（支持多选），格式：\r
```\r
检测到多个可用外呼号码，请选择本次任务要使用的号码（可多选，用逗号分隔序号）：\r
1. {callNumber}（{nickName}）\r
2. {callNumber}（{nickName}）\r
...\r
```\r
**等待用户回复后**，解析出被选中的 `callNumber` 列表（数组形式），赋值给 `callingNumber`。未收到选择不得继续。\r
\r
**2. 查询场景库**\r
\r
> 🛑 **强制实时拉取规则（反幻觉硬约束，违反即视为 bug）：**\r
>\r
> 当 Fran 流程进入"号码池已选定 + 客户来源已确认（含 AiWa 协同 / xlsx / 公司搜索任一通道）"这一步，**必须**真实调用 `POST /ai/outBound/listScripts` 接口拿到当前账号下的场景库列表后，**用接口返回的真实 `scriptName / industry / scene / status` 渲染**给用户挑选。\r
>\r
> **绝对禁止**：\r
> - ❌ 不调接口、直接凭"上次记忆 / 训练语料 / 用户聊天里提过的关键词"编造一份候选场景列表（典型幻觉如：脑补出"家纺外贸开发场景 / 服装清仓促销场景"等并标记为 `PUBLISHED`）。\r
> - ❌ 在接口返回**全部非 PUBLISHED** 的情况下，自行把某条 `TO_BE_REVIEWED` / `REJECTED` / 草稿场景"美化"成 `PUBLISHED` 让用户选用 —— 即使 status 是 `TO_BE_REVIEWED`、`REVIEWING` 也**不得**当作可用项；用户若不想等审核中的场景，必须按"无可用场景"分支引导他走 [Step 1.7](#step-17电话场景创建审核子流程独立入口) **创建 + 审核 + 发布**完整流程，审核通过（变 `PUBLISHED`）后再继续下任务。\r
> - ❌ 把 Step 1.7 中刚拿到的 `scriptId` 用作"列表里的一项"伪装成接口返回。Step 1.7 出口走的是上文的"已选定场景"分支（直接复用 `scriptId / agentProfileId`，**跳过本步骤**），不要二次列表。\r
>\r
> 只有接口真的返回了 `status === "PUBLISHED"` 的条目，才允许进入下方"列出供用户选择"分支；否则一律走"无可用场景 → 引导创建/取消"分支。\r
\r
接口：`POST https://ai.deepsop.com/prod-api/ai/outBound/listScripts`\r
\r
请求头：\r
```\r
Content-Type: application/json\r
x-api-key: $DEEPSOP_API_KEY\r
```\r
\r
请求体：\r
```json\r
{"pageNumber": 1, "pageSize": 20, "scriptName": ""}\r
```\r
\r
返回结构（重点字段）：\r
- `data.body.scripts.list[]`：场景库列表\r
- `scriptId`：场景库 ID\r
- `scriptName`：场景库名称\r
- `industry` / `scene`：行业 / 场景\r
- `status`：状态，**必须为 `PUBLISHED` 才可用**\r
- `data.chatbotIdList[]`：与场景库配套的 chatbot id 列表，取第一个作为 `agentProfileId`\r
\r
处理规则：\r
- `list` 为空，或过滤后无 `status === "PUBLISHED"` 的场景：**不再立即终止**。改为向用户提供「即时创建」与「自行去后台创建」两个选项，格式：\r
```\r
⚠️ 当前账号下没有可用（已发布）的场景库。可以二选一：\r
1. 我现在引导您创建一个外呼场景（回复"创建"）— 含场景信息 + TTS 音色 + 机器人 prompt + 阿里云审核（约 1～5 分钟）\r
2. 前往 https://ai.deepsop.com 自行创建并发布场景后重试（回复"取消"）\r
```\r
- 用户回复"创建/我自己建/帮我建一个" → **暂存当前 Fran 流程上下文**，跳转到 [Step 1.7：电话场景创建/审核子流程](#step-17电话场景创建审核子流程独立入口)；待 Step 1.7 拿到 `scriptId / agentProfileId` 后**回到本步骤的"已选定场景"分支**，直接使用，**不再重查** `listScripts`。\r
- 用户回复"取消/不创建" → 按原文案终止任务。\r
- 用户多轮不明确回复（≥2 次） → 默认按"取消"终止任务，提示同上。\r
- 仅 1 条 `PUBLISHED` 场景：**不得自动选用**，必须列出并等待用户明确确认，格式：\r
```\r
检测到以下可用场景库，请确认是否使用（回复「确认」即可）：\r
1. {scriptName}（行业：{industry}，场景：{scene}）\r
```\r
**等待用户明确回复「确认」后**，取对应 `scriptId`。未收到确认不得继续。\r
- 多条 `PUBLISHED` 场景：列出供用户**单选**，格式：\r
```\r
请选择本次电话销售任务要使用的场景库（回复序号）：\r
1. {scriptName}（行业：{industry}，场景：{scene}）\r
2. ...\r
```\r
**等待用户回复后**，取对应 `scriptId`。未收到选择不得继续。\r
- `agentProfileId` 统一取 `data.chatbotIdList[0]`（若为空数组则终止并提示联系管理员）。\r
\r
**前置 B0：Frank 邮箱绑定检查（当 employeeList 包含 Frank 时必须先执行）**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/emailconfig/list?pageSize=1000&pageNum=1&status=1`\r
\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
检查 `rows` 列表：\r
- `rows` 不为空（至少 1 条）：继续执行前置 B（获取用户 Profile）\r
- `rows` 为空（`total=0`）：**终止任务**，回复用户：\r
> ⚠️ 当前账号未绑定可用邮箱，无法提交邮件销售任务，请先登录 https://ai.deepsop.com 前往「邮件配置」绑定邮箱后再试。\r
\r
**前置 B：获取用户 Profile（当 employeeList 包含 Frank 时必须先执行）**\r
\r
```bash\r
curl -s -H "x-api-key: $DEEPSOP_API_KEY" 'https://ai.deepsop.com/prod-api/ai/user/profile'\r
```\r
\r
提取以下字段用于邮件署名：\r
- `nickName`：发件人姓名\r
- `position`：职位（可能为空，直接取 profile 中的 `position` 字段）\r
- `dept.deptName`：公司名称\r
- `phonenumber`：电话（注意字段名全小写）\r
- `email`：邮箱（作为 `senderEmail`）\r
\r
**前置 C：AI 生成邮件内容（当 employeeList 包含 Frank 时必须先执行）**\r
\r
根据用户指令和 profile 信息，用 LLM 生成邮件主题和正文，严格返回 JSON 数组：\r
\r
```\r
生成对应语言【{language}】的内容，请直接输出纯净的JSON数组，不包含任何额外文本、代码标记、说明或包装。\r
输出示例：[{"emailSubject": "邮件主题", "emailText": "邮件内容"}]\r
\r
邮件生成规则：\r
1. 开头：使用标准问候语（中文："尊敬的先生/女士："）\r
2. 正文：根据【{taskDescription}】生成开发信，必须至少包含以下一项：\r
- 产品关键词：从 taskDescription 中提取\r
- 价值主张：包含「功能+场景+风格」三要素（如：【防风防水】男士户外工装夹克 春秋季通勤休闲外套）\r
- 痛点：具体描述需求未被满足的场景\r
- 解决方案：突出技术/设计优势与使用场景\r
- 行动呼吁：包含「稀缺性+权益+行动指令」（如：区域独家授权：仅开放3个地区代理名额！签约即享首单5%折扣→ 立即WhatsApp发送需求）\r
- 证明点：包含「原始痛点+解决方案+量化结果」的客户案例\r
- 服务吸引物：分点列出，覆盖供应链/物流/市场支持/售后/定制化5大类\r
3. 结尾：自然添加对应语言祝福语\r
4. 署名（每项另起一行，共4行）：\r
{nickName}（{position}）\r
{companyName}（若 nickName 与 companyName 相同则省略此行）\r
{phoneNumber}\r
{email}\r
5. 风格：专业、直接、有帮助且富有亲和力；避免使用「免费」「优惠」「限时」等推销词汇\r
6. 主题：简洁引人入胜，避免垃圾邮件词汇\r
7. 禁止出现 [Name] 等变量占位符\r
```\r
\r
生成结果提取 `emailSubject` 和 `emailText` 用于 Frank 参数。\r
\r
**前置 D：Lisa 短信模板查询与变量填写（当 employeeList 包含 Lisa 时必须先执行）**\r
\r
**1. 查询短信模板列表**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/sms/querySmsTemplateList?pageNum=1&pageSize=20&pageNumber=1`\r
\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
关键字段：\r
- `data.smsTemplateList[]`：模板列表\r
- `auditStatus`：必须为 `AUDIT_STATE_PASS` 才可用\r
- `templateCode`：模板编码\r
- `templateName`：模板名称\r
- `templateContent`：模板内容（含 `${xxx}` 占位符）\r
- `signatureName`：签名名称\r
- `templateType`：模板类型（0=通知, 1=推广, 2=验证码）\r
- `outerTemplateType`：提交时使用的模板类型参数\r
\r
处理规则：\r
- 过滤后无 `auditStatus === "AUDIT_STATE_PASS"` 的模板：**终止任务**，回复用户：\r
> ⚠️ 当前账号下没有已审核通过的短信模板，请先登录 https://ai.deepsop.com 创建并审核通过短信模板（状态需为 `AUDIT_STATE_PASS`）后再试。\r
- 仅 1 条 `AUDIT_STATE_PASS` 模板：**不得自动选用**，必须列出并等待用户明确确认，格式：\r
```\r
检测到以下可用短信模板，请确认是否使用（回复「确认」即可）：\r
1. {templateName}（类型：{templateType中文}）\r
内容：{templateContent}\r
```\r
**等待用户明确回复「确认」后**，取该模板。未收到确认不得继续。\r
- 多条 `AUDIT_STATE_PASS` 模板：列出供用户**单选**，格式：\r
```\r
请选择本次短信销售要使用的模板（回复序号）：\r
1. {templateName}（类型：{templateType中文}）\r
内容：{templateContent}\r
2. ...\r
```\r
\r
**2. 模板变量填写**\r
\r
选定模板后，解析 `templateContent` 中的 `${xxx}` 占位符，就每个变量告知用户并求其填写。如模板无变量，跳过此步。\r
\r
根据 `templateType` 匹配对应变量规则集并告知用户填写要求：\r
\r
| templateType | 模板类型 | 应用变量规则集 |\r
|---|---|---|\r
| 2 | 验证码短信 | verify（验证码类规则） |\r
| 0 | 通知短信 | notify（通知类规则） |\r
| 1 | 推广短信 | market（推广类规则） |\r
\r
**主要变量类型与校验规则：**\r
\r
| 变量类型名 | code | 适用范围 | 校验规则 |\r
|---|---|---|---|\r
| 仅数字（验证码） | numberCaptcha | verify | 纯数字4–6位 |\r
| 数字+字母组合或仅字母 | characterWithNumber2 | verify | 长度4–6位 |\r
| 验证码时间（1–2位数字） | verifyTime | verify | 1–99的整数 |\r
| 时间/日期 | time | notify/market | YYYY-MM-DD、hh:mm、上午/下午等标准时间格式 |\r
| 金额/数量 | money | notify/market | 纯数字或小数，不含单位符号 |\r
| 用户昵称 | user_nick | notify/market | 不超过20个字符，不含表情/QQ/微信号 |\r
| 个人姓名 | name | notify/market | 2–5个简体中文 |\r
| 企业/组织名称 | unit_name | notify | 仅中文，不超过20字符 |\r
| 地址 | address | notify | 不超过30字符，不含 QQ/微信号 |\r
| 车牌号 | license_plate_number | notify | 省份简称+字母+数字组合，不超过10字符 |\r
| 快递单号 | tracking_number | notify | 8–16位数字，或字母开头+数字字母 |\r
| 取件码 | pick_up_code | notify | 4–8位数字/短横线/下划线 |\r
| 其他号码 | other_number2 | notify | 不超过35字符字母数字组合 |\r
| 电话号码 | phone_number2 | notify | 3–12位纯数字，每模板最多2个号码变量 |\r
| 链接参数 | link_param | notify/market | 1–8位英文数字，不含完整链接/IP |\r
| 邮筱地址 | email_address | notify | 7–30字符，包含@ |\r
| 其他 | others | notify/market | 不超过35字符，不含 QQ/微信/手机/网址 |\r
\r
**变量匹配逻辑：**\r
1. 根据变量名（如 `conference`、`address`、`time`）在对应规则集中按变量类型名称匹配：\r
- `time`/`date`/`day`/`year`/`month` 类 → `time`\r
- `money`/`price`/`amount` 类 → `money`\r
- `phone`/`tel`/`mobile` 类 → `phone_number2`\r
- `address`/`addr`/`location` 类 → `address`\r
- `name`/姓名类 → `name`\r
- `user_nick`/昵称类 → `user_nick`\r
- `conference`/`unit`/组织类 → `unit_name`\r
- 其他 → `others`\r
2. 求用户为每个变量填写具体值。**必须**同时给出"✅ 正确示例"和"❌ 错误示例"，让用户一眼看到雷区。格式：\r
> 模板内容为：「{templateContent}」\r
> 包含以下变量需要填写（请严格按格式，否则短信会全部发送失败）：\r
> - `${conference}`：企业/组织名称（仅中文，不超过20字符）\r
> - ✅ 例：`库阔数字科技`\r
> - ❌ 例：`Kocgo Tech`（含英文）、`库阔数字科技股份有限公司（杭州）`（超长）\r
> - `${address}`：地址（不超过30字符）\r
> - ✅ 例：`杭州萧山万豪酒店三楼`\r
> - ❌ 例：`https://maps.example.com/...`（含网址）\r
> - `${time}`：时间（仅允许 `YYYY-MM-DD`、`hh:mm`、`上午/下午X点` 等标准格式）\r
> - ✅ 例：`2026-05-15 14:00`、`5月15日 下午2点`\r
> - ❌ 例：`2026年5月15日 14:00`（含中文"年月日"会被运营商网关拒绝）\r
> 请为每个变量填写具体内容。\r
3. 🔒 **强制变量校验（pre-flight gate，违反任意一条都不得继续）：**\r
\r
✅ **首选方式：调用本 SKILL 自带的校验脚本**（代码级校验，结果机器可读，比 LLM 自查可靠）：\r
\r
```bash\r
python3 scripts/validate_sms_template_params.py '\x3CtemplateParamList JSON 字符串>'\r
```\r
\r
- 入参：和最终请求体里的 `templateParamList` 同形状的 JSON 数组（仅含 `variableLabel` / `variableAttribute` / `variableValue` 三键）。\r
- stdout 输出单行 JSON：`{ok, summary, results: [{label, attribute, value, status, reason, suggestion?}]}`。\r
- 退出码：`0` 全 PASS、`1` 至少一项 FAIL、`2` 输入格式错误。\r
- 行为约束：\r
- 退出码 ≠ 0 时，**禁止**继续；必须把 `results` 中每条 FAIL 的 `reason` + `suggestion` 原样回复给用户，要求其重新填写后再次构建 `templateParamList` 并**重新调用本脚本**。\r
- 退出码 = 0 时才进入第 4 步。\r
- **不得**自己规整后跳过脚本（例如把 `2026年5月15日` 改成 `2026-05-15` 然后直接提交），必须让用户确认修改后的值再走一次校验。\r
\r
⚠️ **退路：脚本调用失败时（极少见，例如 python3 不可用）**，按下列规则人工逐个变量校验，规则与脚本完全一致：\r
\r
a. 按变量的 `variableAttribute`（即上一步匹配到的 `code`）查上方"主要变量类型与校验规则"表，取出"校验规则"列。\r
b. 用规则对值做逐字符校验，**必须**判定是 PASS 还是 FAIL。不得"差不多就算过"，不得"用户写得清楚就提交"。\r
c. **任意一个变量 FAIL** → 立即向用户回复不合规的变量、违反的具体规则、合法示例，并要求重新填写。**不得**：\r
- 调用提交任务接口（`agentSubmitTask`）\r
- 自己擅自规整格式（如把 `2026年5月15日` 改写成 `2026-05-15` 后偷偷提交——必须让用户确认）\r
- 把"用户写得很明确"作为跳过校验的理由\r
d. **全部 PASS** 才能进入第 4 步构建 `templateParamList` 并继续后续提交流程。\r
\r
**🚨 高频错误案例（已发生过真实事故，每次提交前必须自查）：**\r
\r
| 变量类型 | 用户实际填写 | AI 错误处理 | 后果 | 正确处理 |\r
|---|---|---|---|---|\r
| `time` | `2026年5月15日 14:00` | 直接提交 | 短信网关拒绝，13 条全部失败 | 提醒用户改成 `2026-05-15 14:00` 后再提交 |\r
| `unit_name` | `Kocgo Tech` | 直接提交 | 模板审核为"仅中文"被拒 | 提醒用户改成中文名称 |\r
| `phone_number2` | `+86 138-1234-5678` | 直接提交 | 含非数字字符被拒 | 提醒用户改成 `13812345678` |\r
\r
4. 校验通过后，构建 `templateParamList`：\r
```json\r
[\r
{"variableLabel": "conference", "variableAttribute": "unit_name", "variableValue": "用户填写的值"},\r
{"variableLabel": "address", "variableAttribute": "address", "variableValue": "用户填写的值"},\r
{"variableLabel": "time", "variableAttribute": "time", "variableValue": "用户填写的值"}\r
]\r
```\r
其中 `variableLabel` = 占位符名（不含 `${}`），`variableAttribute` = 匹配到的 code。\r
\r
**AiWa 参数构建规则：**\r
- `totalTarget`：定额模式下填 Step 1 的 totalTarget，周期模式下为 null\r
- `incrementalTarget`：必填，固定填 5000（不可为 null）\r
- `upperLimitTarget`：固定填 5000\r
- `keywordList`：Step 2 的 keywordList **必须用 `.split(",")` 拆分成数组**（绝不可保留为逗号字符串）\r
- `continent`：Step 2 的 continent，**无则填 `null`，不得填 `""`**\r
- `country`：Step 2 的 country，**无则填 `null`，不得填 `""`**\r
- `countryCodeList`：Step 2 的 countryCodeList **必须用 `.split(",")` 拆分成数组**，无则填 `[]`（**不得填 `""` 或 `null`**）\r
- `addressObjList`：根据 Step 2 的 `addressObjList` 字符串构建数组。**先按英文分号 `;` 切成多个原子地址**，再对每个原子地址按下面规则各自构造一个对象：\r
- **情况 1（整体为空字符串 `""`）**：Step 2 未识别到任何地址。必须填占位 `[{"type":1,"province":"","city":"","county":"","address":""}]`，**不得填 `[]`**。\r
- **情况 2（原子地址包含中文）**：判定为中文结构化地址，按英文逗号 `,` 切分得到层级数组（最多三段：省/市/县），不足三段后续位补 `""`。填 `type=1`、`address=""`：\r
- `"浙江,宁波"` → `{"type":1,"province":"浙江","city":"宁波","county":"","address":""}`\r
- `"浙江,宁波,鄞州区"` → `{"type":1,"province":"浙江","city":"宁波","county":"鄞州区","address":""}`\r
- `"上海"` → `{"type":1,"province":"上海","city":"","county":"","address":""}`\r
- **情况 3（原子地址不含中文 / 为英文自由文本）**：填 `type=0`、`province/city/county=""`、`address` 放原子原文：\r
- `"London, UK"` → `{"type":0,"province":"","city":"","county":"","address":"London, UK"}`\r
- **多个原子地址**：按 `;` 切完后，每个原子单独走情况 2 或情况 3，最终多对象并列在数组里：\r
- `"浙江,宁波;London, UK"` → `[{"type":1,"province":"浙江","city":"宁波","county":"","address":""},{"type":0,"province":"","city":"","county":"","address":"London, UK"}]`\r
- **`type` 取值语义**：`1` = 中文结构化拆分地址（仅填 `province/city/county`）；`0` = 自由文本地址（仅填 `address`）。**禁止两者同时填**（`type=1` 时 `address` 必须为 `""`；`type=0` 时 `province/city/county` 必须全为 `""`），违反 `validate_employee_params.py` 会以 `TYPE_ADDRESS_CONFLICT` 拦截。\r
- `industryList`：Step 2 的 industryList **必须用 `.split(",")` 拆分成数组**\r
\r
> ⛔ **AiWa 结构强约束（违反必返回 500 / 后端识别不到参数）：**\r
>\r
> 1. AiWa 子对象的 key 是 **`AiWa`**（**P**ascal**C**ase 三个字母原样），不是 `aiwa` / `Aiwa` / `aiWa` / `aiwaParam` / `aiWaParams`。\r
> 2. AiWa 子对象**必须**嵌在 `collaborationSubmitTaskParam.employeeParams.AiWa` 之下，**绝对禁止**直接挂到 `collaborationSubmitTaskParam.aiwaParam` / `collaborationSubmitTaskParam.AiWa` 这种少一层的位置。\r
> 3. **以下来自 Step 1/Step 2 的"内部解析变量"是给本 SKILL 内部流程用的，绝不允许出现在最终请求体的任何层级**：\r
> - `employeeList`（Step 1 用来分发员工，请求体只关心 `employeeParams` 里的子键）\r
> - `language`（仅在 `employeeParams.Frank` 子对象内部使用，禁止挂到根级或 AiWa 子对象内）\r
> - `totalTarget`（**只能**作为 `employeeParams.AiWa.totalTarget`，**不得**挂到 `collaborationSubmitTaskParam` 根级）\r
> 4. AiWa 必填的 9 个键：`totalTarget` / `incrementalTarget` / `upperLimitTarget` / `keywordList` / `continent` / `country` / `countryCodeList` / `addressObjList` / `industryList`，**一个都不能漏**。\r
> 5. `currentModule` 必须在 `collaborationSubmitTaskParam` 内，**值固定为 `"content"`**（任何员工组合下都不得写 `"analysis"`）。\r
\r
**AiWa 任务请求体示例（仅 AiWa 单独执行 — 直接对照拷贝，不要自由发挥）：**\r
\r
```json\r
{\r
"collaborationSubmitTaskParam": {\r
"taskName": "家纺客户挖掘",\r
"taskDescription": "帮我找10个做家纺的客户",\r
"executionMode": 1,\r
"employeeParams": {\r
"AiWa": {\r
"totalTarget": 10,\r
"incrementalTarget": 5000,\r
"upperLimitTarget": 5000,\r
"keywordList": ["家纺", "纺织", "床上用品", "毛巾", "窗帘", "home textile", "bedding"],\r
"continent": null,\r
"country": null,\r
"countryCodeList": [],\r
"addressObjList": [{"type": 1, "province": "", "city": "", "county": "", "address": ""}],\r
"industryList": ["家纺", "纺织"]\r
}\r
},\r
"sourceSettings": null,\r
"currentModule": "content"\r
},\r
"completed": true\r
}\r
```\r
\r
> 🚫 **错误示例（曾经真实出现过的错传，禁止再生成此种结构）：**\r
>\r
> ```json\r
> {\r
> "completed": true,\r
> "collaborationSubmitTaskParam": {\r
> "taskName": "家纺客户挖掘",\r
> "executionMode": 1,\r
> "totalTarget": 10, // ❌ 不应在根级\r
> "employeeList": "AiWa", // ❌ Step 1 内部变量，不应出现\r
> "language": "中文", // ❌ Step 1 内部变量，不应出现\r
> "aiwaParam": { // ❌ 应是 employeeParams.AiWa\r
> "keywordList": "家纺,纺织,床上用品,毛巾,窗帘", // ❌ 应是数组\r
> "industryList": "家纺,纺织", // ❌ 应是数组\r
> "continent": "", // ❌ 应是 null\r
> "country": "", // ❌ 应是 null\r
> "countryCodeList": "", // ❌ 应是 []\r
> "addressObjList": [] // ❌ 必须放占位对象\r
> }\r
> // ❌ 缺 employeeParams 包装层\r
> // ❌ 缺 incrementalTarget / upperLimitTarget\r
> // ❌ 缺 currentModule / sourceSettings\r
> }\r
> }\r
> ```\r
>\r
> 上面这个错例犯了 7 项错误，**任何一项都会让后端识别不到参数**。生成请求体前请把上面的"正确示例"拷过来再替换具体值，不要从头自由编写。\r
\r
**Frank 参数构建规则：**\r
- `incrementalTarget`：固定填 1000\r
- `upperLimitTarget`：固定填 1000\r
- `senderEmail`：来自 profile 的 `email`\r
- `language`：来自 Step 1 的 `language`（`"中文"` 或 `"英文"`）\r
- `templateId`：固定为 null\r
- `emailPlanList`：包含一个对象，字段：\r
- `delayDay`：0\r
- `emailSubject`：AI 生成的邮件主题\r
- `emailText`：AI 生成的邮件正文（HTML 格式）\r
- `loading`：0\r
\r
> ⛔ **Frank 结构强约束：**\r
> 1. 子对象 key 必须是 **`Frank`**（首字母大写），不是 `frank` / `FRANK` / `frankParam` / `frankParams`。\r
> 2. 必须嵌在 `collaborationSubmitTaskParam.employeeParams.Frank` 之下。\r
> 3. `language` **只能**作为 `employeeParams.Frank.language`，**不得**挂到根级或其他员工子对象。\r
> 4. `emailPlanList` 必须是**长度为 1 的数组**，元素是对象，且对象内 4 个键 `delayDay` / `emailSubject` / `emailText` / `loading` 一个都不能漏。**不得**写成 `emailPlan`（单数）或 `emailPlans`（错误复数）或直接把对象本身赋给 `emailPlanList`（少一层数组）。\r
> 5. `senderEmail` 必须是字符串，不得写成对象 `{email: "..."}`，也不得改名为 `email` / `fromEmail` / `mailFrom`。\r
> 6. 必填 6 个键：`incrementalTarget` / `upperLimitTarget` / `senderEmail` / `language` / `templateId` / `emailPlanList`，一个都不能漏。\r
\r
**Fran 参数构建规则：**\r
- `ringingDuration`：固定填 25\r
- `incrementalTarget`：固定填 1000\r
- `upperLimitTarget`：固定填 1000\r
- `minConcurrency`：固定填 1\r
- `priority`：固定填 `"Daily"`\r
- `callingNumber`：前置 A 第 1 步用户选定的号码**数组**（如 `["30350903"]`），**单号码也必须是数组形式**\r
- `scriptId`：前置 A 第 2 步用户选定的场景库 `scriptId`\r
- `agentProfileId`：前置 A 第 2 步 `data.chatbotIdList[0]`\r
\r
> ⛔ **Fran 结构强约束：**\r
> 1. 子对象 key 必须是 **`Fran`**（首字母大写、4 个字母原样），不是 `fran` / `FRAN` / `franParam` / `franParams`。\r
> 2. 必须嵌在 `collaborationSubmitTaskParam.employeeParams.Fran` 之下。\r
> 3. `callingNumber` **必须是数组**（`["30350903"]`），即使只有一个号码也不得写成裸字符串 `"30350903"`，也不得改名为 `callingNumbers` / `callerNumber` / `phone` / `outboundNumber`。\r
> 4. `scriptId` 与 `agentProfileId` 必须是 **接口返回的字符串原值**（保留原始大小写如 `"chatbot-cn-RYRmV3jjzb"`），不得自行拼接、改名、加引号包裹两次。`agentProfileId` ≠ `agentId` / `chatbotId` / `profileId`。\r
> 5. `priority` 是字符串 `"Daily"`（**首字母大写**），不是 `"daily"` / `"DAILY"` / 整数。\r
> 6. 必填 8 个键：`ringingDuration` / `incrementalTarget` / `upperLimitTarget` / `minConcurrency` / `priority` / `callingNumber` / `scriptId` / `agentProfileId`，一个都不能漏。\r
\r
**Fran 任务请求体示例（AiWa + Fran 联合任务）：**\r
```json\r
{\r
"collaborationSubmitTaskParam": {\r
"taskName": "启动财务课程电话销售",\r
"taskDescription": "帮我找客户并启动电话销售",\r
"executionMode": 1,\r
"employeeParams": {\r
"AiWa": { "...": "同上" },\r
"Fran": {\r
"ringingDuration": 25,\r
"incrementalTarget": 1000,\r
"upperLimitTarget": 1000,\r
"callingNumber": ["30350903"],\r
"minConcurrency": 1,\r
"priority": "Daily",\r
"scriptId": "c92d016f-03c8-47a3-95d9-61d75e192181",\r
"agentProfileId": "chatbot-cn-RYRmV3jjzb"\r
}\r
},\r
"sourceSettings": {\r
"groupId": [], "stageId": [], "labelId": [], "level": [],\r
"seasGroupIds": [], "addressId": [], "fileList": [],\r
"updateSupport": 1, "cascader": null, "aiMining": null,\r
"customerMining": null, "seasMining": null, "uploadMining": null,\r
"countryId": null, "addressMining": null\r
},\r
"currentModule": "content"\r
},\r
"completed": true\r
}\r
```\r
\r
> ⚠️ 当 `employeeList` **同时包含 `AiWa` 与 `Fran`/`Lisa`** 时，`sourceSettings` 必须按上述完整对象填充（不能为 `null`），且 `currentModule` 固定为 `"content"`。\r
>\r
> ⚠️ 若 `employeeList` 含 `Fran`/`Lisa` 但**不含 `AiWa`**，`sourceSettings` 改用 Step 1.6 产出的客户来源对象（结构是 `groupId / stageId / labelId / level / seasGroupIds / addressId / fileList / updateSupport / addressFileList / suppurIds`），**不要**沿用上面这份带 `cascader / aiMining / customerMining / seasMining / uploadMining / countryId / addressMining` 的旧版结构。\r
\r
**Lisa 参数构建规则：**\r
- `incrementalTarget`：固定填 100\r
- `upperLimitTarget`：固定填 100\r
- `signName`：选定模板的 `signatureName`（**接口返回字段叫 `signatureName`，但请求体提交时必须叫 `signName`，自行改名**）\r
- `qualificationName`：同 `signName`（如两者不同由用户确认）\r
- `templateCode`：选定模板的 `templateCode`\r
- `templateContent`：选定模板的 `templateContent`\r
- `templateType`：选定模板的 `outerTemplateType`（注意：值取自模板对象的 `outerTemplateType` 字段，但请求体的键名仍叫 `templateType`）\r
- `templateParamList`：前置 D 第 2 步构建的变量数组（无变量则为 `[]`）\r
\r
> ⛔ **Lisa 结构强约束：**\r
> 1. 子对象 key 必须是 **`Lisa`**（首字母大写、4 个字母原样），不是 `lisa` / `LISA` / `lisaParam` / `lisaParams`。\r
> 2. 必须嵌在 `collaborationSubmitTaskParam.employeeParams.Lisa` 之下。\r
> 3. `templateParamList` **必须是数组**，每个元素是含 **`variableLabel` / `variableAttribute` / `variableValue`** 三个键的对象。**禁止**改成键值映射形式（如 `{conference: "库阔科技", address: "杭州"}`）；**禁止**漏 `variableAttribute`（即使值与 `variableLabel` 同名也必须显式写出）。无变量时填 `[]`，**不要省略此键**。\r
> 4. `signName` ≠ `signatureName`（提交字段名）；`signName` 不得改名为 `signature` / `sign`。\r
> 5. `templateCode` 必须保留接口返回的原值（如 `"SMS_500460013"`），不得改名为 `code` / `smsTemplateCode`。\r
> 6. `templateType` 是数字（取自 `outerTemplateType`），不是字符串。\r
> 7. 必填 8 个键：`incrementalTarget` / `upperLimitTarget` / `signName` / `qualificationName` / `templateCode` / `templateContent` / `templateType` / `templateParamList`，一个都不能漏。\r
\r
**Lisa 任务请求体示例（AiWa + Lisa 联合任务）：**\r
```json\r
{\r
"collaborationSubmitTaskParam": {\r
"taskName": "双十一老客户短信推广",\r
"taskDescription": "帮我找客户并给老客户发短信",\r
"executionMode": 1,\r
"employeeParams": {\r
"AiWa": { "...": "同上" },\r
"Lisa": {\r
"incrementalTarget": 100,\r
"upperLimitTarget": 100,\r
"qualificationName": "杭州库阔数字科技",\r
"signName": "杭州库阔数字科技",\r
"templateCode": "SMS_500460013",\r
"templateParamList": [\r
{"variableLabel": "conference", "variableAttribute": "unit_name", "variableValue": "库阔科技"},\r
{"variableLabel": "address", "variableAttribute": "address", "variableValue": "杭州"},\r
{"variableLabel": "time", "variableAttribute": "time", "variableValue": "2026-04-20"}\r
],\r
"templateType": 1,\r
"templateContent": "温馨提醒：${conference}会议将在${address}地点，于${time}时间开始，请您准时参加。"\r
}\r
},\r
"sourceSettings": {\r
"groupId": [], "stageId": [], "labelId": [], "level": [],\r
"seasGroupIds": [], "addressId": [], "fileList": [],\r
"updateSupport": 1\r
},\r
"currentModule": "content"\r
},\r
"completed": true\r
}\r
```\r
\r
---\r
\r
**📋 员工组合 → `currentModule` / `sourceSettings` 对照表**\r
\r
构建请求体前，按本次任务实际包含的员工组合从下表查 `currentModule` 与 `sourceSettings` 的取值，**严禁自行推断**：\r
\r
> 🔒 **`currentModule` 全局固定为 `"content"`**：无论员工组合是哪种、是否含销售员工，`currentModule` 字段都是字符串字面量 `"content"`，**不得**写成 `"analysis"` / `"Content"` / `"CONTENT"` / `null` / 省略。\r
\r
| 员工组合 | `currentModule` | `sourceSettings` | 备注 |\r
|---|---|---|---|\r
| 仅 AiWa | `"content"` | `null` | 单纯客户挖掘 |\r
| AiWa + Frank | `"content"` | `null` | 挖客户 + 邮件销售 |\r
| AiWa + Fran | `"content"` | 完整 sourceSettings 对象（见 Fran 示例） | 挖客户 + 电话销售 |\r
| AiWa + Lisa | `"content"` | 完整 sourceSettings 对象（见 Lisa 示例） | 挖客户 + 短信销售 |\r
| AiWa + Frank + Fran | `"content"` | 完整 sourceSettings 对象 | 多通道销售 |\r
| AiWa + Frank + Lisa | `"content"` | 完整 sourceSettings 对象 | 多通道销售 |\r
| AiWa + Fran + Lisa | `"content"` | 完整 sourceSettings 对象 | 多通道销售 |\r
| AiWa + Frank + Fran + Lisa | `"content"` | 完整 sourceSettings 对象 | 全通道销售 |\r
| 仅 Frank（无 AiWa） | `"content"` | Step 1.6 产出的客户来源对象 | 仅邮件销售，客户来源由用户指定 |\r
| 仅 Fran（无 AiWa） | `"content"` | Step 1.6 产出的客户来源对象 | 仅电话销售，客户来源由用户指定 |\r
| 仅 Lisa（无 AiWa） | `"content"` | Step 1.6 产出的客户来源对象 | 仅短信销售，客户来源由用户指定 |\r
| Frank/Fran/Lisa 任意组合（无 AiWa） | `"content"` | Step 1.6 产出的客户来源对象 | 多通道销售但无 AiWa 协同 |\r
\r
> 🔍 **快速判定规则**：\r
> - `currentModule` 始终为 `"content"`（无任何例外分支）。\r
> - **含 AiWa**：含 `Fran` 或 `Lisa` → `sourceSettings` 为完整对象（含 `cascader` / `aiMining` 等键，见 Fran/Lisa 示例）；其他子组合 → `sourceSettings` 为 `null`。\r
> - **不含 AiWa 且含 `Frank`/`Fran`/`Lisa` 任一**：`sourceSettings` **必须**为 Step 1.6 产出的客户来源对象（含 `fileList` / `addressFileList` / `suppurIds` 等键，**不要**带 `cascader` / `aiMining` 等 AiWa 联合场景的旧键），且 `fileList` / `addressFileList` / `suppurIds` 三者至少一个非空。\r
> - **既不含 AiWa 也不含 `Frank`/`Fran`/`Lisa`**：`sourceSettings` 为 `null`。\r
\r
> 🚫 **组合场景常见错例：**\r
>\r
> 1. 仅 AiWa 任务把 `currentModule` 写成 `"analysis"`：错。**任何组合**都必须 `"content"`。\r
> 2. AiWa+Fran 联合任务把 `sourceSettings` 写成 `null`：错。含 Fran 必须填完整对象。\r
> 4. 多员工组合时把不同员工塞进同一个员工 key（如 `employeeParams.AiWaFrank: {...}`）：错。每个员工是 `employeeParams` 下独立的同级 key。\r
> 5. 多员工组合时漏掉某个员工的子对象（仅在 `employeeList` 字符串里出现，但 `employeeParams` 里没有对应键）：错。`employeeList` 里写了的员工，`employeeParams` 必须有对应子对象。\r
\r
---\r
\r
**⚠️ 提交前必须执行参数完整性校验（缺少任意一项禁止提交）**\r
\r
> 🔒 **第 0 步（前置硬闸）：字段名逐键对位检查**\r
> 把刚构建好的 `body` JSON 字符串和本文件对应员工的示例 JSON 并排放置，**逐键比对拼写**：\r
> 1. 示例里出现的每一个键名（含 `taskName`、`taskDescription`、`executionMode`、`employeeParams`、`sourceSettings`、`currentModule`、`completed`，以及各员工子对象内部的全部 key），在 body 中必须**原样存在**，不得改写大小写、不得改 snake_case、不得改单复数、不得换同义词。\r
> 2. 任何键名只要与示例不一致（哪怕只差一个字母大小写），立即停止提交，回头修正后再走本清单。\r
> 3. 这一步在所有员工字段值校验之前完成，因为字段名错了，值再对也没用。\r
\r
根据本次任务包含的员工，逐项对照以下清单检查构建好的请求体，确认每个字段都存在且有合法值：\r
\r
**根结构（必须）：**\r
- `collaborationSubmitTaskParam.taskName`：非空字符串\r
- `collaborationSubmitTaskParam.taskDescription`：非空字符串\r
- `collaborationSubmitTaskParam.executionMode`：**当前阶段一律硬编码为数字 `1`**（即使 Step 1 识别为周期性任务也写 1；不得写 `0` / `2` / `"1"` / `"定额任务"`）\r
- `collaborationSubmitTaskParam.employeeParams`：对象，包含至少一个员工\r
- `collaborationSubmitTaskParam.sourceSettings`：取值严格按上文「员工组合 → `currentModule` / `sourceSettings` 对照表」填（**不要在这里推断**）。快速规则：含 `Fran` 或 `Lisa` → 完整对象；不含 `Fran` 也不含 `Lisa` → `null`\r
- `collaborationSubmitTaskParam.currentModule`：**全局固定为字符串 `"content"`**，无任何例外（不得写 `"analysis"` / `"Content"` / `null`）\r
- `completed`：**必传**，布尔字面量 `true`，与 `collaborationSubmitTaskParam` 同级；不得为 `null`、缺省、字符串 `"true"` 或 `false`，否则接口返回 500\r
\r
**AiWa（当 employeeList 包含 AiWa 时）：**\r
- `totalTarget`：用户指定的目标数量（正整数）\r
- `incrementalTarget`：`5000`\r
- `upperLimitTarget`：`5000`\r
- `keywordList`：非空数组\r
- `continent`：字符串或 `null`\r
- `country`：字符串或 `null`\r
- `countryCodeList`：数组（可为空数组 `[]`）\r
- `addressObjList`：包含至少一个对象，每个对象含 `type`/`province`/`city`/`county`/`address` 五个字段\r
- `industryList`：非空数组\r
\r
**Frank（当 employeeList 包含 Frank 时）：**\r
- `incrementalTarget`：`1000`\r
- `upperLimitTarget`：`1000`\r
- `senderEmail`：来自 profile 的 email，非空字符串\r
- `language`：`"中文"` 或 `"英文"`\r
- `templateId`：`null`\r
- `emailPlanList`：包含一个对象，该对象必须含以下四个字段：\r
- `delayDay`：`0`\r
- `emailSubject`：AI 生成的主题，非空字符串\r
- `emailText`：AI 生成的正文 HTML，非空字符串\r
- `loading`：`0`\r
\r
**Fran（当 employeeList 包含 Fran 时）：**\r
- `ringingDuration`：`25`\r
- `incrementalTarget`：`1000`\r
- `upperLimitTarget`：`1000`\r
- `minConcurrency`：`1`\r
- `priority`：`"Daily"`\r
- `callingNumber`：非空数组，来自号码池选择\r
- `scriptId`：非空字符串，来自场景库选择\r
- `agentProfileId`：非空字符串，来自 `data.chatbotIdList[0]`\r
\r
**Lisa（当 employeeList 包含 Lisa 时）：**\r
- `incrementalTarget`：`100`\r
- `upperLimitTarget`：`100`\r
- `signName`：非空字符串，来自模板 `signatureName`\r
- `qualificationName`：非空字符串，与 `signName` 相同\r
- `templateCode`：非空字符串，来自模板 `templateCode`\r
- `templateContent`：非空字符串，来自模板 `templateContent`\r
- `templateType`：数字，来自模板 `outerTemplateType`\r
- `templateParamList`：数组（无变量时为 `[]`，不可缺少此字段）\r
\r
> ⚠️ **`sourceSettings` 与 `currentModule` 是根级字段，取值取决于本次任务的员工组合，请查阅上文「员工组合 → `currentModule` / `sourceSettings` 对照表」，请勿一律写成 `null`/`"analysis"`。**例如 `AiWa+Lisa` 时，`sourceSettings` 必须是完整对象、`currentModule` 为 `"content"`。\r
\r
**发现任何字段缺失或值不合法时，停止提交，先补全后再执行提交。**\r
\r
**🔒 强制提交：直接走 `scripts/submit_task.py`（一站式：校验 + UTF-8 安全 HTTP）**\r
\r
`submit_task.py` 已串联以下三件事，**LLM 只需调一次**即可完成"校验 + 提交"，不需要再单独调 `validate_employee_params.py` 或 `validate_sms_template_params.py`：\r
\r
1. 内部调用 `validate_employee_params.py`（结构 + 取值，覆盖 AiWa/Frank/Fran/Lisa 全员）\r
2. 含 Lisa 模板变量时，自动调用 `validate_sms_template_params.py` 做内容校验\r
3. 任一步校验失败立即退出（退出码 1），**不会**触发 HTTP 提交\r
4. 校验全过才以 `Content-Type: application/json; charset=utf-8` POST 到 `/ai/presetEmployee/submitTask`\r
\r
```bash\r
python3 scripts/submit_task.py \x3C\x3C'TASK_BODY_EOF'\r
{\r
"completed": true,\r
"collaborationSubmitTaskParam": { ...完整请求体... }\r
}\r
TASK_BODY_EOF\r
```\r
\r
**校验覆盖范围**（详见 `validate_employee_params.py` / `validate_sms_template_params.py` 源码）：\r
- Step 1/2 内部变量（`employeeList` / `language` / 根级 `totalTarget`）泄漏到根或 `collaborationSubmitTaskParam` 层\r
- 员工 key 大小写错（`aiwa` / `aiwaParam` / `franParam` 等都会被纠错为 PascalCase）\r
- `executionMode` 必须是数字 `1`（拦截 `"1"` / `true` / `"定额任务"` 等）\r
- `currentModule` 必须固定为 `"content"`；含 `Fran`/`Lisa` 时 `sourceSettings` 必须是完整对象\r
- 各员工必填键、固定值（如 AiWa.incrementalTarget=5000、Frank.upperLimitTarget=1000、Fran.priority="Daily"、Lisa.incrementalTarget=100）\r
- 数组类字段类型（`keywordList` / `industryList` / `countryCodeList` / `callingNumber` / `templateParamList` / `publishTemplates` / `accountConfigList`）\r
- AiWa.addressObjList 占位规则与 `type=0/1` 与 `address` / `province/city/county` 的互斥\r
- Frank.emailPlanList 长度恰为 1 与子键完整\r
- Lisa.templateParamList 数组结构 + 每项三键齐全 + 变量内容合规（如 `time` 类禁止含中文"年"）\r
\r
**行为约束：**\r
- **必须**用 heredoc + 单引号定界符（`\x3C\x3C'TASK_BODY_EOF'`），不能用 argv 传 JSON。\r
- 脚本输出单行 JSON（含 `summary` / `errors` / `body_preview` / `response`）。\r
- 退出码：`0` 提交成功 / `1` 校验失败 / `2` 网络失败 / `3` HTTP 非 2xx / `4` 输入格式错误或 API key 缺失。\r
- 退出码 ≠ 0 时，**必须**把 `summary`、`errors`/`response` 原样回给用户，按提示修正请求体再重跑；**不允许**跳过校验、不允许"我这次写得很标准"为由绕过。\r
\r
> ℹ️ 仅在排查时可先用 `python3 scripts/submit_task.py --dry-run \x3C\x3C'TASK_BODY_EOF' ...` 跑校验而不发 HTTP；正式提交禁止 `--dry-run`。\r
\r
**用户确认清单（以下各项必须已获得用户明确确认，缺一不可提交）：**\r
- Fran 参与时：✅ `callingNumber` 非空（多号码时用户已选择）\r
- Fran 参与时：✅ 用户已选择/确认场景库（`scriptId` 非空，且用户有明确回复确认）\r
- Lisa 参与时：✅ 用户已选择/确认短信模板（`templateCode` 非空，且用户有明确回复确认）\r
- Lisa 参与时（模板含变量）：✅ 已通过 `scripts/submit_task.py` 完成提交（脚本内部已串行跑过 `validate_employee_params.py` + `validate_sms_template_params.py`）；脚本退出码 ≠ 0 时禁止重试，必须把脚本返回的 `summary`/`errors` 原样回给用户、修正后再重跑。**禁止**绕过 `submit_task.py` 自己拼 curl。**特别注意 `time` 类变量**——值中**不得**出现中文"年"，脚本会直接拒绝\r
- Frank 参与时：✅ 用户 profile 已获取（`senderEmail` 非空），邮件内容已 AI 生成\r
\r
**若上述任一项未完成，禁止调用提交接口。**\r
\r
---\r
\r
**请求体示例（AiWa + Frank 联合任务）：**\r
```json\r
{\r
"collaborationSubmitTaskParam": {\r
"taskName": "找服装客户并发邮件",\r
"taskDescription": "帮我找10个做服装的客户并发邮件",\r
"executionMode": 1,\r
"employeeParams": {\r
"AiWa": {\r
"totalTarget": 10,\r
"incrementalTarget": 5000,\r
"upperLimitTarget": 5000,\r
"keywordList": ["服装", "clothing"],\r
"continent": null,\r
"country": null,\r
"countryCodeList": [],\r
"addressObjList": [{"type": 1, "province": "", "city": "", "county": "", "address": ""}],\r
"industryList": ["服装"]\r
},\r
"Frank": {\r
"incrementalTarget": 1000,\r
"upperLimitTarget": 1000,\r
"senderEmail": "{profile.email}",\r
"language": "中文",\r
"templateId": null,\r
"emailPlanList": [{\r
"delayDay": 0,\r
"emailSubject": "{AI生成的邮件主题}",\r
"emailText": "{AI生成的邮件正文HTML}",\r
"loading": 0\r
}]\r
}\r
},\r
"sourceSettings": null,\r
"currentModule": "content"\r
},\r
"completed": true\r
}\r
```\r
\r
**成功响应：**\r
```json\r
{\r
"msg": "操作成功",\r
"code": 200,\r
"data": {\r
"employeeList": [\r
{\r
"dagTaskId": "\x3CfrankDagTaskId>",\r
"nodeType": "FRANK",\r
"customerPoolId": 1065\r
},\r
{\r
"dagTaskId": "\x3CaiwaDagTaskId>",\r
"nodeType": "AIWA",\r
"customerPoolId": 1066\r
}\r
],\r
"taskId": "\x3CtaskId>"\r
}\r
}\r
```\r
\r
**响应字段提取规则：**\r
- `taskId`：取 `data.taskId`\r
- `aiwaDagTaskId`：遍历 `data.employeeList`，找到 `nodeType === "AIWA"` 的条目，取其 `dagTaskId`，用于 **AiWa** 客户查询；无则为 null\r
- `aiwaCustomerPoolId`：遍历 `data.employeeList`，找到 `nodeType === "AIWA"` 的条目，取其 `customerPoolId`，用于 **AiWa** 客户查询；无则为 null\r
- `frankDagTaskId`：遍历 `data.employeeList`，找到 `nodeType === "FRANK"` 的条目，取其 `dagTaskId`，用于 **Frank** 邮件查询；无则为 null\r
- `franDagTaskId`：遍历 `data.employeeList`，找到 `nodeType === "FRAN"` 的条目，取其 `dagTaskId`，用于 **Fran** 电话查询；无则为 null\r
- `franCustomerPoolId`：遍历 `data.employeeList`，找到 `nodeType === "FRAN"` 的条目，取其 `customerPoolId`，用于 **Fran** 电话统计/详情查询；无则为 null\r
- `lisaDagTaskId`：遍历 `data.employeeList`，找到 `nodeType === "LISA"` 的条目，取其 `dagTaskId`，用于 **Lisa** 短信查询；无则为 null\r
- `lisaCustomerPoolId`：遍历 `data.employeeList`，找到 `nodeType === "LISA"` 的条目，取其 `customerPoolId`，用于 **Lisa** 短信统计/详情查询；无则为 null\r
\r
> ⚠️ **`nodeType` 大写统一**：后端返回的 `nodeType` 是**全大写**（`AIWA` / `FRANK` / `FRAN` / `LISA`），不是 PascalCase 的 `AiWa` / `Frank` 。上面 4 条提取规则里的字符串只能是大写形式。如果某次调用发现某个员工总拿不到 `dagTaskId`，优先检查是不是这里的大写写错了。\r
\r
提交成功后，告知用户并询问等待时间：\r
> 任务已提交！任务名：{taskName}，目标数量：{totalTarget}，任务ID：{taskId}。\r
>\r
> 后台正在执行，**你希望多久后查询结果并推送给你？**（直接告诉我时间，例如「8分钟」「半小时」「20分钟后」，直接回复「好」或不填则默认8分钟）\r
\r
---\r
\r
### Step 3.5：解析用户指定的等待时间\r
\r
等待用户回复后，解析其意图为秒数：\r
\r
| 用户说 | 解析为秒数 |\r
|--------|----------|\r
| N分钟 / N分 | N × 60 |\r
| N小时 | N × 3600 |\r
| 半小时 | 1800 |\r
| 一刻钟 | 900 |\r
| 好 / 默认 / ok / 回车 / 不填 | 480（8分钟）|\r
| 无法识别 | 再询问一次，若仍无效则使用 480 |\r
\r
解析成功后，回复确认：\r
> 好的，将在 {用户指定时间描述}（约 {N} 分钟）后为你查询结果，请稍候 ☕\r
\r
---\r
\r
### Step 4：按用户指定时间设置自动查询\r
\r
根据 Step 3.5 解析出的秒数（变量：`waitSeconds`），使用 `cron` 工具设置一次性定时任务：\r
\r
```json\r
{\r
"action": "add",\r
"job": {\r
"name": "aiwa-query-{taskId前8位}",\r
"schedule": { "kind": "at", "at": "{当前时间 + waitSeconds 的ISO8601字符串，如2026-03-19T15:00:00+08:00}" },\r
"sessionTarget": "main",\r
"wakeMode": "now",\r
"payload": {\r
"kind": "systemEvent",\r
"text": "[DeepSOP-AutoQuery] 人机协作台定时结果推送，请立即跳转 Step 5 执行结果查询并主动推送，不要等待用户提问，不要执行 Step 1-4。taskId={taskId}，aiwaDagTaskId={aiwaDagTaskId}，aiwaCustomerPoolId={aiwaCustomerPoolId}，frankDagTaskId={frankDagTaskId}，franDagTaskId={franDagTaskId}，franCustomerPoolId={franCustomerPoolId}，lisaDagTaskId={lisaDagTaskId}，lisaCustomerPoolId={lisaCustomerPoolId}，任务名：{taskName}，目标数量：{totalTarget}，参与员工：{employeeList}，feishuChatId={feishuChatId}。【AiWa部分，仅当employeeList包含AiWa时执行】1. 调用 POST https://ai.deepsop.com/prod-api/ai/presetEmployee/getCustomerPoolDetail?pageNum=1&pageSize=10 查询结果，参数 {"taskId":"{aiwaDagTaskId}","customerPoolId":{aiwaCustomerPoolId},"startTime":null,"endTime":null}；2. 将完整响应JSON传给脚本生成xlsx：python3 ~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_customers.py '\x3CJSON>' '/tmp/aiwa_{aiwaDagTaskId前8位}.xlsx'；3. 执行 cp /tmp/aiwa_{aiwaDagTaskId前8位}.xlsx ~/.openclaw/workspace/aiwa_{aiwaDagTaskId前8位}.xlsx 并执行 openclaw message send --channel feishu --target {feishuChatId} --media ~/.openclaw/workspace/aiwa_{aiwaDagTaskId前8位}.xlsx --message 'AiWa 客户挖掘完成，共找到客户数据，详见附件' 将文件发送到飞书群；4. 同时在当前会话回复前5条客户摘要。【Frank部分，仅当employeeList包含Frank且frankDagTaskId不为null时执行】1. 调用 GET https://ai.deepsop.com/prod-api/ai/email/getTaskEmailCount?taskId={frankDagTaskId} 查询邮件统计（使用frankDagTaskId）；2. 调用 GET https://ai.deepsop.com/prod-api/ai/email/taskList?pageNum=1&pageSize=2000&taskId={frankDagTaskId} 查询邮件列表（使用frankDagTaskId）；3. 生成xlsx：python3 ~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_emails.py '\x3CJSON>' '/tmp/frank_{frankDagTaskId前8位}.xlsx'；4. 执行 cp /tmp/frank_{frankDagTaskId前8位}.xlsx ~/.openclaw/workspace/frank_{frankDagTaskId前8位}.xlsx 并执行 openclaw message send --channel feishu --target {feishuChatId} --media ~/.openclaw/workspace/frank_{frankDagTaskId前8位}.xlsx --message 'Frank 邮件发送完成，详见附件' 将文件发送到飞书群；5. 同时在当前会话回复邮件统计摘要和前5条详情。【Lisa部分，仅当employeeList包含Lisa且lisaCustomerPoolId不为null时执行】1. 调用 POST https://ai.deepsop.com/prod-api/ai/sms/getTaskSmsCount 查询短信统计，参数 {"taskId":"{taskId}","customerPoolId":{lisaCustomerPoolId}}；2. 调用 POST https://ai.deepsop.com/prod-api/ai/sms/getSmsResultList?pageNum=1&pageSize=10 查询短信列表，参数 {"taskId":"{taskId}","customerPoolId":{lisaCustomerPoolId},"success":null,"startTime":null,"endTime":null}；3. 生成xlsx：python3 ~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_sms.py '\x3CJSON>' '/tmp/lisa_{taskId前8位}.xlsx'；4. 发送文件并在当前会话展示短信统计摘要和前5条短信详情。"\r
},\r
"deleteAfterRun": true\r
}\r
}\r
```\r
\r
`schedule.at` = 当前时间 + `waitSeconds`，ISO8601 格式，含时区（如 `+08:00`）。\r
\r
cron 设置成功后，回复用户确认并进入等待状态：\r
> ✅ 定时任务已设置！将在 **{N} 分钟后**（{schedule.at}）自动查询结果并推送，请安心等候 ⏰\r
> 如需提前查询，可说「现在就查结果」，我会立即执行。\r
\r
> ⚠️ **等待期间处理规则**：\r
> - cron 设置完成到 [DeepSOP-AutoQuery] 到达之前，**不得主动执行 Step 5**。\r
> - 如果用户在等待期间间起其他话题，正常回应，但**不要提前查询结果**。\r
> - 如果用户说「现在就查结果」或「提前查」，立即执行 Step 5（此为唯一允许的提前触发方式）。\r
\r
---\r
\r
### Step 5：查询结果并返回给用户\r
\r
> � **触发锁定：Step 5 只允许在以下两种情况下执行，其他任何情况一律不执行：**\r
> 1. 收到含 `[DeepSOP-AutoQuery]` 标记的 systemEvent（cron 自动触发）\r
> 2. 用户在等待期间明确说「现在就查结果」或「提前查」\r
>\r
> 🚨 **强制执行规则：执行 Step 5 时，以下规则一条都不得违反：**\r
> 1. **立即开始执行，不得发出任何询问或确认语句（如「要开始查询了吗」「是否需要推送」）**\r
> 2. **必须完成全流程：调接口 → 生成 xlsx → 发送文件 → 文字摘要，缺任一不算完成**\r
> 3. **文件必须透过 `openclaw message send` 主动发送到对应 channel，不得只告知文件路径**\r
> 4. **发送完成后在当前会话回复结果摘要，让用户对当前分话框也能看到结果**\r
> 5. **每个参与员工的结果必须按顺序全部处理，不得跳过任一员工**\r
\r
根据 employeeList 包含的员工依次执行对应的 Step 5-A / 5-B / 5-C / 5-D / 5-E。\r
\r
---\r
\r
#### Step 5-A：AiWa 结果处理（仅当 employeeList 包含 AiWa）\r
\r
> ⚠️ AiWa 查询接口使用 `aiwaDagTaskId`（`nodeType=AIWA` 的 `dagTaskId`）+ `aiwaCustomerPoolId`（同条目的 `customerPoolId`）。\r
\r
**接口：** `POST https://ai.deepsop.com/prod-api/ai/presetEmployee/getCustomerPoolDetail?pageNum=1&pageSize=10`\r
\r
**请求头：** `Content-Type: application/json`、`x-api-key: $DEEPSOP_API_KEY`\r
\r
**请求体：**\r
```json\r
{"taskId": "{aiwaDagTaskId}", "customerPoolId": {aiwaCustomerPoolId}, "startTime": null, "endTime": null}\r
```\r
\r
**响应关键字段：**\r
- `total`：总条数\r
- `rows[]`：客户列表（根层）\r
- `personName` / `position`：联系人 / 职位\r
- `companyName`：公司名称\r
- `systemIndustryName`：标准化行业名称\r
- `phone` / `email`：电话 / 邮筱（多个用逗号分隔）\r
- `countryName`：国家（如 `中国/China`）\r
- `whatsapp` / `linkedin` / `facebook` 等社媒字段\r
- `url`：公司网址\r
\r
**情况一：有数据（rows 非空）**\r
\r
1. 将完整 API 响应 JSON 传给脚本生成 xlsx 文件：\r
\r
```bash\r
python3 ~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_customers.py '\x3C完整响应JSON>' '/tmp/aiwa_{aiwaDagTaskId前8位}.xlsx'\r
```\r
\r
2. 根据当前 channel 决定如何返回文件：\r
\r
**飞书（feishu）：** 必须执行，不得跳过\r
```bash\r
cp /tmp/aiwa_{aiwaDagTaskId前8位}.xlsx ~/.openclaw/workspace/aiwa_{aiwaDagTaskId前8位}.xlsx\r
openclaw message send --channel feishu --target {feishuChatId} --media ~/.openclaw/workspace/aiwa_{aiwaDagTaskId前8位}.xlsx --message 'AiWa 客户挖掘完成！任务「{taskName}」共找到 {total} 位客户，详情见附件。'\r
```\r
\r
**Telegram / WhatsApp：** 必须执行，不得跳过\r
```\r
openclaw message send --channel telegram --target {chat_id} --media ~/.openclaw/workspace/aiwa_{aiwaDagTaskId前8位}.xlsx --message 'AiWa 客户挖掘完成！任务「{taskName}」共找到 {total} 位客户，详情见附件。'\r
```\r
\r
**webchat 或其他不支持文件的 channel：**\r
> ✅ xlsx 文件已生成：`/tmp/aiwa_{aiwaDagTaskId前8位}.xlsx`，共 {total} 位客户。请从服务器下载该文件。\r
\r
3. 同时以文字形式展示前5条客户预览：\r
\r
```\r
序号. 👤 {personName}（{position}）\r
🏢 公司：{companyName}\r
🏭 行业：{systemIndustryName}\r
🌍 国家：{countryName}\r
📧 邮筱：{email}\r
📱 手机：{phone}\r
💬 WhatsApp：{whatsapp}\r
🔗 LinkedIn：{linkedin}\r
```\r
\r
社媒字段若为 null 则整行不显示。超过5条附上：`...共 {N} 位，完整数据见 xlsx 文件`\r
\r
**情况二：rows 为空或 code 非 200**\r
\r
> 已到查询时间，暂未获取到客户数据，任务可能仍在执行中。\r
> aiwaDagTaskId：{aiwaDagTaskId}，aiwaCustomerPoolId：{aiwaCustomerPoolId}\r
> 你可以告诉我「再查一次」，我会立即重新查询。\r
\r
---\r
\r
#### Step 5-C：Fran 结果处理（仅当 employeeList 包含 Fran 且 franDagTaskId 不为 null）\r
\r
> ⚠️ Fran 的两个查询接口均使用 `franDagTaskId`（来自 `data.employeeList` 中 `nodeType=Fran` 的 `dagTaskId`）+ `franCustomerPoolId`（同条目的 `customerPoolId`）。\r
\r
**第一步：查询电话任务统计**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/presetEmployee/collaborationTaskStatistics?taskId={franDagTaskId}&customerPoolId={franCustomerPoolId}`\r
\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
返回字段说明：\r
- `taskCallPhoneCount`：总呼叫数\r
- `taskSuccessCallPhoneCount`：总通话数（接通并成功完成的数量）\r
- `taskAnswerCount`：总回复数\r
\r
**第二步：查询电话任务详情列表**\r
\r
接口：`POST https://ai.deepsop.com/prod-api/ai/presetEmployee/collaborationCallResult?pageNum=1&pageSize=10`\r
\r
请求头：\r
```\r
Content-Type: application/json\r
x-api-key: $DEEPSOP_API_KEY\r
```\r
\r
请求体（默认拉全部呼叫，`status` 可根据需求切换）：\r
```json\r
{\r
"taskId": "{franDagTaskId}",\r
"customerPoolId": {franCustomerPoolId},\r
"status": "All",\r
"startTime": "",\r
"endTime": ""\r
}\r
```\r
\r
`status` 可选值：\r
- `All`：全部呼叫（默认，对应 `taskCallPhoneCount`）\r
- `Succeeded`：通话成功记录（对应 `taskSuccessCallPhoneCount`）\r
- `Answer`：有回复记录（对应 `taskAnswerCount`）\r
\r
响应关键字段：\r
- `rows[].jobStatus`：呼叫任务状态（如 `Succeeded`、`Failed`）\r
- `rows[].jobTaskStatus`：任务执行细分状态（如 `SucceededFinish`）\r
- `rows[].companyName` / `personName` / `phoneNumber` / `userName`：客户信息（可能为 null）\r
- `rows[].createTime` / `updateTime`：创建/更新时间\r
- `rows[].describeJobJson`：完整通话详情 JSON（字符串，需二次解析），关键内容在 `body.job.tasks[]`：\r
- `contact.contactName` / `phoneNumber`：联系人与号码\r
- `calledNumber` / `callingNumber`：被呼号 / 呼出号\r
- `duration` / `realRingingDuration`：通话时长毫秒 / 实际振铃秒\r
- `endReason`：挂断原因（如 `FINISHED`）\r
- `conversation[]`：对话明细（`speaker`=`Robot`/`Contact`，`script`=话术内容）\r
\r
**第三步：生成 xlsx 文件**\r
\r
```bash\r
curl 结果存 /tmp/fran_{franDagTaskId前8位}_raw.json\r
python3 ~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_calls.py "$(cat /tmp/fran_{franDagTaskId前8位}_raw.json)" '/tmp/fran_{franDagTaskId前8位}.xlsx'\r
```\r
\r
根据当前 channel 必须发送文件，不得跳过：\r
- **飞书**：必须执行 `cp /tmp/fran_{franDagTaskId前8位}.xlsx ~/.openclaw/workspace/fran_{franDagTaskId前8位}.xlsx`，再用 `openclaw message send --channel feishu --target {feishuChatId} --media ~/.openclaw/workspace/fran_{franDagTaskId前8位}.xlsx --message 'Fran 电话销售完成！任务「{taskName}」共呼叫 {taskCallPhoneCount} 人，详情见附件。'`\r
- **Telegram / WhatsApp**：必须执行，media 路径用 workspace 路径，message 同上\r
- **webchat**：输出文字摘要和文件路径 `/tmp/fran_{franDagTaskId前8位}.xlsx`\r
\r
**第四步：展示结果**\r
\r
先展示统计摘要：\r
```\r
☎️ Fran 电话销售任务结果 — {taskName}\r
\r
📊 呼叫统计：\r
📞 总呼叫数：{taskCallPhoneCount}\r
✅ 总通话数：{taskSuccessCallPhoneCount}\r
💬 总回复数：{taskAnswerCount}\r
```\r
\r
再展示列表中前 5 条呼叫详情（从 `rows[].describeJobJson` 解析）：\r
```\r
序号. 👤 {contactName}（{contactPhone}）\r
🔄 状态：{jobStatus} / {endReason}\r
⏱ 通话时长：{duration_s}s（振铃 {realRingingDuration}s）\r
📞 呼出号码：{callingNumber}\r
📝 对话摘要：取 conversation 中第一条 Robot 的 script 前80字\r
```\r
\r
超过 5 条附上：`...共 {total} 条通话记录，完整数据见 xlsx 文件`。\r
\r
**情况：统计接口全为 0 或列表为空**\r
\r
> Fran 电话任务数据暂未就绪，可能仍在拨号或已呼叫但未接通。\r
> franDagTaskId：{franDagTaskId}，franCustomerPoolId：{franCustomerPoolId}\r
> 你可以告诉我「再查Fran结果」，我会立即重新查询。\r
\r
---\r
\r
#### Step 5-D：Lisa 结果处理（仅当 employeeList 包含 Lisa 且 lisaDagTaskId 不为 null）\r
\r
> ⚠️ Lisa 的两个查询接口均使用 `lisaDagTaskId`（来自 `data.employeeList` 中 `nodeType=Lisa` 的 `dagTaskId`）+ `lisaCustomerPoolId`（同条目的 `customerPoolId`）。\r
\r
**第一步：查询短信任务统计**\r
\r
接口：`POST https://ai.deepsop.com/prod-api/ai/sms/getTaskSmsCount`\r
\r
请求头：`Content-Type: application/json`、`x-api-key: $DEEPSOP_API_KEY`\r
\r
请求体：\r
```json\r
{"taskId": "{lisaDagTaskId}", "customerPoolId": {lisaCustomerPoolId}}\r
```\r
\r
返回字段说明：\r
- `totalCount`：已发送短信数\r
- `successCount`：触达短信数（发送成功）\r
- `failCount`：失败短信数\r
\r
**第二步：查询短信详情列表**\r
\r
接口：`POST https://ai.deepsop.com/prod-api/ai/sms/getSmsResultList?pageNum=1&pageSize=10`\r
\r
请求头：\r
```\r
Content-Type: application/json\r
x-api-key: $DEEPSOP_API_KEY\r
```\r
\r
请求体：\r
```json\r
{"taskId": "{lisaDagTaskId}", "customerPoolId": {lisaCustomerPoolId}, "success": null, "startTime": null, "endTime": null}\r
```\r
\r
关键字段：\r
- `data.total`：总条数\r
- `data.rows[].phoneNumber`：手机号码\r
- `data.rows[].success`：1=发送成功，0=发送失败\r
- `data.rows[].errMsg`：状态描述（如「用户接收成功」）\r
- `data.rows[].errCode`：状态码（如 `DELIVERED`）\r
- `data.rows[].content`：实际发送的短信内容\r
- `data.rows[].smsSize`：短信条数\r
- `data.rows[].sendTime`：发送时间\r
- `data.rows[].reportTime`：回执时间\r
\r
**第三步：生成 xlsx 文件**\r
\r
```bash\r
curl 结果存 /tmp/lisa_{lisaDagTaskId前8位}_raw.json\r
python3 ~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_sms.py "$(cat /tmp/lisa_{lisaDagTaskId前8位}_raw.json)" '/tmp/lisa_{lisaDagTaskId前8位}.xlsx'\r
```\r
\r
根据当前 channel 必须发送文件，不得跳过：\r
- **飞书**：必须执行 `cp /tmp/lisa_{lisaDagTaskId前8位}.xlsx ~/.openclaw/workspace/lisa_{lisaDagTaskId前8位}.xlsx`，再用 `openclaw message send --channel feishu --target {feishuChatId} --media ~/.openclaw/workspace/lisa_{lisaDagTaskId前8位}.xlsx --message 'Lisa 短信发送完成！任务「{taskName}」共发送 {totalCount} 条，详情见附件。'`\r
- **Telegram / WhatsApp**：必须执行，media 路径用 workspace 路径，message 同上\r
- **webchat**：输出文字摘要和文件路径 `/tmp/lisa_{lisaDagTaskId前8位}.xlsx`\r
\r
**第四步：展示结果**\r
\r
先展示统计摘要：\r
```\r
📱 Lisa 短信销售任务结果 — {taskName}\r
\r
📊 发送统计：\r
📨 总发送：{totalCount} 条\r
✅ 触达成功：{successCount} 条\r
❌ 发送失败：{failCount} 条\r
```\r
\r
再展示列表中前 5 条短信详情：\r
```\r
序号. 📱 {phoneNumber}\r
🔄 状态：{success中文} / {errCode}\r
📝 内容：{content前60字}\r
📅 发送：{sendTime}（回执 {reportTime}）\r
```\r
\r
超过 5 条附上：`...共 {total} 条短信记录，完整数据见 xlsx 文件`。\r
\r
**情况：统计接口全为 0 或列表为空**\r
\r
> Lisa 短信任务数据暂未就绪，可能仍在发送中或等待运营商回执。\r
> lisaDagTaskId：{lisaDagTaskId}，lisaCustomerPoolId：{lisaCustomerPoolId}\r
> 你可以告诉我「再查Lisa结果」，我会立即重新查询。\r
\r
---\r
\r
#### Step 5-B：Frank 结果处理（仅当 employeeList 包含 Frank 且 frankDagTaskId 不为 null）\r
\r
> ⚠️ Frank 的两个查询接口均使用 `frankDagTaskId`（来自提交响应 `data.employeeList` 中 `nodeType=FRANK` 的 `dagTaskId`），**不是** `taskId`。\r
\r
**第一步：查询邮件统计**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/email/getTaskEmailCount?taskId={frankDagTaskId}`\r
\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
返回字段说明：\r
- `taskSendEmailCount`：任务发送邮件总数\r
- `taskSuccessEmailCount`：发送成功数量\r
- `taskOpenEmailCount`：已读数量\r
- `taskReceiveEmailCount`：收到回复数量\r
- `taskClickEmailCount`：点击链接数量\r
\r
**第二步：查询邮件列表**\r
\r
接口：`GET https://ai.deepsop.com/prod-api/ai/email/taskList?pageNum=1&pageSize=2000&taskId={frankDagTaskId}`\r
\r
请求头：`x-api-key: $DEEPSOP_API_KEY`\r
\r
关键字段：\r
- `rows[].recipientEmailAddress`：收件人邮箱\r
- `rows[].companyName`：公司名称\r
- `rows[].personName`：联系人姓名\r
- `rows[].position`：职位\r
- `rows[].emailSubject`：邮件主题\r
- `rows[].sendTime`：发送时间\r
- `rows[].emailStatus`：发送状态（0=未发送，1=发送失败，2=发送成功）\r
- `rows[].round`：轮次\r
\r
**第三步：生成 xlsx 文件**\r
\r
将邮件列表 JSON 传给脚本生成 xlsx：\r
```bash\r
curl 结果存 /tmp/frank_{frankDagTaskId前8位}_raw.json\r
python3 ~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_emails.py "$(cat /tmp/frank_{frankDagTaskId前8位}_raw.json)" '/tmp/frank_{frankDagTaskId前8位}.xlsx'\r
```\r
\r
根据当前 channel 必须发送文件，不得跳过：\r
- **飞书**：必须执行 `cp /tmp/frank_{frankDagTaskId前8位}.xlsx ~/.openclaw/workspace/frank_{frankDagTaskId前8位}.xlsx`，再用 `openclaw message send --channel feishu --target {feishuChatId} --media ~/.openclaw/workspace/frank_{frankDagTaskId前8位}.xlsx --message 'Frank 邮件发送完成！任务「{taskName}」共发送 {taskSendEmailCount} 封，详情见附件。'`\r
- **Telegram / WhatsApp**：必须执行，media 路径用 workspace 路径，message 同上\r
- **webchat**：输出文字摘要和文件路径 `/tmp/frank_{frankDagTaskId前8位}.xlsx`\r
\r
**第四步：展示结果**\r
\r
先展示统计摘要：\r
```\r
📧 Frank 邮件任务结果 — {taskName}\r
\r
📊 发送统计：\r
📤 总发送：{taskSendEmailCount} 封\r
✅ 发送成功：{taskSuccessEmailCount} 封（emailStatus=2）\r
❌ 发送失败：{taskSendEmailCount - taskSuccessEmailCount} 封（emailStatus=1）\r
👁 已读：{taskOpenEmailCount} 封\r
💬 收到回复：{taskReceiveEmailCount} 封\r
🔗 点击链接：{taskClickEmailCount} 封\r
```\r
\r
再展示前5条邮件发送详情：\r
```\r
序号. 📧 {emailSubject}\r
👤 收件人：{personName}（{position}）\r
🏢 公司：{companyName}\r
📮 邮箱：{recipientEmailAddress}\r
📅 发送时间：{sendTime}\r
状态：✅ 成功 / ❌ 失败\r
```\r
\r
超过5条附上：`...共 {total} 封，如需完整列表请告知`\r
\r
**情况：统计接口或列表接口返回非 200 / data 为空**\r
\r
> Frank 邮件任务数据暂未就绪，可能仍在发送中。\r
> 任务ID：{taskId}\r
> 你可以告诉我「再查Frank结果」，我会立即重新查询。\r
\r
\r
---\r
\r
## 实现方式\r
\r
- **AI 分析**：直接在当前对话中用 LLM 完成，分析时告知用户正在处理\r
- **HTTP 请求**：使用 `exec` 工具调用 `curl`\r
- **定时等待**：使用 `cron(action=add)` 设置 8 分钟后触发的 systemEvent\r
- **xlsx 生成**：使用 `exec` 调用 Python 脚本\r
\r
---\r
\r
## 依赖\r
\r
- Python 3（系统自带）\r
- openpyxl：`python3 -m pip install openpyxl --user --break-system-packages`\r
- AiWa 生成脚本：`~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_customers.py`\r
- Frank 生成脚本：`~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_emails.py`\r
- Fran 生成脚本：`~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_calls.py`\r
- Lisa 生成脚本：`~/.openclaw/workspace/skills/deepsop-humabot/scripts/format_sms.py`\r
\r
---\r
\r
## 错误处理\r
\r
- `DEEPSOP_API_KEY` 未设置：提示用户**需要 API Key 授权**才能使用本技能：\r
- **已有账号** → 前往 [https://ai.deepsop.com/login?source=3](https://ai.deepsop.com/login?source=3) 登录获取\r
- **没有账号** → 前往 [https://ai.deepsop.com/register?source=3](https://ai.deepsop.com/register?source=3) 注册获取\r
\r
登录后在控制台新建 API Key（`sk-` 开头），配置 `DEEPSOP_API_KEY` 环境变量后再重试\r
- POST 接口返回非 200：展示错误信息，提示检查参数或稍后重试\r
- AiWa GET 接口 data 为空：提示任务可能仍在执行，给出 taskId 供用户告知「再查一次」\r
- Frank 邮件统计/列表接口异常：提示邮件任务可能仍在发送中，给出 taskId 供用户告知「再查Frank结果」\r
- Frank / Fran / Lisa 单独出现（未与 AiWa 搭配）：终止任务，提示用户补充客户挖掘需求\r
- Fran 外呼实例并发数为 0：终止任务，提示用户联系管理员开通并发资源\r
- Fran 号码池为空：终止任务，提示用户联系管理员开通外呼号码\r
- Frank 邮箱未绑定：终止任务，提示用户登录 https://ai.deepsop.com 前往「邮件配置」绑定邮箱\r
- Fran 场景库为空或无 `PUBLISHED` 状态：终止任务，提示用户前往 https://ai.deepsop.com 创建并发布场景库\r
- Lisa 短信模板为空或无 `AUDIT_STATE_PASS` 状态：终止任务，提示用户前往 https://ai.deepsop.com 创建并提交审核短信模板\r
- Lisa 变量校验失败：明确告知用户不符合的具体规则并要求重新填写，不中断整个流程\r
- Lisa 统计/详情接口异常或计数全为 0：提示短信任务可能仍在发送中，给出 taskId 和 lisaCustomerPoolId 供用户告知「再查Lisa结果」\r
- Fran 统计/详情接口异常或计数全为 0：提示电话任务可能仍在拨号中，给出 taskId 和 franCustomerPoolId 供用户告知「再查Fran结果」\r
- Python 脚本执行失败：直接以文字列表格式返回客户数据，不中断流程\r
- 数字员工禁用（status=1）：终止任务，提示联系管理员启用该员工\r
- 数字员工使用天数耗尽（remainingDays≤0）：终止任务，提示前往 https://ai.deepsop.com 购买/续费\r
- 不支持的员工（Jack/Leo/Sophia/Alex）：终止任务，提示当前仅支持 AiWa、Frank、Fran、Lisa\r
- TikTok 视频生成与发布（Toby）：本技能不再支持，请改用 `deepsop-tiktokflow` 技能\r
- 网络请求失败：展示 curl 错误信息\r
Usage Guidance
Install only if you are comfortable giving this skill a DeepSOP API key and allowing it to submit sales tasks, create/read customer reports, and push detailed contact records to chat channels. Use it in a restricted workspace or channel, avoid shared group chats for sensitive customer data, and prefer aggregate-only reporting unless recipient-level details are truly needed.
Capability Tags
Capability Assessment
Purpose & Capability
The DeepSOP sales-assistant purpose is coherent with customer mining, email, phone, and SMS workflows, but those workflows inherently handle sensitive contact data and can trigger outbound sales actions and paid package purchase flows.
Instruction Scope
SKILL.md requires result files and record previews to be sent automatically after a timer, and tells the agent not to ask for confirmation before Step 5 delivery; this is high-impact and under-scoped for sensitive customer data.
Install Mechanism
The artifact is a skill with Markdown instructions and Python helper scripts; no installer, obfuscation, destructive setup, or package-install behavior was found. The README's self-audit claims understate file handling compared with the SKILL.md and formatter scripts.
Credentials
Use of DEEPSOP_API_KEY and DeepSOP API calls is expected, but the skill also writes detailed xlsx reports and pushes them through Feishu, Telegram, or WhatsApp channels, which expands exposure beyond the DeepSOP service.
Persistence & Privilege
The cron job is one-shot and deleteAfterRun is set, but it creates an automatic future action that queries results and sends attachments/messages without re-confirming the destination or data sensitivity at send time.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install deepsop-humabot-ai - After installation, invoke the skill by name or use
/deepsop-humabot-ai - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
deepsop v1.0.0
- 首次发布，提供人机协作台（deepsop-humabot）智能销售任务助手。
- 支持用户用自然语言提交销售/客户挖掘、邮件/电话/短信等多种任务，AI自动拆解参数并调用 deepsop 平台接口。
- 实现全流程自动提交任务、异步结果查询与推送、xlsx 报表生成及多角色协作分发。
- 严格要求所有 HTTP 调用匹配 API 路径清单，对接口路径和参数进行强约束校验，防止错误请求。
- 内置电话场景创建、审核、撤销与流程分流，支持根据用户输入自动切换。
- 需在环境中配置 DEEPSOP_API_KEY，详细使用规则及接口要求见 SKILL.md。
Metadata
Frequently Asked Questions
What is DeepSop工作台?
人机协作台技能。用户输入自然语言销售指令，AI自动分析拆解任务参数，调用 deepsop 平台接口提交任务，等待后查询结果并推送。触发场景：用户说「帮我找客户」「挖掘XXX行业客户」「找XXX个客户」「提交任务」等与客户挖掘、销售任务相关的指令；或用户说「创建电话场景」「新建外呼话术」「新建电话机器人」「提交场景... It is an AI Agent Skill for Claude Code / OpenClaw, with 28 downloads so far.
How do I install DeepSop工作台?
Run "/install deepsop-humabot-ai" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is DeepSop工作台 free?
Yes, DeepSop工作台 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does DeepSop工作台 support?
DeepSop工作台 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created DeepSop工作台?
It is built and maintained by kukuoAI (@kukuoai); the current version is v1.0.0.
More Skills