feat(admin): family-aware goods view - auto tags readonly, clean link names, config badges, locate highlight

apps/admin/src/types/index.ts

@@ -360,6 +360,7 @@ export interface OriginGood {
   sizeRowCount?: number
   packageRowCount?: number
   productCode?: string | null
+  family?: { familyId: string; familyCode: string | null; familyName: string } | null
 }
 
 // Origin Goods Tree types

apps/admin/src/utils/origin-name.spec.ts

@@ -1,5 +1,11 @@
 import { describe, expect, it } from 'vitest';
-import { sameOriginGroup, truncateToProcess } from './origin-name';
+import {
+  cleanLinkName,
+  deriveLinkTagNames,
+  parseLinkName,
+  sameOriginGroup,
+  truncateToProcess,
+} from './origin-name';
 
 describe('truncateToProcess', () => {
   it('keeps first 3 dash segments (drops warehouse)', () => {
@@ -44,3 +50,59 @@ describe('sameOriginGroup', () => {
     expect(sameOriginGroup('', '')).toBe(false);
   });
 });
+
+describe('parseLinkName / cleanLinkName', () => {
+  it('parses 国家（物流）品名-SKU-工艺 → 品名 + 型号', () => {
+    expect(parseLinkName('美国（包邮）180g纯棉T恤成人款-DG001-单面印花')).toEqual({
+      productName: '180g纯棉T恤成人款',
+      skuCode: 'DG001',
+    });
+    expect(cleanLinkName('美国（包邮）180g纯棉T恤成人款-DG001-单面印花')).toBe(
+      '180g纯棉T恤成人款 DG001',
+    );
+  });
+
+  it('handles half-width parens and warehouse suffix', () => {
+    expect(
+      cleanLinkName('美国(不包邮光板)180GT恤成人款-JSA002-不打印·美西洛杉矶二仓'),
+    ).toBe('180GT恤成人款 JSA002');
+  });
+
+  it('returns null / raw fallback for manual names without the country(remark) structure', () => {
+    expect(parseLinkName('180g纯棉T恤成人款')).toBeNull();
+    expect(cleanLinkName('180g纯棉T恤成人款')).toBe('180g纯棉T恤成人款');
+    expect(cleanLinkName(null)).toBe('');
+  });
+
+  it('returns null when product name after parens is empty', () => {
+    expect(parseLinkName('美国（包邮）-DG001-单面印花')).toBeNull();
+  });
+});
+
+describe('deriveLinkTagNames', () => {
+  it('单面印花 + 包邮 + 无工艺关键字 → 单面印花/烫画/包邮', () => {
+    expect(deriveLinkTagNames('美国（包邮）180g纯棉T恤成人款-DG001-单面印花')).toEqual([
+      '单面印花',
+      '烫画',
+      '包邮',
+    ]);
+  });
+
+  it('不打印 + 光板 + 不包邮 → 两工艺标签 + 不包邮', () => {
+    expect(
+      deriveLinkTagNames('美国（不包邮光板）180GT恤成人款-JSA002-不打印·美西洛杉矶二仓'),
+    ).toEqual(['不打印', '光板', '不包邮']);
+  });
+
+  it('双面印花 + 不包邮，且不误命中包邮', () => {
+    expect(deriveLinkTagNames('美国（不包邮）T恤-DG001-双面印花·美东新泽西仓')).toEqual([
+      '双面印花',
+      '烫画',
+      '不包邮',
+    ]);
+  });
+
+  it('空名称返回空数组', () => {
+    expect(deriveLinkTagNames(null)).toEqual([]);
+  });
+});

apps/admin/src/utils/origin-name.ts

@@ -18,3 +18,54 @@ export function sameOriginGroup(
   const ka = truncateToProcess(a);
   return ka !== '' && ka === truncateToProcess(b);
 }
+
+/** 链接名结构化解析结果：品名 + 型号（SKU 代码） */
+export interface ParsedLinkName {
+  productName: string;
+  skuCode: string | null;
+}
+
+/**
+ * 解析链接名称：`国家（物流备注）品名-SKU-工艺位置[-·仓库名]` → 品名 + 型号。
+ * 与 api 端 origin-name.parser.ts 同构；解析失败（无「国家（备注）」前缀结构）返回 null，
+ * 调用方应回退显示原始名称 —— 手动维护的品名不走该解析。
+ */
+export function parseLinkName(name: string | null | undefined): ParsedLinkName | null {
+  if (!name) return null;
+  const segs = name.split('-').map((s) => s.trim());
+  const head = segs[0] ?? '';
+  const closeIdx = Math.max(head.lastIndexOf('）'), head.lastIndexOf(')'));
+  if (closeIdx <= 0 || closeIdx === head.length - 1) return null;
+  const productName = head.slice(closeIdx + 1).trim();
+  if (!productName) return null;
+  const skuCode = segs[1] || null;
+  return { productName, skuCode };
+}
+
+/** 展示名：`品名 型号`（如「180g纯棉T恤成人款 DG001」）；解析失败回退原名 */
+export function cleanLinkName(name: string | null | undefined): string {
+  if (!name) return '';
+  const parsed = parseLinkName(name);
+  if (!parsed) return name;
+  return parsed.skuCode ? `${parsed.productName} ${parsed.skuCode}` : parsed.productName;
+}
+
+const CRAFT_KEYWORDS = ['直喷', '不打印', '光板'] as const;
+
+/**
+ * 由链接名称派生标签名（与 api 端 auto-tag-rules.ts 规则一致，仅用于成员行只读展示）：
+ * 印花数量：双面印花 优先于 单面印花；工艺：直喷/不打印/光板，皆无则默认烫画；
+ * 物流：不包邮 优先于 包邮。
+ */
+export function deriveLinkTagNames(name: string | null | undefined): string[] {
+  if (!name) return [];
+  const names: string[] = [];
+  if (name.includes('双面印花')) names.push('双面印花');
+  else if (name.includes('单面印花')) names.push('单面印花');
+  const craftHits = CRAFT_KEYWORDS.filter((k) => name.includes(k));
+  if (craftHits.length > 0) names.push(...craftHits);
+  else names.push('烫画');
+  if (name.includes('不包邮')) names.push('不包邮');
+  else if (name.includes('包邮')) names.push('包邮');
+  return names;
+}

apps/admin/src/views/goods/GoodsView.vue

@@ -18,7 +18,7 @@ import { tagGroupsApi } from '@/api/tag-groups'
 import { originGoodsApi } from '@/api/origin-goods'
 import { syncApi } from '@/api/sync'
 import { sameFamily } from '@/utils/family-match'
-import { truncateToProcess } from '@/utils/origin-name'
+import { cleanLinkName, deriveLinkTagNames, truncateToProcess } from '@/utils/origin-name'
 import { productFamiliesApi } from '@/api/product-families'
 
 const mode = ref<'category' | 'country' | 'global'>('category')
@@ -182,7 +182,9 @@ function goodToNode(g: Good): any {
 const filteredGoods = computed(() => {
   let result = allGoods.value
   if (searchKeyword.value) {
-    result = result.filter(g => g.goodName?.includes(searchKeyword.value))
+    const kw = searchKeyword.value
+    // 同时匹配原始链接名与解析后的「品名 型号」展示名
+    result = result.filter(g => g.goodName?.includes(kw) || cleanLinkName(g.goodName).includes(kw))
   }
   if (selectedCountryIds.value.length) {
     result = result.filter(g => selectedCountryIds.value.includes(g.countryId))
@@ -289,13 +291,32 @@ function buildRightTree(tree: OriginGoodsTreeResponse) {
       children: [...children, ...goods],
     }
   }
-  rightTreeData.value = tree.tree.map(mapCat)
+  const roots = tree.tree.map(mapCat)
+  // 已配置数按族计入：链接成族（或已配置商品）即视为已配置，后序汇总到各级分类
+  function fillConfiguredEff(nodes: any[]): number {
+    let count = 0
+    for (const n of nodes) {
+      if (n.isOG) {
+        n.configuredEff = n.configuredCount > 0 || n.familyId ? 1 : 0
+      } else {
+        n.configuredEff = fillConfiguredEff(n.children ?? [])
+      }
+      count += n.configuredEff
+    }
+    return count
+  }
+  fillConfiguredEff(roots)
+  rightTreeData.value = roots
 }
 
 function rightFilterNode(_value: string, data: any) {
   if (data.isOG) {
-    if (showUnconfiguredOnly.value && data.configuredCount > 0) return false
-    if (searchKeyword.value && !data.label.includes(searchKeyword.value)) return false
+    // 「仅未配置」同样把族内链接视为已配置
+    if (showUnconfiguredOnly.value && (data.configuredCount > 0 || data.familyId)) return false
+    if (searchKeyword.value) {
+      const kw = searchKeyword.value
+      if (!data.label.includes(kw) && !cleanLinkName(data.label).includes(kw)) return false
+    }
     return true
   }
   return true
@@ -930,8 +951,17 @@ function locateInRightTree(originGoodId: string) {
   }, 250)
 }
 
+/** 右侧定位到左侧后短暂闪烁的商品 id（用于行级高亮动画） */
+const locateFlashGoodId = ref<string>('')
+
 function locateInLeftTree(originGoodId: string) {
-  const good = allGoods.value.find(g => g.originGoodId === originGoodId)
+  // 链接 → 商品：优先精确匹配该链接配置的商品，其次同族商品（族内任一链接都可定位）
+  const ogNode = findOgNodeById(originGoodId)
+  const familyId = ogNode?.familyId ?? null
+  const good = allGoods.value.find(g => String(g.originGoodId) === String(originGoodId))
+    ?? (familyId
+      ? allGoods.value.find(g => g.originGood?.family?.familyId === familyId)
+      : null)
   if (!good) {
     ElMessage.warning('该原产品尚未配置到官网')
     return
@@ -958,6 +988,9 @@ function locateInLeftTree(originGoodId: string) {
   }
   setTimeout(() => {
     tree.setCurrentKey(targetKey)
+    // 闪烁高亮定位行（2.4s 后自动消失）
+    locateFlashGoodId.value = good.id
+    setTimeout(() => { if (locateFlashGoodId.value === good.id) locateFlashGoodId.value = '' }, 2400)
     nextTick(() => {
       const el = document.querySelector('.gv-left .el-tree-node.is-current') as HTMLElement
       el?.scrollIntoView({ behavior: 'smooth', block: 'center' })
@@ -1293,27 +1326,14 @@ const groupedTagOptions = computed(() => {
   return groups
 })
 
-// ─── 族派生标签：物流/工艺/位置组由族自动同步，表单中只读 ───
-const isAutoTagGroup = (name: string) => /物流|工艺|位置/.test(name)
+// ─── 派生标签：物流/工艺/印花数量组由系统按链接名称自动生成，表单中只读 ───
+const isAutoTagGroup = (name: string) => /物流|工艺|位置|印花数量/.test(name)
 const autoTagGroupIds = computed(() =>
   new Set(allTagGroups.value.filter((g) => isAutoTagGroup(g.groupName)).map((g) => g.id)),
 )
-const configHasFamily = computed(() => Boolean((configOG.value as any)?.familyId))
-const configTagOptions = computed(() =>
-  configHasFamily.value
-    ? groupedTagOptions.value.filter((g) => g.id === 'ungrouped' || !autoTagGroupIds.value.has(g.id as any))
-    : groupedTagOptions.value,
-)
-const editTagOptions = computed(() =>
-  editFamilyId.value
-    ? groupedTagOptions.value.filter((g) => g.id === 'ungrouped' || !autoTagGroupIds.value.has(g.id as any))
-    : groupedTagOptions.value,
-)
-/** 当前商品的自动组标签（只读展示） */
-const editDerivedTags = computed(() =>
-  editFamilyId.value
-    ? ((editGood.value as any)?.tags ?? []).filter((t: any) => autoTagGroupIds.value.has(t.tagGroupId))
-    : [],
+/** 当前商品的自动组标签（只读展示，来自其链接名称的解析结果） */
+const editAutoTags = computed(() =>
+  ((editGood.value as any)?.tags ?? []).filter((t: any) => autoTagGroupIds.value.has(t.tagGroupId)),
 )
 
 function toggleTagInSelection(tagId: string): void {
@@ -1370,19 +1390,6 @@ async function quickCreateCountry(targetForm: () => void) {
   } catch {}
 }
 
-async function quickCreateTag(targetForm: () => void) {
-  try {
-    const { value } = await ElMessageBox.prompt('请输入标签名称', '新增标签', {
-      confirmButtonText: '新增', cancelButtonText: '取消', inputPlaceholder: '标签名称',
-    })
-    if (!value.trim()) return
-    await tagsApi.createTag({ tagName: value.trim(), tagColor: '#ff6800' } as any)
-    await reloadTags()
-    targetForm()
-    ElMessage.success('已创建并选中')
-  } catch {}
-}
-
 async function quickCreateTagGroup() {
   try {
     const { value } = await ElMessageBox.prompt('请输入分组名称', '新建分组', {
@@ -1662,6 +1669,7 @@ onMounted(() => loadAll())
           :data="leftTreeData"
           :props="treeProps"
           node-key="id"
+          highlight-current
           :draggable="mode === 'category'"
           :expand-on-click-node="true"
           @node-drag-end="onLeftTreeDragEnd"
@@ -1684,7 +1692,12 @@ onMounted(() => loadAll())
               </span>
             </div>
             <!-- Good node: two-line with meta -->
-            <div v-else-if="data.isGood" class="good-node" @click="openEdit(data.raw)">
+            <div
+              v-else-if="data.isGood"
+              class="good-node"
+              :class="{ 'good-node--flash': data.goodId === locateFlashGoodId }"
+              @click="openEdit(data.raw)"
+            >
               <el-image v-if="data.goodImage" :src="data.goodImage" fit="cover" class="good-thumb" />
               <div v-else class="good-thumb-placeholder" />
               <div class="good-body">
@@ -1697,7 +1710,7 @@ onMounted(() => loadAll())
                             <el-image v-if="data.goodImage" :src="data.goodImage" fit="cover" class="gt-img" />
                             <div v-else class="gt-img gt-img-empty" />
                             <div class="gt-title-area">
-                              <div class="gt-title">{{ data.goodName }}</div>
+                              <div class="gt-title">{{ cleanLinkName(data.goodName) }}</div>
                               <div class="gt-country">{{ data.country }}</div>
                             </div>
                           </div>
@@ -1715,12 +1728,12 @@ onMounted(() => loadAll())
                             </div>
                             <div v-if="data.originGoodName" class="gt-row">
                               <div class="gt-label">{{ data.isCustom ? '来源' : '原产品' }}</div>
-                              <div class="gt-val gt-val-ellipsis">{{ data.originGoodName }}</div>
+                              <div class="gt-val gt-val-ellipsis">{{ cleanLinkName(data.originGoodName) }}</div>
                             </div>
                           </div>
                         </div>
                       </template>
-                      <span class="good-name">{{ data.goodName }}</span>
+                      <span class="good-name" :title="data.goodName">{{ cleanLinkName(data.goodName) }}</span>
                       <span v-if="data.mergedCount > 1" class="gv-merged-badge">×{{ data.mergedCount }}</span>
                     </el-tooltip>
                   </div>
@@ -1778,11 +1791,11 @@ onMounted(() => loadAll())
             <div v-if="data.isOG" class="og-node" draggable="true" @dragstart="onOGDragStart($event, data)">
               <el-image v-if="data.goodImage" :src="data.goodImage" fit="cover" class="og-thumb" />
               <div v-else class="og-thumb og-thumb-placeholder" />
-              <span class="og-name">{{ data.label }}</span>
+              <span class="og-name" :title="data.label">{{ cleanLinkName(data.label) }}</span>
               <span
-                v-if="data.configuredCount > 0"
+                v-if="data.familyId || data.configuredCount > 0"
                 class="og-badge og-badge--ok"
-                title="已配置 {{ data.configuredCount }} 国"
+                :title="data.familyId ? `族 ${data.familyCode || ''} · ${data.familyName || ''}` : `已配置 ${data.configuredCount} 国`"
               >已配置{{ data.configuredCount > 1 ? ' ' + data.configuredCount : '' }}</span>
               <span
                 v-else
@@ -1805,12 +1818,12 @@ onMounted(() => loadAll())
                 @click.stop="handleSyncOriginDetail(data)"
               />
               <el-button
-                v-if="data.configuredCount > 0"
+                v-if="data.configuredCount > 0 || data.familyId"
                 size="small" link :icon="Aim" title="定位到官网商品"
                 @click.stop="locateInLeftTree(data.rawId)"
               />
               <el-button
-                v-if="!data.configuredCount"
+                v-if="!data.configuredCount && !data.familyId"
                 size="small" type="primary" link class="og-config-btn"
                 @click.stop="openConfigFromRightTree(data)"
               >配置</el-button>
@@ -1818,8 +1831,8 @@ onMounted(() => loadAll())
             <div v-else class="og-cat-node">
               <span>{{ data.label }}</span>
               <span v-if="data.totalCount" class="og-cat-count">
-                <template v-if="data.configuredCount < data.totalCount">
-                  {{ data.configuredCount }}/{{ data.totalCount }}
+                <template v-if="data.configuredEff < data.totalCount">
+                  {{ data.configuredEff }}/{{ data.totalCount }}
                 </template>
                 <template v-else>{{ data.totalCount }}</template>
               </span>
@@ -1909,7 +1922,7 @@ onMounted(() => loadAll())
     <el-dialog v-model="configVisible" title="配置原产品" width="520px" destroy-on-close>
       <div v-if="configOG" class="config-og-info">
         <div>
-          <div class="config-og-name">{{ configOG.goodName }}</div>
+          <div class="config-og-name" :title="configOG.goodName">{{ cleanLinkName(configOG.goodName) }}</div>
           <div class="config-og-meta">SDS ID: {{ configOG.sdsGoodId }}<template v-if="configOG.goodPrice"> · 价格: ¥{{ configOG.goodPrice }}</template></div>
         </div>
       </div>
@@ -1929,16 +1942,16 @@ onMounted(() => loadAll())
         </el-form-item>
         <el-form-item v-if="configSiblings.length" label="合并同名">
           <div class="config-merge-box">
-            <div class="config-merge-tip">勾选同分类下同名（不同工厂/仓库）原产品，合并为一个商品；主源决定价格与详情。</div>
+            <div class="config-merge-tip">勾选同分类下同名（不同工厂/仓库）原产品，合并为一个商品；主链接决定价格与详情。</div>
             <div class="config-merge-primary">
               <el-radio-group v-model="configPrimaryId">
-                <el-radio :value="String(configOG.rawId)">主源：{{ configOG.goodName }}</el-radio>
-                <el-radio v-for="s in checkedSiblingNodes" :key="s.rawId" :value="String(s.rawId)">{{ s.goodName }}</el-radio>
+                <el-radio :value="String(configOG.rawId)">主链接：{{ cleanLinkName(configOG.goodName) }}</el-radio>
+                <el-radio v-for="s in checkedSiblingNodes" :key="s.rawId" :value="String(s.rawId)">{{ cleanLinkName(s.goodName) }}</el-radio>
               </el-radio-group>
             </div>
             <el-checkbox-group v-model="configChecked">
               <el-checkbox v-for="s in configSiblings" :key="s.rawId" :value="String(s.rawId)">
-                {{ s.goodName }}<template v-if="s.goodPrice"> · ¥{{ s.goodPrice }}</template>
+                {{ cleanLinkName(s.goodName) }}<template v-if="s.goodPrice"> · ¥{{ s.goodPrice }}</template>
               </el-checkbox>
             </el-checkbox-group>
           </div>
@@ -1947,17 +1960,7 @@ onMounted(() => loadAll())
           <ImageUpload v-model="configForm.goodImage" label="上传图片" />
         </el-form-item>
         <el-form-item label="标签">
-          <div class="select-inline">
-            <el-select v-model="configForm.tagIds" multiple filterable placeholder="选择标签" style="flex:1">
-              <el-option-group v-for="g in configTagOptions" :key="g.id" :label="g.label">
-                <el-option v-for="t in g.tags" :key="t.id" :label="t.tagName" :value="t.id" />
-              </el-option-group>
-            </el-select>
-            <el-button text :icon="Plus" @click="quickCreateTag(() => { const latest = allTags[allTags.length - 1]; if (latest) configForm.tagIds.push(latest.id) })" />
-          </div>
-          <div v-if="configHasFamily" class="derived-tags-note">
-            物流 / 工艺 / 印刷位置标签由族成员自动生成，无需手动选择
-          </div>
+          <div class="derived-tags-note">标签无需手动选择：保存后由系统按链接名称自动解析（印花数量 / 工艺 / 物流）</div>
         </el-form-item>
       </el-form>
       <template #footer>
@@ -2002,13 +2005,13 @@ onMounted(() => loadAll())
     </el-dialog>
 
     <!-- Edit Good Modal (direct edit — no separate detail step) -->
-    <el-dialog v-model="editVisible" :title="editGood?.goodName || '编辑商品'" width="900px" destroy-on-close>
+    <el-dialog v-model="editVisible" :title="cleanLinkName(editGood?.goodName) || '编辑商品'" width="900px" destroy-on-close>
       <!-- Origin product reference -->
       <div v-if="editGood?.originGood" class="edit-og-ref">
         <el-image v-if="editGood.originGood.goodImage" :src="editGood.originGood.goodImage" fit="cover" class="edit-og-img" />
         <div class="edit-og-meta">
           <div class="edit-og-label">{{ editIsCustom ? '自定义商品' : '关联原产品' }}</div>
-          <div class="edit-og-name">{{ editGood.originGood.goodName }}</div>
+          <div class="edit-og-name" :title="editGood.originGood.goodName ?? undefined">{{ cleanLinkName(editGood.originGood.goodName) }}</div>
           <div class="edit-og-sub">{{ editIsCustom ? '自定义 ID' : 'SDS ID' }}: {{ editGood.originGood.sdsGoodId }}<template v-if="editGood.originGood.goodPrice"> · ¥{{ editGood.originGood.goodPrice }}</template></div>
           <div class="edit-og-status">
             <el-tag :type="editGood.originGood.hasDetail ? 'success' : 'warning'" size="small">
@@ -2043,20 +2046,28 @@ onMounted(() => loadAll())
         <div class="edit-merged-list">
           <div class="edit-merged-item primary">
             <span class="edit-merged-tag">主</span>
-            <span>{{ editGood?.originGood?.goodName }}</span>
+            <span class="edit-merged-name" :title="editGood?.originGood?.goodName ?? undefined">{{ cleanLinkName(editGood?.originGood?.goodName) }}</span>
+            <span v-if="deriveLinkTagNames(editGood?.originGood?.goodName).length" class="member-chips">
+              <span v-for="c in deriveLinkTagNames(editGood?.originGood?.goodName)" :key="c" class="member-chip">{{ c }}</span>
+            </span>
           </div>
           <div v-for="m in editFamilyMembers" :key="m.id" class="edit-merged-item">
             <span class="edit-merged-tag sub">族</span>
-            <span>{{ m.goodName }}</span>
+            <span class="edit-merged-name" :title="m.goodName">{{ cleanLinkName(m.goodName) }}</span>
+            <span v-if="deriveLinkTagNames(m.goodName).length" class="member-chips">
+              <span v-for="c in deriveLinkTagNames(m.goodName)" :key="c" class="member-chip">{{ c }}</span>
+            </span>
+            <div class="edit-merged-actions">
               <el-button size="small" link type="primary" @click="promoteFamilyPrimary(m)">设为主链接</el-button>
               <el-button size="small" link type="danger" @click="removeFamilyMember(m)">移除出族</el-button>
             </div>
+          </div>
           <div v-if="!editFamilyLoaded && editFamilyId" class="edit-family-loading">族成员加载中…</div>
           <div v-else-if="!editFamilyId" class="edit-family-loading">暂未成族：配置合并时自动成族</div>
         </div>
         <el-select v-model="editFamilyAddKw" filterable remote :remote-method="searchFamilyCandidates"
           placeholder="搜索原产品名称添加到族" clearable style="width:100%">
-          <el-option v-for="c in editFamilyCandidates" :key="c.id" :label="c.goodName" :value="String(c.id)"
+          <el-option v-for="c in editFamilyCandidates" :key="c.id" :label="cleanLinkName(c.goodName) || c.goodName" :value="String(c.id)"
             @click="addFamilyMember(c)" />
         </el-select>
       </div>
@@ -2077,20 +2088,12 @@ onMounted(() => loadAll())
           <el-cascader v-model="editForm.cascaderCategory" :options="categoryCascader as any" :props="{ checkStrictly: true }" placeholder="请选择分类" @change="onEditCascaderChange" />
         </el-form-item>
         <el-form-item label="标签">
-          <div class="select-inline">
-            <el-select v-model="editForm.tagIds" multiple filterable placeholder="选择标签" style="flex:1">
-              <el-option-group v-for="g in editTagOptions" :key="g.id" :label="g.label">
-                <el-option v-for="t in g.tags" :key="t.id" :label="t.tagName" :value="t.id" />
-              </el-option-group>
-            </el-select>
-            <el-button text :icon="Plus" @click="quickCreateTag(() => { const latest = allTags[allTags.length - 1]; if (latest) editForm.tagIds.push(latest.id) })" />
-          </div>
-          <div v-if="editFamilyId && editDerivedTags.length" class="derived-tags-row">
-            <span class="derived-tags-label">族自动：</span>
-            <el-tag v-for="t in editDerivedTags" :key="t.id" size="small" type="info" class="derived-tag">{{ t.tagName }}</el-tag>
-          </div>
-          <div v-else-if="editFamilyId" class="derived-tags-note">
-            物流 / 工艺 / 印刷位置标签由族成员自动生成，无需手动选择
+          <div class="derived-tags-row derived-tags-readonly">
+            <template v-if="editAutoTags.length">
+              <el-tag v-for="t in editAutoTags" :key="t.id" size="small" class="derived-tag">{{ t.tagName }}</el-tag>
+            </template>
+            <span v-else class="derived-tags-note">暂无自动标签</span>
+            <span class="derived-tags-note">由链接名称自动解析（印花数量 / 工艺 / 物流），不可手动编辑</span>
           </div>
         </el-form-item>
         <el-form-item v-if="editIsCustom" label="基础价格">
@@ -2530,14 +2533,35 @@ onMounted(() => loadAll())
 .edit-family-loading { color: var(--el-text-color-placeholder); font-size: 12px; padding: 4px 0; }
 .derived-tags-note { font-size: 12px; color: var(--el-text-color-secondary); margin-top: 4px; }
 .derived-tags-row { display: flex; align-items: center; flex-wrap: wrap; gap: 4px; margin-top: 4px; }
+.derived-tags-readonly { margin-top: 0; row-gap: 2px; }
 .derived-tags-label { font-size: 12px; color: var(--el-text-color-secondary); }
 .derived-tag { pointer-events: none; }
+/* 左树定位高亮：el-tree 当前节点底色 + 行级闪烁动画 */
+.gv-left :deep(.el-tree-node.is-current > .el-tree-node__content) {
+  background: var(--el-color-primary-light-8);
+}
+.good-node--flash { animation: good-node-flash 1.2s ease-in-out 2; }
+@keyframes good-node-flash {
+  0%, 100% { background: transparent; }
+  50% { background: var(--el-color-primary-light-7); box-shadow: inset 0 0 0 1px var(--el-color-primary-light-5); }
+}
 .edit-merged-list { display: flex; flex-direction: column; gap: 6px; margin-bottom: 8px; }
 .edit-merged-item {
   display: flex; align-items: center; gap: 8px;
   padding: 6px 10px; background: #f5f7fa; border-radius: 6px; font-size: 13px;
 }
-.edit-merged-item .el-button { margin-left: auto; }
+.edit-merged-name {
+  flex: 1; min-width: 0;
+  overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+}
+/* 操作按钮固定右缘：只有 actions 容器吃 margin-left:auto，两个按钮间距固定 */
+.edit-merged-actions { margin-left: auto; flex-shrink: 0; display: flex; align-items: center; }
+.edit-merged-actions .el-button + .el-button { margin-left: 4px; }
+.member-chips { display: flex; align-items: center; gap: 4px; flex-shrink: 0; flex-wrap: nowrap; overflow: hidden; }
+.member-chip {
+  font-size: 11px; line-height: 16px; padding: 1px 7px; border-radius: 8px;
+  background: #ecf5ff; color: var(--el-color-primary); white-space: nowrap;
+}
 .edit-merged-tag {
   padding: 0 5px; border-radius: 4px; font-size: 11px; line-height: 18px;
   background: var(--el-color-primary); color: #fff; flex-shrink: 0;

docs/references/product-center.md

@@ -135,16 +135,31 @@ pnpm --filter @inkreach/api backfill:product-families
   操作直接作用于族（并集与价格矩阵随重算更新）；
 - 人工改价/自动成族等族管理 API（`/product-families/*`）保留，供脚本或后续界面使用。
 
-**族派生标签（物流/工艺/印刷位置标签自动化）**：
+**族派生标签（按链接名称自动解析，2026-08 规则改版）**：
 
-- 标签组名含「物流」「工艺」「位置」的组视为**自动组**；有族商品的这些标签由族成员的
-  `logisticsLabel/craftLabel` **自动生成**（前缀匹配取最长命中：单面印花→单面印、
-  不包邮光板→不包邮），每次族重算/成员变更/商品创建更新时同步到族下所有商品；
-- 表单中自动组不再出现在标签下拉里（只读展示"族自动：…"），后端也会剔除手动传入的
-  自动组标签；无族商品（如独立自定义商品）仍可手动打标签；
+- 标签与**产品链接一一对应**（每条链接因印花数量/工艺/物流不同而价格不同），因此不再按
+  族并集派生，而是按每条链接自身名称解析后写入该链接对应的商品；
+- 解析规则（`apps/api/src/product-families/auto-tag-rules.ts`，与 admin 端
+  `utils/origin-name.ts#deriveLinkTagNames` 同构）：
+  - **印花数量**：名称含「双面印花」→ `双面印花`；否则含「单面印花」→ `单面印花`（新组「印花数量」）；
+  - **工艺**：名称含「直喷」「不打印」「光板」→ 对应标签（可多个，组「印刷工艺」）；
+    都不含 → 默认 `烫画`；
+  - **物流**：含「不包邮」→ `不包邮`；否则含「包邮」→ `包邮`（组「物流渠道」，先判不包邮防子串误命中）；
+- 组名匹配「物流/工艺/位置/印花数量」的组视为**自动组**：每次族重算/成员变更/商品创建更新时
+  同步；缺失的组与标签自动补建；旧的自动组标签（如「印刷位置」的单面印/双面印）会被剔除；
+- 后台商品表单**不再提供标签手输框**：编辑弹窗展示只读的自动标签胶囊，配置弹窗提示
+  「保存后由系统按链接名称自动解析」；后端同样剔除手动传入的自动组标签；
+- **人工调节接口保留**：`设为主链接` / `移除出族` / 搜索添加成员（`updateMembers`）、
+  价格改价（`/product-families/*/overrides`）——自动组织不对时可手动调整；
 - 其他分组（如风格类）不受影响，保持人工管理；
-- 实测（DG015，10 链接）：商品自动获得 `包邮、不包邮、双面印、直喷、单面印`，
-  官网物流/工艺筛选直接命中合并后的完整链接集合。
+- 实测：`美国（包邮）…-DG001-单面印花` → `包邮 / 烫画 / 单面印花`；
+  `美国（不包邮光板）…-JSA002-不打印` → `不包邮 / 不打印 / 光板`；
+  `美国（不包邮）…-DG501-双面印花` → `不包邮 / 烫画 / 双面印花`。
+
+**链接名称展示解析**：后台所有链接名展示位（左右树、族成员列表、配置/编辑弹窗、搜索候选）
+统一解析为「品名 型号」（如 `美国（包邮）180g纯棉T恤成人款-DG001-单面印花` →
+`180g纯棉T恤成人款 DG001`），悬停 tooltip 保留原始全名；搜索同时匹配原始名与解析名
+（`utils/origin-name.ts#cleanLinkName`）。
 
 
 

docs/references/structs.md

@@ -59,7 +59,7 @@ apps/api/
 │   ├── tag-groups/                # 标签分组 CRUD（受 JWT 保护，含批量排序）
 │   ├── positions/                 # 坑位 CRUD（受 JWT 保护）
 │   ├── origin-goods/              # SDS 原始商品快照（只读分页 + 配置状态树，树叶子含族信息）
-│   ├── product-families/          # 产品族（SPU 层）：CRUD / auto-group / 成员管理 / 自定义成员 / 价格覆盖 / 重算
+│   ├── product-families/          # 产品族（SPU 层）：CRUD / auto-group / 成员管理 / 自定义成员 / 价格覆盖 / 重算 / 按链接名称派生标签（auto-tag-rules）
 │   ├── goods/                     # 商品 CRUD + 批量优先级 + 批量创建
 │   ├── sync/                      # SDS 同步：分类 / 商品 / 同步日志
 │   ├── public/                    # 公开 API：分类树 / 国家 / 商品分页 / 商品详情