Release Notes (2026-10-06)

✨ 重点 Feature

物流风险中心「市场风险」恢复可见（QuoteGo / QuickPoint 联动）

• QuickPoint：「风险中心 → 物流风险」中的「市场风险」页签恢复显示，展示各市场（目的地）的热力图：订单数、异常率、平均送达时效与主要阻塞原因，支持按市场 / 客户 / 承运商切换维度，并按订单数、异常率、时效排序。仅「预警队列」页签保留搜索与过滤项，「市场风险」「自动化」页签不再显示该过滤项。
• QuoteGo：为市场风险页签提供数据；其中平均送达时效改为从「发货时间」起算（以运单号上传时间为准），不再从订单创建时间起算，避免备货时间混入时效统计。
• 当某市场在近 90 天内没有可用的已签收数据时，平均送达时效显示为 N/A（排序时按 0 处理），不再显示 0.0 小时。

物流风险中心 — 市场风险

查看维度：按市场　排序：异常率 · 降序

市场	订单数	异常率	时效(小时)	主要阻塞原因
美国	1,286	3.2%	96.5	清关延误
德国	421	5.7%	N/A	末端派送慢
英国	389	2.1%	72.0	—

时效显示 N/A 表示近 90 天该市场暂无已签收订单数据；时效已改为从发货时间起算。

AI 助理新增成本毛利报表查询（QuoteGo）

• 商家在已接入的 AI 助理（MCP）中，可直接查询指定周期的发货成本、营收、毛利与每日明细，无需再手动导出核对。
• 可选周期：当天 / 过去 7 天 / 过去 30 天 / 本月 / 自定义区间；自定义区间最长为 180 天，超出时会提示缩小范围。
• 查询结果按商家所在时区聚合，口径与商家端「订单报表」页面保持一致。

AI 助理 — 成本毛利查询

你：帮我查一下本月到目前为止的发货成本和毛利

AI 助理：已按你的时区汇总本月订单报表（截至 10-06）：

项目	金额
营收	$ 12,480.00
成本	$ 8,320.00
毛利	$ 4,160.00

支持当天 / 过去 7 天 / 过去 30 天 / 本月 / 自定义区间；自定义区间最长 180 天。

🚀 其他 Feature

工单列表排序改为「待回复」优先

• 工单列表中，等待货代回复的客户工单会排在前面：只要某张工单的最新一条消息来自客户，就视为待回复，无论该消息是否已被货代读阅。
• 同为待回复的工单，按客户最近一次回复时间从新到旧排列；其余工单按创建时间从新到旧排列。
• 「待回复」与「未读」不同：已读但尚未回复的工单同样会靠前，货代回复后自动移出该优先级。

工单列表 — 待回复优先

工单	状态	最近消息
#T0012 包裹丢失	待回复	客户 10 分钟前
#T0011 账单异议	待回复	客户 2 小时前
#T0009 商品破损	已回复	货代 1 天前

等待货代回复的工单排在最前（不论是否已读），回复后自动下移。

订单费用详情展示 Shopify 变体 ID

• 订单费用详情弹窗左侧的源订单商品，除商品名称、规格外，新增展示对应的 Shopify 变体 ID，便于与订单商品逐项核对映射关系。

订单费用详情 — 源订单商品

无线蓝牙耳机

蓝色 / 标准版

变体 ID：43821567890123

账单预览新增访问期限提示，并优先跟随浏览器语言

• 分享出去的账单预览页在顶部新增提示：账单链接含 30 天免密访问期，超过 3 个月的账单将无法查看和下载订单明细，建议提前下载 Excel 备份。该提示仅在订单账单且未归档时显示。
• 账单预览页的展示语言改为优先跟随浏览器语言（中文 / 英文），无法识别时回退到当前语言设置。
• 账单预览页内容区的最大宽度调整为 1280px，在宽屏下更易阅读。

账单预览 — 访问期限提示

提示 账单链接含 30 天免密访问期；超过 3 个月的账单将无法查看和下载订单明细。如需备份，请提前下载 Excel 保存。

🐛 重大 Bug Fix

平均配送时效计算口径修正

• 此前部分市场的「平均送达时效」从订单创建时间起算，会把备货、等待发货的时间一并计入，导致数值偏高。本版改为从发货时间（运单号上传时间）起算，仅统计已签收订单。
• 缺少发货时间或暂无签收数据的记录不再参与平均，避免产生误导性数值；对应市场显示 N/A。

♻️ 重构 / 移除

• 本版无面向用户的移除或废弃功能。
• 内部将成本报表聚合逻辑抽为共享实现，商家端「订单报表」与 AI 助理查询使用同一套计算口径（用户侧无感知）。

🧱 数据库 Schema 变更（需执行迁移）

本版无数据库结构变更，无需执行迁移。

⚠️ 部署注意

1. QuoteGo 与 QuickPoint 需同版本发布 v5.4.0：市场风险页签与配送时效 N/A 依赖后端新响应。若前端先上线、后端仍为旧版，市场风险页签可能无数据，时效也可能显示异常。
2. 无需执行数据库迁移：本版未新增迁移脚本，无需运行 ./quotepilot migrate。
3. AI 助理成本毛利查询需后端更新后生效：后端发布后，已在 AI 工具中配置 MCP 的商家重新加载 / 重连工具列表即可看到新工具（部分客户端有工具缓存）。
4. 配送时效口径变更影响历史对比：改版前显示的时效可能偏高（含备货时间），改版后仅统计有发货时间的已签收订单；跨版本对比数据时请注意口径差异。
5. droppilot 本版无变更，无需发布。

---

本版涉及的提交（技术信息）

• QuoteGo（5 commits，head a2980a9）：0b4dd7a AI 助理新增成本毛利报表查询并共享商家聚合逻辑、173e68c 修正平均配送时效基准为发货时间、ccf98c3 合并 way_bill_final2_heatmap、8178f3b 合并 way_bill_final2_ai_add_cogs、a2980a9 Merge tag 'v5.4.0'
• QuickPoint（9 commits，head bda9878）：e28ab48 工单列表排序改为待回复优先并抽取回复状态工具、a80ce6f 订单费用详情左侧源订单商品展示 Shopify 变体 ID、9089d9f 账单新增访问期限提示并按浏览器语言优先展示、f27583a 5.4.0、5c943e6 合并 way_bill_final2_heatmap、1d41e8b 市场风险 Tab 下隐藏预警队列搜索过滤项、17fdb5e 恢复风险中心市场风险 Tab 可见并加载热力数据、b448c69 物流风险中心时效为空时显示 N/A 且按 0 参与排序、bda9878 Merge tag 'v5.4.0'
• droppilot：无变更