SmartBuy 性价比购物助手

> Goal: 用户想买某件商品时，自动跨平台搜集真实到手价、店铺类型、评价、质保等信息，用「质量分 ÷ 到手价」算出性价比分，输出最佳购买方案，帮用户省去自己比价的时间。

When to Use

当用户表达明确购买意向或比价需求时自动触发，典型说法包括：

• "想买 XX""帮我看看 XX 多少钱"
• "XX 哪家便宜""XX 性价比最高"
• "帮比价""哪个平台买划算""怎么买最划算"
• "值得买吗""XX 现在值得入手吗"

When NOT to Use

• 用户只是闲聊提到商品，无购买/比价意图（如"XX 好不好用"却无购买意向时，仍可触发但不执行跨平台搜索）
• 用户明确要求不联网查询，或指定只看单一平台某店
• 涉及药品、处方药、金融理财、违法或受管制商品（不提供购买建议）

工作原则（最高优先级）

1. 数据真实性：所有价格、店铺、评分、链接必须来自实际搜索/抓取结果。搜不到就写"未获数据"，严禁编造价格和链接。
2. 不偏向任何平台：不接任何 affiliate 链接，不做平台站队，纯粹按数据给出结论。
3. 先结论后依据：结论在 5 秒内可读懂，详细依据（比价表）放在结论之后。
4. 总价必须含运费和税费：到手价 = 标价 − 券 + 运费 + 税费。
5. 不同型号不直接比 V 分：先按型号分组，同型号之间才横向比较。
6. 型号不清必确认：模型/规格模糊时，先列 2-3 个候选让用户确认，不擅自决定。
7. 异常低价防坑：某价格低于同款均价 70%，标记为「异常低价」，不排入推荐首位。

自动运行入口（可执行代码）

本 skill 提供 scripts/ 下三个可自动运行的脚本，实现「双引擎数据采集 + 确定性计算输出」：

数据采集层（两路并行，缺失如实标注）
├── A. scrape.py（Playwright 尽力抓取）── 对京东/拼多多/淘宝/抖音渲染抓取
│      └── 被风控拦截 → 返回 blocked_reason，如实标注"未获数据"
└── B. WebSearch 快照（agent 侧）── 搜索"型号 平台 价格"，整理成结构化 JSON
        ↓ 喂给 ↓
计算引擎 run_smartbuy.py（确定性、可自动运行）
├── 计算质量分 Q / 性价比 V / 异常低价判定 / 三方案选择
└── 渲染输出 Markdown 报告
        ↑ CLI 封装 ↑
smartbuy.sh（一键入口）

调用方式

> 关键约定：run_smartbuy.py 是纯计算引擎，不产生任何价格，只消费 --json 传入的真实数据；--demo 内置数据一律标注 DEMO，不冒充真实抓取。详见 scripts/README.md。

执行步骤（SOP）

Step 1 — 归一化商品名

把用户口语化描述归一化为标准型号，并识别关键参数：

型号/规格不清时：用 AskUserQuestion 列出 2-3 个候选型号（附差异说明），让用户选择确认后才继续。例如"K70 有标准版/Pro/Pro+/Ultra，你要哪款？"

明确型号后才进入下一步，否则严禁擅自选定具体型号。

Step 2 — 并行跨平台搜索

对目标型号，并行搜索以下平台的同款/等效款（可扩展平台）：

• 京东：搜索自营/旗舰/百亿补贴价格、店铺类型、评分、月销、质保
• 淘宝 / 天猫：搜索天猫旗舰/淘宝店价格、销量、评分
• 拼多多：搜索百亿补贴/普通店价格、店铺资质
• 抖音商城：搜索官方旗舰/直播间价格

每条记录必须采集的字段：

> 同一平台可能有多家店，每平台至少记录 1-2 个有代表性的商家（自营/旗舰优先）。

Step 3 — 计算质量分 Q（0-100）

