电商店铺诊断技能（Ecom Store Diagnosis · 免费版/诊断引擎）

> 🔒 版权与授权：本技能为免费诊断引擎，仅供购买者本人/授权团队使用，禁止转售、二次分发、逆向提取知识库。进阶经验库与运营工作台为独立进阶产品。

概述

本技能把"电商运营推广数据分析 + 店铺诊断"沉淀为可复用流程，面向任意淘宝/天猫卖家。
技能不绑定任何具体店铺：店铺名、类目、保本线、数据源连接器均通过配置参数化（见 references/store_config_template.md）。

> ❓ 遇到问题 / 想避免踩坑 → 见 references/faq.md：反模式 25 条（哪些做法会让诊断失真，含跳过第 0 层店铺画像、渠道锁定、泛词投放、伪反哺等）+ FAQ 20 条（数据/指标/输出/连接器/报错五类，含一步步排查）+ 快速排查表（症状→原因→一步解决）。
三种调用方式均可直接使用：① 对话触发（说人话即可）· ② 命令行直调（CLI 一键入口 scripts/diagnose.py，带完整参数与退出码）· ③ 程序化集成（标准退出码 0-4 + JSON 运行摘要，可被 CI/定时任务/外部系统直接调用）——详见「三种调用方式」章节。
核心产出是单文件深色 HTML 驾驶舱，含高/中预警分级与「现状/问题/该怎么查」三段式点评（只诊断、只提问，不替你做运营优化）。

免费版定位 = 纯诊断引擎：提供通用的 ROI / 边际利润 / 流量构成 / 人群画像（基础三维）计算与类目基准预警；不含进阶版的"经验判断大脑"与运营工作台。

何时使用

• 用户说"分析下我的推广数据 / 直通车 ROI / 店铺诊断 / 生意参谋"
• 用户说"看下我的推广计划，有没有要调整的 / 哪个计划在亏 / 哪个计划在烧钱" → 走计划级诊断，必须先按 plan_type 分形态（见核心能力第 1 条与 promo_a_logic.md）
• 用户问"这个品该不该投关键词 / 关键词推广从哪个品起 / 帮我挑个品去推" → 先走第 0 步「店铺画像」：判 新店/老店 决定"AI 选品还是老板自己选"，再判 单品店/多品店 决定诊断路线（见核心能力第 0 条）
• 用户问"这店是新店还是老店 / 开了多久" → 走第 0 层「店铺生命周期」判定（含两个自动取数法）
• 需要生成店铺健康度报告、数据驾驶舱、竞品对标（类目基准）
• 用户说"看下店铺人群 / 男女比例 / 年龄分布 / 哪个地域买得多 / 人群画像"
• 多店对比、每日巡检、专项诊断

> ⚠️ 规则来源与时效说明：本技能的诊断逻辑来自两类依据——① 平台官方明文规则（如末次触点归因、单品计划与全店模式互斥，以阿里妈妈官方知识库为准）；② 实战反复验证的"暗规则"（如渠道锁定原则、泛词禁令，平台不写但真实存在，已在红线 D/E 标注）。阿里妈妈后台迭代极快，凡涉及具体界面操作以商家后台实时为准；引用官方规则时括号内标注来源（如「万相台无界投放顾问·官方知识库」）。本技能为静态知识快照，关键操作请后台核对。
>
> 🔗 与「万相台无界投放顾问」的分工：本免费版只诊断、不替你设出价/建计划；当用户问"出价怎么设、ROI 怎么定、全店模式怎么开、最大化拿量还是控投产"等投放操作类问题时，那是运营优化范畴，请联动「万相台无界投放顾问」获取阿里妈妈官方操作指引——本技能负责"把账算清、把异常标出"，它负责"告诉你后台怎么点"。

核心能力（第 0 层前置 + 六大模块）

0. ★ 第 0 层 · 店铺画像（一切诊断的前置，未定不往下走）——先判两件正交的事：
   - 店铺结构（单品店 / 多品店） → 决定诊断路线：单品店走「链接深挖线」（纵向钻一个链接），多品店走「计划矩阵线」（先横向比品、再纵向钻）。判据：★ 计划→链接映射（n 条计划打同一个链接 = 单品店）、在售链接数、★ 计划名是否被人工改过（带日期后缀 / 纯品名 = 多品店强证据）、多品计划占比。最快是张嘴问用户。
   - 店铺生命周期（新店 / 老店） → 决定选品时该由谁判断：新店 = AI 用生意参谋「流量→商品」的搜索渠道转化率选品给客人挑；老店 = 直接问老板"你想推哪个品"，不要拿 AI 的短期数据榜单覆盖他 6 个月+ 的经营直觉。判据 5 组（可自动 4 组）：最早已投计划创建日（计划名内嵌 _YYYYMMDD_HHMMSS_ 时间戳 + campaignId 相邻锚点分段插值）、达摩盘累计人群资产（首购 <1000 新 / ≥5000 老）、老访客占比、计划累计花费厚度、店铺创建时间（最权威）。≥3 组一致才下判，否则必须问用户，不许猜。
   - 详见 references/promo_a_logic.md 第零节、references/data_sources.md 第五之三节。
