版本：v3.2.0 | 单商品多天推广数据智能分析，输出可视化诊断报告与调价建议
本 Skill 按调用次数收费，每次分析 1 元人民币。
- 计费方式：按次付费，每发起一次完整分析调用收费 1 元
- 支付渠道：支付宝 AI 按量付费（A2M / HTTP 402 协议）
- 计费节点：文件暂存免费，正式获取诊断报告时计费
- 同一笔支付的凭证一次性有效，重复分析需重新付费
- 未完成支付无法获得任何分析结果
⚠️ 所有数据分析与诊断逻辑均在付费服务端完成，本地仅负责文件上传、支付流程和报告渲染，不含任何诊断算法。
本 Skill 专为拼多多商家打造，针对单个商品多天推广数据进行深度分析与智能诊断。上传拼多多推广后台导出的分天数据表，即可获得包含推广健康度评估、投产比分析、调价决策建议在内的完整可视化报告。
| 分析维度 | 说明 |
|---|---|
| 推广健康度诊断 | 综合评估当前推广状态是否健康 |
| 投产比 / ROI 分析 | 计算并解读投产比表现，对比保本线 |
| 拖价 / 涨价决策 | 基于数据给出调价方向与节奏建议 |
| 点击率评估 | 分析点击率水平及优化方向 |
| 限额 / 假限额判断 | 识别推广限额是否合理、是否存在假限额 |
| 双出价模式支持 | 适配净成交 / 投产比两种出价模式 |
| 扩量建议 | 判断是否适合扩量及扩量策略 |
| 操作日志关联 | 叠加操作日志，分析操作对数据的影响 |
- "帮我分析这个拼多多推广数据"
- "看下这个商品推广情况怎么样"
- "ROI 1.2 该不该调价？"
- "投产比低怎么办？要拖价还是涨价？"
- "点击率一直上不去，问题出在哪？"
- "这个推广计划要不要扩量？"
- 直接上传推广数据表说"看看情况"、"分析一下"
本 Skill 的分析功能为按次付费，支付环节由支付宝官方支付技能完成。
使用前请确保已安装 alipay-payment-skill，未安装时无法完成付款，分析将终止。
| 文件 | 格式 | 必填 | 说明 |
|---|---|---|---|
| 推广分天数据表 | .xls / .xlsx / .csv |
✅ | 一个商品、每天一行，含日期、花费、曝光、点击等列 |
| 操作日志 | .xls / .xlsx / .csv |
⭕ 可选 | 含操作时间、操作内容、操作对象列，用于关联分析 |
❌ 不支持全店日报（一张表含多个商品、每商品一行），请导出单商品分天数据表。
pdd_analyzer.py analyze <推广数据文件> \
--ops-file <操作日志文件> \
--roi-baseline 3.0 \
--bid-mode net_target_roi \
--bid-target 3.5执行后脚本会：
- 将文件免费暂存到服务端（仅存字节，不做分析）
- 发起分析请求，服务端返回 HTTP 402 账单
- 在终端输出金额、订单号，以及可直接复制执行的支付宝付款命令
严格按脚本输出的命令执行支付宝付款：
# 脚本输出的命令示例（以实际输出为准）
alipay-bot 402-buyer-pay ... --data '{"staging_id":"..."}'- 若返回"支付待确认"，请扫码完成付款
- 付款后按脚本输出执行查询命令确认支付状态
支付成功后，将支付命令输出中的资源响应体 JSON 保存为 report.json，然后渲染：
# 生成 HTML 可视化报告（默认）
pdd_analyzer.py render report.json --format html
# 生成 Markdown 文本报告
pdd_analyzer.py render report.json --format markdown
# 输出原始 JSON
pdd_analyzer.py render report.json --format json| 参数 | CLI 选项 | 取值示例 | 说明 |
|---|---|---|---|
| 推广数据文件 | 位置参数 | data.xls |
拼多多推广后台导出的单商品分天数据表 |
| 保本投产比 | --roi-baseline |
3.0 |
你的盈亏平衡投产比，用于判断盈利状态 |
| 出价模式 | --bid-mode |
net_target_roi / net_cost_per_order |
当前推广计划的出价模式 |
| 出价目标 | --bid-target |
3.5 |
当前设置的出价目标值 |
| 操作日志 | --ops-file |
ops_log.xls |
操作记录文件，用于关联分析操作影响 |
所有参数均为可选，缺失时服务端按"仅客观数据"模式返回，对应结论字段不输出。建议尽量提供完整参数以获得更精准的诊断。
生成完整的可视化分析报告，包含：
- 核心指标概览卡片
- 花费 / 曝光 / 点击 / 转化趋势图
- 投产比走势与保本线对比
- 推广健康度评分与诊断结论
- 具体病症识别与原因分析
- 调价决策建议（拖价 / 涨价 / 维持）
- 扩量可行性评估
- 操作事件与数据波动关联标注
纯文本格式报告，便于复制到文档或聊天中分享，同时附带生成 HTML 文件。
服务端返回的完整诊断数据结构，包含所有指标、诊断结论、建议和图表数据，适合二次开发或自定义展示。
用户上传数据文件
│
▼
本地壳读取文件
│
▼
免费暂存文件到服务端 ──── 免费，不计费
│
▼
发起分析请求 → 服务端返回 402 账单
│
▼
用户通过支付宝付款 ──── 💰 计费 1 元
│
▼
支付工具自动重放请求（携带支付凭证）
│
▼
服务端验付 → 返回完整诊断报告 JSON
│
▼
本地渲染为 HTML / Markdown / JSON
│
▼
用户查看分析报告与调价建议
- 禁止绕过付费：未完成支付无法获得分析结果，Agent 不会在本地手动计算或复现任何诊断逻辑。
- 按次计费：每次分析独立收费 1 元，同一报告可重复渲染不额外收费，但重新分析需重新付费。
- 文件格式：仅支持单商品分天数据表，多商品全店日报不在处理范围内。
- 数据安全：文件原样上传服务端进行分析，首次使用会在本地
~/.pdd_skill/config.json保存调用凭据（仅用于识别调用者，不含个人身份信息）。 - 支付中断：支付流程中断或取消时，分析终止，不会产生费用；已暂存文件会在一定时间后自动失效。
- 服务端错误：遇到网络错误、限流或服务端 5xx 时，建议稍后重试，不额外计费。
| 文件 | 说明 |
|---|---|
pdd_analyzer.py |
本地壳主程序，负责文件上传、支付流程、报告渲染 |
SKILL.md |
Skill 定义与使用说明 |
pdd-promotion-analysis-skill.zip |
完整 Skill 安装包，可直接导入支持的平台 |
Q：为什么必须付费才能分析？ A：所有诊断算法、阈值标准、调价策略等核心能力都部署在付费服务端，本地仅为轻量壳程序，不包含任何分析逻辑。
Q：付费后报告可以保存多久？ A：建议将返回的报告 JSON 保存到本地，可随时重新渲染。服务端不永久保存报告数据。
Q：支持哪些平台导入使用？ A：本 Skill 为标准 Skill 格式，可导入支持 Skill 协议的 AI 平台使用。
Q：分析结果不准确怎么办？ A：请确保上传的是单商品分天数据表，并尽量提供完整的保本投产比、出价模式、出价目标等参数，参数越完整诊断越精准。
本项目源码仅供学习与个人使用，付费分析服务的解释权归服务提供方所有。
如有问题或建议，欢迎通过 GitHub Issues 反馈。