Release Notes (2026-10-10 ~ 2026-10-13)

✨ 重点 Feature

批量操作改为后台任务（QuoteGo / QuickPoint 联动）

申请运单、打印面单、标记已发货、虚拟发货不再停留在页面上等待，提交后转入后台任务队列执行。

• 提交后页面立即返回，可继续浏览其他页面；同一组织、同一用户、同一类型的任务同时只允许一个，进行中时重复提交会被拦截并提示「已有任务进行中」。
• 任务执行时显示进度（如「正在申请运单... 12 / 30」），完成后提示可点击查看成功与失败明细；任务被中断时提示重试。
• 服务端会定时清理过期的后台任务记录，避免记录堆积。

批量操作 — 后台任务

申请运单　已完成　点击查看

虚拟发货　进行中　正在虚拟发货... 8 / 20

标记发货　已有任务进行中

同一类型的后台任务同时只允许一个；进行中时重复提交会被拦截。

账单新增折扣与挂号费减免明细（QuoteGo / QuickPoint 联动）

账单详情预览新增「折扣明细」与「挂号费减免」展开区域，便于核对每一笔减免的来源。

• 折扣明细按「规则名 + 变体」聚合展示每件减免金额，并显示「下单 N → 有效 M」的件数。
• 挂号费减免逐单列出减免次数与金额。
• 明细过长时仅展示前若干条，并提示「仅展示前 N 条，共 M 条」，避免遗漏。

账单详情预览 — 折扣明细

折扣明细　展开

规则 / 变体	每件减免	件数
老客折扣 / 红色-M	$ 0.50	下单 10 → 有效 10
新客折扣 / 蓝色-L	$ 0.30	下单 5 → 有效 4

挂号费减免　展开

仅展示前 50 条，共 128 条。

风险中心改为「批量跟进」（QuoteGo / QuickPoint 联动）

风险中心的批量处置动作由「批量标记已解决」改为「批量跟进」。

• 可对所选预警批量写入跟进记录，跟进记录支持上传附件，附件在列表中显示。
• 解决备注保留，已解决记录仍在「已解决历史」中只读追溯。

风险中心 — 批量跟进

已选 3 条预警　批量跟进

跟进备注：已联系商家核实收货地址

附件：address-proof.jpg　已上传

跟进记录会写入每一条预警，支持上传附件。

澳洲偏远标签细分「3 区 / 4 区」（QuoteGo / QuickPoint 联动）

原来统一的「澳洲偏远」标签细分为「澳洲偏远3区」「澳洲偏远4区」两个互斥标签。

• 存量已打标的订单会自动重新归类到对应分区。
• 账单统计按 3 区 / 4 区分别展示订单数。

账单统计 — 澳洲偏远分区

澳洲偏远3区订单 42 单　澳洲偏远4区订单 17 单

订单标签：澳洲偏远3区 / 澳洲偏远4区

原「澳洲偏远」标签已细分为互斥的 3 区与 4 区；存量订单自动重新归类。

报价页新增「线路不可用」提示（QuickPoint）

报价页顶部新增提示横幅，集中列出哪些目的地的物流线路不可用及原因（如「原线路已停用，请重新选择」「请选择物流线路」），与下单时的线路校验口径保持一致。

报价页 — 线路不可用提示

以下目的地线路不可用，请检查：

目的地	原因
美国	原线路已停用，请重新选择
德国	请选择物流线路

待办事项改为悬浮便签（QuickPoint）

侧边栏的待办事项入口移除，改为桌面端可拖拽的悬浮按钮。

• 点击展开为一块自由文本便签，输入即自动保存。
• 便签可拖动到屏幕任意位置，松手后吸附左右边缘并记忆位置。

临时记录（悬浮便签）

记一笔…（输入即自动保存）

联系工厂确认第二批面料颜色　已保存

便签可拖动到屏幕任意位置（松手吸附左右边缘），位置自动记忆。

🚀 其他 Feature

补发前置条件放宽（QuoteGo / QuickPoint 联动）

订单只要已发货或已签收即可发起补发，不再要求订单已确认。

拣货单商品名回退顺序调整（QuoteGo）