1. 推广数据诊断：关键词推广（原直通车）花费/点击/转化/ROI、余额巡检、计划级与关键词效率、保本线达标判断
   - ★ 计划级诊断须先分「计划形态」（plan_type：单商品 / 多品·经营型 / 全店推广·凑数型 / 全店推广·经营型 / 智能托管单商品）——形态决定"能做什么动作"，也决定"该怎么判盈亏"。关键业务前提：全店推广类计划有「至少挂 3 个商品」的建计划门槛，多品常是为过门槛凑数，不代表在经营；判据是单品均摊花费/天（<1 元 ⇒ 凑数倾向，≥2 元 ⇒ 真在投）。全店推广计划不可按单品拆分；凑数型即便 ROI 破线也属"影响有限、低优先级"。详见 references/metrics_def.md「计划形态五分法」与 references/promo_a_logic.md 第三节之二。
   - ⚠️ 两个"形态"不要混：投放形态（关键词推广/人群推广/超级直播/超级短视频/货品全站推/全店推广）看"钱花在哪个入口"；计划形态（五分法）看"单个计划是什么类型"。两者独立，诊断都要看。
   - 📖 新旧命名映射表（很多老板仍用旧称，诊断时统一按现名归口 · 来源：万相台无界投放顾问·官方知识库）：直通车 → 关键词推广（搜索关键词竞价）；引力魔方 → 人群推广（推荐信息流人群投放）；万相台（含全店模式）→ 货品全站推广（单品/全店智能放量）；店铺直达、内容营销、活动运营、线索推广（原获客易）、小店成交宝 为新增独立入口。脚本 CHANNEL_ALIAS 已做别名归一，旧名输入自动识别，但报告与建议一律用现名，避免与用户旧称混淆导致误操作（如把"万相台"误当成某个单渠道）。
   - ⚠️ 判渠道归属不能只看计划名前缀：人工改过名的计划（如 韭菜籽、大血藤夏枯草茵陈20260603）不带系统前缀，需按后台归属判；「全店推广」渠道下会拆多个分组计划（各带不同净目标 ROI），极易漏抓。
   • 🚫 渠道锁定原则（必须遵守，平台不写明但真实存在）：一个商品固定在一个推广渠道，不要建议跨渠道迁移——全站推广里跑得好的品，拿出来打关键词推广，这个品会死。原因：① 托管渠道的流量模型不可迁移，换渠道等于从零学；② 两渠道互相抢量打架；③ 计划累计花费有隐性权重，挪品/新建计划 = 权重清零。→ 要跑关键词推广，用没进过托管渠道的品（新品/未投放品）；已在某渠道跑的品，优化留在原渠道内做（收窄人群/调预算/调时段/调托管模式），不换渠道。诊断落点永远是"这条计划内部怎么改"，不是"把这个品换到哪条渠道"。
   • 🔒 官方互斥/归因规则佐证（与红线 D 同源、互相印证 · 来源：万相台无界投放顾问·官方知识库）：① 同一商品在整个「货品全站推广」场景下只能存在一条计划，且单品计划与全店模式即便解除互斥仍互斥——即一个品要么在单品计划、要么在全店模式，绝不可能两头占，从平台规则层面锁死了"换渠道/挪品"的可操作性（挪 = 删旧建新 = 累计花费权重清零）；② 末次触点归因：货品全站推广与无界其他场景成交不重复计算——这印证了我们「渠道明细求和 = 账户总成交」的口径校验前提（偏差大优先查漏抓，而非"多算了渠道"）。详见 promo_a_logic.md 红线 D 段落、data_sources.md 第五之四节。
   • 🚫 泛词（大词）投放禁令：不要建议小店投泛词大词（如"中药材""中草药"）。机制：投泛词 → 被匹配给所有带该词的搜索（如"黄芪中药材"）→ 叠加最大化拿量 → 精准商品被泛流量点掉、点击花了转化没有，纯浪费。→ 付费只打精准中长尾（品名+规格+场景）；大词靠自然搜索排名，不靠付费硬砸。详见 promo_a_logic.md 第三节之三/之四与第十节红线 D、E。
   • 🔎 「相似品跟投」五方案是"营销目标"，不是"五种出价方式"：新品跟爆 / 相似跟投 / 竞争拉新 / 乘胜追击 / 流失防守。共同机制 = 把商品贴到锚点商品的搜索结果附近、抢它的人群，五者只差锚点选谁。除「新品跟爆」外均支持设置平均点击成本，但开启后拿量能力会下降（官方建议"起量期先不设、稳定期再设"）。跟投属阶段性拉新/竞争工具（约半个月至一个月），不能拿常规投产标准硬套 ROI；也不得把托管渠道在跑的品拿来开跟投（红线 D）。详见 promo_a_logic.md 第三节之五。
   • 💰 预算利用率闸门（★ 别把"花费低"当成"没给钱"）：charge（实际花费）不是 budget（预算），可差 100 倍。先算 预算利用率 = 花费 ÷ (日预算 × 天数)：≥80% ⇒ 真缺预算（加预算有效）；<20% ⇒ 系统不愿花（托管渠道的目标 ROI 掐死 / 出价过低 / 人群过窄）——加预算一分也花不出去。托管渠道判据：目标达成度 = 实际ROI ÷ 净目标ROI，<0.4 = 重度掐死，必须先降目标。实测：全店推广日预算 5000、日耗 60.62（利用率 1.2%）、净目标 3.7 vs 实际 0.29 → 动作是降目标到 2.2~2.5，不是加预算。拿不到预算/目标字段时，不许对此做任何归因，标"待核实"。
   • 🏷️ 术语统一 · 全店推广 = 货品全站推广-全店模式（来源：万相台无界投放顾问·官方知识库）：平台侧「仅需设全店 ROI + 全店预算即可一键开启」，并有「一键起量」杠杆（「全部推广中商品」适用于跑量差/冷启长；「自定义商品 ≤20 个」适用于系统未优选的高预期品）。落到诊断上：① 报告与建议统一用现名"全店推广/货品全站推广"，不再混用"万相台"旧称；② 消耗过低且目标达成度 <0.4 时，「一键起量」与「降目标」都是官方认可的放量手段，免费版只点破、不替你操作，动作仍走红线 D/F 闸门校验。
   • 🩺 低消耗三形态闸门（★「钱花不出去」不是一种病，动作相反）：先分流、再给动作——A 出价被掐死（花费 ≈ 0、预算利用率 < 5% ⇒ 降目标）；B 内功弱·捡便宜量（花费在花，但 cpc 显著低于全店 ecpc、CVR 同步垫底 ⇒ 修内功，禁止降目标）；C 冷启/测款（观察 7 天）。分流判据 = cpc_ratio = 该计划 cpc ÷ 全店 ecpc：≥ 0.8 走 A；< 0.5 必判 B；算不出来 ⇒ 先补数。内功五查：跳失率（< 60%）、人均浏览量（≥ 3）、平均停留时长（≥ 30 秒）、定价带 TGI（≥ 80）、动销率（≥ 30%）。定价联动：多数品「推广费率 > 边际利润率」⇒ 是定价/承接问题，调投放救不回来。详见 promo_a_logic.md 第三节之八、metrics_def.md 零之二。
   • 🔄 货品生命周期视角（★诊断全站推广计划前先定单品所处阶段，避免误判 · 来源：万相台无界投放顾问·官方知识库）：官方按「货品生命周期 × 出价策略」给出权威映射——新品冷启/成长期应「最大化拿量 + 加购目标」，爆发/平销期才转「控投产 + 直接成交目标」。落到诊断上：① 处于冷启/成长的新品，ROI 低、消耗爬坡慢是设计使然，属我们「低消耗三形态」的 C 冷启/测款，不可按常规投产标准判它亏、也别急着降目标；② 反过来，一个本该控投产的成熟品却在用最大化拿量烧、ROI 远低于保本线，才是真异常（再走 A/B 细分）。这把「第 0 层店铺生命周期（新店/老店）」补成了第二个正交维度：单品的货品生命周期，让「花钱受阻三形态」的分流更准。详见 promo_a_logic.md 第三节之八（花钱受阻三形态）。
   • 📋 渠道占用盘点（用户问"哪些品能做跟投 / 哪些品绝对不能动"时）：把全店计划折算成「品 × 渠道」占用矩阵，按累计花费分三层——🟢绿区（无任何计划覆盖，新渠道的唯一合法起点）/ 🟡黄区（<100 元，须再切"有量但浅"与"建了没跑"两刀）/ 🔴红区（≥100 元，绝对锁死、禁换渠道）。⚠️ 这是占用判定、不是选品（老店选品由店主定）；绿区算不出时如实索要全店在售商品清单，不许用已覆盖品反推填充。详见 promo_a_logic.md 第三节之六。
