Release Notes (2026-10-16)

✨ 重点 Feature

报价单「关联使用」（QuoteGo / QuickPoint 联动）

报价历史列表的每条报价单新增「关联使用」标识，用于判断该报价单是否已被映射规则引用。

• 被引用时显示「已使用 · N 条规则」，未被引用时显示「未被引用」。
• 点击徽章展开浮层，逐条列出引用它的映射规则：店铺变体 → 命中的报价产品、所属店铺与客户、以及规则是启用还是停用；命中的报价产品若没有名称则显示 SKU。
• 列表顶部新增「全部 / 已使用 / 未被引用」筛选，作用于当前页。
• 报价单查看页在页头也显示该标识（仅登录状态展示，公开分享链接不展示）。

报价历史 — 关联使用

报价单 QP123　已使用 · 2 条规则

报价单 QP456　未被引用

被以下映射规则引用

店铺变体	报价产品	状态
Earbuds Pro (Black)	SKU-A1	启用
Old Fan	SKU-A2	停用

顶部可按「全部 / 已使用 / 未被引用」筛选当前页报价单。

物流目的地新增备注，国家代码在同一线路内唯一（QuoteGo / QuotePilot 联动）

物流目的地新增「备注」列（选填，纯文本），用于记录该目的地的补充说明。

• 目的地列表与编辑弹窗均可填写、查看备注；展开目的地详情时也会展示备注。
• 导入 / 导出模板新增「备注」列，导入时随其它数据一并覆盖（留空即清空）；旧模板没有该列时按空处理，仍可正常导入。
• 同一线路下的国家代码唯一：重复导入同一国家会覆盖原记录而不是新增；手动新增已存在的国家代码会被拦截并提示「该国家代码已存在，请直接编辑已有目的地」。
• 存量重复的国家代码记录会在升级时自动合并（保留有价格阶梯的一条），代码统一为大写。

物流目的地 — 备注

代码	名称	备注	更新时间
US	美国	小包专线	2026-10-15 10:20
DE	德国	-	2026-10-13 09:00

同一线路下国家代码唯一；重复代码的导入会覆盖、手动新增会被拦截。

订单拆分支持合并回一个包裹（QuoteGo / QuickPoint 联动）

拆分订单弹窗现在支持手动合并回未拆分状态。

• 包裹 2 起的每个包裹右上角都有「移除包裹」按钮，移除后订单回到一个包裹；只有一个包裹时提交按钮显示为「合并」。
• 调整某个商品数量时，差额会优先从「数量最多的包裹」扣减或回补，数量最多的包裹不足时顺延到下一个，减少来回手动调整。

拆分订单 — 合并回一个包裹

商品	包裹 1
T-Shirt (Blue)	2
Hat	1

移除多余包裹后，按钮变为「合并」，提交即回到未拆分状态。

库存「采购」列拆分为未入库 / 已入库（QuoteGo / QuotePilot 联动）

库存列表的「采购」列不再只显示一个总数，改为「未入库 / 已入库」两个数字，且均不含已取消的采购记录。

• 表头新增说明「采购记录数：未入库 / 已入库（不含已取消）」。
• 仍保留原有的采购记录入口与待确认签收角标。

库存列表 — 采购记录数

商品	采购（未入库 / 已入库）
无线充电套装 A	3 / 2

「采购」列拆分为「未入库 / 已入库」，不包含已取消的采购记录。

🚀 其他 Feature

订单导出 Excel（QuickPoint）

订单工具栏新增「导出订单」，把已选订单导出为 Excel 文件（.xlsx）。

• 跨分页选择时会以缓存订单为准并补全运单号，保证导出内容完整。
• 导出列包含：序号、订单号、Shopify 订单、店铺、下单时间、账单状态、物流状态、售价、收件人、电话、收货地址、国家、目的地、物流渠道、运单号、地址异常、标签、备注、订单商品。
• 一个订单有多个商品时，会在「订单商品」同一单元格内分行展示。文件名带店铺与导出时间。

订单 — 导出订单

已选 3 个订单　导出订单

订单号	账单状态	物流状态	运单号	订单商品
#1001	已结算	已打单	TN-1	T-Shirt (Blue) SKU-1 × 2

