货代商物流决策看板生成器

概述

此技能从一个跨境物流发货汇总表（Excel）中提取全量数据，清洗价格和日期字段，自动计算缺失的时效天数， 然后生成一个自包含的交互式 HTML 可视化看板。看板支持渠道分组切换、仓库/发船日期筛选、时效与价格权重调节， 并通过归一化加权评分自动推荐最优货代商。

使用方式

输入

• Excel 文件路径：用户的发货汇总表，包含多个 sheet，每个 sheet 代表一个渠道分组。 各 sheet 需包含以下列（列名精确匹配，详见 references/column_mapping.md）：
  • 货代名称、单号、运输渠道、目的国家、亚马逊仓库/沃尔玛仓库
  • 起飞/开船/开车日、到港日期、签收入仓日、总时效天数、单价、是否查验
• 输出路径（可选）：HTML 看板的保存路径，默认与 Excel 同目录。

执行

运行 scripts/build_dashboard.py 脚本，传入 Excel 路径和可选的输出路径：

python scripts/build_dashboard.py EXCEL_PATH [--output HTML_PATH]

脚本会自动完成以下步骤：

1. 读取 Excel 所有 sheet（跳过"说明"等非数据 sheet）
2. 自动检测并映射列名（精确匹配，归一化空白+忽略大小写）
3. 清洗价格字段（如 "11.88/kg" → 11.88）
4. 计算缺失的时效天数（通过发船日→签收/到港日推算）
5. 将数据序列化为 JSON 并嵌入 HTML 模板
6. 输出自包含的 HTML 看板文件

输出

• HTML 文件：自包含的交互式看板，无需服务器，浏览器直接打开即可使用。 包含以下功能模块：
  • 渠道分组选择器（多货代对比的渠道排前面）
  • 亚马逊仓库 + 发船日期二级筛选
  • 时效/价格权重滑块（实时更新推荐）
  • 货代商卡片（评分、均值、范围、查验率）
  • 散点图（时效 vs 价格，每点=一票货）
  • 时效/价格分布图（min~max、Q1~Q3、中位数）
  • 平均时效/单价柱状图
  • 按发船日期的时效趋势线图
  • 明细数据表
  • 综合评分排名推荐表

注意事项

• 脚本依赖 pandas 和 openpyxl，执行前确保已安装（脚本会自动尝试安装）。
• 列名检测采用精确匹配（归一化空白+忽略大小写后完全相等），不做子串/模糊匹配，避免误命中。
• 看板中的图表使用 Chart.js CDN，需联网加载。如果完全离线使用，需将 Chart.js 下载到本地引用。
• 价格字段支持多种格式："11.88"、"11.88/kg"、"11.88元/kg" 等，脚本会提取第一个数字。
• 时效天数缺失时，脚本会尝试用 签收入仓日 - 起飞/开船/开车日 推算；若签收日也缺失则用 到港日期 - 起飞日。