2. 店铺诊断：流量结构（免费/付费/自主）、转化漏斗、客单价
3. 竞品对标（类目基准口径）：按类目经验基准（转化率/退款率/付费占比等阈值）做超标预警；竞品店指数反推真实咨询人数 + 白名单监控为进阶版能力

4. 两个 ROI（推广ROI vs 实际利润ROI）——诊断的核心判据：
   - 推广ROI = 卖了多少钱 ÷ 花了多少推广费（net_gmv / promotion_spend），看广告效率；
   - 实际利润ROI = 卖了多少钱 ÷（推广费 + 商品成本 + 其他成本支出），看真赚不赚（< 1 即全口径真亏）；
   - 边际利润率（(售价−商品成本)/售价）作为桥梁，用于推导推广ROI 的精准保本线 = 1 ÷ 边际利润率（取代默认 2.0）；
   - 单品级边际利润率与推广费率联动（推广费率 > 边际利润率 → 越推越亏）。
   - 详见 references/metrics_def.md 第十节。

5. 流量构成（生意参谋口径）：按来源拆访客/成交金额/成交单——免费（搜索/推荐/首页等）、付费（直通车/万象台/引力魔方）、自主（购物车/收藏/直接访问）；输出免费/付费访客占比与成交金额占比、各来源转化率；预警：付费访客占比 >70%、免费访客占比 <30%、大流量低转化来源、来源合计与全店口径偏差 >5%。数据两条路（运行时问用户）：A 用户导入（生意参谋流量看板导出/截图）或 B 自定义连接器后台快照抓取（详见 references/data_sources.md）。详见 references/metrics_def.md 第十一节。

6. 人群画像（访客结构分析，免费版含性别/年龄/地域基础三维）：按分段拆访客占比/成交金额占比/分段转化率，计算 TGI 人群转化指数（分段转化率÷维度整体转化率×100，≥110 高转化人群、<80 拖后腿人群）；预警：某分段访客占比 ≥30% 且转化率不足整体一半 → 高预警「大流量低转化人群」，访客主力 TGI <80 → 中预警「引流与成交人群偏离合」。数据来源：生意参谋 → 流量 → 访客分析/客群洞察（T-1，导出/截图皆可）。消费层级、兴趣人群（达摩盘）等深层维度与人群×渠道/单品交叉解读属进阶版。详见 references/metrics_def.md 第十二节。

工作流

