Merge remote-tracking branch 'origin/test' into dev

# Conflicts:
#	AGENTS.md
#	scripts/AGENTS.md
#	scripts/admin-test-env-modules/README.md
#	scripts/agents-index-contract.ps1

order/src/main/java/com/baiyue/order/service/UnifiedOrderQueryService.java

@@ -306,7 +306,8 @@ public class UnifiedOrderQueryService {
             order.getCustomerId(), order.getCustomerName(),
             order.getChannelCode(), order.getChannelName(), Boolean.TRUE.equals(order.getChannelChanged()), order.getReceivingWarehouseId(), order.getReceivingWarehouseName(),
             order.getDestinationWarehouseId(), order.getDestinationWarehouseName(), inbound.id(), inbound.version(), inbound.inboundCode(),
-            order.getExpectedShipDate(), displayedPackageCount(order, cargo, inbound), null, inbound.locationCodes(),
+            order.getExpectedShipDate(), displayedPackageCount(order, cargo, inbound), null,
+            distinctLocationCodes(inbound.locationCodes()),
             order.getEstimatedVolumeCbm(), volumeCbm(cargo),
             inbound.actualGrossWeightKg(), inbound.actualVolumeCbm(),
             order.getExpectedArrivalAt() != null ? order.getExpectedArrivalAt() : inbound.expectedArrivalAt(), inbound.feeReviewStatus(),
@@ -333,7 +334,7 @@ public class UnifiedOrderQueryService {
             order != null && Boolean.TRUE.equals(order.getChannelChanged()), inbound.warehouseId(),
             inbound.warehouseName(), inbound.deliveryWarehouseId(), inbound.deliveryWarehouseName(),
             inbound.id(), inbound.version(), inbound.inboundCode(), null,
-            displayedPackageCount(order, cargo, inbound), null, inbound.locationCodes(),
+            displayedPackageCount(order, cargo, inbound), null, distinctLocationCodes(inbound.locationCodes()),
             order == null ? null : order.getEstimatedVolumeCbm(), volumeCbm(cargo),
             inbound.actualGrossWeightKg(), inbound.actualVolumeCbm(),
             order != null && order.getExpectedArrivalAt() != null ? order.getExpectedArrivalAt() : inbound.expectedArrivalAt(), inbound.feeReviewStatus(), inbound.companyName(),
@@ -408,6 +409,13 @@ public class UnifiedOrderQueryService {
         return values.isEmpty() ? null : String.join(", ", values);
     }
 
+    private String distinctLocationCodes(String locationCodes) {
+        if (!StringUtils.hasText(locationCodes)) return null;
+        LinkedHashSet<String> values = new LinkedHashSet<>(List.of(
+            StringUtils.tokenizeToStringArray(locationCodes, ",，、")));
+        return values.isEmpty() ? null : String.join("、", values);
+    }
+
     private Integer totalQuantity(CargoSummary cargo) {
         return cargo == null ? null : cargo.totalQuantity();
     }

order/src/main/resources/openapi/order-v1.yaml

@@ -752,7 +752,7 @@ components:
         expectedShipDate: {type: string, format: date, nullable: true}
         totalPackageCount: {type: integer, nullable: true, description: 无入仓事实时为当前订单有效货物箱数合计；存在入仓业务单元后为该单元履约总箱数，拆分后不以父单原始箱数覆盖}
         recommendedPalletType: {type: string, nullable: true, description: 当前无列表级权威事实时返回 null，不得返回固定托盘类型}
-        locationCodes: {type: string, nullable: true}
+        locationCodes: {type: string, nullable: true, description: "库位编码汇总；按首次出现顺序去重并使用中文顿号分隔"}
         estimatedVolumeCbm: {type: number, nullable: true, description: 平台运营填写的预估体积，不得与客户下单或实测体积混用}
         expectedVolumeCbm: {type: number, nullable: true, description: Order 客户下单货物体积合计，不得与平台预估或实测体积混用}
         actualGrossWeightKg: {type: number, nullable: true, description: 仅 Firstleg 实测毛重；无实测时返回 null}