merge: 合并远端开发分支

apps/backend/src/config/app-config-keys.ts

@@ -7,6 +7,8 @@ export const APP_CONFIG_KEYS = {
   workerProductMatch: 'worker_product_match',
   workerAnnouncement: 'worker_announcement',
   workerHall: 'worker_hall',
+  /** 商品名来源后缀：按 material.source.provider 在商品名后追加（文字），仅展示用 */
+  workerProductNameSuffix: 'worker_product_name_suffix',
   workerRiskControl: 'worker_risk_control',
   workerMockShops: 'worker_mock_shops',
   kuaishouIndustrySource: 'kuaishou_industry_source',

apps/backend/src/repositories/worker-platform/work-order-query-repo.ts

@@ -1689,6 +1689,24 @@ function buildHallCandidateIdsSql(limitPlaceholder: string, categoryLimitsPlaceh
   `
 }
 
+/**
+ * 后台「商品名来源后缀」下拉选项：取工单资料里的来源标识。
+ * 去重、去空、限制数量，避免脏数据把下拉撑爆。
+ */
+export async function listWorkOrderSourceProviders(limit = 200): Promise<string[]> {
+  const result = await query<{ provider: string }>(
+    `
+      SELECT DISTINCT NULLIF(BTRIM(material_json->'source'->>'provider'), '') AS provider
+      FROM work_orders
+      WHERE NULLIF(BTRIM(material_json->'source'->>'provider'), '') IS NOT NULL
+      ORDER BY provider ASC
+      LIMIT $1
+    `,
+    [limit],
+  )
+  return result.rows.map((row) => row.provider).filter(Boolean)
+}
+
 /**
  * 抢单操作在事务中复核容量与当前打手的可见延迟，避免通过订单 ID 绕过大厅队列。
  * 候选集与列表接口同源（FIFO 窗口 + 全部置顶单），所以置顶单即使排在窗口外也能正常抢单/拼单。

apps/backend/src/routes/admin/worker-platform/config.ts

@@ -13,6 +13,7 @@ import {
   getAdminWorkerPlatformNotificationConfig,
   getAdminWorkerPlatformSummary,
   getAdminWorkerProductMatchConfig,
+  getAdminWorkerProductNameSuffixConfig,
   listAdminKuaishouMatchSources,
   listAdminWorkCategories,
   listAdminWorkProductMatchLogs,
@@ -20,6 +21,7 @@ import {
   listAdminWorkProductRuleMappings,
   listAdminWorkProductRules,
   listAdminWorkerLevels,
+  listWorkerProductNameSuffixSourceOptions,
   saveAdminWorkCategory,
   saveAdminWorkProductRule,
   saveAdminWorkProductRuleMapping,
@@ -29,6 +31,7 @@ import {
   saveAdminWorkerLevel,
   saveAdminWorkerPlatformNotificationConfig,
   saveAdminWorkerProductMatchConfig,
+  saveAdminWorkerProductNameSuffixConfig,
   syncAdminWorkProductRulePrice,
   testAdminKuaishouProductMatch,
   testAdminProductMatchByOrderItem,
@@ -309,6 +312,44 @@ router.post(
   }),
 )
 
+router.get(
+  '/worker-platform/product-name-suffix',
+  requireAdminRoles(['admin', 'operator', 'support']),
+  createJsonHandler(() => getAdminWorkerProductNameSuffixConfig(), {
+    successMessage: 'ok',
+    errorMessage: '读取商品名来源后缀配置失败',
+    scope: '[admin/worker-platform/product-name-suffix]',
+  }),
+)
+
+// 下拉选项来自工单资料里的来源标识，低频配置，给浏览器 5 分钟缓存。
+router.get(
+  '/worker-platform/product-name-suffix/sources',
+  requireAdminRoles(['admin', 'operator', 'support']),
+  setHttpCache(300),
+  createJsonHandler(() => listWorkerProductNameSuffixSourceOptions(), {
+    successMessage: 'ok',
+    errorMessage: '读取工单来源选项失败',
+    scope: '[admin/worker-platform/product-name-suffix/sources]',
+  }),
+)
+
+router.post(
+  '/worker-platform/product-name-suffix',
+  requireAdminRoles(['admin']),
+  createJsonHandler((req) => saveAdminWorkerProductNameSuffixConfig(req.body || {}), {
+    successMessage: '商品名来源后缀已保存',
+    errorMessage: '保存商品名来源后缀失败',
+    scope: '[admin/worker-platform/product-name-suffix]',
+    audit: (_req, data) => ({
+      action: 'worker_product_name_suffix_saved',
+      targetType: 'worker_product_name_suffix',
+      targetId: 'worker_product_name_suffix',
+      data: data && typeof data === 'object' ? (data as Record<string, unknown>) : {},
+    }),
+  }),
+)
+
 router.post(
   '/worker-platform/product-match-config',
   requireAdminRoles(['admin', 'operator']),

apps/backend/src/routes/admin/worker-platform/consignment.ts

@@ -36,6 +36,7 @@ import {
   listInventoryMatchableOrders,
   listWorkOrderInventoryMatchOptions,
 } from '../../../services/worker-platform/consignment-fulfillment-service.js'
+import { listPendingPistolMatches } from '../../../services/worker-platform/consignment-pending-match-service.js'
 
 const router = Router()
 
@@ -266,6 +267,25 @@ router.post(
 
 // ---------------- 匹配与履约 ----------------
 
+// 全局待抢单匹配看板：只看非拼单的待抢单工单 × 在库待匹配现货，只读。
+router.get(
+  '/worker-platform/consignment/pending-pistol-matches',
+  requireAdminPermission('consignment.view'),
+  createJsonHandler(
+    (req) =>
+      listPendingPistolMatches({
+        keyword: String(req.query.keyword || ''),
+        includeConflicts: String(req.query.includeConflicts || '') === 'true',
+        limit: Number(req.query.limit || 0) || undefined,
+      }),
+    {
+      successMessage: 'ok',
+      errorMessage: '读取待匹配手枪订单失败',
+      scope: '[admin/consignment/pending-pistol-matches]',
+    },
+  ),
+)
+
 router.get(
   '/worker-platform/consignment/matches/:workOrderId',
   requireAdminPermission('consignment.view'),

apps/backend/src/routes/worker/orders.ts

@@ -8,6 +8,7 @@ import {
   getWorkerMyOrderEvents,
   getWorkerMyOrderOverview,
   getWorkerOrderFeedbackSummary,
+  getWorkerProductNameSuffixDisplayConfig,
   listWorkerMyOrders,
   markWorkerOrderRead,
   remindWorkerOrderAcceptance,
@@ -90,6 +91,17 @@ router.get(
   }),
 )
 
+// 商品名来源后缀映射：只下发已启用配置，打手端列表/详情/大厅统一按来源追加（文字），只读。
+router.get(
+  '/product-name-suffix',
+  requireActiveWorker,
+  createRouteHandler(() => getWorkerProductNameSuffixDisplayConfig(), {
+    successMessage: 'ok',
+    errorMessage: '读取商品名来源后缀配置失败',
+    scope: '[worker/product-name-suffix]',
+  }),
+)
+
 router.get(
   '/orders/feedbacks',
   requireActiveWorker,

apps/backend/src/services/worker-platform/admin-worker-config-service.ts

@@ -12,6 +12,10 @@ import {
   getWorkerProductMatchConfig,
   saveWorkerProductMatchConfig,
 } from './worker-product-match-config-service.js'
+import {
+  getWorkerProductNameSuffixConfig,
+  saveWorkerProductNameSuffixConfig,
+} from './worker-product-name-suffix-service.js'
 
 export async function getAdminWorkerPlatformNotificationConfig() {
   return getWorkerPlatformNotificationConfig()
@@ -37,6 +41,14 @@ export async function saveAdminWorkerProductMatchConfig(payload: JsonObject = {}
   return saveWorkerProductMatchConfig(payload)
 }
 
+export async function getAdminWorkerProductNameSuffixConfig() {
+  return getWorkerProductNameSuffixConfig()
+}
+
+export async function saveAdminWorkerProductNameSuffixConfig(payload: JsonObject = {}) {
+  return saveWorkerProductNameSuffixConfig(payload)
+}
+
 export async function pruneAdminWorkProductMatchLogs(payload: JsonObject = {}) {
   const config = getWorkerProductMatchConfig()
   const maxRows = payload.maxRows !== undefined ? Number(payload.maxRows) : config.maxMatchLogs

apps/backend/src/services/worker-platform/consignment-matching-service.ts

@@ -566,6 +566,122 @@ export function listConsignmentMatchOptions(
   }))
 }
 
+/** 全局待抢单匹配看板使用的细粒度评分结果。 */
+export type ConsignmentDetailedMatchScore = {
+  matchType: 'exact' | 'partial' | 'conflict'
+  score: number
+  reason: string
+  conflicts: string[]
+}
+
+/**
+ * 细粒度匹配打分（0-100），仅用于「待抢单手枪 × 在库现货」看板排序。
+ *
+ * 权重：系统 20 / 区服 20 / 系列 20 / 钻级 25 / 璀璨 15。
+ * 订单未写或无法确认的字段只给一半分；现货配置更高时钻级给 20、璀璨给 12。
+ * 品类、系统/区服/系列冲突、钻级/璀璨低于订单要求属于硬性不匹配，直接 0 分。
+ */
+export function scoreConsignmentMatchDetails(
+  order: ParsedOrderSpecs,
+  inventory: ConsignmentInventoryRow,
+): ConsignmentDetailedMatchScore {
+  const conflicts = describeConsignmentSpecDifferences(order, inventory)
+  const conflict = (fallback: string): ConsignmentDetailedMatchScore => ({
+    matchType: 'conflict',
+    score: 0,
+    reason: conflicts.join('；') || fallback,
+    conflicts,
+  })
+
+  if (!inventory.allow_matching || inventory.status !== 'in_stock') {
+    return conflict('现货不在库或已暂停匹配')
+  }
+
+  const orderCat = detectItemCategory(order.rawText)
+  const invCat = detectItemCategory(
+    `${inventory.item_name} ${inventory.series} ${inventory.category_name || ''}`,
+  )
+  if (orderCat !== 'other' && invCat !== 'other' && orderCat !== invCat) {
+    return conflict('品类不匹配')
+  }
+  if (invCat === 'pistol_suernan') {
+    const orderHasPistolSignal =
+      Boolean(order.series) ||
+      order.rawText.includes('苏尔南') ||
+      order.rawText.includes('手枪') ||
+      order.rawText.includes('枪皮')
+    if (!orderHasPistolSignal) {
+      return conflict('订单商品不是苏尔南手枪')
+    }
+  }
+
+  const invSystem = normalizePeacekeeperSystem(inventory.system)
+  const invZone = normalizePeacekeeperServerZone(inventory.server_zone)
+  const invSeries = normalizePeacekeeperSeries(inventory.series)
+
+  const verdictSystem = compareSpec(order.system, invSystem)
+  const verdictZone = compareSpec(order.serverZone, invZone, ZONE_WILDCARDS)
+  const verdictSeries = compareSpec(order.series, invSeries)
+  if (verdictSystem === 'mismatch' || verdictZone === 'mismatch' || verdictSeries === 'mismatch') {
+    return conflict('系统/区服/系列规格冲突')
+  }
+
+  const invDiamond = Number(inventory.diamond_level || 1)
+  const invBrilliance = Number(inventory.brilliance_count || 0)
+  const orderDiamond = Number(order.diamondLevel || 0)
+  const orderBrilliance = Number(order.brillianceCount || 0)
+
+  if (orderDiamond > 0 && invDiamond < orderDiamond) {
+    return conflict('现货钻级低于订单要求')
+  }
+  if (invBrilliance < orderBrilliance) {
+    return conflict('现货璀璨低于订单要求')
+  }
+
+  const unknownFields: string[] = []
+  let score = 0
+
+  score += verdictSystem === 'match' ? 20 : 10
+  if (verdictSystem === 'unknown') unknownFields.push('系统')
+  score += verdictZone === 'match' ? 20 : 10
+  if (verdictZone === 'unknown') unknownFields.push('区服')
+  score += verdictSeries === 'match' ? 20 : 10
+  if (verdictSeries === 'unknown') unknownFields.push('系列')
+
+  if (orderDiamond <= 0) {
+    score += 12.5
+    unknownFields.push('钻级')
+  } else if (invDiamond === orderDiamond) {
+    score += 25
+  } else {
+    score += 20
+  }
+
+  score += invBrilliance === orderBrilliance ? 15 : 12
+
+  const reasons: string[] = []
+  if (unknownFields.length > 0) {
+    reasons.push(`订单规格信息不全(未写: ${unknownFields.join('、')})，需人工确认`)
+  }
+  if (orderDiamond > 0 && invDiamond > orderDiamond) {
+    reasons.push(`钻级更高(${invDiamond}钻充${orderDiamond}钻)`)
+  }
+  if (invBrilliance > orderBrilliance) {
+    reasons.push(`多出【${invBrilliance - orderBrilliance}璀璨】`)
+  }
+
+  const roundedScore = Math.round(score)
+  if (roundedScore >= 100) {
+    return { matchType: 'exact', score: 100, reason: '规格完全一致', conflicts: [] }
+  }
+  return {
+    matchType: 'partial',
+    score: roundedScore,
+    reason: reasons.length > 0 ? `需人工确认：${reasons.join('，')}` : '部分规格匹配，需人工确认',
+    conflicts,
+  }
+}
+
 export function findMatchingPeacekeeperInventories(
   rawRequirementText: string,
   inventories: ConsignmentInventoryRow[],

apps/backend/src/services/worker-platform/consignment-pending-match-service.test.ts

@@ -0,0 +1,247 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import type { ConsignmentInventoryRow } from '../../repositories/worker-platform/consignment-repo.js'
+import type { WorkOrderRow } from '../../repositories/worker-platform/types.js'
+import {
+  extractPeacekeeperSpecs,
+  scoreConsignmentMatchDetails,
+} from './consignment-matching-service.js'
+import {
+  buildPendingPistolMatchPairs,
+  type PendingPistolMatchPair,
+} from './consignment-pending-match-service.js'
+
+function buildInventory(overrides: Partial<ConsignmentInventoryRow> = {}): ConsignmentInventoryRow {
+  return {
+    id: 1,
+    inventory_no: 'INV001',
+    game_name: '和平精英',
+    category_id: 1,
+    item_name: '苹果微信区 暗潮 1钻 苏尔南',
+    system: '苹果',
+    server_zone: '微信区',
+    series: '暗潮',
+    diamond_level: 1,
+    brilliance_count: 0,
+    cost_price_fen: 10500,
+    buyer_name: '周杰雄',
+    inbound_batch: '8.30-1',
+    seller_contact: 'wx_123',
+    seller_game_id: 'UID8888',
+    seller_payment_info: '王大锤商行 331682...',
+    seller_phone: '13800000000',
+    credentials_json: {},
+    screenshots_json: [],
+    remark: '',
+    allow_matching: true,
+    status: 'in_stock',
+    allocation_status: '待安排',
+    bound_order_id: null,
+    bound_work_order_id: null,
+    bound_platform_order_id: '',
+    shop_name: '',
+    source_type: 'manual',
+    source_submission_id: null,
+    inbound_at: '2026-11-01T09:00:00.000Z',
+    consumed_at: null,
+    created_at: '2026-11-01T08:00:00.000Z',
+    updated_at: '2026-11-01T09:00:00.000Z',
+    ...overrides,
+  }
+}
+
+function buildOrder(overrides: Partial<WorkOrderRow> = {}): WorkOrderRow {
+  return {
+    id: 1,
+    work_order_no: 'WK001',
+    platform_order_id: 'PLAT001',
+    product_name: '苹果微信区 苏尔南手枪 暗潮 1钻',
+    status: 'open',
+    active_share_quantity: 0,
+    material_json: JSON.stringify({
+      collect: { fields: { system: '苹果', serverZone: '微信区', series: '暗潮' } },
+    }),
+    created_at: '2026-11-01T10:00:00.000Z',
+    ...overrides,
+  } as unknown as WorkOrderRow
+}
+
+function pairByInventory(result: { pairs: PendingPistolMatchPair[] }, inventoryId: number) {
+  return result.pairs.find((pair) => pair.inventoryId === inventoryId)
+}
+
+test('细粒度评分：全部规格一致为 100 分', () => {
+  const order = extractPeacekeeperSpecs('苹果微信区 苏尔南手枪 暗潮 1钻')
+  const scored = scoreConsignmentMatchDetails(order, buildInventory())
+  assert.deepEqual(scored, {
+    matchType: 'exact',
+    score: 100,
+    reason: '规格完全一致',
+    conflicts: [],
+  })
+})
+
+test('细粒度评分：钻级更高 95 分，璀璨更多 97 分', () => {
+  const order = extractPeacekeeperSpecs('苹果微信区 苏尔南手枪 暗潮 1钻')
+  const higherDiamond = scoreConsignmentMatchDetails(order, buildInventory({ diamond_level: 2 }))
+  assert.equal(higherDiamond.matchType, 'partial')
+  assert.equal(higherDiamond.score, 95)
+  assert.match(higherDiamond.reason, /钻级更高/)
+
+  const higherBrilliance = scoreConsignmentMatchDetails(
+    order,
+    buildInventory({ brilliance_count: 2 }),
+  )
+  assert.equal(higherBrilliance.matchType, 'partial')
+  assert.equal(higherBrilliance.score, 97)
+  assert.match(higherBrilliance.reason, /多出【2璀璨】/)
+})
+
+test('细粒度评分：订单未写系统时扣一半分', () => {
+  const order = extractPeacekeeperSpecs('微信区 苏尔南手枪 暗潮 1钻')
+  const scored = scoreConsignmentMatchDetails(order, buildInventory())
+  assert.equal(scored.matchType, 'partial')
+  assert.equal(scored.score, 90)
+  assert.match(scored.reason, /未写: 系统/)
+})
+
+test('细粒度评分：系统/区服/系列冲突或现货配置更低为 0 分', () => {
+  const order = extractPeacekeeperSpecs('苹果微信区 苏尔南手枪 暗潮 3钻')
+  assert.equal(scoreConsignmentMatchDetails(order, buildInventory({ system: '安卓' })).score, 0)
+  assert.equal(
+    scoreConsignmentMatchDetails(order, buildInventory({ server_zone: 'QQ区' })).score,
+    0,
+  )
+  assert.equal(scoreConsignmentMatchDetails(order, buildInventory({ series: '怒嚎' })).score, 0)
+  assert.equal(scoreConsignmentMatchDetails(order, buildInventory({ diamond_level: 1 })).score, 0)
+  assert.equal(
+    scoreConsignmentMatchDetails(order, buildInventory({ diamond_level: 3, brilliance_count: 0 }))
+      .matchType,
+    'exact',
+  )
+  assert.equal(
+    scoreConsignmentMatchDetails(
+      extractPeacekeeperSpecs('苹果微信区 苏尔南手枪 暗潮 1钻 2璀璨'),
+      buildInventory({ brilliance_count: 0 }),
+    ).score,
+    0,
+  )
+})
+
+test('匹配看板：只保留非拼单待抢单 × 在库待匹配手枪', () => {
+  const result = buildPendingPistolMatchPairs({
+    orders: [
+      buildOrder({ id: 1 }),
+      buildOrder({ id: 2, active_share_quantity: 1 }),
+      buildOrder({
+        id: 3,
+        product_name: '指挥官密钥10个',
+        material_json: JSON.stringify({}),
+      }),
+      buildOrder({ id: 4, status: 'unassigned' }),
+    ],
+    inventories: [
+      buildInventory({ id: 10 }),
+      buildInventory({ id: 11, allow_matching: false }),
+      buildInventory({ id: 12, status: 'consumed' }),
+      buildInventory({ id: 13, item_name: '指挥官密钥10个', series: '' }),
+    ],
+  })
+
+  assert.equal(result.pendingOrderCount, 1)
+  assert.equal(result.inStockInventoryCount, 1)
+  assert.equal(result.pairCount, 1)
+  assert.equal(result.pairs[0]?.workOrderId, 1)
+  assert.equal(result.pairs[0]?.inventoryId, 10)
+})
+
+test('匹配看板：不按时间过滤，寄售入库晚于工单创建仍参与匹配', () => {
+  const result = buildPendingPistolMatchPairs({
+    orders: [buildOrder({ created_at: '2026-11-01T10:00:00.000Z' })],
+    inventories: [buildInventory({ inbound_at: '2026-11-02T10:00:00.000Z' })],
+  })
+  assert.equal(result.pairCount, 1)
+  assert.equal(result.pairs[0]?.inventoryInboundAt, '2026-11-02T10:00:00.000Z')
+})
+
+test('匹配看板：按分数降序，同分新工单优先', () => {
+  const result = buildPendingPistolMatchPairs({
+    orders: [buildOrder({ id: 1 }), buildOrder({ id: 2, work_order_no: 'WK002' })],
+    inventories: [
+      buildInventory({ id: 10 }),
+      buildInventory({ id: 11, diamond_level: 2, inbound_at: '2026-11-01T11:00:00.000Z' }),
+    ],
+  })
+
+  assert.deepEqual(
+    result.pairs.map((pair) => [pair.workOrderId, pair.inventoryId, pair.score]),
+    [
+      [2, 10, 100],
+      [1, 10, 100],
+      [2, 11, 95],
+      [1, 11, 95],
+    ],
+  )
+})
+
+test('匹配看板：关键字同时搜索工单号与寄售单号', () => {
+  const orders = [buildOrder({ id: 1, work_order_no: 'WK001' })]
+  const inventories = [
+    buildInventory({ id: 10, source_submission_no: 'SUB-AAA' }),
+    buildInventory({ id: 11, source_submission_no: 'SUB-BBB' }),
+  ]
+  const byOrder = buildPendingPistolMatchPairs({ orders, inventories, keyword: 'wk001' })
+  assert.equal(byOrder.pairCount, 2)
+
+  const byConsignment = buildPendingPistolMatchPairs({
+    orders,
+    inventories,
+    keyword: 'sub-bbb',
+  })
+  assert.equal(byConsignment.pairCount, 1)
+  assert.equal(byConsignment.pairs[0]?.inventoryId, 11)
+})
+
+test('匹配看板：默认隐藏 0 分冲突项，可显式包含', () => {
+  const orders = [buildOrder()]
+  const inventories = [buildInventory({ id: 10, system: '安卓' })]
+  const hidden = buildPendingPistolMatchPairs({ orders, inventories })
+  assert.equal(hidden.pairCount, 0)
+  assert.equal(hidden.conflictCount, 0)
+
+  const included = buildPendingPistolMatchPairs({
+    orders,
+    inventories,
+    includeConflicts: true,
+  })
+  assert.equal(included.pairCount, 1)
+  assert.equal(included.conflictCount, 1)
+  assert.equal(included.pairs[0]?.score, 0)
+})
+
+test('匹配看板：结果条数受 limit 限制并标记 truncated', () => {
+  const result = buildPendingPistolMatchPairs({
+    orders: [buildOrder({ id: 1 }), buildOrder({ id: 2, work_order_no: 'WK002' })],
+    inventories: [buildInventory({ id: 10 }), buildInventory({ id: 11 })],
+    limit: 2,
+  })
+  assert.equal(result.pairCount, 4)
+  assert.equal(result.pairs.length, 2)
+  assert.equal(result.truncated, true)
+})
+
+test('匹配看板：配对明细包含平台号/工单号/商品名/寄售单号/寄售物品/分数', () => {
+  const result = buildPendingPistolMatchPairs({
+    orders: [buildOrder()],
+    inventories: [buildInventory({ id: 10, source_submission_no: 'SUB-001' })],
+  })
+  const pair = pairByInventory(result, 10)
+  assert.ok(pair)
+  assert.equal(pair.platformOrderId, 'PLAT001')
+  assert.equal(pair.workOrderNo, 'WK001')
+  assert.equal(pair.productName, '苹果微信区 苏尔南手枪 暗潮 1钻')
+  assert.equal(pair.consignmentNo, 'SUB-001')
+  assert.equal(pair.itemName, '苹果微信区 暗潮 1钻 苏尔南')
+  assert.equal(pair.score, 100)
+})

apps/backend/src/services/worker-platform/consignment-pending-match-service.ts

@@ -0,0 +1,199 @@
+import { WORK_ORDER_STATUS } from '../../domain/work-order-status.js'
+import {
+  listActiveConsignmentInventoriesForMatching,
+  type ConsignmentInventoryRow,
+} from '../../repositories/worker-platform/consignment-repo.js'
+import { listWorkOrders } from '../../repositories/worker-platform/work-order-query-repo.js'
+import type { WorkOrderRow } from '../../repositories/worker-platform/types.js'
+import {
+  detectItemCategory,
+  extractPeacekeeperSpecs,
+  scoreConsignmentMatchDetails,
+} from './consignment-matching-service.js'
+import { resolveCollectSubmittedFieldValues } from './work-order-material-mappers.js'
+
+export type PendingPistolMatchPair = {
+  workOrderId: number
+  workOrderNo: string
+  platformOrderId: string
+  productName: string
+  workOrderCreatedAt: string | null
+  inventoryId: number
+  consignmentNo: string
+  inventoryNo: string
+  itemName: string
+  inventoryInboundAt: string | null
+  matchType: 'exact' | 'partial' | 'conflict'
+  score: number
+  reason: string
+  conflicts: string[]
+}
+
+export type PendingPistolMatchResult = {
+  /** 参与匹配的待抢单手枪单数量 */
+  pendingOrderCount: number
+  /** 参与匹配的在库待匹配现货数量 */
+  inStockInventoryCount: number
+  /** 命中关键字后的配对总数（未截断前） */
+  pairCount: number
+  exactCount: number
+  partialCount: number
+  conflictCount: number
+  /** 结果过多被截断，或待抢单工单本身超过单次拉取上限 */
+  truncated: boolean
+  pairs: PendingPistolMatchPair[]
+}
+
+const OPEN_ORDER_FETCH_LIMIT = 500
+const DEFAULT_RESULT_LIMIT = 300
+const MAX_RESULT_LIMIT = 1000
+
+function buildPairHaystack(pair: PendingPistolMatchPair): string {
+  return [
+    pair.workOrderNo,
+    pair.platformOrderId,
+    pair.productName,
+    pair.consignmentNo,
+    pair.inventoryNo,
+    pair.itemName,
+  ]
+    .join(' ')
+    .toLowerCase()
+}
+
+/** 纯函数：把待抢单工单与在库现货做笛卡尔匹配并排序，便于单测。 */
+export function buildPendingPistolMatchPairs(input: {
+  orders: WorkOrderRow[]
+  inventories: ConsignmentInventoryRow[]
+  keyword?: string | undefined
+  includeConflicts?: boolean | undefined
+  limit?: number | undefined
+  ordersTruncated?: boolean | undefined
+}): PendingPistolMatchResult {
+  const preparedOrders = input.orders
+    .filter((order) => String(order.status || '') === WORK_ORDER_STATUS.OPEN)
+    // 寄售只做整单：已有有效拼单份额的待抢单不参与匹配。
+    .filter((order) => Number(order.active_share_quantity || 0) <= 0)
+    .map((order) => {
+      const fields = resolveCollectSubmittedFieldValues(order)
+      const specs = extractPeacekeeperSpecs(order.product_name, {
+        system: fields.system,
+        serverZone: fields.serverZone,
+        series: fields.series,
+      })
+      return { order, specs }
+    })
+    .filter(({ order, specs }) => {
+      const text = [
+        String(order.product_name || ''),
+        specs.system,
+        specs.serverZone,
+        specs.series,
+      ].join(' ')
+      return detectItemCategory(text) === 'pistol_suernan'
+    })
+
+  const preparedInventories = input.inventories.filter((inventory) => {
+    if (inventory.status !== 'in_stock' || inventory.allow_matching !== true) return false
+    return (
+      detectItemCategory(
+        `${inventory.item_name} ${inventory.series || ''} ${inventory.category_name || ''}`,
+      ) === 'pistol_suernan'
+    )
+  })
+
+  const keyword = String(input.keyword || '')
+    .trim()
+    .toLowerCase()
+  const includeConflicts = input.includeConflicts === true
+  const limit = Math.min(
+    Math.max(Math.floor(Number(input.limit) || DEFAULT_RESULT_LIMIT), 1),
+    MAX_RESULT_LIMIT,
+  )
+
+  const pairs: PendingPistolMatchPair[] = []
+  for (const { order, specs } of preparedOrders) {
+    for (const inventory of preparedInventories) {
+      const scored = scoreConsignmentMatchDetails(specs, inventory)
+      if (scored.matchType === 'conflict' && !includeConflicts) continue
+
+      const pair: PendingPistolMatchPair = {
+        workOrderId: Number(order.id),
+        workOrderNo: String(order.work_order_no || ''),
+        platformOrderId: String(order.platform_order_id || ''),
+        productName: String(order.product_name || ''),
+        workOrderCreatedAt: order.created_at ? String(order.created_at) : null,
+        inventoryId: Number(inventory.id),
+        consignmentNo: String(inventory.source_submission_no || inventory.inventory_no || ''),
+        inventoryNo: String(inventory.inventory_no || ''),
+        itemName: String(inventory.item_name || ''),
+        inventoryInboundAt: inventory.inbound_at
+          ? String(inventory.inbound_at)
+          : inventory.created_at
+            ? String(inventory.created_at)
+            : null,
+        matchType: scored.matchType,
+        score: scored.score,
+        reason: scored.reason,
+        conflicts: scored.conflicts,
+      }
+
+      if (keyword && !buildPairHaystack(pair).includes(keyword)) continue
+      pairs.push(pair)
+    }
+  }
+
+  const exactCount = pairs.filter((pair) => pair.matchType === 'exact').length
+  const partialCount = pairs.filter((pair) => pair.matchType === 'partial').length
+  const conflictCount = pairs.filter((pair) => pair.matchType === 'conflict').length
+
+  // 分数优先；同分时新工单优先，再按寄售入库时间早的优先。
+  pairs.sort((left, right) => {
+    if (right.score !== left.score) return right.score - left.score
+    if (right.workOrderId !== left.workOrderId) {
+      return right.workOrderId - left.workOrderId
+    }
+    const leftTime = Date.parse(left.inventoryInboundAt || '') || left.inventoryId
+    const rightTime = Date.parse(right.inventoryInboundAt || '') || right.inventoryId
+    if (leftTime !== rightTime) return leftTime - rightTime
+    return left.inventoryId - right.inventoryId
+  })
+
+  return {
+    pendingOrderCount: preparedOrders.length,
+    inStockInventoryCount: preparedInventories.length,
+    pairCount: pairs.length,
+    exactCount,
+    partialCount,
+    conflictCount,
+    truncated: pairs.length > limit || input.ordersTruncated === true,
+    pairs: pairs.slice(0, limit),
+  }
+}
+
+/** 后台「寄售仓库 → 匹配」：待抢单手枪单 × 在库待匹配现货。 */
+export async function listPendingPistolMatches(
+  input: {
+    keyword?: string | undefined
+    includeConflicts?: boolean | undefined
+    limit?: number | undefined
+  } = {},
+): Promise<PendingPistolMatchResult> {
+  const { items, total } = await listWorkOrders({
+    statuses: [WORK_ORDER_STATUS.OPEN],
+    page: 1,
+    pageSize: OPEN_ORDER_FETCH_LIMIT,
+    includeTotal: true,
+    sort: 'id_desc',
+  })
+  const inventories = await listActiveConsignmentInventoriesForMatching()
+
+  return buildPendingPistolMatchPairs({
+    orders: items,
+    inventories,
+    keyword: input.keyword,
+    includeConflicts: input.includeConflicts,
+    limit: input.limit,
+    ordersTruncated: total > items.length,
+  })
+}

apps/backend/src/services/worker-platform/index.ts

@@ -61,7 +61,9 @@ export {
 export * from './worker-product-match-config-service.js'
 export * from './worker-announcement-config-service.js'
 export * from './worker-hall-config-service.js'
+export * from './worker-product-name-suffix-service.js'
 export * from './worker-acceptance-config-service.js'
 export * from './sync-worker-orders-service.js'
 export * from './consignment-contact-service.js'
+export * from './consignment-pending-match-service.js'
 export * from './work-order-material-link-service.js'

apps/backend/src/services/worker-platform/work-order-display-mappers.ts

@@ -525,6 +525,14 @@ export function summarizeWorkerShares(
   }
 }
 
+/** 来源平台标识（如 91kaquan）：管理端直接读 material，打手端单独透出，避免大厅裁剪 material 后丢失。 */
+function resolveSourceProviderFromMaterial(material: unknown): string {
+  if (!material || typeof material !== 'object' || Array.isArray(material)) return ''
+  const source = (material as Record<string, unknown>).source
+  if (!source || typeof source !== 'object' || Array.isArray(source)) return ''
+  return String((source as Record<string, unknown>).provider || '').trim()
+}
+
 export function mapWorkOrderForWorker(
   workOrder: WorkOrderRow,
   permissions: { depositFreeAmount: number },
@@ -571,6 +579,8 @@ export function mapWorkOrderForWorker(
     productName: hasActiveShares
       ? resolveWorkerShareProductName(workOrder.product_name, shareSummary.quantity)
       : visibleOrder.productName,
+    /** 来源平台标识；前端按后台配置决定是否在商品名后追加（文字） */
+    sourceProvider: resolveSourceProviderFromMaterial(visibleOrder.material),
     status: personalStatus,
     /** 行上展示的问题备注：母单问题单用母单备注，否则用被标记份额的备注 */
     problemNote:
@@ -664,6 +674,7 @@ export function mapWorkOrderForHall(
     workOrderNo: mapped.workOrderNo,
     platformOrderId: mapped.platformOrderId,
     productName: mapped.productName,
+    sourceProvider: mapped.sourceProvider,
     categoryId: mapped.categoryId,
     categoryName: mapped.categoryName,
     parentCategoryId: workOrder.parent_category_id ? Number(workOrder.parent_category_id) : null,

apps/backend/src/services/worker-platform/worker-product-name-suffix-service.test.ts

@@ -0,0 +1,143 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import {
+  buildWorkerProductNameSuffixDisplayConfig,
+  normalizeProductNameSuffixText,
+  normalizeWorkerProductNameSuffixConfig,
+} from './worker-product-name-suffix-service.js'
+
+function item(
+  source: string,
+  suffix: string,
+  extra: Partial<{ enabled: boolean; note: string }> = {},
+) {
+  return { source, suffix, enabled: false, note: '', ...extra }
+}
+
+test('来源后缀配置：默认空配置', () => {
+  assert.deepEqual(normalizeWorkerProductNameSuffixConfig(undefined), { items: [] })
+  assert.deepEqual(normalizeWorkerProductNameSuffixConfig({}), { items: [] })
+  assert.deepEqual(normalizeWorkerProductNameSuffixConfig({ items: 'bad' }), { items: [] })
+})
+
+test('来源后缀配置：来源去空格转小写，后缀剥离外层括号', () => {
+  assert.deepEqual(
+    normalizeWorkerProductNameSuffixConfig({
+      items: [
+        { source: ' 91KAQUAN ', suffix: '（91卡券）' },
+        { source: 'douyin', suffix: '(抖音)' },
+      ],
+    }),
+    {
+      items: [item('91kaquan', '91卡券'), item('douyin', '抖音')],
+    },
+  )
+  assert.equal(normalizeProductNameSuffixText('（91卡券）'), '91卡券')
+  assert.equal(normalizeProductNameSuffixText('(91卡券)'), '91卡券')
+})
+
+test('来源后缀配置：空来源或空后缀被丢弃', () => {
+  assert.deepEqual(
+    normalizeWorkerProductNameSuffixConfig({
+      items: [
+        { source: '', suffix: '空来源' },
+        { source: 'empty-suffix', suffix: '  ' },
+        { source: 'ok', suffix: '保留' },
+      ],
+    }),
+    { items: [item('ok', '保留')] },
+  )
+})
+
+test('来源后缀配置：同一来源不区分大小写去重，保留第一条', () => {
+  assert.deepEqual(
+    normalizeWorkerProductNameSuffixConfig({
+      items: [
+        { source: '91kaquan', suffix: '第一条' },
+        { source: '91Kaquan', suffix: '第二条' },
+      ],
+    }),
+    { items: [item('91kaquan', '第一条')] },
+  )
+})
+
+test('来源后缀配置：最多 50 条', () => {
+  const items = Array.from({ length: 60 }, (_, index) => ({
+    source: `source-${index}`,
+    suffix: `后缀${index}`,
+  }))
+  assert.equal(normalizeWorkerProductNameSuffixConfig({ items }).items.length, 50)
+})
+
+test('来源后缀配置：来源最长 64、后缀最长 32', () => {
+  const config = normalizeWorkerProductNameSuffixConfig({
+    items: [{ source: 'a'.repeat(80), suffix: 's'.repeat(40) }],
+  })
+  assert.equal(config.items[0]?.source.length, 64)
+  assert.equal(config.items[0]?.suffix.length, 32)
+})
+
+test('来源后缀配置：非对象条目被忽略', () => {
+  assert.deepEqual(
+    normalizeWorkerProductNameSuffixConfig({
+      items: ['bad', null, 42, { source: 'ok', suffix: '保留' }],
+    }),
+    { items: [item('ok', '保留')] },
+  )
+})
+
+test('来源后缀配置：启停与备注原样归一化，旧配置默认停用', () => {
+  assert.deepEqual(
+    normalizeWorkerProductNameSuffixConfig({
+      items: [
+        { source: 'a', suffix: '甲', enabled: true, note: ' 第一条备注 ' },
+        { source: 'b', suffix: '乙', note: '只有备注' },
+      ],
+    }),
+    {
+      items: [
+        item('a', '甲', { enabled: true, note: '第一条备注' }),
+        item('b', '乙', { note: '只有备注' }),
+      ],
+    },
+  )
+})
+
+test('来源后缀配置：同一时间只保留第一条启用项', () => {
+  const config = normalizeWorkerProductNameSuffixConfig({
+    items: [
+      { source: 'a', suffix: '甲', enabled: true },
+      { source: 'b', suffix: '乙', enabled: true },
+      { source: 'c', suffix: '丙', enabled: true },
+    ],
+  })
+  assert.deepEqual(
+    config.items.map((row) => [row.source, row.enabled]),
+    [
+      ['a', true],
+      ['b', false],
+      ['c', false],
+    ],
+  )
+})
+
+test('来源后缀配置：备注最长 200', () => {
+  const config = normalizeWorkerProductNameSuffixConfig({
+    items: [{ source: 'ok', suffix: '后缀', note: 'n'.repeat(240) }],
+  })
+  assert.equal(config.items[0]?.note.length, 200)
+})
+
+test('打手端展示配置：只下发启用项且不带备注', () => {
+  assert.deepEqual(
+    buildWorkerProductNameSuffixDisplayConfig({
+      items: [
+        { source: 'a', suffix: '甲', enabled: false, note: '停用' },
+        { source: 'b', suffix: '乙', enabled: true, note: '启用' },
+      ],
+    }),
+    { items: [{ source: 'b', suffix: '乙' }] },
+  )
+  assert.deepEqual(buildWorkerProductNameSuffixDisplayConfig({ items: [] }), { items: [] })
+})

apps/backend/src/services/worker-platform/worker-product-name-suffix-service.ts

@@ -0,0 +1,145 @@
+import { APP_CONFIG_KEYS } from '../../config/app-config-keys.js'
+import { listWorkOrderSourceProviders } from '../../repositories/worker-platform/work-order-query-repo.js'
+import type { JsonObject } from '../../types/json.js'
+import { readAppConfigEntry, saveAppConfigEntry } from '../config/app-config-store.js'
+
+/**
+ * 商品名来源后缀配置。
+ *
+ * 只影响展示：工单表里的 `product_name` 永远保持原值。
+ * `source` 与工单资料里的 `material.source.provider` 精确匹配（不区分大小写），
+ * `suffix` 只存括号内的文字，前端统一按「商品名（后缀）」渲染。
+ * 同一时间只允许启用一条配置，只有启用项会追加后缀。
+ */
+export type WorkerProductNameSuffixItem = {
+  source: string
+  suffix: string
+  /** 是否启用；保存时只保留第一条启用项 */
+  enabled: boolean
+  /** 后台备注（仅后台配置页可见） */
+  note: string
+}
+
+export type WorkerProductNameSuffixConfig = {
+  items: WorkerProductNameSuffixItem[]
+}
+
+/** 打手端只需要启用的来源 -> 后缀映射，不暴露备注等信息。 */
+export type WorkerProductNameSuffixDisplayItem = {
+  source: string
+  suffix: string
+}
+
+export type WorkerProductNameSuffixDisplayConfig = {
+  items: WorkerProductNameSuffixDisplayItem[]
+}
+
+const MAX_ITEMS = 50
+const MAX_SOURCE_LENGTH = 64
+const MAX_SUFFIX_LENGTH = 32
+const MAX_NOTE_LENGTH = 200
+
+export function getWorkerProductNameSuffixConfig(): WorkerProductNameSuffixConfig {
+  return readAppConfigEntry({
+    configKey: APP_CONFIG_KEYS.workerProductNameSuffix,
+    fallback: createDefaultWorkerProductNameSuffixConfig,
+    normalize: normalizeWorkerProductNameSuffixConfig,
+  })
+}
+
+export async function saveWorkerProductNameSuffixConfig(
+  rawValue: unknown,
+): Promise<WorkerProductNameSuffixConfig> {
+  return saveAppConfigEntry({
+    configKey: APP_CONFIG_KEYS.workerProductNameSuffix,
+    value: rawValue,
+    normalize: normalizeWorkerProductNameSuffixConfig,
+  })
+}
+
+/** 默认不配置任何来源，保存前所有商品名都保持原样。 */
+export function createDefaultWorkerProductNameSuffixConfig(): WorkerProductNameSuffixConfig {
+  return { items: [] }
+}
+
+export function normalizeWorkerProductNameSuffixConfig(
+  rawValue: unknown,
+): WorkerProductNameSuffixConfig {
+  const source = isPlainObject(rawValue) ? rawValue : {}
+  const rawItems = Array.isArray(source.items) ? source.items : []
+  const seenSources = new Set<string>()
+  const items: WorkerProductNameSuffixItem[] = []
+  let hasEnabledItem = false
+
+  for (const rawItem of rawItems) {
+    if (items.length >= MAX_ITEMS) break
+    if (!isPlainObject(rawItem)) continue
+    const sourceText = String(rawItem.source ?? '')
+      .trim()
+      .slice(0, MAX_SOURCE_LENGTH)
+    const suffixText = normalizeProductNameSuffixText(rawItem.suffix)
+    if (!sourceText || !suffixText) continue
+    // 匹配时大小写不敏感，统一存小写，避免 91kaquan / 91Kaquan 配置出两条。
+    const normalizedSource = sourceText.toLowerCase()
+    if (seenSources.has(normalizedSource)) continue
+    seenSources.add(normalizedSource)
+    // 同时只能启用一个来源：按保存顺序保留第一条启用项，其余强制停用。
+    const enabled = rawItem.enabled === true && !hasEnabledItem
+    if (enabled) hasEnabledItem = true
+    items.push({
+      source: normalizedSource,
+      suffix: suffixText,
+      enabled,
+      note: String(rawItem.note ?? '')
+        .trim()
+        .slice(0, MAX_NOTE_LENGTH),
+    })
+  }
+
+  return { items }
+}
+
+/** 打手端展示配置：只下发启用项，未启用时返回空列表（商品名保持原样）。 */
+export function buildWorkerProductNameSuffixDisplayConfig(
+  config: WorkerProductNameSuffixConfig,
+): WorkerProductNameSuffixDisplayConfig {
+  return {
+    items: config.items
+      .filter((item) => item.enabled)
+      .map((item) => ({ source: item.source, suffix: item.suffix })),
+  }
+}
+
+export function getWorkerProductNameSuffixDisplayConfig(): WorkerProductNameSuffixDisplayConfig {
+  return buildWorkerProductNameSuffixDisplayConfig(getWorkerProductNameSuffixConfig())
+}
+
+/** 后台来源下拉选项：工单资料里出现过的来源 + 已配置但暂时没有工单的来源。 */
+export async function listWorkerProductNameSuffixSourceOptions(): Promise<{ items: string[] }> {
+  const providers = await listWorkOrderSourceProviders()
+  const config = getWorkerProductNameSuffixConfig()
+  const seen = new Map<string, string>()
+  for (const value of [...providers, ...config.items.map((item) => item.source)]) {
+    const text = String(value ?? '').trim()
+    if (!text) continue
+    const key = text.toLowerCase()
+    if (!seen.has(key)) seen.set(key, text)
+  }
+  return { items: [...seen.values()].sort((a, b) => a.localeCompare(b)) }
+}
+
+/** 后缀只保留括号内的文字：用户填了外层全角/半角括号时自动剥离。 */
+export function normalizeProductNameSuffixText(value: unknown): string {
+  let text = String(value ?? '').trim()
+  if (!text) return ''
+  const wrappedFullWidth = text.startsWith('（') && text.endsWith('）')
+  const wrappedHalfWidth = text.startsWith('(') && text.endsWith(')')
+  if ((wrappedFullWidth || wrappedHalfWidth) && text.length >= 2) {
+    text = text.slice(1, -1).trim()
+  }
+  return text.slice(0, MAX_SUFFIX_LENGTH)
+}
+
+function isPlainObject(value: unknown): value is JsonObject {
+  return Object.prototype.toString.call(value) === '[object Object]'
+}

apps/frontend/src/components/admin/ConsignmentPendingMatchModal.tsx

@@ -0,0 +1,266 @@
+import { useQuery } from '@tanstack/react-query'
+import { ReloadOutlined } from '@ant-design/icons'
+import { Alert, Button, Checkbox, Empty, Input, Modal, Space, Tag, Typography } from 'antd'
+import type { TableColumnsType } from 'antd'
+import { useState } from 'react'
+
+import PercentTable from '@/components/common/PercentTable'
+import { fetchPendingPistolMatches } from '@/services/admin/consignment'
+import type { PendingPistolMatchPair } from '@/types/consignment'
+import { formatDateTime } from '@/utils/date-time'
+
+const { Text } = Typography
+
+function resolveScoreTag(pair: PendingPistolMatchPair) {
+  if (pair.matchType === 'exact') return { color: 'green', label: '精确' }
+  if (pair.matchType === 'conflict') return { color: 'default', label: '不匹配' }
+  if (pair.score >= 90) return { color: 'blue', label: '非精确' }
+  if (pair.score >= 70) return { color: 'orange', label: '非精确' }
+  return { color: 'gold', label: '需核对' }
+}
+
+export default function ConsignmentPendingMatchModal({
+  open,
+  onClose,
+}: {
+  open: boolean
+  onClose: () => void
+}) {
+  const [keyword, setKeyword] = useState('')
+  const [includeConflicts, setIncludeConflicts] = useState(false)
+
+  const query = useQuery({
+    queryKey: ['admin-pending-pistol-matches', keyword, includeConflicts],
+    queryFn: () => fetchPendingPistolMatches({ keyword, includeConflicts, limit: 300 }),
+    enabled: open,
+    refetchOnWindowFocus: false,
+    retry: false,
+  })
+  const data = query.data?.data
+  const pairs = data?.pairs || []
+
+  const columns: TableColumnsType<PendingPistolMatchPair> = [
+    {
+      title: '匹配打分',
+      key: 'score',
+      width: 90,
+      render: (_, record) => {
+        const tag = resolveScoreTag(record)
+        return (
+          <Space direction="vertical" size={3} style={{ width: '100%' }}>
+            <span style={{ fontSize: 18, fontWeight: 700, lineHeight: 1 }}>{record.score}</span>
+            <Tag color={tag.color} style={{ marginInlineEnd: 0 }}>
+              {tag.label}
+            </Tag>
+          </Space>
+        )
+      },
+    },
+    {
+      title: '订单信息',
+      key: 'order',
+      width: 280,
+      render: (_, record) => (
+        <Space direction="vertical" size={2} style={{ width: '100%' }}>
+          <Space size={4} align="center">
+            <Text type="secondary" style={{ fontSize: 11 }}>
+              工单
+            </Text>
+            {record.workOrderNo ? (
+              <Text
+                copyable={{ text: record.workOrderNo }}
+                style={{ fontSize: 12, fontWeight: 600, whiteSpace: 'nowrap' }}
+              >
+                {record.workOrderNo}
+              </Text>
+            ) : (
+              <Text type="secondary">-</Text>
+            )}
+          </Space>
+          <Space size={4} align="center">
+            <Text type="secondary" style={{ fontSize: 11 }}>
+              平台
+            </Text>
+            {record.platformOrderId ? (
+              <Text
+                copyable={{ text: record.platformOrderId }}
+                style={{ fontSize: 11, whiteSpace: 'nowrap' }}
+              >
+                {record.platformOrderId}
+              </Text>
+            ) : (
+              <Text type="secondary">-</Text>
+            )}
+          </Space>
+          <Text type="secondary" style={{ fontSize: 11 }}>
+            录单 {record.workOrderCreatedAt ? formatDateTime(record.workOrderCreatedAt) : '-'}
+          </Text>
+        </Space>
+      ),
+    },
+    {
+      title: '商品名',
+      key: 'productName',
+      width: 220,
+      render: (_, record) => (
+        <Text ellipsis={{ tooltip: record.productName }} style={{ maxWidth: '100%' }}>
+          {record.productName || '-'}
+        </Text>
+      ),
+    },
+    {
+      title: '寄售信息',
+      key: 'consignment',
+      width: 280,
+      render: (_, record) => (
+        <Space direction="vertical" size={2} style={{ width: '100%' }}>
+          <Space size={4} align="center">
+            <Text type="secondary" style={{ fontSize: 11 }}>
+              寄售
+            </Text>
+            <Text
+              copyable={{ text: record.consignmentNo || record.inventoryNo }}
+              style={{ fontSize: 12, fontWeight: 600, whiteSpace: 'nowrap' }}
+            >
+              {record.consignmentNo || record.inventoryNo || '-'}
+            </Text>
+          </Space>
+          {record.inventoryNo && record.inventoryNo !== record.consignmentNo ? (
+            <Space size={4} align="center">
+              <Text type="secondary" style={{ fontSize: 11 }}>
+                仓库
+              </Text>
+              <Text
+                copyable={{ text: record.inventoryNo }}
+                style={{ fontSize: 11, whiteSpace: 'nowrap' }}
+              >
+                {record.inventoryNo}
+              </Text>
+            </Space>
+          ) : null}
+          <Text type="secondary" style={{ fontSize: 11 }}>
+            入库 {record.inventoryInboundAt ? formatDateTime(record.inventoryInboundAt) : '-'}
+          </Text>
+        </Space>
+      ),
+    },
+    {
+      title: '寄售物品',
+      key: 'itemName',
+      width: 220,
+      render: (_, record) => (
+        <Text ellipsis={{ tooltip: record.itemName }} style={{ maxWidth: '100%' }}>
+          {record.itemName || '-'}
+        </Text>
+      ),
+    },
+    {
+      title: '匹配说明',
+      key: 'reason',
+      width: 300,
+      render: (_, record) => (
+        <Space direction="vertical" size={2}>
+          <Text style={{ fontSize: 12 }}>{record.reason || '-'}</Text>
+          {record.conflicts.length > 0 ? (
+            <Text type="danger" style={{ fontSize: 11 }}>
+              {record.conflicts.join('；')}
+            </Text>
+          ) : null}
+        </Space>
+      ),
+    },
+  ]
+
+  return (
+    <Modal
+      title="匹配 · 待抢单手枪 × 在库现货"
+      open={open}
+      width="min(1320px, 94vw)"
+      footer={null}
+      destroyOnHidden
+      onCancel={onClose}
+    >
+      <Space direction="vertical" size={12} style={{ width: '100%' }}>
+        <Alert
+          type="info"
+          showIcon
+          message="只查询非拼单的待抢单手枪单 × 在库待匹配现货，不直接改单。"
+          description="分数 0-100：系统 20 / 区服 20 / 系列 20 / 钻级 25 / 璀璨 15。非精确项仍需按现有规则确认；不按录单、入库时间先后过滤。"
+        />
+
+        <Space wrap size={12}>
+          <Tag>待抢单 {data?.pendingOrderCount ?? 0} 单</Tag>
+          <Tag>在库待匹配 {data?.inStockInventoryCount ?? 0} 件</Tag>
+          <Tag color="blue">匹配组合 {data?.pairCount ?? 0} 条</Tag>
+          <Tag color="green">精确 {data?.exactCount ?? 0}</Tag>
+          <Tag color="orange">非精确 {data?.partialCount ?? 0}</Tag>
+          {includeConflicts ? <Tag>不匹配 {data?.conflictCount ?? 0}</Tag> : null}
+        </Space>
+
+        <Space wrap size={12}>
+          <Input.Search
+            allowClear
+            placeholder="搜索平台号 / 工单号 / 商品名 / 寄售单号 / 寄售物品"
+            style={{ width: 420 }}
+            onSearch={(value) => setKeyword(value.trim())}
+          />
+          <Checkbox
+            checked={includeConflicts}
+            onChange={(event) => setIncludeConflicts(event.target.checked)}
+          >
+            显示 0 分不匹配项
+          </Checkbox>
+          <Button
+            icon={<ReloadOutlined />}
+            loading={query.isFetching}
+            onClick={() => void query.refetch()}
+          >
+            刷新
+          </Button>
+        </Space>
+
+        {query.isError ? (
+          <Alert
+            type="error"
+            showIcon
+            message="读取匹配结果失败"
+            description={query.error instanceof Error ? query.error.message : '请稍后重试'}
+          />
+        ) : null}
+
+        {data?.truncated ? (
+          <Alert
+            type="warning"
+            showIcon
+            message={`结果较多，仅展示前 ${pairs.length} 条，请用搜索缩小范围`}
+          />
+        ) : null}
+
+        <PercentTable<PendingPistolMatchPair>
+          rowKey={(record) => `${record.workOrderId}-${record.inventoryId}`}
+          size="small"
+          loading={query.isFetching}
+          dataSource={pairs}
+          columns={columns}
+          scroll={{ y: 460 }}
+          pagination={{
+            pageSize: 20,
+            showSizeChanger: false,
+            showTotal: (total) => `共 ${total} 条`,
+          }}
+          locale={{
+            emptyText: (
+              <Empty
+                description={
+                  includeConflicts
+                    ? '没有可展示的配对'
+                    : '没有有分匹配；可勾选「显示 0 分不匹配项」查看冲突'
+                }
+              />
+            ),
+          }}
+        />
+      </Space>
+    </Modal>
+  )
+}

apps/frontend/src/pages/admin/panels/AnnouncementPanel.tsx

@@ -1,5 +1,5 @@
 import { useQuery, useQueryClient } from '@tanstack/react-query'
-import { ReloadOutlined, SaveOutlined } from '@ant-design/icons'
+import { DeleteOutlined, PlusOutlined, ReloadOutlined, SaveOutlined } from '@ant-design/icons'
 import {
   Alert,
   App,
@@ -9,12 +9,13 @@ import {
   Input,
   InputNumber,
   Popconfirm,
+  Select,
   Space,
   Switch,
   Tag,
   Typography,
 } from 'antd'
-import { useEffect, useState } from 'react'
+import { useEffect, useMemo, useState } from 'react'
 
 import {
   addAdminMockCustomShop,
@@ -22,14 +23,18 @@ import {
   fetchAdminMockCustomShops,
   fetchAdminScheduledJobsConfig,
   fetchAdminWorkerAnnouncement,
+  fetchAdminWorkerProductNameSuffix,
+  fetchAdminWorkerProductNameSuffixSources,
   renameAdminMockCustomShop,
   runAdminScheduledJob,
   saveAdminWorkerAnnouncement,
+  saveAdminWorkerProductNameSuffix,
   saveAdminScheduledJobsConfig,
 } from '@/services/admin'
 import type { AdminScheduledJobItem, AdminScheduledJobRuntimeState } from '@/types/admin'
-import type { WorkerAnnouncementConfig } from '@/types/worker-platform'
+import type { WorkerAnnouncementConfig, WorkerProductNameSuffixItem } from '@/types/worker-platform'
 import { formatAdminDateTime } from '@/utils/admin-time'
+import { normalizeProductNameSuffixText } from '@/utils/product-name-source-suffix'
 
 import HallConfigPanel from './HallConfigPanel'
 
@@ -41,6 +46,7 @@ export default function AnnouncementPanel() {
   return (
     <Space direction="vertical" size={16} style={{ width: '100%' }}>
       <AnnouncementCard />
+      <ProductNameSourceSuffixCard />
       <DepositUnfreezeCard />
       <MockCustomShopsCard />
       <HallConfigPanel />
@@ -241,6 +247,233 @@ function AnnouncementCard() {
   )
 }
 
+type ProductNameSuffixDraft = WorkerProductNameSuffixItem & { rowKey: string }
+
+let productNameSuffixRowSeed = 0
+
+function createProductNameSuffixRow(
+  source = '',
+  suffix = '',
+  enabled = false,
+  note = '',
+): ProductNameSuffixDraft {
+  productNameSuffixRowSeed += 1
+  return {
+    rowKey: `product-name-suffix-${productNameSuffixRowSeed}`,
+    source,
+    suffix,
+    enabled,
+    note,
+  }
+}
+
+/** 商品名来源后缀：按工单来源在商品名后追加「（文字）」，只影响展示，不改库里的商品名。 */
+function ProductNameSourceSuffixCard() {
+  const { message } = App.useApp()
+  const queryClient = useQueryClient()
+  const [saving, setSaving] = useState(false)
+  const [items, setItems] = useState<ProductNameSuffixDraft[]>([])
+  const suffixQuery = useQuery({
+    queryKey: ['admin-worker-product-name-suffix'],
+    queryFn: fetchAdminWorkerProductNameSuffix,
+    staleTime: 5 * 60 * 1000,
+  })
+  const sourcesQuery = useQuery({
+    queryKey: ['admin-worker-product-name-suffix-sources'],
+    queryFn: fetchAdminWorkerProductNameSuffixSources,
+    staleTime: 5 * 60 * 1000,
+  })
+
+  useEffect(() => {
+    const remoteItems = suffixQuery.data?.data.items || []
+    setItems(
+      remoteItems.map((item) =>
+        createProductNameSuffixRow(item.source, item.suffix, item.enabled, item.note),
+      ),
+    )
+  }, [suffixQuery.data])
+
+  // 下拉选项来自订单来源字段；已配置但暂时没有工单的来源也保留，避免编辑时丢值。
+  const sourceOptions = useMemo(() => {
+    const values = new Map<string, string>()
+    for (const item of items) {
+      const text = String(item.source || '').trim()
+      if (!text) continue
+      const key = text.toLowerCase()
+      if (!values.has(key)) values.set(key, text)
+    }
+    for (const value of sourcesQuery.data?.data.items || []) {
+      const text = String(value || '').trim()
+      if (!text) continue
+      const key = text.toLowerCase()
+      if (!values.has(key)) values.set(key, text)
+    }
+    return [...values.values()]
+      .sort((a, b) => a.localeCompare(b))
+      .map((value) => ({ value, label: value }))
+  }, [items, sourcesQuery.data])
+
+  function patchRow(rowKey: string, patch: Partial<WorkerProductNameSuffixItem>) {
+    setItems((prev) => prev.map((item) => (item.rowKey === rowKey ? { ...item, ...patch } : item)))
+  }
+
+  function toggleRow(rowKey: string, enabled: boolean) {
+    setItems((prev) =>
+      prev.map((item) => {
+        if (item.rowKey === rowKey) return { ...item, enabled }
+        // 同一时间只能启用一个来源：启用当前行时自动停用其他行。
+        return enabled ? { ...item, enabled: false } : item
+      }),
+    )
+  }
+
+  function removeRow(rowKey: string) {
+    setItems((prev) => prev.filter((item) => item.rowKey !== rowKey))
+  }
+
+  async function save() {
+    const normalized: WorkerProductNameSuffixItem[] = []
+    const seenSources = new Set<string>()
+    let hasEnabledItem = false
+    for (const [index, item] of items.entries()) {
+      const source = String(item.source || '').trim()
+      const suffix = normalizeProductNameSuffixText(item.suffix)
+      if (!source && !suffix) continue
+      if (!source || !suffix) {
+        message.error(`第 ${index + 1} 行：来源和后缀都要填写`)
+        return
+      }
+      const normalizedSource = source.toLowerCase()
+      if (seenSources.has(normalizedSource)) {
+        message.error(`来源「${source}」重复，一行只能配置一个来源`)
+        return
+      }
+      seenSources.add(normalizedSource)
+      const enabled = item.enabled === true && !hasEnabledItem
+      if (enabled) hasEnabledItem = true
+      normalized.push({
+        source,
+        suffix,
+        enabled,
+        note: String(item.note || '').trim(),
+      })
+    }
+    if (normalized.length > 50) {
+      message.error('最多配置 50 条来源后缀')
+      return
+    }
+
+    setSaving(true)
+    try {
+      await saveAdminWorkerProductNameSuffix({ items: normalized })
+      await queryClient.invalidateQueries({ queryKey: ['admin-worker-product-name-suffix'] })
+      message.success('商品名来源后缀已保存')
+    } catch (error) {
+      message.error(error instanceof Error ? error.message : '保存商品名来源后缀失败')
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  return (
+    <Card
+      title="商品名来源后缀"
+      bordered={false}
+      extra={
+        <Button type="primary" icon={<SaveOutlined />} loading={saving} onClick={() => void save()}>
+          保存
+        </Button>
+      }
+    >
+      <Typography.Paragraph type="secondary" style={{ marginBottom: 12 }}>
+        来源下拉数据取自工单的「来源」字段；选中来源后填写后缀，启用后展示为「商品名（后缀）」。
+        同一时间只能启用一个来源，启用新来源会自动停用其他行；未启用或没有匹配配置的来源不追加。
+        备注仅后台可见。只影响列表/详情的展示，不会改写工单里的商品名。
+      </Typography.Paragraph>
+      {sourcesQuery.isError ? (
+        <Typography.Text type="danger" style={{ display: 'block', marginBottom: 8 }}>
+          读取工单来源选项失败，已配置的来源仍可编辑；请稍后刷新重试。
+        </Typography.Text>
+      ) : null}
+      {items.length === 0 ? (
+        <Typography.Text type="secondary">
+          还没有配置，所有商品名保持原样；点击「添加一行」开始配置。
+        </Typography.Text>
+      ) : null}
+      <Space direction="vertical" size={4} style={{ width: '100%' }}>
+        {items.map((item, index) => {
+          const suffix = normalizeProductNameSuffixText(item.suffix)
+          return (
+            <Space
+              key={item.rowKey}
+              size={8}
+              wrap
+              align="center"
+              style={{ width: '100%', padding: '6px 0', borderBottom: '1px solid #f0f0f0' }}
+            >
+              <Switch
+                checked={item.enabled === true}
+                checkedChildren="启用"
+                unCheckedChildren="停用"
+                onChange={(checked) => toggleRow(item.rowKey, checked)}
+              />
+              <Select
+                showSearch
+                allowClear
+                loading={sourcesQuery.isLoading}
+                optionFilterProp="label"
+                style={{ width: 220 }}
+                placeholder="选择来源"
+                options={sourceOptions}
+                value={item.source || undefined}
+                onChange={(value) => patchRow(item.rowKey, { source: String(value || '') })}
+              />
+              <Input
+                addonBefore="后缀"
+                style={{ width: 200 }}
+                maxLength={34}
+                placeholder="如 91卡券"
+                value={item.suffix}
+                onChange={(event) => patchRow(item.rowKey, { suffix: event.target.value })}
+              />
+              <Input
+                style={{ width: 220 }}
+                maxLength={200}
+                placeholder="备注（选填）"
+                value={item.note}
+                onChange={(event) => patchRow(item.rowKey, { note: event.target.value })}
+              />
+              <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+                {suffix
+                  ? item.enabled
+                    ? `示例：商品名（${suffix}）`
+                    : '未启用，不追加'
+                  : '未填写后缀时不追加'}
+              </Typography.Text>
+              <Button
+                danger
+                type="text"
+                icon={<DeleteOutlined />}
+                aria-label={`删除第 ${index + 1} 行`}
+                onClick={() => removeRow(item.rowKey)}
+              >
+                删除
+              </Button>
+            </Space>
+          )
+        })}
+        <Button
+          icon={<PlusOutlined />}
+          disabled={items.length >= 50}
+          onClick={() => setItems((prev) => [...prev, createProductNameSuffixRow()])}
+        >
+          添加一行
+        </Button>
+      </Space>
+    </Card>
+  )
+}
+
 function MockCustomShopsCard() {
   const { message, modal } = App.useApp()
   const queryClient = useQueryClient()

apps/frontend/src/pages/admin/panels/ConsignmentInventoryPanel.tsx

@@ -1,4 +1,10 @@
-import { EyeOutlined, ReloadOutlined, RollbackOutlined, StopOutlined } from '@ant-design/icons'
+import {
+  EyeOutlined,
+  ReloadOutlined,
+  RollbackOutlined,
+  StopOutlined,
+  ThunderboltOutlined,
+} from '@ant-design/icons'
 import { useQuery } from '@tanstack/react-query'
 import {
   Alert,
@@ -27,6 +33,7 @@ import type { TableColumnsType } from 'antd'
 import { useState } from 'react'
 
 import ConsignmentEvidenceGallery from '@/components/admin/ConsignmentEvidenceGallery'
+import ConsignmentPendingMatchModal from '@/components/admin/ConsignmentPendingMatchModal'
 import {
   archiveAdminConsignmentInventory,
   fetchAdminConsignmentContacts,
@@ -149,6 +156,7 @@ export default function ConsignmentInventoryPanel() {
   const [viewingItem, setViewingItem] = useState<ConsignmentInventory | null>(null)
   const [returnItem, setReturnItem] = useState<ConsignmentInventory | null>(null)
   const [manualMatchItem, setManualMatchItem] = useState<ConsignmentInventory | null>(null)
+  const [pendingMatchOpen, setPendingMatchOpen] = useState(false)
   const [returnReason, setReturnReason] = useState<string>('')
 
   const [editForm] = Form.useForm()
@@ -836,6 +844,10 @@ export default function ConsignmentInventoryPanel() {
               }}
             />
 
+            <Button icon={<ThunderboltOutlined />} onClick={() => setPendingMatchOpen(true)}>
+              一键查询待匹配订单
+            </Button>
+
             <Button icon={<ReloadOutlined />} onClick={refresh}>
               刷新
             </Button>
@@ -1305,6 +1317,12 @@ export default function ConsignmentInventoryPanel() {
         }
         onMatched={() => void inventoriesQuery.refetch()}
       />
+
+      {/* 全局匹配看板：非拼单待抢单手枪 × 在库待匹配现货 */}
+      <ConsignmentPendingMatchModal
+        open={pendingMatchOpen}
+        onClose={() => setPendingMatchOpen(false)}
+      />
     </div>
   )
 }

apps/frontend/src/pages/admin/panels/WorkOrderTableCells.tsx

@@ -4,6 +4,7 @@ import { useRef, useState } from 'react'
 
 import { updateAdminWorkOrder, updateAdminWorkOrderPaymentAmount } from '@/services/admin'
 import type { WorkOrder } from '@/types/worker-platform'
+import { appendProductNameSourceSuffix } from '@/utils/product-name-source-suffix'
 
 import { formatMoney } from './shared'
 import {
@@ -15,10 +16,13 @@ import {
 /** 商品名：单击看详情，双击原地修改（仅未接走工单） */
 export function ProductNameEditableCell({
   order,
+  sourceSuffix = '',
   onOpenDetail,
   onSaved,
 }: {
   order: WorkOrder
+  /** 按来源匹配到的后缀（不含括号）：只用于展示，编辑态仍显示原始商品名 */
+  sourceSuffix?: string
   onOpenDetail: () => void
   onSaved: () => Promise<void> | void
 }) {
@@ -69,13 +73,15 @@ export function ProductNameEditableCell({
   }
 
   if (!editing) {
+    const displayName =
+      appendProductNameSourceSuffix(order.productName, sourceSuffix) || '未命名商品'
     return (
       <Typography.Link
         title={editable ? '双击修改商品名' : undefined}
         onClick={handleClick}
         onDoubleClick={handleDoubleClick}
       >
-        {order.productName || '未命名商品'}
+        {displayName}
       </Typography.Link>
     )
   }

apps/frontend/src/pages/admin/panels/WorkOrdersPanel.tsx

@@ -68,6 +68,7 @@ import {
   fetchAdminWorkOrderSharing,
   fetchAdminWorkOrderShopOptions,
   fetchAdminWorkerLevels,
+  fetchAdminWorkerProductNameSuffix,
   fetchAdminWorkerUsers,
   fetchAdminWorkOrders,
   markAdminWorkOrderProblem,
@@ -107,6 +108,10 @@ import { ADMIN_DEFAULT_PAGE_SIZE, buildAdminTablePagination } from '@/utils/admi
 import { getAdminUsername, hasAdminPermission, hasAdminRole } from '@/utils/admin-auth'
 import { formatAdminDateTime } from '@/utils/admin-time'
 import { buildCollectMaterialLinkUrl } from '@/utils/collect-link'
+import {
+  applyProductNameSourceSuffix,
+  resolveProductNameSourceSuffix,
+} from '@/utils/product-name-source-suffix'
 import { isExplicitOrderNoSearch, normalizeSearchText } from '@/utils/admin-realtime-work-orders'
 import {
   DeadlineCountdown,
@@ -285,6 +290,13 @@ export default function WorkOrdersPanel() {
     queryFn: fetchAdminSession,
     retry: false,
   })
+  // 商品名来源后缀（杂项配置维护）：只影响列表/详情展示，编辑与复制仍用原始商品名。
+  const productNameSuffixQuery = useQuery({
+    queryKey: ['admin-worker-product-name-suffix'],
+    queryFn: fetchAdminWorkerProductNameSuffix,
+    staleTime: 5 * 60 * 1000,
+  })
+  const productNameSuffixItems = productNameSuffixQuery.data?.data.items || []
   const sessionPermissions = adminSessionQuery.data?.data.user.permissions
   const canReturnToHall = sessionPermissions
     ? sessionPermissions.includes('worker_order.return_to_hall')
@@ -436,6 +448,13 @@ export default function WorkOrdersPanel() {
 
   // 详情抽屉里的寄售履约信息（有寄售履约才展示寄卖单号）
   const detailConsignment = detailOrder ? getConsignmentFulfillment(detailOrder) : null
+  const detailProductName = detailOrder
+    ? applyProductNameSourceSuffix(
+        detailOrder.productName,
+        asRecord(detailOrder.material?.source).provider,
+        productNameSuffixItems,
+      )
+    : ''
 
   // 仅单独筛选「待验收」时提供批量验收入口（多选状态下不启用勾选，避免误操作）
   const isPendingAcceptanceOnly = statuses.length === 1 && statuses[0] === 'pending_acceptance'
@@ -1676,11 +1695,13 @@ export default function WorkOrdersPanel() {
         const source = asRecord(row.material?.source)
         const shopName = String(source.shopName || '').trim()
         const provider = String(source.provider || '').trim()
+        const sourceSuffix = resolveProductNameSourceSuffix(productNameSuffixItems, provider)
         const consignment = getConsignmentFulfillment(row)
         return (
           <div className="cell-stack">
             <ProductNameEditableCell
               order={row}
+              sourceSuffix={sourceSuffix}
               onOpenDetail={() => openDetailDrawer(row)}
               onSaved={refreshAll}
             />
@@ -2360,7 +2381,7 @@ export default function WorkOrdersPanel() {
         className="worker-order-detail-drawer"
         title={
           detailOrder
-            ? `${detailOrder.productName || '工单详情'} · ${getDisplayOrderNo(detailOrder)}`
+            ? `${detailProductName || '工单详情'} · ${getDisplayOrderNo(detailOrder)}`
             : '工单详情'
         }
         width={860}
@@ -2408,7 +2429,7 @@ export default function WorkOrdersPanel() {
                 <Descriptions.Item label="订单子项 ID">
                   {detailOrder.orderItemId || '-'}
                 </Descriptions.Item>
-                <Descriptions.Item label="商品">{detailOrder.productName || '-'}</Descriptions.Item>
+                <Descriptions.Item label="商品">{detailProductName || '-'}</Descriptions.Item>
                 <Descriptions.Item label="分类">
                   {detailOrder.categoryName || '-'}
                 </Descriptions.Item>

apps/frontend/src/pages/worker/WorkerHallPage.tsx

@@ -33,7 +33,15 @@ import {
   Tooltip,
   Typography,
 } from 'antd'
-import { memo, useCallback, useEffect, useRef, useState, useSyncExternalStore } from 'react'
+import {
+  memo,
+  useCallback,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+  useSyncExternalStore,
+} from 'react'
 import { Link } from 'react-router'
 
 import { WorkerContactModal } from '@/components/worker/WorkerContactModal'
@@ -44,6 +52,7 @@ import {
   fetchWorkerHallLeaderboard,
   fetchWorkerMyOrders,
   fetchWorkerMyOrderOverview,
+  fetchWorkerProductNameSuffix,
   fetchWorkerProfile,
   grabWorkerOrder,
   joinWorkerSharingOrder,
@@ -67,6 +76,10 @@ import {
   resolveHallRemainingQuantity,
   resolveHallRewardAmount,
 } from '@/utils/worker-product-name'
+import {
+  applyProductNameSourceSuffix,
+  type ProductNameSourceSuffixItem,
+} from '@/utils/product-name-source-suffix'
 import { formatDateTime, formatPublishedElapsedTime } from '@/utils/date-time'
 import { createRequestId } from '@/utils/request-id'
 
@@ -161,6 +174,28 @@ export default function WorkerHallPage() {
   const orders = ordersQuery.data?.pages.flatMap((page) => page.data.items) || []
   const firstPage = ordersQuery.data?.pages[0]?.data
 
+  // 商品名来源后缀（后台「杂项配置」维护）：只影响展示，不改商品名本身。
+  const productNameSuffixQuery = useQuery({
+    queryKey: ['worker-product-name-suffix'],
+    queryFn: fetchWorkerProductNameSuffix,
+    staleTime: 5 * 60 * 1000,
+    refetchOnWindowFocus: false,
+    retry: false,
+  })
+  const productNameSuffixItems = useMemo(
+    () => productNameSuffixQuery.data?.data.items || [],
+    [productNameSuffixQuery.data],
+  )
+  const resolveDisplayProductName = useCallback(
+    (order: WorkOrder) =>
+      applyProductNameSourceSuffix(
+        resolveHallProductName(order),
+        order.sourceProvider,
+        productNameSuffixItems,
+      ) || '未命名商品',
+    [productNameSuffixItems],
+  )
+
   const [categoryMeta, setCategoryMeta] = useState<{
     categories: WorkCategory[]
     showSubcategories: boolean
@@ -337,7 +372,7 @@ export default function WorkerHallPage() {
       modal.confirm({
         title: '确认抢单',
         icon: <QuestionCircleOutlined />,
-        content: `确认抢下「${resolveHallProductName(order)}」？奖励 ${formatMoney(
+        content: `确认抢下「${resolveDisplayProductName(order)}」？奖励 ${formatMoney(
           resolveHallRewardAmount(order),
         )}`,
         okText: '确认抢单',
@@ -345,7 +380,7 @@ export default function WorkerHallPage() {
         onOk: () => submitGrab(order),
       })
     },
-    [grabConfirmEnabled, modal, submitGrab],
+    [grabConfirmEnabled, modal, submitGrab, resolveDisplayProductName],
   )
 
   const openSharingModal = useCallback((order: WorkOrder) => {
@@ -679,6 +714,7 @@ export default function WorkerHallPage() {
                   remainingSlots={remainingSlots}
                   isInternalWorker={isInternalWorker}
                   grabbing={grabbingId === order.workOrderId}
+                  productNameSuffixItems={productNameSuffixItems}
                   onGrab={requestGrab}
                   onOpenSharing={openSharingModal}
                 />
@@ -1017,6 +1053,7 @@ export default function WorkerHallPage() {
                       remainingSlots={remainingSlots}
                       isInternalWorker={isInternalWorker}
                       grabbing={grabbingId === order.workOrderId}
+                      productNameSuffixItems={productNameSuffixItems}
                       onGrab={requestGrab}
                       onOpenSharing={openSharingModal}
                     />
@@ -1031,7 +1068,7 @@ export default function WorkerHallPage() {
       )}
 
       <Modal
-        title={`拼单参与 · ${sharingOrder ? resolveHallProductName(sharingOrder) : ''}`}
+        title={`拼单参与 · ${sharingOrder ? resolveDisplayProductName(sharingOrder) : ''}`}
         width={isMobile ? '92%' : 520}
         open={Boolean(sharingOrder)}
         confirmLoading={submittingSharing}
@@ -1169,6 +1206,8 @@ type HallCardProps = {
   remainingSlots: number | null
   isInternalWorker: boolean
   grabbing: boolean
+  /** 后台「杂项配置」维护的来源后缀；仅展示追加，不影响复制内容 */
+  productNameSuffixItems: ProductNameSourceSuffixItem[]
   onGrab: (order: WorkOrder) => void
   onOpenSharing: (order: WorkOrder) => void
 }
@@ -1202,11 +1241,17 @@ const HallDesktopCard = memo(function HallDesktopCard({
   remainingSlots,
   isInternalWorker,
   grabbing,
+  productNameSuffixItems,
   onGrab,
   onOpenSharing,
 }: HallCardProps) {
   const disabledReason = resolveGrabDisabledReason(order, worker, remainingSlots)
-  const productName = resolveHallProductName(order) || '未命名商品'
+  const productName =
+    applyProductNameSourceSuffix(
+      resolveHallProductName(order),
+      order.sourceProvider,
+      productNameSuffixItems,
+    ) || '未命名商品'
   const sharingRemaining = resolveHallRemainingQuantity(order)
   const depositAmount = resolveHallDepositAmount(order)
   const rewardAmount = resolveHallRewardAmount(order)
@@ -1326,11 +1371,17 @@ const HallMobileCard = memo(function HallMobileCard({
   remainingSlots,
   isInternalWorker,
   grabbing,
+  productNameSuffixItems,
   onGrab,
   onOpenSharing,
 }: HallCardProps) {
   const disabledReason = resolveGrabDisabledReason(order, worker, remainingSlots)
-  const productName = resolveHallProductName(order) || '未命名商品'
+  const productName =
+    applyProductNameSourceSuffix(
+      resolveHallProductName(order),
+      order.sourceProvider,
+      productNameSuffixItems,
+    ) || '未命名商品'
   const sharingRemaining = resolveHallRemainingQuantity(order)
   const myShareSummary = resolveHallMyShareSummary(order)
 

apps/frontend/src/pages/worker/WorkerOrderDetailDrawer.tsx

@@ -7,6 +7,10 @@ import VideoPreview, { formatAcceptanceVideoDuration } from '@/components/files/
 import type { WorkOrder } from '@/types/worker-platform'
 import { formatDateTime } from '@/utils/date-time'
 import { resolveOrderConsignmentScreenshotUrls } from '@/utils/consignment-display'
+import {
+  applyProductNameSourceSuffix,
+  type ProductNameSourceSuffixItem,
+} from '@/utils/product-name-source-suffix'
 
 import {
   canEditAcceptanceImages,
@@ -35,6 +39,7 @@ export function WorkerOrderDetailDrawer({
   isMobile,
   order,
   orderTimelineVisible,
+  productNameSuffixItems,
   onClose,
   onOpenAcceptance,
   onOpenGiftMaterial,
@@ -44,6 +49,8 @@ export function WorkerOrderDetailDrawer({
   isMobile: boolean
   order: WorkOrder | null
   orderTimelineVisible: boolean
+  /** 后台「杂项配置」维护的来源后缀；仅展示追加，不影响复制内容 */
+  productNameSuffixItems: ProductNameSourceSuffixItem[]
   onClose: () => void
   onOpenAcceptance: (order: WorkOrder) => void
   onOpenGiftMaterial: (order: WorkOrder) => void
@@ -51,6 +58,13 @@ export function WorkerOrderDetailDrawer({
   onOpenFeedback: (order: WorkOrder) => void
 }) {
   const isTimedOut = Boolean(order && (order.status === 'open' || order.timeoutNotice?.isTimedOut))
+  const displayProductName = order
+    ? applyProductNameSourceSuffix(
+        order.productName,
+        order.sourceProvider,
+        productNameSuffixItems,
+      ) || '-'
+    : '-'
 
   return (
     <Drawer
@@ -121,7 +135,7 @@ export function WorkerOrderDetailDrawer({
           </div>
           <Card title="基础信息" size="small">
             <Descriptions column={{ xs: 1, md: 2 }} bordered size="small">
-              <Descriptions.Item label="商品">{order.productName || '-'}</Descriptions.Item>
+              <Descriptions.Item label="商品">{displayProductName}</Descriptions.Item>
               <Descriptions.Item label="分类">{order.categoryName || '-'}</Descriptions.Item>
               <Descriptions.Item label="工单编号">{getDisplayOrderNo(order)}</Descriptions.Item>
               <Descriptions.Item label="状态">

apps/frontend/src/pages/worker/WorkerOrderMobileList.tsx

@@ -20,6 +20,10 @@ import type {
   WorkOrder,
 } from '@/types/worker-platform'
 import { formatDateTime } from '@/utils/date-time'
+import {
+  applyProductNameSourceSuffix,
+  type ProductNameSourceSuffixItem,
+} from '@/utils/product-name-source-suffix'
 
 import type { WorkerOrderStatusOption } from './WorkerOrderDesktopList'
 import {
@@ -56,6 +60,7 @@ export function WorkerOrderMobileList({
   pagination,
   page,
   pageSize,
+  productNameSuffixItems,
   renderShareTable,
   loading,
   searching,
@@ -85,6 +90,8 @@ export function WorkerOrderMobileList({
   pagination: PaginationData | undefined
   page: number
   pageSize: number
+  /** 后台「杂项配置」维护的来源后缀；仅展示追加，不影响复制内容 */
+  productNameSuffixItems: ProductNameSourceSuffixItem[]
   renderShareTable?: (order: WorkOrder) => ReactNode
   loading: boolean
   searching: boolean
@@ -178,6 +185,7 @@ export function WorkerOrderMobileList({
             <WorkerOrderMobileCard
               key={order.workOrderId}
               order={order}
+              productNameSuffixItems={productNameSuffixItems}
               renderShareTable={renderShareTable}
               onOpenDetail={onOpenDetail}
               onOpenAcceptance={onOpenAcceptance}
@@ -209,6 +217,7 @@ export function WorkerOrderMobileList({
 
 function WorkerOrderMobileCard({
   order,
+  productNameSuffixItems,
   renderShareTable,
   onOpenDetail,
   onOpenAcceptance,
@@ -251,6 +260,9 @@ function WorkerOrderMobileCard({
   const workerNote = String(order.workerNote || '').trim()
   const statusDisplay = getOrderStatusDisplay(order)
   const flagTags = getOrderFlagTags(order)
+  const displayProductName =
+    applyProductNameSourceSuffix(order.productName, order.sourceProvider, productNameSuffixItems) ||
+    '未命名商品'
 
   return (
     <article className="worker-order-mobile-card">
@@ -308,7 +320,7 @@ function WorkerOrderMobileCard({
       </div>
 
       <div className="worker-order-mobile-main-row">
-        <div className="worker-order-mobile-product-title">{order.productName || '未命名商品'}</div>
+        <div className="worker-order-mobile-product-title">{displayProductName}</div>
         {order.status === 'open' || order.timeoutNotice?.isTimedOut ? (
           <div className="worker-order-mobile-price-badge">
             <span className="worker-order-mobile-price-label" style={{ color: '#cf1322' }}>

apps/frontend/src/pages/worker/WorkerOrderTableColumns.tsx

@@ -12,6 +12,10 @@ import { DeadlineCountdown } from '@/components/DeadlineCountdown'
 import ImagePreviewList from '@/components/files/ImagePreviewList'
 import type { WorkOrder } from '@/types/worker-platform'
 import { formatDateTime } from '@/utils/date-time'
+import {
+  applyProductNameSourceSuffix,
+  type ProductNameSourceSuffixItem,
+} from '@/utils/product-name-source-suffix'
 
 import {
   canEditAcceptanceImages,
@@ -40,6 +44,7 @@ import {
 type NoteTheme = 'success' | 'processing' | 'danger' | 'warning' | 'purple' | 'default'
 
 export function buildWorkerOrderTableColumns({
+  productNameSuffixItems,
   onOpenDetail,
   onOpenAcceptance,
   onOpenGiftMaterial,
@@ -50,6 +55,7 @@ export function buildWorkerOrderTableColumns({
   onCopyOrderInfo,
   onCopyMaterialImages,
 }: {
+  productNameSuffixItems: ProductNameSourceSuffixItem[]
   onOpenDetail: (order: WorkOrder) => void
   onOpenAcceptance: (order: WorkOrder) => void
   onOpenGiftMaterial: (order: WorkOrder) => void
@@ -64,41 +70,49 @@ export function buildWorkerOrderTableColumns({
     {
       title: '订单信息',
       width: 270,
-      render: (_, row) => (
+      render: (_, row) => {
-        <div className="cell-stack">
+        const displayProductName =
-          <Space size={4} align="center">
+          applyProductNameSourceSuffix(
-            {row.isUnread ? (
+            row.productName,
-              <Tag color="purple" className="worker-order-unread-tag">
+            row.sourceProvider,
-                新
+            productNameSuffixItems,
-              </Tag>
+          ) || '未命名商品'
-            ) : null}
+        return (
-            <Typography.Link
+          <div className="cell-stack">
-              strong
+            <Space size={4} align="center">
-              onClick={() => onOpenDetail(row)}
+              {row.isUnread ? (
-              title={row.productName || '未命名商品'}
+                <Tag color="purple" className="worker-order-unread-tag">
-              ellipsis
+                  新
+                </Tag>
+              ) : null}
+              <Typography.Link
+                strong
+                onClick={() => onOpenDetail(row)}
+                title={displayProductName}
+                ellipsis
+              >
+                {displayProductName}
+              </Typography.Link>
+            </Space>
+            <Space size={[4, 4]} wrap>
+              {row.categoryName ? <Tag color="blue">{row.categoryName}</Tag> : null}
+              {row.myShares?.length || row.myShare ? (
+                <Tag color="purple">拼单 {row.myShares?.length || 1} 次</Tag>
+              ) : null}
+            </Space>
+            <Typography.Text
+              type="secondary"
+              style={{ fontSize: 12 }}
+              ellipsis={{ tooltip: getDisplayOrderNo(row) }}
             >
-              {row.productName || '未命名商品'}
+              {getDisplayOrderNo(row)}
-            </Typography.Link>
+            </Typography.Text>
-          </Space>
+            <Typography.Text type="secondary" style={{ fontSize: 12 }}>
-          <Space size={[4, 4]} wrap>
+              接单：{formatDateTime(row.assignedAt)}
-            {row.categoryName ? <Tag color="blue">{row.categoryName}</Tag> : null}
+            </Typography.Text>
-            {row.myShares?.length || row.myShare ? (
+          </div>
-              <Tag color="purple">拼单 {row.myShares?.length || 1} 次</Tag>
+        )
-            ) : null}
+      },
-          </Space>
-          <Typography.Text
-            type="secondary"
-            style={{ fontSize: 12 }}
-            ellipsis={{ tooltip: getDisplayOrderNo(row) }}
-          >
-            {getDisplayOrderNo(row)}
-          </Typography.Text>
-          <Typography.Text type="secondary" style={{ fontSize: 12 }}>
-            接单：{formatDateTime(row.assignedAt)}
-          </Typography.Text>
-        </div>
-      ),
     },
     {
       title: '状态',

apps/frontend/src/pages/worker/WorkerOrdersPage.tsx

@@ -1,7 +1,7 @@
 import { keepPreviousData, useQuery, useQueryClient } from '@tanstack/react-query'
 import { useNavigate } from 'react-router'
 import { App, Badge, Button, Form, Modal, Radio, Space, Tag, Typography } from 'antd'
-import { useState } from 'react'
+import { useMemo, useState } from 'react'
 
 import {
   fetchWorkerAfterSalesCases,
@@ -9,6 +9,7 @@ import {
   fetchWorkerOrderFeedbacks,
   fetchWorkerMyOrderOverview,
   fetchWorkerMyOrders,
+  fetchWorkerProductNameSuffix,
   fetchWorkerProfile,
   markWorkerOrderRead,
   remindWorkerAcceptance,
@@ -206,6 +207,18 @@ export default function WorkerOrdersPage() {
   const pagination = ordersQuery.data?.data.pagination
   const orders = ordersQuery.data?.data.items || []
 
+  // 商品名来源后缀（后台「杂项配置」维护）：仅展示追加，复制资料仍用原始商品名。
+  const productNameSuffixQuery = useQuery({
+    queryKey: ['worker-product-name-suffix'],
+    queryFn: fetchWorkerProductNameSuffix,
+    staleTime: 5 * 60 * 1000,
+    retry: false,
+  })
+  const productNameSuffixItems = useMemo(
+    () => productNameSuffixQuery.data?.data.items || [],
+    [productNameSuffixQuery.data],
+  )
+
   // 流转记录对打手是否可见（后台配置开关，默认关闭）
   const profileQuery = useQuery({
     queryKey: ['worker-profile'],
@@ -626,6 +639,7 @@ export default function WorkerOrdersPage() {
   }
 
   const columns = buildWorkerOrderTableColumns({
+    productNameSuffixItems,
     onOpenDetail: openOrderDetail,
     onOpenAcceptance: openAcceptanceModal,
     onOpenGiftMaterial: openGiftMaterialModal,
@@ -686,6 +700,7 @@ export default function WorkerOrdersPage() {
           pagination={pagination}
           page={page}
           pageSize={pageSize}
+          productNameSuffixItems={productNameSuffixItems}
           renderShareTable={renderShareTable}
           loading={ordersQuery.isLoading}
           searching={ordersQuery.isFetching}
@@ -767,6 +782,7 @@ export default function WorkerOrdersPage() {
         isMobile={isMobile}
         order={detailOrder}
         orderTimelineVisible={orderTimelineVisible}
+        productNameSuffixItems={productNameSuffixItems}
         onClose={() => setDetailOrder(null)}
         onOpenAcceptance={openAcceptanceModal}
         onOpenGiftMaterial={openGiftMaterialModal}

apps/frontend/src/services/admin/consignment.ts

@@ -5,6 +5,7 @@ import type {
   ConsignmentStatsSummary,
   ConsignmentSubmission,
   InventoryMatchableOrders,
+  PendingPistolMatchResult,
   WorkOrderInventoryMatchCheck,
   WorkOrderInventoryMatchOptions,
 } from '@/types/consignment'
@@ -158,6 +159,22 @@ export function fetchInventoryMatchableOrders(
   )
 }
 
+/** 全局匹配看板：非拼单待抢单手枪 × 在库待匹配现货，按细粒度评分排序。 */
+export function fetchPendingPistolMatches(params?: {
+  keyword?: string
+  includeConflicts?: boolean
+  limit?: number
+}) {
+  return apiGet<PendingPistolMatchResult>(
+    '/api/v1/admin/worker-platform/consignment/pending-pistol-matches',
+    {
+      keyword: params?.keyword?.trim() || undefined,
+      includeConflicts: params?.includeConflicts ? 'true' : undefined,
+      limit: params?.limit,
+    },
+  )
+}
+
 /** 履约/指派返回的电子凭证核销结果：ok=false 时必须提示运营人工核销，不能报成功 */
 export type WorkOrderVoucherConsumeResult = {
   ok: boolean

apps/frontend/src/services/admin/worker-platform.ts

@@ -29,6 +29,7 @@ import type {
   WorkerPlatformNotificationConfig,
   WorkerProductMatchConfig,
   WorkerAnnouncementConfig,
+  WorkerProductNameSuffixConfig,
   WorkerLevel,
   WorkerListResponse,
   WorkerUserListResponse,
@@ -109,6 +110,22 @@ export function saveAdminWorkerAnnouncement(payload: WorkerAnnouncementConfig) {
   return apiPost<WorkerAnnouncementConfig>('/api/v1/admin/worker-platform/announcement', payload)
 }
 
+export function fetchAdminWorkerProductNameSuffix() {
+  return apiGet<WorkerProductNameSuffixConfig>('/api/v1/admin/worker-platform/product-name-suffix')
+}
+
+/** 来源下拉选项：来自工单资料里的 source.provider */
+export function fetchAdminWorkerProductNameSuffixSources() {
+  return apiGet<{ items: string[] }>('/api/v1/admin/worker-platform/product-name-suffix/sources')
+}
+
+export function saveAdminWorkerProductNameSuffix(payload: WorkerProductNameSuffixConfig) {
+  return apiPost<WorkerProductNameSuffixConfig>(
+    '/api/v1/admin/worker-platform/product-name-suffix',
+    payload,
+  )
+}
+
 export function fetchAdminWorkerCancelRequests(
   status: 'pending' | 'approved' | 'rejected' = 'pending',
 ) {

apps/frontend/src/services/worker.ts

@@ -11,6 +11,8 @@ import type {
   WorkerCancelRequest,
   WorkerCancelRequestRisk,
   WorkerAnnouncementConfig,
+  WorkerProductNameSuffixConfig,
+  WorkerProductNameSuffixDisplayConfig,
   WorkerAcceptanceConfig,
   WorkerAcceptanceVideo,
   WorkerOrderFeedback,
@@ -152,6 +154,11 @@ export function fetchWorkerAnnouncement() {
   return apiGet<WorkerAnnouncementConfig>('/api/v1/worker/announcement')
 }
 
+/** 商品名来源后缀映射（后台「杂项配置」维护，只返回已启用项），打手端列表/详情/大厅展示用。 */
+export function fetchWorkerProductNameSuffix() {
+  return apiGet<WorkerProductNameSuffixDisplayConfig>('/api/v1/worker/product-name-suffix')
+}
+
 /** 验收视频配置（后台可改）：时长上限、目标高度、码率等，压缩前读取。 */
 export function fetchWorkerAcceptanceConfig() {
   return apiGet<WorkerAcceptanceConfig>('/api/v1/worker/acceptance/config')

apps/frontend/src/types/consignment.ts

@@ -240,3 +240,32 @@ export type WorkOrderInventoryMatchCheck = {
   partialCount: number
   matches: ConsignmentMatchResult[]
 }
+
+/** 后台「寄售仓库 → 匹配」：待抢单手枪 × 在库待匹配现货的配对明细 */
+export type PendingPistolMatchPair = {
+  workOrderId: number
+  workOrderNo: string
+  platformOrderId: string
+  productName: string
+  workOrderCreatedAt: string | null
+  inventoryId: number
+  consignmentNo: string
+  inventoryNo: string
+  itemName: string
+  inventoryInboundAt: string | null
+  matchType: 'exact' | 'partial' | 'conflict'
+  score: number
+  reason: string
+  conflicts: string[]
+}
+
+export type PendingPistolMatchResult = {
+  pendingOrderCount: number
+  inStockInventoryCount: number
+  pairCount: number
+  exactCount: number
+  partialCount: number
+  conflictCount: number
+  truncated: boolean
+  pairs: PendingPistolMatchPair[]
+}

apps/frontend/src/types/worker-platform.ts

@@ -325,6 +325,26 @@ export type WorkerAnnouncementConfig = {
   content: string
 }
 
+export type WorkerProductNameSuffixItem = {
+  /** 来源标识（精确匹配、不区分大小写），如 91kaquan */
+  source: string
+  /** 括号内的后缀文字，如 91卡券 */
+  suffix: string
+  /** 是否启用；同一时间只允许启用一条 */
+  enabled: boolean
+  /** 后台备注（仅后台配置页可见） */
+  note: string
+}
+
+export type WorkerProductNameSuffixConfig = {
+  items: WorkerProductNameSuffixItem[]
+}
+
+/** 打手端只拿启用的来源 -> 后缀映射 */
+export type WorkerProductNameSuffixDisplayConfig = {
+  items: Array<Pick<WorkerProductNameSuffixItem, 'source' | 'suffix'>>
+}
+
 export type WorkerHallConfig = {
   maxVisibleOrders: number
   showSubcategories?: boolean
@@ -622,6 +642,8 @@ export type WorkOrder = {
   workOrderNo: string
   platformOrderId: string
   productName: string
+  /** 来源平台标识（如 91kaquan），仅打手端返回；用于按后台配置追加展示后缀 */
+  sourceProvider?: string
   categoryId?: number | null
   categoryName: string
   parentCategoryId?: number | null

apps/frontend/src/utils/product-name-source-suffix.ts

@@ -0,0 +1,69 @@
+export type ProductNameSourceSuffixItem = {
+  /** 来源标识，如 91kaquan */
+  source: string
+  /** 括号内的后缀文字，如 91卡券 */
+  suffix: string
+  /** 未启用（false）的配置不参与展示；缺省按启用处理，兼容打手端精简数据 */
+  enabled?: boolean
+}
+
+/** 后缀只保留括号内的文字：填了外层全角/半角括号时自动剥离。 */
+export function normalizeProductNameSuffixText(value: unknown): string {
+  let text = String(value ?? '').trim()
+  if (!text) return ''
+  const wrappedFullWidth = text.startsWith('（') && text.endsWith('）')
+  const wrappedHalfWidth = text.startsWith('(') && text.endsWith(')')
+  if ((wrappedFullWidth || wrappedHalfWidth) && text.length >= 2) {
+    text = text.slice(1, -1).trim()
+  }
+  return text
+}
+
+/**
+ * 按来源取后缀：来源精确匹配、不区分大小写，空来源或空后缀不命中。
+ * 同一来源配置多条时以第一条有效配置为准。
+ */
+export function resolveProductNameSourceSuffix(
+  items: ProductNameSourceSuffixItem[] | null | undefined,
+  provider: unknown,
+): string {
+  const normalizedProvider = String(provider ?? '')
+    .trim()
+    .toLowerCase()
+  if (!normalizedProvider) return ''
+
+  for (const item of items ?? []) {
+    if (item?.enabled === false) continue
+    const source = String(item?.source ?? '')
+      .trim()
+      .toLowerCase()
+    if (!source || source !== normalizedProvider) continue
+    const suffix = normalizeProductNameSuffixText(item?.suffix)
+    if (suffix) return suffix
+  }
+  return ''
+}
+
+/**
+ * 在商品名后追加「（后缀）」；没有后缀时原样返回。
+ * 商品名已以相同后缀结尾（全角/半角括号均可）时不重复追加。
+ */
+export function appendProductNameSourceSuffix(productName: unknown, suffix: unknown): string {
+  const name = String(productName ?? '').trim()
+  const normalizedSuffix = normalizeProductNameSuffixText(suffix)
+  if (!name || !normalizedSuffix) return name
+
+  if (name.endsWith(`（${normalizedSuffix}）`) || name.endsWith(`(${normalizedSuffix})`)) {
+    return name
+  }
+  return `${name}（${normalizedSuffix}）`
+}
+
+/** 展示用：按来源匹配后一次性完成后缀追加；无匹配时返回原商品名。 */
+export function applyProductNameSourceSuffix(
+  productName: unknown,
+  provider: unknown,
+  items: ProductNameSourceSuffixItem[] | null | undefined,
+): string {
+  return appendProductNameSourceSuffix(productName, resolveProductNameSourceSuffix(items, provider))
+}

apps/frontend/tests/product-name-source-suffix.test.ts

@@ -0,0 +1,92 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import {
+  appendProductNameSourceSuffix,
+  applyProductNameSourceSuffix,
+  normalizeProductNameSuffixText,
+  resolveProductNameSourceSuffix,
+} from '../src/utils/product-name-source-suffix.ts'
+
+const items = [
+  { source: '91kaquan', suffix: '91卡券' },
+  { source: 'douyin', suffix: '抖音' },
+]
+
+test('来源后缀：空配置不追加', () => {
+  assert.equal(applyProductNameSourceSuffix('苏尔南手枪', '91kaquan', []), '苏尔南手枪')
+  assert.equal(applyProductNameSourceSuffix('苏尔南手枪', '91kaquan', null), '苏尔南手枪')
+})
+
+test('来源后缀：精确匹配后追加全角括号后缀', () => {
+  assert.equal(
+    applyProductNameSourceSuffix('苏尔南手枪', '91kaquan', items),
+    '苏尔南手枪（91卡券）',
+  )
+})
+
+test('来源后缀：来源匹配不区分大小写并去除首尾空格', () => {
+  assert.equal(resolveProductNameSourceSuffix(items, ' 91KAQUAN '), '91卡券')
+  assert.equal(
+    applyProductNameSourceSuffix('苏尔南手枪', ' 91Kaquan ', items),
+    '苏尔南手枪（91卡券）',
+  )
+})
+
+test('来源后缀：没有匹配来源时不追加', () => {
+  assert.equal(applyProductNameSourceSuffix('苏尔南手枪', 'kuaishou', items), '苏尔南手枪')
+  assert.equal(applyProductNameSourceSuffix('苏尔南手枪', '', items), '苏尔南手枪')
+})
+
+test('来源后缀：商品名已带相同后缀时不重复追加', () => {
+  assert.equal(
+    appendProductNameSourceSuffix('苏尔南手枪（91卡券）', '91卡券'),
+    '苏尔南手枪（91卡券）',
+  )
+  assert.equal(appendProductNameSourceSuffix('苏尔南手枪(91卡券)', '91卡券'), '苏尔南手枪(91卡券)')
+})
+
+test('来源后缀：后缀为空或商品名为空时不做处理', () => {
+  assert.equal(appendProductNameSourceSuffix('苏尔南手枪', ''), '苏尔南手枪')
+  assert.equal(appendProductNameSourceSuffix('', '91卡券'), '')
+  assert.equal(applyProductNameSourceSuffix('', '91kaquan', items), '')
+})
+
+test('来源后缀：配置里的外层括号会被剥离后再拼接', () => {
+  assert.equal(normalizeProductNameSuffixText('（91卡券）'), '91卡券')
+  assert.equal(normalizeProductNameSuffixText('(91卡券)'), '91卡券')
+  assert.equal(
+    applyProductNameSourceSuffix('苏尔南手枪', '91kaquan', [
+      { source: '91kaquan', suffix: '（91卡券）' },
+    ]),
+    '苏尔南手枪（91卡券）',
+  )
+})
+
+test('来源后缀：停用的配置不参与展示，启用后才追加', () => {
+  assert.equal(
+    applyProductNameSourceSuffix('苏尔南手枪', '91kaquan', [
+      { source: '91kaquan', suffix: '91卡券', enabled: false },
+    ]),
+    '苏尔南手枪',
+  )
+  assert.equal(
+    applyProductNameSourceSuffix('苏尔南手枪', '91kaquan', [
+      { source: '91kaquan', suffix: '91卡券', enabled: true },
+    ]),
+    '苏尔南手枪（91卡券）',
+  )
+})
+
+test('来源后缀：同一来源多条配置时取第一条有效后缀', () => {
+  assert.equal(
+    resolveProductNameSourceSuffix(
+      [
+        { source: '91kaquan', suffix: '第一' },
+        { source: '91kaquan', suffix: '第二' },
+      ],
+      '91kaquan',
+    ),
+    '第一',
+  )
+})