> ★ 第 0 步（前置 · 未定不往下走）· 店铺画像——先回答"这是什么店"，再进入下面 1~6 步。
> 第 0 层判错，后面全是空转，甚至方向反掉。两个正交维度都要定：
>
> 维度 A · 店铺结构 = 单品店 / 多品店 → 决定诊断路线
> - 单品店 → 走「链接深挖线」（纵向钻链路的转化/价格/主图/标题；不做品与品的横向取舍）
> - 多品店 → 走「计划矩阵线」（先横向比品，再纵向钻）
> - 判据：★ 计划 → 链接映射（n 条计划打同一个链接 = 单品店）、★ 在售链接数（1~3 vs 十几个）、计划名清单（被人工改过 = 带日期后缀 / 纯品名 = 多品店强证据）、多品计划占比、SKU 规格。
> - 最快的确认方式是直接问用户"你店主打几个链接"；自动化场景用计划反推。
>
> 维度 B · 店铺生命周期 = 新店 / 老店 → 决定选品时该由谁来做判断
> - 新店 → AI 主动选品：去 生意参谋 → 流量 → 商品，按搜索渠道转化率降序取 TOP，交给客人挑（老板此时无数据、无手感，AI 比他有判断力）。
> - 老店 → 直接让老板选：不问数据榜单，开口就问"你想推哪个品"（老板有 6 个月+ 的经营直觉；AI 手上通常只有 7~14 天样本，3~5 单就能"算出"高转化，属噪音；且老店动的是已攒花费权重的品，试错成本高）。
> - 判据 5 组（4 组可自动）：① ★ 最早已投计划创建日（计划名内嵌 _YYYYMMDD_HHMMSS_ 时间戳；改名计划用 campaignId 相邻锚点分段插值补）② ★ 达摩盘累计人群资产（首购人群 <1000 = 新 / ≥5000 = 老）③ 老访客占比（<10% 新 / ≥20% 老）④ 计划累计花费厚度 ⑤ 店铺创建时间（最权威，生意参谋 → 店铺概览 / 千牛 → 店铺信息）。
> - 判定规则：≥3 组指向同一侧才下判；2:2 或缺数据 = 不确定 ⇒ 必须张嘴问用户「这店开了多久 / 是老店还是新店」，绝不许猜——猜错是双向代价：把老店当新店 = 数据覆盖老板判断 + 冒犯；把新店当老店 = 老板答不上来，流程空转。
>
> ⚠️ 无论新老店，选品都先过「渠道锁定原则」这道闸：候选品必须是当前没有任何渠道在跑的品（新品/未投放品/已停投品）。老店再加一条：差集由老板来挑，不是 AI 算完直接推。
> 详见 references/promo_a_logic.md 第零节、references/data_sources.md 第五之三节（含两个取数法）。

1. 确定范围（两步强制询问类目）：用户指定店铺（单店/多店）与周期（默认 T-1 已结算）。
   - 第一步：先问类目类型——该类目是 标品 / 半标品 / 非标（见 metrics_def.md 第八节），category_type 写入输入 JSON。
   - 第二步：再仔细询问具体是什么类目——在确认类型后，进一步问清具体类目（如服饰、美妆、食品、3C数码、家居日用、公证认证、药食同源中药材、定制服务等）。不同具体类目的诊断基准（转化率基线、付费占比、退款率、客单价）与运营抓手差异很大，不细问会误诊。category 写入输入 JSON。
   - 未完成两步询问前，不进入数据处理；若使用者未提供具体类目，技能在结果中给中提示要求补充。
2. 摄入数据（推荐顺序：先连接器、再导入；详见 references/data_sources.md）：
   - A. 自定义连接器（★优先推荐 · 由技能帮你搭建 · 最快）：优先向用户推荐使用自定义连接器，并由技能按 references/connector_setup.md 的六步 SOP 主动带他搭好——确认店铺标识 → 建立持久化 profile → 一次性扫码 → 登记 NAV_MAP（明确记录这家店的数据从哪个后台入口获取）→ 试抓验证。搭好之后：日常静默复用登录态，绝不反复弹窗扫码；连接器自己知道去哪取数，用户无需翻后台找页面。任何店铺、任何人都可用（不写死店铺名）。若用户尚未配置连接器，不要直接让他导 CSV，应先提议并帮他搭建。
   - B. 消费已导出数据：读取生意参谋/千牛导出的 CSV/Excel 订单、销售明细、聊天质检、竞品指数、访客分析（人群画像）文件或台账
   - C. 每日自动化产出：读取已结构化的每日自动化文件（TXT 台账 / 自动化产出）
   - 任何来源最终都组装成统一 JSON（{"stores":[...]}）传入脚本，字段见 references/metrics_def.md
   - 成本摄入（算实际利润ROI / 精准保本线必需，三选一，见 references/data_sources.md）：
   ① 截图识别——你截成本表图，我识别后填进 JSON；
   ② 表格导入——导出进销存/ERP 成本表(CSV/XLSX)，跑 scripts/ingest_costs.py 按 SKU 自动合并进 products；
   ③ 连接器抓取——经 Playwright MCP 从千牛/供应商后台抓成本。
   需提供两类成本：
   • 商品成本：单品填 products[].cogs，或全店一个合计数填 cogs_total；
   • 其他成本支出：佣金/物流/人工/平台费/售后等，全店一个合计数填 other_cost 即可。
   • 📌 问用户要成本时，必须附带以下备注（先把两个 ROI 讲清楚，用户才知道该报什么数）：
     > 「我会给你两个 ROI，先说清区别免得看混：
     > 1. 推广ROI = 卖了多少钱 ÷ 花了多少推广费——只看广告效率，你后台平时看到的多半是这个；
     > 2. 实际利润ROI = 卖了多少钱 ÷（推广费 + 商品成本 + 其他成本支出）——把赚的钱和所有花掉的钱都算进去，看真赚不赚，这个数 < 1 就是真亏。
     >
     > 所以要算准实际利润ROI，麻烦你给两类成本：① 商品成本（每个 SKU 的进货/制作成本，或给全店一个合计数）；② 其他成本支出（佣金、物流、人工、平台费、售后等，给一个合计数就行）。
     > 有了商品成本，我还能反推出你这店专属的精准保本 ROI = 1 ÷ 边际利润率，取代拍脑袋的默认 2.0——比如边际利润率 40%，推广ROI 得 ≥2.5 才算真不亏。」
     一句话让用户明白：报准成本 = 拿到真实盈亏判定 + 专属保本线。
