拼多多售后轻量版看板 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 表格分析一下，生成轻量版看板」
「不要爬了，直接拿我导出的报表做看板」