物流决策看板

解决什么问题

跨境物流通常会把一个渠道或目的国的业务放在 Excel 的同一个 Sheet 里，数据里既有货代、承运商，也有渠道、船名、起飞/到港/入仓时间、单价和查验标记。管理者真正想回答的问题不是“哪家货代总体更好”，而是：在相同船名、相同起飞日、相同到港日的可比条件下，哪家货代或渠道更优。

如果只看整页平均，小样本货代可能因为只接了一票顺路货而虚高；如果只看价格，又可能忽略时效和查验带来的隐性成本；如果让运营手动做透视表和图表，口径又容易不一致。这个技能的目标就是把这些判断固化成一个可复现的 HTML 决策看板。

技能如何工作

它的核心流程是“上传 Excel + 发送精确指令”：

• 用户在同一轮对话中上传发货汇总表 Excel（.xlsx / .xls），并发送精确提示词 请生成对应决策看板。
• 脚本运行 build_forwarder_dashboard.py，默认在 Excel 同目录输出 _货代择优决策看板.html。
• 读取所有 Sheet，跳过 说明 / README / 目录 / 索引 等非数据页。
• 列名支持别名和关键词模糊匹配，例如 承运商、运输方式、价格/kg、入仓签收日 也能对应到标准字段。
• 清洗单价中的首个数字，解析日期；总时效天数 缺失时按 签收入仓日 - 起飞日，再退到 到港日 - 起飞日 推算。

择优的关键不是简单平均，而是先构造可比批次：

• CA / US 使用 亚马逊仓库|船名|起飞日|到港日。
• UK / DE / FR / AU 使用 亚马逊仓库|起飞日。
• 其他无国家前缀的 Sheet 使用 船名|起飞日|到港日。
• 同批次只有存在 ≥2 个不同货代时，才记为可比批次并参与推荐。

看板前端是实时计算的：

• 按 Sheet 分页切换，不同渠道或国家分组互不混算。
• 总时效天数、是否查验、单价三个权重使用滑块调节，并自动平衡到 100%。
• 评分在当前 Sheet 内做最小-最大归一化，方向都是“越低越好 → 得分越高”。
• 某条记录缺失某个指标时，该指标不参与该条记录的加权，得分由其余可用指标折算。
• 提供“样本数≥2才参与排名”开关，用来过滤小样本虚高。
• 输出包括最优货代、最优渠道、时效 vs 单价散点、平均时效/单价柱状图、对比批次明细和可搜索的原始明细。

适用边界与注意点

它适合已经按 Sheet 拆分渠道/国家分组的结构化发货汇总表，并期望得到离线 HTML 看板。输出自包含，图表是原生 SVG，不依赖外部 CDN，浏览器直接打开即可长期保存。

需要注意几点：

• 触发条件非常严格，数据表和精确指令必须在同一轮同时成立；上一轮上传的文件不会延续到本轮。
• 提示词必须一字不差，多一个空格、少一个字符或改成“仪表盘”都会触发报错。
• 评分只是结构化口径下的择优参考，不自动纳入爆舱、甩柜、异常赔付、旺季运力等未在表中体现的业务因素。
• 如果某个指标在一个 Sheet 内全部相同，该指标对所有人得分相同，不会产生区分度。

换新版 Excel 时重新上传并触发生成即可，不需要手工改模板。