3. 组装数据 JSON：字段对齐 references/metrics_def.md，形如 {"stores":[{...}]}；做边际利润率时每个 store 需含 products:[{sku,price,units_sold,cogs,...}]（见第十节）。
   - ★ 口径校验闸门（"我抓全了吗"）：计划明细抓取极易漏抓（已删计划 / 分页没翻完 / 筛选不全 / 虚拟滚动只加载首屏）。组装前必须用账户口径（账户首页期间总消耗/总成交/总订单）与日粒度口径（逐日求和）交叉校验计划口径。差额 > 5% ⇒ 报告里显式标注「未覆盖消耗 X 元 / Y 单（占 Z%）」，并把"渠道单一"类结论降级为"待核实"，列出两种可能（① 漏抓 ② 存在未纳入的其他渠道）。详见 references/data_sources.md 第五之四节。
4. 计算指标与预警：运行 scripts/compute_metrics.py，输出 metrics JSON（含预警分级）。
   - ★ 做计划级诊断前的形态校验：拿到计划数据后，逐计划确认 n_products + 单品均摊花费/天 + plan_type（单商品 / 多品·经营型 / 全店推广·凑数型 / 全店推广·经营型 / 智能托管单商品）。只拿到列表页数据（无商品数）时，必须提示需点进计划详情补抓，不可凭计划名猜形态。单品均摊花费是区分"凑数"与"真在投"的关键判据。
5. 渲染驾驶舱：运行 scripts/build_dashboard.py，生成单文件深色 HTML。
6. 输出与建议：呈现 HTML，按高/中预警分级给「现状+建议」。
   - 💰 预算利用率闸门：凡建议里出现"加预算 / 投不足 / 预算给少了"→ 先查该计划的 daily_budget 与 net_target_roi：
   答不上来 ⇒ 删掉该建议；预算利用率 <20% ⇒ 改写为"降目标 / 提出价"（加预算无效）；目标达成度 <0.4 ⇒ 先降目标，不是加预算。
   - 🩺 内功自检（红线 F · 与上面的预算闸门配套，缺一条就是单向归因）：凡要建议"降目标 ROI / 加预算"去解决消耗低时，
   必须先算 cpc_ratio（该计划 cpc ÷ 全店 ecpc）：≥ 0.8 才可提"降目标"；< 0.5 ⇒ 禁止提降目标/加预算，改写为"修内功"（内功五查）；算不出来（无 clicks / ecpc）⇒ 先补数，不许凭猜给建议。
   理由：形态 B（内功弱）下降目标是加速器不是刹车——系统会放开更宽的口子，灌进更多更便宜的垃圾流量 → CVR 更低、跳失更高 → 越降越烂。
   - ★ 建议的可执行性自检（双向闸门）：
   • 凡建议中出现"拆分 / 拆开 / 按单品改"字样时，回查该计划的 plan_type——若为 store_wide 或 store_wide_filler（全店推广），该建议无效，须改写为可执行动作（提报真实主推品替换凑数品 / 调预算 / 调时段 / 调托管模式 / 关停整条）。
   • 反之，不要看到"多品计划"就一律归为"凑数、不用管"：若单品均摊 ≥2 元/天且有可观成交，它是 multi_manual（多品·经营型），拆分与单品取舍是正确且高价值的动作，不可放过。
   • ★ 渠道迁移自检（红线 D，提建议前必过）：
   • 凡建议中出现"转到 / 换到 / 挪到 / 拿到 XX 渠道去打 / 两个渠道都投"字样时，先问：这个品现在有没有正在跑的渠道？
     —— 有 → 撤回该建议。理由：托管渠道的流量模型不可迁移、两渠道互相抢量、计划累计花费的隐性权重会被清零；实际后果是这个品会死。
   • 要建议关键词推广，只能用"没进过托管渠道的品"（新品 / 未投放品）。
   • 若用户想用关键词拉搜索但手头都是已投放品 → 引导他拿新链接/新品起步，而不是挪爆款。
   • ★ 泛词自检（红线 E）：凡建议里出现"中药材 / 中草药 / 中药"这类不带品名的泛词要投付费时，撤回并改为精准中长尾（品名+规格+场景）；大词只走自然排名。
   • ★ 渠道占用自检（用户问"哪些品能动 / 哪些绝对不能动"时）：把全店计划折算成「品 × 渠道」矩阵后按累计花费分三层——🔴红区（≥100 元）禁换渠道；🟡黄区（<100 元）须区分"有量但浅"（效率高的第一动作是在原渠道加预算，不是换渠道）与"建了没跑"（权重接近干净，但退出仍是一次归零，须用户拍板）；🟢绿区（无计划覆盖）才是新渠道唯一合法起点。绿区需要全店在售商品清单才能算，拿不到就如实说"算不出来"并索要，不许反推填充。详见 references/promo_a_logic.md 第三节之六。