拣货单上的商品名回退顺序调整为「库存名 > 报关信息 > Shopify 商品名」。

报价单号一键复制（QuickPoint）

报价单号旁新增复制按钮，列表展示的是报价单名称时，复制按钮复制的仍是单号本身。

报价单 — 单号复制

报价单号 QP123　复制

点击复制按钮复制单号本身，即使列表展示的是报价单名称。

报价产品选择器按报价单分组（QuickPoint）

物流规则配置中的报价产品选择器改为按报价单分组展示，便于查找。

物流渠道显示线路更新时间（QuickPoint）

物流渠道下拉（订单行 / 批量设置 / 报价计算共用）逐条展示线路的最后更新时间，便于判断运费是否为最新价格。

物流渠道选择 — 线路更新时间

线路	最后更新	运费
云途-普货专线	2026-10-12	$ 5.20
燕文-经济小包	2026-09-30	$ 4.80

下拉展示每条线路的最后更新时间，便于判断运费是否为最新价格。

报关重量录入警示（QuickPoint）

报关重量录入（编辑弹窗 / 批量设置）新增「运费按报关重量计算，请谨慎填写」提示。

物流规则多值分隔支持空格与中文逗号（QuickPoint）

物流规则的多值匹配除英文逗号外，还支持以空格或中文逗号分隔。

订单 Tab 与筛选记忆（QuickPoint）

订单列表的「账单 / 物流」Tab 与状态筛选按会话记忆，刷新后保留原视图；关闭标签页后回到默认视图。

虚拟发货筛选改为三态（QuoteGo / QuickPoint 联动）

订单高级搜索中的虚拟发货筛选改为「仅虚拟发货 / 未虚拟发货 / 不限」三态，并迁移旧数据。

库存旧锁库链路兼容开关（QuoteGo / QuickPoint / droppilot 联动）

新增组织级开关，支持新老锁库链路共存。

• 开启旧链路后，droppilot 商家端库存列表会新增「缺货」列，展示由负余额换算得到的缺货量；新链路下不显示该列（无负余额）。
• 同时修复客户现存库存为负数时的展示异常。

商家端库存列表 — 缺货列（旧链路）

商品 / 报价单	SKU	在仓可用	缺货
无线充电套装 A	SKU-1001	0	3
Type-C 数据线	SKU-1002	5	0

仅在旧锁库链路下展示「缺货」列；新链路无负余额，不显示该列。

🐛 重大 Bug Fix

Shopify 履约回执竞态导致发货被跳过

修复 Shopify 履约回执竞态导致订单发货被跳过的问题。

订单页刷新后重置视图

修复订单页刷新后 Tab 与筛选被重置回默认视图的问题（改为按会话记忆）。

♻️ 重构 / 移除

• 侧边栏「待办事项」入口移除：待办弹窗与相关状态管理一并移除，改为悬浮便签（复用同一个记录字段，无需迁移）。
• 风险中心「批量标记已解决」更名为「批量跟进」：批量动作语义由「直接解决」改为「写入跟进记录」。

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

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

账单明细

• 2026100902_invoice_discount_items.js：账单新增折扣明细字段。
• 2026100903_shipping_discount_orders.js：账单新增挂号费减免明细字段。
• 2026100904_adjustment_detail_meta.js：账单新增调整明细截断元数据字段，并扩容关税明细字段容量。

澳洲偏远标签

• 2026101100_au_remote_tag_split_zones.js：将存量已打标订单从「澳洲偏远」重分类到「澳洲偏远3区 / 4区」。

后台任务

• 2026101300_create_AsyncJobs.js：新增后台任务集合（申请运单 / 打印面单）。
• 2026101310_async_jobs_add_shipping_types.js：后台任务类型追加「虚拟发货」「标记已发货」。

库存链路开关

• 2026101400_seed_org_inventory_legacy_lock_mode.js：为所有组织写入库存旧锁库链路开关的默认值（关闭，即使用新链路）。

⚠️ 部署注意

