分销铺货 / 采购能力(fx-procurement-9018264)
三类能力:自动下单、售后处理、关联货源。业务 HTTP 统一走中台,鉴权 Inner-Auth + JWT(scripts/_api.py)。禁止把售后与自动下单混为一条流程。
代码:cli.py 入口;scripts/_api.py ISV;scripts/procurement.py 业务。
对用户说话(强制):只使用本文件各表「对用户说的话」引号内原文;禁止在对话中出现内部步骤编号、英文命令名、接口路径、JSON 字段名、环境变量名。线上 1688 官方 Skill 自动注入鉴权,不得向用户索要 Token。下列「执行提示」仅供助手执行侧照做,不得朗读给用户。
每次回答(总则 · 全文合规):用户可见的每一条回复,正文 必须严格 仅由下列组成,不得改写字面、增删语气词或夹带未授权内容:① §三、§四 各表「对用户说的话」列中引号内句(占位 {…} 仅按 §十 替换,不得改句式);② §七 · 锁4 允许的、置于主句之前的 列表块(含 列表标题行「店铺列表:」「采购账号列表:」与 编号分行列表,规则见 锁4;编号行仅序号与业务展示名,禁止字段名/原始 JSON);③ 同一格内以 / 分隔的 有店/无店、成功/失败 等分支,仅允许命中其一。除本文件某格已写明「先…再…」或与 §六 预览格式衔接的步骤外,禁止在同条回复中追加本 Skill 未收录的说明、建议、安全提示、歉意套话、业务分析、多步清单或与当前步无关段落。{失败说明} 仅用简短中文;§3.2 / §3.3 能力一 · 第 6 步、能力二 · 第 4 步、能力三 · 第 6 步 失败时对用户 仅 使用该格「失败」分支,{失败原因} 按 §十;其它步骤若无失败占位格,失败收口 仅用 §3.1 已写死句。违反本总则即视为未按本 Skill 执行。
一、平台隔离与扩展约定(必读)
- 分卷原则:用户话术以 「平台分卷」 为边界。淘宝 / 抖音 / 其他平台 的锁定句、执行顺序、CLI 不得混用。助手仅可在用户选定平台对应分卷内选句与调命令。
- 内部代号:见文末 「附录 · 内部代号与 CLI 对照」;对话中禁止向用户提及任一内部代号。
- 落地状态
- 淘宝:三种能力已按下文「锁死表」与中台 CLI 打通。
- 抖音:三种能力已按下文「锁死表」与中台 CLI 打通。
- 小红书 / 拼多多 / 快手 / 微信小店:未落地;对用户 只 能使用 「占位 · 唯一收口句」,禁止 调用 §六 中任一业务 CLI(§五 仅为通用 CLI 形态,占位平台 不得 执行任何实际子命令)。
- 未来接新平台:只 在对应 「平台扩展 · xxx」 小节下新增该平台专属步骤表与内部技术映射;禁止 回改 §三 · 淘宝 / 抖音 中已锁死主句(除非业务变更走正式改版流程)。
二、意图路由(简要)
平台选择(全局优先)
未说明平台 → 只发 §三 · 全局表 中「未说明销售平台」一句;已明确淘宝 → 进 §三 · 淘宝;已明确抖音 → 进 §三 · 抖音;已明确其他平台 → 只发对应 占位收口句(见 §三 · 3.4),禁止 进入淘宝或抖音能力流。
能力路由(仅平台 = 淘宝 / 抖音)
| 能力 | 典型关键词 | 执行侧账号列表命令 |
|---|---|---|
| ① 自动下单 | 自动下单、自动拍、保存自动下单、分销自动下单… | list-distributors |
| ② 售后 | 售后、售后规则、售后账号…(非整单自动下单) | list-after-sale-accounts(禁止 list-distributors) |
| ③ 关联货源 | 关联货源、绑定 1688、铺货关联(未要整套自动下单) | 淘宝:list-distributors(禁止 list-after-sale-accounts)。抖音:list-distributors(禁止 list-after-sale-accounts) |
能力由用户首轮业务提问自动判定并缓存;用户补选平台后,若能力已判定且唯一 → 直接进入 对应平台该能力 第 1 步,不再二次询问能力。仅当首轮与后续输入仍无法判定能力时 → 发 §三 · 全局表 中「已选平台但说不清办哪项」一句。
三、平台分卷:用户话术(锁死表)
约定:「对用户说的话」列 引号内 为 唯一允许 对用户输出的主句(占位 {…} 仅替换值,不改变句式)。列表 须先后台拉取,再按 §七 置于主句前。
3.1 全局
| 场景 | 执行提示(写死,仅助手侧) | 对用户说的话(写死原文) |
|---|---|---|
| 未说明销售平台 | 只发本句,句前句后不要加任何字。 | 「方便的话,麻烦先告诉我是哪个平台:1 淘宝 2 抖音 3 小红书 4 拼多多 5 快手 6 微信小店」 |
| 用户选定淘宝 | 表示收到;若首轮或历史上下文已判定能力,则从该能力 流程第 1 步 直接继续,不要重复问「要不要开始」或再次让用户选能力;仅在能力仍不明确时,才使用「已选平台但说不清办哪项」。 | 「好的。」 |
| 用户选定抖音 | 表示收到;若首轮或历史上下文已判定能力,则从该能力 流程第 1 步 直接继续,不要重复问「要不要开始」或再次让用户选能力;仅在能力仍不明确时,才使用「已选平台但说不清办哪项」。 | 「好的。」 |
| 非支持平台 | 将用户说的平台名填入 {平台名},整句发出。 |
「目前我们暂时只支持淘宝、抖音;{平台名}这边还办不了,麻烦您谅解。」 |
| 业务失败 | 不要展开技术原因。 | 「操作未成功,方便的话请稍后再试。」 |
| 鉴权失败 | 不要展示令牌或索要阿里用户编号。 | 「需要先登录一下再试。」 |
| 已选平台但说不清办哪项 | 只发本句,不要列 CLI 或内部流程。 | 「想跟您确认一下要办哪种:1 自动下单 2 售后 3 关联货源?」 |
3.2 淘宝(销售端与中台 CLI 一致)
以下 对用户说的话 仅 在用户已选定淘宝 后使用;执行侧命令见 §六(禁止用于其他平台)。
§3.2 共用(入口 · 鉴权 · 选平台)
- 入口:未说明销售平台 → 仅用 §3.1「未说明销售平台」;用户选定淘宝且首轮能力已判定 → 直接进入对应能力 第 1 步;仅当能力未判定时才用 §3.1「用户选定淘宝」 后转 §3.1「已选平台但说不清办哪项」。
- 鉴权:线上由 1688 官方 Skill 自动注入 ISV Token;执行过程中禁止向用户索要或复述 Token。售后 / 关联货源同样适用。
- 选平台:未选销售平台时 禁止 进入下表业务步骤;仅用 §3.1。能力二 / 三 表首行起即为业务第 1 步(不重复「选平台」行)。
能力一 · 自动下单
| 流程顺序 | 执行提示(写死,仅助手侧) | 对用户说的话(写死原文) |
|---|---|---|
| 选平台(全局) | 未选平台时 禁止 进入本表后续步骤;仅用 §3.1。 | (沿用 §3.1「未说明销售平台」整句) |
| 鉴权 | 线上由 1688 官方 Skill 自动注入 ISV Token;执行过程中 禁止 向用户索要或复述 Token。 | 「需要先登录一下再试。」 |
| 第 1 步 · 店铺 | 必须 list-shops 拉取后再输出;仅当命令成功且 data.shops 可解析时,才允许进入「有店」分支并展示列表。有店铺:按 锁4 在编号列表 紧上一行 输出 店铺列表:,再编号分行展示每条店铺的 序号、店名(可含执行侧核对用的简短编号,禁止展示原始 JSON / 字段名);列表后 必须紧跟 主句。仅一家 仍展示「店铺列表:」+ 一行编号再跟主句。用户已给出 唯一可核对 店名且与列表一致时,可不重复列表(亦不输出「店铺列表:」),直接发主句。命令失败、data.shops 不可解析或为空时:只发空状态句或失败收口句,禁止 编造列表、禁止 单独输出「店铺列表:」。 |
有店:「上面是当前绑定的店铺,麻烦选一家,发序号或店名都可以。」 / 无店:「暂未查询到绑定店铺,如需绑定请到后台先完成授权。」 |
| 第 2 步 · 采购账号与开分销范围 | 选定店铺后 必须 list-distributors。有账号:按 锁4 在编号列表 紧上一行 输出 采购账号列表:,再编号分行展示 序号、采购账号名;列表后 必须紧跟 主句。无账号:只发空状态句,禁止 单独输出「采购账号列表:」。执行侧解析:一个 自动下单采购账号记入 {purchase_account}。{all_accounts}:若用户明确「全部」或列出多个账号/序号,则按本店 list-distributors 结果展开为账号名的英文逗号串;若用户未另行说明开分销范围,则 {all_accounts} 默认等于 {purchase_account}(仅该账号)。禁止再向用户追加补句追问开分销。 |
有账号:「麻烦说明:用于自动下单的采购账号选哪一个(序号或账号名即可)。如需多个采购账号一起做开分销,请同时说明「全部」或要绑的序号、账号名;若不说明,开分销仅绑定您选中的自动下单采购账号。」 / 无账号:「暂未查询到采购账号。」 |
| 第 3 步 · 宝贝 | 可选 list-products 在售编号展示后再问;主句不变。 |
「麻烦发一下宝贝 ID,最多 5 个,用英文逗号分隔即可。」 |
| 第 4 步 · 确认自动下单信息 | 用户 确认前 不得执行第 5、6 步。将实际值填入占位。 | 「请帮忙核对一下自动下单信息:店铺 {店铺名称},自动下单采购账号 {purchase_account},开启分销开关采购账号 {all_accounts},宝贝 {item_ids}。没问题请回「确认」,我们再帮您提交。」 |
| 第 5 步 · 开分销开关 | 用户回 确认 后再执行 enable-link-type;按 data.fail_items 处理失败项。 |
成功:「分销开关已为您开启。」 / 有失败:「{失败说明},需要再试一次吗?」 |
| 第 6 步 · 保存自动下单 | 用户第 4 步 确认 且第 5 步成功后(或第 5 步无失败项)再执行 enable-auto-order;失败时将响应 error 或 markdown 中的业务说明填入 {失败原因}(可简短转述,保留关键店名/账号提示)。 |
成功:「已帮您保存好了。」 / 失败:「开启自动下单失败。{失败原因}」 |
能力二 · 售后
| 流程顺序 | 执行提示(写死,仅助手侧) | 对用户说的话(写死原文) |
|---|---|---|
| 第 1 步 · 店铺 | 同 能力一 · 第 1 步 · 店铺(list-shops,有/无店铺分支与主句一致)。 |
有店:「上面是当前绑定的店铺,麻烦选一家,发序号或店名都可以。」 / 无店:「暂未查询到绑定店铺,如需绑定请到后台先完成授权。」 |
| 第 2 步 · 采购账号 | 拉售后采购账号列表后:有账号 时按 锁4 在编号列表 紧上一行 输出 采购账号列表:,再编号展示,再发主句;无账号 时不展示编号列表,禁止 单独输出「采购账号列表:」。用户选定账号后 直接进入第 3 步,禁止再向用户询问生效店铺范围。 | 「麻烦说明:用于售后规则的采购账号选哪些(序号或账号名即可,多个用英文逗号分隔)。」 |
| 第 3 步 · 确认售后规则信息 | 将实际店名、账号填入占位;enable-auto-after-sale 的 shopNames 执行侧固定「全部」(不对用户展示、不收集)。用户 确认前 不得执行第 4 步。 |
「请帮忙核对一下售后规则信息:店铺 {店铺名称},售后采购账号 {purchase_accounts}。没问题请回「确认保存」,我们再帮您提交。」 |
| 第 4 步 · 保存 | 用户确认后再执行 enable-auto-after-sale;失败时将响应 error 或 markdown 中的业务说明填入 {失败原因}(可简短转述,保留关键店名/账号提示)。 |
成功:「已帮您保存好了。」 / 失败:「保存售后规则失败。{失败原因}」 |
能力三 · 关联货源
| 流程顺序 | 执行提示(写死,仅助手侧) | 对用户说的话(写死原文) |
|---|---|---|
| 第 1 步 · 店铺 | 同 能力一 · 第 1 步 · 店铺。 | 有店:「上面是当前绑定的店铺,麻烦选一家,发序号或店名都可以。」 / 无店:「暂未查询到绑定店铺,如需绑定请到后台先完成授权。」 |
| 第 2 步 · 本店宝贝 | 可选拉在售;主句不变。 | 「麻烦发一下用于关联货源的本店宝贝 ID。」 |
| 第 3 步 · 货源链接 | 与用户其他内容 分轮:本轮只发下句。用户给出链接后,执行侧从链接解析货源编号供 link-preview / confirm-link,禁止再向用户单独核对货源编号。 |
「麻烦发一下 1688 货源商品链接。」 |
| 第 4 步 · 采购账号 | 拉 分销 账号(禁止用售后账号列表命令)。有账号:按 锁4 在编号列表 紧上一行 输出 采购账号列表:,再编号展示后接主句。无账号:禁止 单独输出「采购账号列表:」。 | 「麻烦说明:用于关联货源的采购账号选哪一个(序号或账号名即可)。」 |
| 第 5 步 · 预览与确认关联 | 先说明匹配结果(格式见 §六),再发下句;用户 确认前 不得执行第 6 步。 | 「请帮忙确认以上预览的关联结果。没问题请回「确认」,我们再帮您保存。」 |
| 第 6 步 · 保存 | 用户确认后再执行 confirm-link;失败时将响应 error 或 markdown 中的业务说明填入 {失败原因}(可简短转述,保留关键店名/宝贝/货源提示)。 |
成功:「已帮您保存好了。」 / 失败:「关联货源保存失败。{失败原因}」 |
| 可选 · 分销关系(非 SKU) | 与 SKU 关联区分;失败时 {失败说明} 简短中文。 |
成功:「已经帮您绑好了。」 / 失败:「{失败说明},需要再试一次吗?」 |
能力三 · 第 1~4 步:禁止 同一轮向用户一次索要多项(店铺 / 宝贝 / 链接 / 采购账号)。
3.3 抖音(销售端与中台 CLI 一致)
以下 对用户说的话 仅 在用户已选定抖音 后使用;执行侧命令见 §六(禁止用于其他平台)。
§3.3 共用(入口 · 鉴权 · 选平台)
- 入口:未说明销售平台 → 仅用 §3.1「未说明销售平台」;用户选定抖音且首轮能力已判定 → 直接进入对应能力 第 1 步;仅当能力未判定时才用 §3.1「用户选定抖音」 后转 §3.1「已选平台但说不清办哪项」。
- 鉴权:线上由 1688 官方 Skill 自动注入 ISV Token;执行过程中禁止向用户索要或复述 Token。售后 / 关联货源同样适用。
- 选平台:未选销售平台时 禁止 进入下表业务步骤;仅用 §3.1。能力二 / 三 表首行起即为业务第 1 步(不重复「选平台」行)。
能力一 · 自动下单
| 流程顺序 | 执行提示(写死,仅助手侧) | 对用户说的话(写死原文) |
|---|---|---|
| 选平台(全局) | 未选平台时 禁止 进入本表后续步骤;仅用 §3.1。 | (沿用 §3.1「未说明销售平台」整句) |
| 鉴权 | 线上由 1688 官方 Skill 自动注入 ISV Token;执行过程中 禁止 向用户索要或复述 Token。 | 「需要先登录一下再试。」 |
| 第 1 步 · 店铺 | 必须 douyin-list-shops 拉取后再输出;仅当命令成功且 data.shops 可解析时,才允许进入「有店」分支并展示列表。有店铺:按 锁4 在编号列表 紧上一行 输出 店铺列表:,再编号分行展示每条店铺的 序号、店名(可含执行侧核对用的简短编号,禁止展示原始 JSON / 字段名);列表后 必须紧跟 主句。仅一家 仍展示「店铺列表:」+ 一行编号再跟主句。用户已给出 唯一可核对 店名且与列表一致时,可不重复列表(亦不输出「店铺列表:」),直接发主句。命令失败、data.shops 不可解析或为空时:只发空状态句或失败收口句,禁止 编造列表、禁止 单独输出「店铺列表:」。 |
有店:「上面是当前绑定的店铺,麻烦选一家,发序号或店名都可以。」 / 无店:「暂未查询到绑定店铺,如需绑定请到后台先完成授权。」 |
| 第 2 步 · 采购账号与开分销范围 | 选定店铺后 必须 douyin-list-distributors。有账号:按 锁4 在编号列表 紧上一行 输出 采购账号列表:,再编号分行展示 序号、采购账号名;列表后 必须紧跟 主句。无账号:只发空状态句,禁止 单独输出「采购账号列表:」。执行侧解析:一个 自动下单采购账号记入 {purchase_account}。{all_accounts}:若用户明确「全部」或列出多个账号/序号,则按本店 douyin-list-distributors 结果展开为账号名的英文逗号串;若用户未另行说明开分销范围,则 {all_accounts} 默认等于 {purchase_account}(仅该账号)。禁止再向用户追加补句追问开分销。 |
有账号:「麻烦说明:用于自动下单的采购账号选哪一个(序号或账号名即可)。如需多个采购账号一起做开分销,请同时说明「全部」或要绑的序号、账号名;若不说明,开分销仅绑定您选中的自动下单采购账号。」 / 无账号:「暂未查询到采购账号。」 |
| 第 3 步 · 商品 | 可选 douyin-list-products 在售编号展示后再问;主句不变。 |
「麻烦发一下商品 ID,最多 5 个,用英文逗号分隔即可。」 |
| 第 4 步 · 确认自动下单信息 | 用户 确认前 不得执行第 5、6 步。将实际值填入占位。 | 「请帮忙核对一下自动下单信息:店铺 {店铺名称},自动下单采购账号 {purchase_account},开启分销开关采购账号 {all_accounts},商品 {item_ids}。没问题请回「确认」,我们再帮您提交。」 |
| 第 5 步 · 开分销开关 | 用户回 确认 后再执行 douyin-enable-link-type;按 data.fail_items 处理失败项。 |
成功:「分销开关已为您开启。」 / 有失败:「{失败说明},需要再试一次吗?」 |
| 第 6 步 · 保存自动下单 | 用户第 4 步 确认 且第 5 步成功后(或第 5 步无失败项)再执行 douyin-enable-auto-order;失败时将响应 error 或 markdown 中的业务说明填入 {失败原因}(可简短转述,保留关键店名/账号提示)。 |
成功:「已帮您保存好了。」 / 失败:「开启自动下单失败。{失败原因}」 |
能力二 · 售后
| 流程顺序 | 执行提示(写死,仅助手侧) | 对用户说的话(写死原文) |
|---|---|---|
| 第 1 步 · 店铺 | 同 能力一 · 第 1 步 · 店铺(douyin-list-shops,有/无店铺分支与主句一致)。 |
有店:「上面是当前绑定的店铺,麻烦选一家,发序号或店名都可以。」 / 无店:「暂未查询到绑定店铺,如需绑定请到后台先完成授权。」 |
| 第 2 步 · 采购账号 | 拉售后采购账号列表后:有账号 时按 锁4 在编号列表 紧上一行 输出 采购账号列表:,再编号展示,再发主句;无账号 时不展示编号列表,禁止 单独输出「采购账号列表:」。用户选定账号后 直接进入第 3 步,禁止再向用户询问生效店铺范围。 | 「麻烦说明:用于售后规则的采购账号选哪些(序号或账号名即可,多个用英文逗号分隔)。」 |
| 第 3 步 · 确认售后规则信息 | 将实际店名、账号填入占位;douyin-enable-auto-after-sale 的 shopNames 执行侧固定「全部」(不对用户展示、不收集)。用户 确认前 不得执行第 4 步。 |
「请帮忙核对一下售后规则信息:店铺 {店铺名称},售后采购账号 {purchase_accounts}。没问题请回「确认保存」,我们再帮您提交。」 |
| 第 4 步 · 保存 | 用户确认后再执行 douyin-enable-auto-after-sale;失败时将响应 error 或 markdown 中的业务说明填入 {失败原因}(可简短转述,保留关键店名/账号提示)。 |
成功:「已帮您保存好了。」 / 失败:「保存售后规则失败。{失败原因}」 |
能力三 · 关联货源
| 流程顺序 | 执行提示(写死,仅助手侧) | 对用户说的话(写死原文) |
|---|---|---|
| 第 1 步 · 店铺 | 同 能力一 · 第 1 步 · 店铺。 | 有店:「上面是当前绑定的店铺,麻烦选一家,发序号或店名都可以。」 / 无店:「暂未查询到绑定店铺,如需绑定请到后台先完成授权。」 |
| 第 2 步 · 本店商品 | 可选拉在售;主句不变。 | 「麻烦发一下用于关联货源的本店商品 ID。」 |
| 第 3 步 · 货源链接 | 与用户其他内容 分轮:本轮只发下句。用户给出链接后,执行侧从链接解析货源编号供 douyin-link-preview / douyin-confirm-link,禁止再向用户单独核对货源编号。 |
「麻烦发一下 1688 货源商品链接。」 |
| 第 4 步 · 采购账号 | 拉 分销 账号(禁止用售后账号列表命令)。有账号:按 锁4 在编号列表 紧上一行 输出 采购账号列表:,再编号展示后接主句。无账号:禁止 单独输出「采购账号列表:」。 | 「麻烦说明:用于关联货源的采购账号选哪一个(序号或账号名即可)。」 |
| 第 5 步 · 预览与确认关联 | 先说明匹配结果(格式见 §六),再发下句;用户 确认前 不得执行第 6 步。 | 「请帮忙确认以上预览的关联结果。没问题请回「确认」,我们再帮您保存。」 |
| 第 6 步 · 保存 | 用户确认后再执行 douyin-confirm-link;失败时将响应 error 或 markdown 中的业务说明填入 {失败原因}(可简短转述,保留关键店名/商品/货源提示)。 |
成功:「已帮您保存好了。」 / 失败:「关联货源保存失败。{失败原因}」 |
| 可选 · 分销关系(非 SKU) | 与 SKU 关联区分;失败时 {失败说明} 简短中文。 |
成功:「已经帮您绑好了。」 / 失败:「{失败说明},需要再试一次吗?」 |
能力三 · 第 1~4 步:禁止 同一轮向用户一次索要多项(店铺 / 商品 / 链接 / 采购账号)。
3.4 平台扩展占位(非淘宝 / 抖音 · 与已支持平台隔离)
下列 当前 对用户输出 只有 下表「占位 · 唯一收口句」,不得 套用 §3.2 / §3.3 任一主句或调用 §六 CLI。
| 平台 | 当前落地 | 占位 · 唯一收口句(原文) |
|---|---|---|
| 小红书 | 否 | 「目前我们暂时只支持淘宝、抖音;小红书这边还办不了,麻烦谅解。」 |
| 拼多多 | 否 | 「目前我们暂时只支持淘宝、抖音;拼多多这边还办不了,麻烦谅解。」 |
| 快手 | 否 | 「目前我们暂时只支持淘宝、抖音;快手这边还办不了,麻烦谅解。」 |
| 微信小店 | 否 | 「目前我们暂时只支持淘宝、抖音;微信小店这边还办不了,麻烦谅解。」 |
四、锁定句速查(合并表)
全局:§3.1 全表「对用户说的话」列。
淘宝:§3.2 各表「对用户说的话」列。
抖音:§3.3 各表「对用户说的话」列。
非支持平台占位:§3.4「占位 · 唯一收口句」列(禁止 自撰)。
五、CLI 规范
- 形态:
python3 cli.py <command> [options] - 平台路由:
cli.py与scripts/procurement.py为唯一固定入口;执行侧必须先按用户已选平台决定子命令。淘宝 使用本节列出的淘宝命令名;抖音 使用与淘宝不同的独立命令名。禁止 跨平台混用子命令。 - 鉴权:所有子命令仅通过
--token传 ISV Token;未传或空 → JSONerror: missing_token。 - stdout:JSON(
success、markdown、data;失败可有error)。 - 环境:
SKILL_API_BASE默认https://spmiddle.1tsoft.com/skill/skill。
子命令与参数示例见 §六(本节不重复贴 bash)。区分:淘宝 link-source 与抖音对应独立命令均走 daifa/relation(分销关系);SKU 关联分别使用 §六 · 能力三 中当前平台对应的预览 / 保存关联命令。
六、能力一 / 二 / 三 — 技术说明与 CLI(按平台分流)
适用:已选定平台;§3.3 占位平台 禁止 执行本节命令。
6.1 淘宝
能力一 · 自动下单
店铺列表
python3 cli.py list-shops --token "<ISV_TOKEN>"
多店铺时列表选定后再继续;记下 shopId、店名。
采购账号
python3 cli.py list-distributors --token "<ISV_TOKEN>" --shop-id "<shop_id>"
在 第 2 步 · 采购账号与开分销范围 中:自动下单账号用于 enable-auto-order;enable-link-type 的 --purchasing-accounts 对应 {all_accounts}:用户约定「全部」或子集时展开为 accounts[].name 英文逗号串;用户未说明开分销范围时默认仅 {purchase_account} 一个账号。
商品 ID
逗号分隔,最多 5 个。可选在售:
python3 cli.py list-products --token "<ISV_TOKEN>" --shop-nick "<店铺nick或ID>"
确认后 · 开分销
python3 cli.py enable-link-type \
--token "<ISV_TOKEN>" \
--item-ids "123456,789012" \
--shop "<店铺名称>" \
--purchasing-accounts "<账号1,账号2,...>"
按 data.fail_items 处理失败项。
确认后 · 保存自动下单
python3 cli.py enable-auto-order \
--token "<ISV_TOKEN>" \
--shop-name "<店铺名称>" \
--purchase-account "<用户选中的采购账号>"
失败时对用户输出 §3.2 淘宝 第 6 步「失败」句,将响应 error 或 markdown 中的业务说明填入 {失败原因}。
能力二 · 售后处理
店铺列表
python3 cli.py list-shops --token "<ISV_TOKEN>"
能力二对用户 不收集 生效店铺范围;调用 enable-auto-after-sale 时 --shop-names 固定 "全部"。
售后采购账号
python3 cli.py list-after-sale-accounts --token "<ISV_TOKEN>" --shop-id "<shop_id>"
--shop-id 仅用于中台解析 sid,不作为上述 URL 的 query。
保存
python3 cli.py enable-auto-after-sale \
--token "<ISV_TOKEN>" \
--shop-id "<shop_id>" \
--purchase-account "<账号1,账号2,...>" \
--shop-names "全部"
用户确认后再执行。失败时对用户输出 §3.2 淘宝 能力二 · 第 4 步「失败」句,将响应 error 或 markdown 中的业务说明填入 {失败原因}。
能力三 · 关联货源
店铺列表
python3 cli.py list-shops --token "<ISV_TOKEN>"
本店商品 ID
可选 list-products(同能力一)。
1688 货源链接
https://detail.1688.com/offer/....html;执行侧解析 offerId,与 --source-offer-url 一致;不对用户单独核对货源编号。
采购账号
python3 cli.py list-distributors --token "<ISV_TOKEN>" --shop-id "<shop_id>"
禁止 list-after-sale-accounts。
SKU 预览
python3 cli.py link-preview \
--token "<ISV_TOKEN>" \
--shop-id "<shopId>" \
--shop-nick "<店铺名称>" \
--local-item-id "<本店商品ID>" \
--source-offer-url "https://detail.1688.com/offer/xxxx.html" \
--purchase-account "<采购账号>"
匹配说明:本店SKU---上家SKU --匹配度:xx%(整数);用户认可后再执行保存。
保存关联
python3 cli.py confirm-link \
--token "<ISV_TOKEN>" \
--shop-id "<shopId>" \
--shop-nick "<店铺名称>" \
--local-item-id "<本店商品ID>" \
--source-offer-url "https://detail.1688.com/offer/xxxx.html" \
--purchase-account "<采购账号>" \
[--limit-rows "<仅提交前 N 条 SKU 映射,可选>"]
用户确认后再执行。失败时对用户输出 §3.2 淘宝 能力三 · 第 6 步「失败」句,将响应 error 或 markdown 中的业务说明填入 {失败原因}。
可选:分销关系(非 SKU)
python3 cli.py link-source \
--token "<ISV_TOKEN>" \
--downstream-item-id "<本店商品ID>" \
--shop "<店铺名称>" \
--purchasing-accounts "<采购账号>" \
[--source-offer-id "<offerId>"]
6.2 抖音
能力一 · 自动下单
店铺列表
python3 cli.py douyin-list-shops --token "<ISV_TOKEN>"
多店铺时列表选定后再继续;记下 shopId、店名。
采购账号
python3 cli.py douyin-list-distributors --token "<ISV_TOKEN>" --shop-id "<shop_id>"
在 第 2 步 · 采购账号与开分销范围 中:自动下单账号用于 douyin-enable-auto-order;douyin-enable-link-type 的 --purchasing-accounts 对应 {all_accounts}:用户约定「全部」或子集时展开为 accounts[].name 英文逗号串;用户未说明开分销范围时默认仅 {purchase_account} 一个账号。
商品 ID
逗号分隔,最多 5 个。可选在售:
python3 cli.py douyin-list-products --token "<ISV_TOKEN>" --shop-ids-json '["<店铺nick或ID>"]'
确认后 · 开分销
python3 cli.py douyin-enable-link-type \
--token "<ISV_TOKEN>" \
--item-ids "123456,789012" \
--shop "<店铺名称>" \
--purchasing-accounts "<账号1,账号2,...>"
按 data.fail_items 处理失败项。
确认后 · 保存自动下单
python3 cli.py douyin-enable-auto-order \
--token "<ISV_TOKEN>" \
--shop-name "<店铺名称>" \
--purchase-account "<用户选中的采购账号>"
失败时对用户输出 §3.3 抖音 第 6 步「失败」句,将响应 error 或 markdown 中的业务说明填入 {失败原因}。
能力二 · 售后处理
店铺列表
python3 cli.py douyin-list-shops --token "<ISV_TOKEN>"
能力二对用户 不收集 生效店铺范围;调用 douyin-enable-auto-after-sale 时 --shop-names 固定 "全部"。
售后采购账号
python3 cli.py douyin-list-after-sale-accounts --token "<ISV_TOKEN>" --shop-id "<shop_id>"
--shop-id 仅用于中台解析 sid,不作为上述 URL 的 query。
保存
python3 cli.py douyin-enable-auto-after-sale \
--token "<ISV_TOKEN>" \
--shop-id "<shop_id>" \
--purchase-account "<账号1,账号2,...>" \
--shop-names "全部"
用户确认后再执行。失败时对用户输出 §3.3 抖音 能力二 · 第 4 步「失败」句,将响应 error 或 markdown 中的业务说明填入 {失败原因}。
能力三 · 关联货源
店铺列表
python3 cli.py douyin-list-shops --token "<ISV_TOKEN>"
本店商品 ID
可选 douyin-list-products(同能力一)。
1688 货源链接
https://detail.1688.com/offer/....html;执行侧解析 offerId,与 --source-offer-url 一致;不对用户单独核对货源编号。
采购账号
python3 cli.py douyin-list-distributors --token "<ISV_TOKEN>" --shop-id "<shop_id>"
禁止 douyin-list-after-sale-accounts。
SKU 预览
python3 cli.py douyin-link-preview \
--token "<ISV_TOKEN>" \
--shop-id "<shopId>" \
--shop-nick "<店铺名称>" \
--local-item-id "<本店商品ID>" \
--source-offer-url "https://detail.1688.com/offer/xxxx.html" \
--purchase-account "<采购账号>"
匹配说明:本店SKU---上家SKU --匹配度:xx%(整数);用户认可后再执行保存。
保存关联
python3 cli.py douyin-confirm-link \
--token "<ISV_TOKEN>" \
--shop-id "<shopId>" \
--shop-nick "<店铺名称>" \
--local-item-id "<本店商品ID>" \
--source-offer-url "https://detail.1688.com/offer/xxxx.html" \
--purchase-account "<采购账号>" \
[--limit-rows "<仅提交前 N 条 SKU 映射,可选>"]
用户确认后再执行。失败时对用户输出 §3.3 抖音 能力三 · 第 6 步「失败」句,将响应 error 或 markdown 中的业务说明填入 {失败原因}。
可选:分销关系(非 SKU)
python3 cli.py douyin-link-source \
--token "<ISV_TOKEN>" \
--downstream-item-id "<本店商品ID>" \
--shop "<店铺名称>" \
--purchasing-accounts "<采购账号>" \
[--source-offer-id "<offerId>"]
七、助手执行协议与流程锁死
以下约束 优先于 模型默认习惯;违反即视为未按本 Skill 执行。
流程锁死(话术原文级)
- 锁0 · 全文严格合规:对用户的每条消息,可见正文 必须 同时满足上款 「每次回答(总则 · 全文合规)」 与 锁1~锁8、下述「编号条款」;禁止出现任何未获本文件某表「对用户说的话」或 锁4 列表规则 明示授权 的字句(含自撰提醒、操作建议、安全提示、接口长文复述等)。
- 锁1 · 未说明销售平台:用户可见内容 仅允许 §3.1「未说明销售平台」引号内 整句,句前句后不得加任何字。
- 锁2 · 全局固定句:§3.1 中「用户选定淘宝」「用户选定抖音」「非支持平台」「业务失败」「鉴权失败」「已选平台但说不清办哪项」各 对用户说的话 与引号内 逐字一致;仅
{平台名}、{店铺名称}等占位替换。 - 锁3 · 分卷业务隔离:淘宝分卷(§3.2) 各表「对用户说的话」必须原文;禁止 用 §3.2以外的占位句办理淘宝业务;禁止 在 未选淘宝 时使用 §3.2 主句。抖音分卷(§3.3) 各表「对用户说的话」必须原文;禁止 用 §3.3以外的占位句办理抖音业务;禁止 在 未选抖音 时使用 §3.3 主句。
- 锁4 · 列表辅助:需展示店铺 / 采购账号 / 在售列表时,仅允许在 主句原文之前 增加 列表块。店铺 编号列表:该列表 紧上一行 必须为 店铺列表:(四字加中文冒号,独占一行,字面逐字),其下为编号分行(序号、店名等)。采购账号 编号列表(含自动下单
list-distributors、售后list-after-sale-accounts、关联货源第 4 步之分销账号):该列表 紧上一行 必须为 采购账号列表:(六字加中文冒号,独占一行,字面逐字),其下为编号分行。在售list-products若编号展示:不使用「店铺列表:」「采购账号列表:」。无店铺 / 无采购账号因而 不展示 编号列表时:禁止 单独输出上述标题行。列表块后 必须紧跟 该步主句(或用户已给出唯一可核对选项时直接进入下一步主句)。禁止用自撰问法替代主句。 - 锁5 · 禁止抢答解释:禁止向用户解释 Skill 未提供的背景说明;禁止把内部路由、附录代号、执行提示全文复述给用户。
- 锁6 · 店铺步骤:进入 能力一 / 二 / 三 的第 1 步 · 店铺 时,执行侧 必须先 拉取店铺列表,再按锁4 输出(含 有店 / 无店 分支锁死句);禁止未拉表仅让用户凭空报店名(用户已给出唯一可核对店名除外)。
- 锁8 · 鉴权:线上由平台自动注入 Token;禁止在任何步骤向用户索要、展示或复述 Token。
- 锁7 · 平台隔离:非淘宝(§3.2)只 输出对应 占位 · 唯一收口句;非抖音(§3.3)只 输出对应 占位 · 唯一收口句****禁止调用 §六 CLI;禁止将淘宝/抖音锁死句改写到占位节「代替」落地。
编号条款
- 单步输出:每次回复只推进 当前一步;禁止同条消息列全流程清单。
- 对用户不展示实现细节:禁止命令行、代码块、JSON、路径、接口字段名、环境变量名(助手后台执行即可)。禁止在任何轮次索要或复述 Token 内容。
- 列表类信息:须用户从店铺 / 账号 / 商品中选择时,先拉列表再编号展示;禁止展示原始接口数据。
- 禁止伪造列表:未取得对应查询命令的真实结果前,禁止输出「店铺列表:」「采购账号列表:」及任何编号行;禁止输出“店铺A/店铺B/店铺C”等示例占位内容充当真实列表。
- 话术禁区:禁止承诺未实现能力;失败时对用户 仅 输出当前平台分卷已收录的「成功/失败」分支(含能力一 · 第 6 步、能力二 · 第 4 步、能力三 · 第 6 步之
{失败原因})或 §3.1「业务失败」句,禁止自撰。 - 鉴权失败:只对用户说 §3.1「鉴权失败」一句;禁止展示 Token 内容、禁止索要阿里用户 ID。
- 店铺列表:勿向用户索要阿里用户 ID。
八、内部技术参考(禁止对用户朗读)
- 平台:
procurement.py/ CLI 仅 淘宝 / yzg / 抖音;§3.4 无独立调用链。 - 执行侧:
{shopId}、data.shops、data.accounts[].name、data.fail_items等不念给用户;鉴权见--token(由平台自动注入)。保存类(淘宝:enable-auto-order、enable-auto-after-sale、confirm-link;抖音:见 6.2 对应保存命令)失败时对用户输出当前平台分卷对应「失败」句 +{失败原因};其它失败按 §3.1「鉴权失败」或「业务失败」。
九、聚合与其它命令
settings:淘宝使用python3 cli.py settings --token "<ISV_TOKEN>" [--shop-id "<店铺ID>"];抖音使用python3 cli.py douyin-settings --token "<ISV_TOKEN>" [--shop-id "<店铺ID>"];传--shop-id时额外查该店分销账号;售后账号须用各自平台对应的售后账号命令。- 子命令(均需
--token,仅淘宝 / 抖音):与 §六 一致。淘宝:list-shops,list-distributors/list-after-sale-accounts,list-products,enable-link-type,enable-auto-order,enable-auto-after-sale,link-preview,confirm-link,link-source,settings。抖音:douyin-list-shops,douyin-list-distributors/douyin-list-after-sale-accounts,douyin-list-products,douyin-enable-link-type,douyin-enable-auto-order,douyin-enable-auto-after-sale,douyin-link-preview,douyin-confirm-link,douyin-link-source,douyin-settings。
附录 · 内部代号与 CLI 对照(勿对用户提及)
下表左列英文代号禁止对用户提及。
| 内部代号 | 含义 | 对应 §六 CLI / 备注 |
|---|---|---|
| GL-P0-问平台 | 未说明平台 | — |
| GL-P0-选淘宝 | 选定淘宝 | — |
| GL-P0-选抖音 | 选定抖音 | — |
| GL-非支持平台 | 非支持平台收口 | — |
| GL-失败 | 业务失败 | 对用户 §3.1「业务失败」句 |
| GL-登录异常 | 鉴权失败 | 对用户 §3.1「鉴权失败」句 |
| GL-歧义 | 说不清能力 | — |
| TB-A-0 | 鉴权(平台自动注入) | 线上默认 |
| TB-A-1~6 | 自动下单 第 1~6 步 | list-shops → list-distributors(采购账号+开分销范围合并为第 2 步)→ 宝贝 → 确认 → enable-link-type → enable-auto-order |
| TB-S-1~4 | 售后 第 1~4 步 | list-shops → list-after-sale-accounts → enable-auto-after-sale |
| TB-L-1~6 | 关联货源 第 1~6 步 | list-shops → 本店宝贝 ID、1688 链接 → list-distributors → link-preview → confirm-link(货源编号仅执行侧解析) |
| DY-A-0 | 鉴权(平台自动注入) | 线上默认 |
| DY-A-1~6 | 自动下单 第 1~6 步 | douyin-list-shops → douyin-list-distributors(采购账号+开分销范围合并为第 2 步)→ 商品 → 确认 → douyin-enable-link-type → douyin-enable-auto-order |
| DY-S-1~4 | 售后 第 1~4 步 | douyin-list-shops → douyin-list-after-sale-accounts → douyin-enable-auto-after-sale |
| DY-L-1~6 | 关联货源 第 1~6 步 | douyin-list-shops → 本店商品 ID、1688 链接 → douyin-list-distributors → douyin-link-preview → douyin-confirm-link(货源编号仅执行侧解析) |
十、字段占位说明(执行侧替换,勿对用户念字段名)
| 占位符 | 含义 |
|---|---|
{平台名} |
用户说的非支持平台名称 |
{店铺名称} |
选定店铺名称 |
{purchase_account} |
用户选中的单个采购账号(自动下单) |
{all_accounts} |
开启分销开关用的采购账号英文逗号串;用户未另行说明时 默认与 {purchase_account} 相同 |
{item_ids} |
宝贝 ID,逗号分隔,最多 5 个 |
{local_item_id} |
抖音关联货源本店商品 ID(§3.3 能力三 · 第 6 步核对句) |
{purchase_accounts} |
售后用账号,逗号分隔 |
{shop_names} |
(仅执行侧)售后 shopNames 固定「全部」,不对用户话术出现 |
{失败说明} |
接口或业务失败的中文短因 |
{失败原因} |
enable-auto-order(能力一第 6 步)、enable-auto-after-sale(能力二第 4 步)、confirm-link / douyin-confirm-link(能力三第 6 步)失败时,取自响应 error 或 markdown 中的业务说明(可简短转述) |