拼多多售后轻量版看板 Skill
把「PDD 售后报表（Excel / CSV）」直接变成「轻量版分析看板 HTML」。
不扫码、不登录、不爬取 —— 纯表格分析 + 看板生成，秒级出结果。
何时使用
- 用户手头已有 PDD 商家后台导出的售后报表（官方 Excel，或同列名的 CSV）。
- 用户想要退款原因分布、各分类占比、退款时长、秒拍秒退等分析，并看可视化看板。
- 用户明确不需要登录扫码、不需要爬聊天记录 / 商品主图 / 整改建议（即「轻量版」）。
- 不适用于：需要从网页实时抓取最新数据、需要聊天记录原文或商品主图（那是完整「全量版」，走原项目
main.py流程）。
输入要求
报表文件（.xlsx 优先；.csv 需与官方 Excel 同列名）：
| 必需列（中文） | 说明 |
|---|---|
| 售后编号 | 唯一标识 |
| 订单编号 | 关联订单 |
| 退款类型 | 退款 / 退货退款 / 换货 / 补寄 |
| 订单状态 | 未发货 / 已发货 等 |
| 交易金额 / 退款金额 | 金额 |
| 申请时间 / 同意退款时间 | 时长计算 |
| 买家 / 商品ID / 备注 | 展示 |
可选：一份订单 CSV（含「订单号、支付时间」等）通过 --orders-csv 传入，
用于 VLOOKUP 补「支付时间(成团时间)」，让退款时长 / 秒拍秒退可计算。
使用方法
# 1) 进入脚本目录
cd <skill>/scripts
# 2) 用 Excel 报表生成（推荐）
python make_dashboard.py "路径/售后报表.xlsx" \
--orders-csv "路径/订单.csv" \
--shop "DR_JEVEITAL洁维塔博士个护官方旗舰店" \
--out "输出.html"
# 或：直接喂 CSV
python make_dashboard.py "路径/售后报表.csv" --out "输出.html"
# 跳过订单 VLOOKUP（不补支付时间）
python make_dashboard.py "报表.xlsx" --no-vlookup
- 不传
--out时，看板输出到scripts/outputs/after_sales_dashboard_<时间>_shop-<店铺>.html。 - 依赖：Python 3.10+ 与
openpyxl（pip install openpyxl）。 - 看板 HTML 用 Chart.js CDN，打开时需联网加载图表库。
输出
- 单个自包含 HTML 文件（内联 CSS/JS）。
- 头部标有红色「轻量版」徽章，明确不含聊天记录 / 商品主图 / 整改建议。
- 含：核心指标卡（总单数 / 退款总额 / 退款成功率 / 秒拍秒退等）、各原因售后单数柱状图、
各分类原因占比饼图、分析结论（按分类 tab 切换）、可搜索的售后明细表。
实现说明（维护者须知）
- 本 Skill 是「轻量版分析 + 看板」链路的独立快照，自包含于
scripts/内，
不依赖主项目的登录 / 爬虫代码（browser.py/after_sales.py/ Playwright 均未引入）。 - 模块闭包：
config / common / dashboard / analyzer / scraper，相对 import 结构与主项目一致。 config.py已精简：去除app_runtime依赖与所有爬虫常量（PDD 登录 URL、浏览器配置等），
路径以 Skill 目录为基准，可用环境变量PDD_LW_OUTPUT/PDD_LW_REPORT覆盖。learned_rules.py的数据文件落在scripts/data/learned_rules.json（种子规则首次运行自动写入）。- 分类定义与退款原因关键词库来自主项目
config.py，如主项目更新了分类/关键词，
需手动同步scripts/config.py，否则分析口径会偏离主项目。
触发话术示例
- 「用这份 Excel 出个售后看板」
- 「把 CSV 表格分析一下，生成轻量版看板」
- 「不要爬了，直接拿我导出的报表做看板」