1. 需执行数据库迁移：部署前运行 ./quotepilot migrate；迁移在后端启动时执行，完成后需重启后端。
2. 前端需同时发布 v5.13.0：后台任务、账单明细、风险中心、澳洲偏远标签、库存开关等均为前后端联动功能，旧前端或旧后端会显示字段缺失或行为不一致；droppilot（库存缺货列）也需与后端同版本发布。
3. 澳洲偏远标签重分类为一次性存量迁移：执行时间取决于历史订单量，建议在业务低峰期执行。
4. 库存旧锁库链路开关默认关闭：升级后默认使用新锁库链路；如个别组织需沿用旧链路，请在组织设置中手动开启。
5. 补发前置条件放宽：由「订单已确认」放宽为「已发货或已签收」，属行为变更，请知悉。
6. 后台任务并发限制：同一组织、同一用户、同一类型的任务同时只允许一个进行中；服务端会定时清理过期任务记录。

---

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

• QuoteGo（19 commits，head 0794dd8）：0794dd8 Merge branch 'main_final_legacy_inventory' into main_final、2f5ef71 虚拟发货筛选改为三态 only/none/不限、b360aab 新增组织级旧锁库链路兼容开关、afe15a6 Merge 'feat/async-waybill-print-progress'、84edc6b Merge 'feat/picking-product-name-fallback'、bcb7c38 Merge 'main_batch_followup'、5447c1a Merge 'gggg_au_split_zones'、e5e78fd Merge 'gggg_discount_details_truncate'、1be75cd Merge 'gggg_discount_details'、56e0de3 补发放宽前置校验为仅需已发货或已签收、535e2bf 修复 Shopify 履约回执竞态导致发货被跳过、5d6a58b 虚拟发货与标记已发货改为异步任务入队返回 jobId、26d668a 新增过期 AsyncJobs 记录定时清理、507e677 申请运单与打印面单改为异步任务执行、a4a7228 拣货单商品名回退改为库存名 > 报关信息 > shopify 商品名、d88e707 风控批量解决接口重构为批量跟进并支持附件、419871f 澳洲偏远标签按 3/4 区细分并迁移存量订单、938c2ce 账单明细快照限量并写入截断元数据、4498a40 账单新增折扣与挂号费减免明细快照
• QuickPoint（28 commits，head 2bfce10）：2bfce10 Merge 'main_final_quote_issues'、545d868 Merge 'main_final_legacy_inventory'、88b2809 虚拟发货筛选改为三态并支持旧数据迁移、3eb6a55 新增线路不可用提示横幅并抽取目的地判定逻辑、27aba0f 调整便签悬浮按钮尺寸为 36px、3310173 报价产品选择器按报价单分组展示、3fa91c0 报价单号新增一键复制按钮及相关文案、f099f98 新增旧锁库链路开关并修复客存负库存展示、4b70829 Merge 'feat/floating-note'、ba2e71d 待办事项改为可拖拽悬浮便签、f016e10 Merge 'feat/async-waybill-print-progress'、fe74708 Merge 'fix/order-shipping-tab-refresh'、ebd8a30 Merge 'feat/customs-weight-warn-channel-update'、ead9d77 Merge 'main_dev'、4cf6585 Merge 'main_batch_followup'、eb3b1eb Merge 'gggg_au_split_zones'、a67c0cf Merge 'gggg_discount_details_truncate'、cf1317e Merge 'gggg_discount_details'、3bd5ce4 补发不再要求订单已确认，已发货即可发起补发、f4acd2e 标记发货与虚拟发货改为异步任务并支持进度展示、2cd74a9 修复刷新后未恢复上次的账单/物流 Tab 与筛选、c29bdb1 申请运单与打印面单改为异步任务队列、3d0c54d 渠道下拉显示线路更新时间并新增报关重量警示、3d19362 物流规则多值分隔支持空格与中文逗号、86b3c89 风险中心批量标记已解决重构为批量跟进、0d4b3d3 澳洲偏远标签拆分为 3 区/4 区并分区统计、4654f79 调整明细截断时按真实总数计数并展示截断提示、e6d77db 账单新增折扣与挂号费减免明细展开功能
• droppilot（1 commit，head 5dc1706）：5dc1706 新增旧锁库链路缺货列展示