多商品在同一「订单商品」单元格内分行展示。

物流面单支持补打（QuickPoint）

物流队列的「打印面单」入口从「待打单」扩展到「已打单 / 已发货 / 已签收」。

• 只要订单有申请运单成功的包裹即可补打，不受账单状态或搁置影响，已退款 / 已取消的已发货订单同样可以补打。
• 补打完成后只打开面单文件，不再弹「确认已打印」；待打单批次仍会弹确认，以回写打印状态。

订单 — 补打面单

已打单已发货已签收 队列均可使用「打印面单」补打

补打只打开面单文件；待打单批次仍需确认回写。

物流更新时间逐层聚合与排序（QuotePilot）

物流渠道、线路、目的地的「更新时间」改为逐层聚合展示。

• 目的地更新时间取其自身与所有价格阶梯中的最新值；线路取自身与所有目的地中的最新值；渠道取自身与所有线路中的最新值，反映该节点的整体数据新鲜度。
• 目的地表格新增「更新时间」列，点击列头可在最新 / 最旧间切换排序。
• 左侧渠道 / 线路树新增「按更新时间排序」按钮，选中后渠道与线路均按更新时间降序排列；按更新时间排序时不可拖拽排序。

物流管理 — 更新时间

云途物流

更新于 2026-10-15 12:30

└ US专线

代码	更新时间
US	2026-10-15 12:30

渠道 / 线路的更新时间取其下方所有内容（含阶梯）中的最新值；点表头可切换最新 / 最旧排序。

物流渠道下拉按货物属性分区（QuotePilot）

订单行等处的物流渠道下拉新增按货物属性分区展示：普货 / 特货 / 敏感货 / 仿牌 / 其他按固定顺序分区，段内仍保持价格升序；未填属性的线路并入「其他」。

• 只有存在多个属性分区时才显示分区小标题；仅单一属性时不显示。
• 物流公司分组胶囊与属性分区小标题可同时存在。
• 下拉列表最大高度加大，并优化了贴近窗口底部时的展开方向与留白，减少被窗口边缘遮挡。

物流渠道下拉 — 按货物属性分区

搜索渠道…

普货

华东 / 普货便宜线　¥5.00

敏感货

华东 / 敏感便宜线　¥8.00

其他（未填属性与「其他」合并）

订单高级筛选改为浮层（QuickPoint）

订单的「更多」高级筛选从向下展开的内联面板改为悬浮浮层，浮于列表之上，不再把订单列表往下挤。

• 浮层内新增固定定位与视口自适应；点浮层外部或按 Esc 收起，随页面滚动 / 窗口缩放重新定位。
• 高级筛选按钮与「清空筛选」按钮均显示生效条目数角标。
• 浮层底部按钮由「确定 / 取消」改为「搜索 / 重置」：「重置」立即清空本面板所有高级条件并生效（无需再点搜索），「搜索」应用当前填写内容。
• 变体组合过滤：存在未选择变体的空行、或填写了非正数的商品数量时，「搜索」会阻止提交并提示。

订单 — 高级筛选

更多 2　清空筛选 3

国家筛选：美国 ×

虚拟发货：仅虚拟发货

重置　搜索

浮层浮于列表之上，不再把订单列表往下挤；点外部或按 Esc 收起。

已退款 / 已取消订单可移入搁置（QuickPoint）

订单的「已退款 / 已取消」视图新增「移入搁置」，可将不再跟进的终态订单收起，归入「已搁置」。

账单统计仅组织所有者可见（QuickPoint）

账单页顶部的「累计结算金额」等账单统计卡片改为仅组织所有者可见；成员不再看到统计卡片，也不会拉取统计数据。

网页标题跟随选中模块（QuotePilot）

浏览器标签页标题跟随左侧栏选中的模块显示，格式为「模块名 - 应用名」；无选中模块或退出应用时回退为应用名。应用名支持通过环境变量配置，未配置时回退为 QuotePilot。

拣货单显示内部备注并支持多行（QuoteGo）

拣货单上的「备注」改为读取订单的内部备注，并支持多行展示（保留换行），过长时截断加省略号；续页不再重复备注。

订单确认后费用明细显示库存商品名称与 SKU（QuoteGo）