指标口径

见 references/metrics_def.md。两个核心 ROI（务必向用户讲清区别）：
- 推广ROI = 净成交(net_gmv) / 全部推广花费（promotion_spend，缺省回退直通车花费）——只看广告效率；
- 实际利润ROI = 净成交 /（推广费 + 商品成本 + 其他成本支出）——全口径真赚不赚，< 1 即真亏。
- 推广花费分两层展示：首屏是全店汇总（promotion_spend），下方展开各「投放形态」明细（channels[]，按 关键词推广/人群推广/超级直播/超级短视频/货品全站推/全店推广 拆分——不再用「万象台」大筐聚合，脚本自动求和；旧名 直通车/引力魔方/万象台 自动归一兼容；未填形态时按 spend 单渠道兜底）。首屏绝不并列两个花费数字。

其他关键约定：净成交=生意参谋口径扣除退款后的实际成交，算 ROI 更准；保本线运行时由使用者指定（--breakeven，默认 2.0 兜底，auto 模式按边际利润率反推）；实际利润ROI <1 高预警 / 1~1.2 中预警；余额预警默认 100（可配）；CVR 环比下滑 ≥25% 高 / ≥10% 中；预警分级规则见该文件。

店铺配置（通用，不写死）

见 references/store_config_template.md。新增店铺只需复制字段表填写；脚本通过 --breakeven / --balance-warn 覆盖阈值。技能本身不持有任何店铺信息。

数据源与连接器

见 references/data_sources.md。仅抓 T-1 已结算数据，不实时抓当天（避风控）。涉资外部操作（充值等）执行前先获用户确认。

三种调用方式（对话 / 命令行 / 程序化集成）

本技能提供三层调用入口，从"说人话"到"系统集成"均可直接使用，并非只能通过对话触发。

方式 ① · 对话触发（最常用 · 零门槛）

直接用自然语言唤醒，不用记任何命令：
- "帮我看看推广 ROI" / "做个店铺诊断" / "看看人群画像" / "分析流量构成"
- 技能自动引导补数据（连接器拉取或导入表格）→ 跑计算 → 交付 HTML 驾驶舱。

方式 ② · 命令行直调（CLI · 无需对话）

一键入口（推荐）——一条命令从原始数据直接产出驾驶舱：

python scripts/diagnose.py data.json -o report.html --breakeven auto

分步调用（需要中间指标 JSON 做二次分析时用）：

python scripts/compute_metrics.py  data.json     -o metrics.json --breakeven 2.0 --balance-warn 100 --margin-warn 0.10
python scripts/build_dashboard.py  metrics.json  -o diagnosis_dashboard.html --title "店铺诊断驾驶舱"
python scripts/ingest_costs.py     data.json costs.csv -o data_with_costs.json

一键入口 diagnose.py 参数表：

方式 ③ · 程序化集成（API 级 · 供技术用户 / 自动化接入）

退出码契约（供 CI、定时任务、外部系统判断执行结果）：

结构化运行摘要（--json-summary 输出的机器可读结果）：

{ "status": "ok", "exit_code": 0, "input": "...", "html_output": "...",
  "metrics_output": "...", "warnings_high": 10, "warnings_mid": 1, "stores": 3 }

集成示例 · Shell / 定时任务：

python scripts/diagnose.py daily.json -o /var/www/report.html --breakeven auto --quiet
if [ $? -eq 0 ]; then echo "诊断完成，报告已生成"; fi

集成示例 · Python subprocess：

import subprocess, json, sys
r = subprocess.run([sys.executable, "scripts/diagnose.py", "data.json",
                    "-o", "report.html", "--breakeven", "auto",
                    "--json-summary", "summary.json"],
                   capture_output=True, text=True, encoding="utf-8")
if r.returncode == 0:
    s = json.load(open("summary.json", encoding="utf-8"))
    print(s["warnings_high"], s["html_output"])

中间产物契约：metrics.json 的完整结构与字段定义见 references/metrics_def.md，
可被其他系统直接消费（BI 入库、二次分析、自定义渲染），无需依赖本技能的 HTML 输出。

脚本清单：diagnose.py（一键入口）、compute_metrics.py（指标计算）、
build_dashboard.py（驾驶舱渲染）、ingest_costs.py（成本表导入）。

输入字段说明见 references/metrics_def.md；可选传入 cvr_baseline 用于转化率环比预警。
两个 ROI 见第十节第 0 点：推广ROI = 净成交/推广费（已有字段 roi），实际利润ROI = 净成交/(推广费+商品成本+其他成本)（字段 profit_roi，需 cogs/cogs_total + other_cost 才能算出，缺失时为 null 并提示补成本）。
边际利润率与精准保本 ROI 推导见第十节第 1–5 点（products[] 结构与预警分级），实际利润ROI 的输入输出字段见第 6 点。

输出规范

• 单文件 HTML、深色主题、纯 SVG/CSS、无外部链接
• 高/中预警分级 + 「现状+建议」两段式
• 数据勾稽一致，脚注标注来源（合成 / 真实）
• 页脚含版权水印：© 附近的吴彦祖 · 禁止未授权分发/转售

参考文件