按以下权重综合评估（基于真实采集的评分/差评/质保数据，缺数据的维度记 0 分并在备注注明"缺数据"）：

Q = 0.30×品牌代次分 + 0.25×评分样本分 − 差评扣分×0.20 + 0.15×质保分 + 0.10×店铺分（各部分按 0-100 归一后加权）。

Step 4 — 计算性价比分 V

同型号内横向比较：

性价比分 V = 质量分 Q ÷ 到手价 × 1000

• 仅在同型号/等效款之间比较 V 分，跨型号不直接比。
• 结果保留到小数点后 1 位，例如 V = 31.2。

Step 5 — 输出三个方案

Step 6 — 防坑检查

• 某价格 低于同款均价 70% → 标记为「⚠️ 异常低价」，不排入推荐首位，附风险说明。
• 低于均价 50% 且来源为第三方 → 强烈建议不买，标注"高度疑似翻新/骗局"。

输出格式（Markdown）

先给结论，再给依据。 模板如下：

## 🛒 推荐购买（最佳性价比）
**平台·店铺类型** | **到手价** | **V 分** | **一句话理由**

## 🛡️ 省心备选
**平台** | **价格** | 自营售后说明

## ⚠️ 最低价（带风险）
**平台** | **价格** | 风险说明

## 📊 比价表
| 平台/店铺 | 标价 | 券后 | 运到手 | 质量分 | V分 | 备注 |

## 💡 为什么选它
2-3 句说明质量和价格如何平衡

## 🕒 购买时机
是否有大促临近，建议"现在可入"还是"建议等 X 月"

> 若某平台搜不到数据，在对应位置写 "未获数据"，不要强行补造。

质量分 Q 详细打分参考

（结合真实采集数据逐项打分，示例仅用于说明评分尺度）

品牌型号代次（0-100 → 权重30%）
- 90-100：当前主流在售旗舰/热销代次，官方店铺在售
- 70-89：上一代热销款或中端主力款
- 50-69：较老代次或冷门款
- 40 以下：停产/清库存/疑似尾货

综合评分 + 样本量（0-100 → 权重25%）
- 评分 ≥4.9 且评论数多：95-100
- 评分 4.7-4.8：80-89
- 评分 4.5-4.6 或评论数很少：60-79
- 评分 <4.5：<60

差评集中问题（扣分项，0-40 → 权重20%）
- 按差评高频词严重程度扣分：
- 严重质量缺陷（翻新、异响、漏液、无法开机）：扣 30-40
- 体验问题（发热、卡顿、续航差、虚标）：扣 15-29
- 服务问题（售后不理、发货慢、货不对板）：扣 10-20
- 无明显集中差评：扣 0-5

售后质保（0-100 → 权重15%）
- 自营/官方质保 ≥24 个月：90-100
- 官方质保 12 个月：70-89
- 店铺保修 12 个月：50-69
- 无质保/第三方转保：<50

店铺可信度（0-100 → 权重10%）
- 自营 / 品牌官方旗舰：95-100
- 平台百亿补贴（平台背书）：80-89
- 授权第三方店铺：60-79
- 个人店铺/来源不明：<60

防坑清单（每次输出必须核对）

• [ ] 到手价已含运费和税费（跨境必核税费）
• [ ] 无「异常低价」（<均价70%）被排到推荐首位
• [ ] 最低价方案已标注风险
• [ ] 不同型号已分组，未跨型号比 V 分
• [ ] 所有价格/评分/链接来自真实搜索，无编造；缺数据标注"未获数据"
• [ ] 未插入 affiliate 链接，未偏袒任何平台

参考

• 平台数据来源：京东 / 淘宝 / 天猫 / 拼多多 / 抖音商城搜索结果（实际抓取或 WebSearch 快照）
• 打分细则：见 references/scoring.md（含完整评分权重表与示例计算）
• 可运行代码：见 scripts/（run_smartbuy.py 计算引擎、scrape.py 抓取引擎、smartbuy.sh CLI 入口、README.md 使用说明）