确认订单后，费用明细中的客户自有库存商品会显示商品名称与 SKU，不再显示一段内部编号。

物流配置页税号布局与页签视觉（QuotePilot）

物流商配置中的欧盟 IOSS 与挪威 VOEC 税号合并为一张卡片，标题与输入同行、宽屏下两列并排，纵向占用更紧凑；物流页面顶部三个页签改为品牌色加粗并带底部指示条。

手机端扫码入库提示可点击跳转（QuotePilot）

采购记录中「后续签收与入库请在手机端『扫码入库』页面完成」的「扫码入库」变为可点击链接，直接打开手机端入库页面。

🐛 重大 Bug Fix

同一履约地点拆成多个履约单导致无法发货

修复同一订单、同一履约地点被拆成多个履约单时，发货回写报「跨履约单」失败的问题。现在同一地点的多个履约单会合并为一次发货；跨地点的履约单仍会按原有规则拦截。

筛选条件变更后已选订单未清空

修复订单筛选条件变更后仍保留之前已选订单的问题（此前批量操作可能误作用到筛选前的结果）。现在筛选条件变化会自动清空已选订单。

♻️ 重构 / 移除

• 高级筛选按钮文案调整：高级筛选面板内的「清除高级筛选」按钮移除，由面板底部的「重置」承担；「确定 / 取消」改为「搜索 / 重置」。
• 订单状态数量统计提速：订单各状态数量统计改用更合适的索引查询，大店铺下加载更快。

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

本版共 2 个迁移脚本，按时间戳顺序执行，命令：./quotepilot migrate

• 2026101401_add_channeldestination_remark.js：目的地新增备注字段（选填）。
• 2026101500_destination_route_code_unique.js：将存量国家代码统一为大写并对同一线路内的重复国家代码去重（保留有价格阶梯的记录），随后建立「线路 + 国家代码」唯一索引。此迁移对存量数据为一次性纠错，执行时间取决于目的地数量，建议在业务低峰期执行。

⚠️ 部署注意

1. 需执行数据库迁移：部署前运行 ./quotepilot migrate；迁移在后端启动时执行，完成后需重启后端。
2. 前后端需同版本发布：报价单关联使用、目的地备注与国家代码唯一、订单拆分合并、库存采购列拆分等均为前后端联动功能，旧前端或旧后端会显示字段缺失或行为不一致。
3. 国家代码唯一索引迁移不可逆：去重与大小写归一化为一次性业务纠错，回滚脚本仅移除唯一索引、不还原数据；执行时间取决于目的地数量，建议在业务低峰期执行。
4. 行为变更：账单统计仅组织所有者可见；已退款 / 已取消订单新增「移入搁置」；订单列表在筛选条件变化时会清空已选订单；物流面单补打不再弹「确认已打印」。请知悉。

---

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

• QuoteGo（8 commits，head 853108a）：853108a 支持单个包裹合并回未拆分状态、e18732a Merge branch 'main_final'、443dcd7 支持同地点多履约单合并回写、拣货单多行内部备注、64446cd 订单确认快照回填库存展示名与 SKU、7d7217a 库存采购分组统计并返回已入库计数、b3402d0 订单状态计数查询强制走覆盖索引、971af6f 目的地新增备注字段并以线路+代码唯一去重、fa57a31 新增报价单关联使用条数与明细查询接口
• QuotePilot（12 commits，head ad5977d）：ad5977d 支持单包裹合并并优化自动平衡扣减逻辑、d1b980e Merge branch 'main_final'、4d0312d 支持物流补打面单并优化筛选清空已选、5538ff2 渠道/线路/目的地更新时间逐层聚合并支持按更新时间排序、bb0aed9 账单统计限 owner、采购列拆分并支持终态单搁置、7712f78 网页标题跟随选中模块显示并支持注入应用名、1c75ef8 优化配置面板税号布局与顶部页签视觉、e0ee4a2 高级筛选改为浮层并新增搜索/重置与计数角标、f165afb 物流路由按货物属性分区展示并优化浮层视口适配、82f658c 新增已选订单导出 Excel 功能、d83a232 目的地新增备注字段并校验国家代码唯一、d8bf05f 报价历史新增报价单关联使用徽章与引用明细浮层
• droppilot：无变更