• references/metrics_def.md — 指标定义与预警分级（含计划形态五分法、投放形态口径、店铺画像两维度）
• references/promo_a_logic.md — 计划级下钻 A 模块逻辑（第零节 · 店铺画像（第 0 层） + 形态分流 + 五级追问链 + 亏钱标红 + 五条红线）
• references/data_sources.md — 数据源/连接器映射与合规规则（含店铺画像证据包 + 两个创建时间取数法）
• references/connector_setup.md — 自定义连接器搭建 SOP（六步）+ 数据入口清单 NAV_MAP（优先推荐给使用者的取数方式）
• references/faq.md — 常见问题与反模式（反模式 25 条 + FAQ 20 条 + 快速排查表）
• references/store_config_template.md — 通用店铺配置模板
• templates/dashboard_template.html — 深色驾驶舱 HTML 模板
• scripts/compute_metrics.py / scripts/build_dashboard.py — 计算与渲染

版本

• 1.8.0（当前）：吸收「万相台无界投放顾问」官方知识库的权威佐证与维度补全（不越界，仍坚守免费版"只诊断不优化"定位）——① 新增新旧命名映射表（直通车→关键词推广 / 引力魔方→人群推广 / 万相台→货品全站推广 等，报告与建议统一用现名，避免旧称混淆导致误操作）；② 新增货品生命周期视角，把"第 0 层店铺生命周期（新店/老店）"补成第二个正交维度"单品货品生命周期（冷启/成长/爆发/平销）"，让「花钱受阻三形态」分流更准（冷启新品 ROI 低属设计使然，不误判为亏）；③ 用官方互斥/归因规则佐证并加固红线 D（同一商品在货品全站推广只能一条计划、单品计划与全店模式互斥、末次触点归因不重复计算成交），从平台规则层面锁死"挪品/换渠道"操作；④ 统一术语：全店推广 = 货品全站推广-全店模式，并标注「一键起量」为官方放量杠杆（免费版只点破不操作）；⑤ 新增规则来源与时效说明与跨技能分工指引（投放操作类问题交「万相台无界投放顾问」）。来源对齐：万相台无界投放顾问 官方知识库（阿里妈妈 842 篇手册蒸馏）。
• 1.7.0：新增「花钱受阻三形态鉴别」（promo_a_logic.md 第三节之八 / metrics_def.md 零之二）——补上 1.6.0 的单向归因缺口："钱花不出去"不是一种病，A/B 两种形态动作相反。A 出价被掐死（花费 ≈ 0、预算利用率 < 5% ⇒ 降目标）；B 内功弱·捡便宜量（花费在花，但 cpc 显著低于全店 ecpc、CVR 同步垫底 ⇒ 修内功；降目标是毒药）；C 冷启/测款。分流判据 = cpc_ratio = 该计划 cpc ÷ 全店 ecpc（≥ 0.8 → A；< 0.5 → B；灰区看 CVR 是否同步垫底）。新增三件工具：① cpc–CVR 相关性检验（按 cpc 升序分两组比加权 CVR，确认"垃圾流量池"是否存在）；② 内功五查（跳失率 / 人均浏览量 / 平均停留时长 / 定价带 TGI / 动销率）；③ 推广费率 vs 边际利润率 定价联动校验（多数品费率 > 利润率 ⇒ 是定价与承接问题，调投放救不回来）。新增 红线 F（内功未修，禁止用"降目标 / 加预算"治低消耗）+ 自检清单第 12 条；AP-5m / 5n / 5o（反模式 22 → 25 条）；必抓字段 clicks / ecpc / ctr / bounce_rate / pv_per_visitor / avg_stay_sec / onsale_links / active_links。
• 1.6.0：新增「预算利用率与目标达成度」（promo_a_logic.md 第三节之七）——修正一个方向性归因错：看到某计划花费很低时，不能直接说"老板没给钱 / 投不足"（charge 实际花费 ≠ budget 预算，可差 100 倍）。落地三道判据：① 预算利用率 = 花费 ÷ (日预算 × 天数)，≥80% ⇒ 真缺预算（加预算有效）、<20% ⇒ 系统不愿花（加预算完全无效）；② 托管渠道「目标掐死」机制——全站推广 / 全店推广是目标 ROI 驱动，净目标（如 3.7）远高于真实可实现值（如 0.29）时，系统判定"无合格流量"、拒绝出价、预算躺着不动（实测：日预算 5000、日消耗 60.62、利用率仅 1.2%）；③ 目标达成度 = 实际ROI ÷ 净目标ROI，<0.4 = 重度掐死 ⇒ 必须先降目标（降到「真实ROI × 1.1~1.2」），不是加预算。同时修正两处渠道归类错：人工改名计划不带系统前缀（不能只看名字判渠道）、「全店推广」渠道下会拆多个分组计划（各带不同净目标 ROI，极易漏抓）；并把口径差额的优先解释定为"同渠道漏抓分组计划"而非"存在另一个渠道"（实测差额 369.93 元 / 日均 52.85 元，与该店全店分 3 组吻合）。新增必抓字段 daily_budget / net_target_roi；新增反模式 AP-5j / AP-5k / AP-5l（反模式 19 → 22 条）。
• 1.5.4（当前）：新增两项工程化沉淀——① 「渠道占用盘点」（promo_a_logic.md 第三节之六）：回答"哪些品能做跟投 / 哪些品绝对不能动"时，把全店计划折算成「品 × 渠道」占用矩阵，按累计花费分三层——🟢绿区（无计划覆盖，新渠道唯一合法起点）/ 🟡黄区（<100 元，须再切"有量但浅"与"建了没跑"两刀）/ 🔴红区（≥100 元，绝对锁死禁换渠道）；明确它是占用判定、不是选品（老店选品由店主定），并要求绿区算不出来时如实索要全店在售清单而非反推填充。② 「口径校验闸门」（data_sources.md 第五之四节）：计划明细抓取极易漏抓（已删计划 / 分页 / 筛选 / 虚拟滚动），收数后必须用账户口径 + 日粒度口径交叉校验计划口径，差额 > 5% 须显式标注「未覆盖 X 元 / Y 单（占 Z%）」并把"渠道单一"类结论降级为"待核实"。实测教训：某店 20 条计划聚合 2,655 元 vs 账户日报 3,025 元，差额 370 元 / 32 单 / 占 12%——不做这步校验，"全店 100% 单渠道"会以 88% 的成色被当成 100% 讲出去。
• 1.5.3：新增关键词推广「相似品跟投」五方案认知（阿里妈妈官方口径「五大行业解决策略」：新品跟爆 / 相似跟投 / 竞争拉新 / 乘胜追击 / 流失防守）。要点：① 升级后它由出价目标上移为营销目标，操作顺序是「先选方案，再在里面设出价与预算」；② 五个方案只差"锚点选谁"——把你的商品贴到哪个锚点商品的搜索结果附近、抢它的人群；③ 除新品跟爆外均支持设置平均点击成本，但开启后拿量能力下降，官方建议「起量期先不设、稳定期再设」；④ 跟投品建议一次铺 5~10 个（当前上限 40），不要塞满单计划，拆 2 组便于汰换；⑤ 跟投属阶段性拉新/竞争工具（约半个月至一个月），单品达标即关停转常规，不能拿常规投产标准硬套 ROI；⑥ 与红线 D 联动：不得把托管渠道（全站推广）里在跑的品拿来开跟投（两渠道互相抢量 + 累计花费权重清零）。落地：promo_a_logic 新增第三节之五（五方案对照表 + 三个实操要点 + 三条诊断红线）；SKILL.md 核心能力第 1 条同步挂载。
• 1.5.2：新增第 0 层「店铺画像」（前置于一切诊断，未定不往下走）。两个正交维度：① 店铺结构（单品店 / 多品店） → 决定诊断路线（链接深挖线 vs 计划矩阵线）；② 店铺生命周期（新店 / 老店） → 决定选品时该由谁判断——新店 = AI 用生意参谋「流量→商品」搜索渠道转化率选品给客人挑；老店 = 直接问老板"你想推哪个品"，不拿短期数据榜单覆盖其 6 个月+ 经营直觉。新增两个可自动化的取数法：从计划名内嵌 _YYYYMMDD_HHMMSS_ 时间戳反推创建日 + 用 campaignId 相邻锚点分段插值补改名计划（济安阁实测 20 条计划 ID 升序与创建时间严格同序、平均误差 0 天；禁全局线性外推，跨月偏差可达 20+ 天）。判定规则：5 组判据 ≥3 组一致才下判，否则必须问用户，不许猜（猜错是双向代价：把老店当新店 = 冒犯 + 误导 + 可能动到权重品；把新店当老店 = 老板答不上来、流程空转）。同时补齐了长期缺失的店铺结构识别。
• 1.5.1：新增两条暗规则红线——① 渠道锁定原则（红线 D）：一个商品固定在一个推广渠道，绝不要建议跨渠道迁移（"全站推广里跑得好的品，拿出来打关键词推广，这个品会死"）；原因是托管流量模型不可迁移 + 两渠道互相抢量 + 计划累计花费的隐性权重会被清零（平台不写在规则里）。要跑关键词推广只能用没进过托管渠道的品。② 泛词投放禁令（红线 E）：小店不投泛词大词，投"中药材"会被"黄芪中药材"这类搜索命中、叠加最大化拿量 → 精准商品被泛流量点掉、纯浪费；付费只打精准中长尾，大词靠自然排名。同时新增"战略设想回应的传导链校验法"（逐环节追问"物理载体是什么"，如搜索权重是商品级的、能跨品的是店铺人群资产）。
• 1.5.0：合并两条并行演进线——① 「投放形态」渠道口径（关键词推广/人群推广/超级直播/超级短视频/货品全站推/全店推广，旧名自动归一）；② 「计划形态五分法」（单商品/多品·经营型/全店推广·凑数型/全店推广·经营型/智能托管单商品）。两条线维度独立、互不替代：投放形态看"钱花在哪个入口"，计划形态看"单个计划是什么类型"。
• 1.4.6：渠道明细改按投放形态拆分（不再用「万象台」大筐聚合）；引擎新增 CHANNEL_ALIAS 别名归一表。
• 1.4.3：计划形态由「四分法」升级为五分法——新增「全店推广·凑数型」（store_wide_filler）；判形态改为四步（商品数 + 单品均摊花费/天 + 商品是否成体系 + 业务定位）；新增双向可执行性闸门、凑数型低优先级规则。
• 1.4.2：新增计划形态四分法（plan_type）与「建议可执行性自检」。
• 1.4.1：自定义连接器 SOP 与 NAV_MAP 强化。
• 1.4.0：人群画像（基础三维 + TGI）模块。

> 💡 本免费版聚焦「诊断与提问」：把问题摆清楚、把异常标出来；运营优化与经验打法在进阶版中提供。