From 9a23ab2f5a85a3b656e8168133fc81253c162ac5 Mon Sep 17 00:00:00 2001
From: czl231 <3286836406@qq.com>
Date: Mon, 31 Aug 2026 20:49:51 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E9=85=8D=E9=80=81=E7=AB=AF?=
 =?UTF-8?q?=E5=90=88=E5=90=8C=E4=B8=8E=E7=94=A8=E6=88=B7=E7=AE=A1=E7=90=86?=
 =?UTF-8?q?=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 backend/api/internal/logic/delivery/order.go  |  5 ++-
 .../order_contract_attachment_test.go         | 21 +++++++++-
 backend/api/internal/logic/delivery/user.go   | 20 +++++++++-
 .../logic/delivery/user_error_test.go         | 33 ++++++++++++++++
 ...“�作日志_é…�é€�点å�ˆå�Œç”¨æˆ·å��称显示_20260831.md | 29 ++++++++++++++
 .../�作日志_��点用户����示_20260831.md | 29 ++++++++++++++
 ...作日志_��点订���空列表修�_20260831.md | 30 +++++++++++++++
 docs/项目文档_��点��用户�称显示_v1.0.md  | 24 ++++++++++++
 docs/项目文档_��点用户����示_v1.0.md    | 22 +++++++++++
 .../项目文档_��点订���空列表修�_v1.0.md | 27 +++++++++++++
 .../scripts/check-resource-pages.mjs          |  3 ++
 .../src/views/shared/RelationNameText.vue     | 21 ++++++++--
 .../src/views/shared/ResourceListPage.vue     | 38 +++++++++++++++++--
 13 files changed, 290 insertions(+), 12 deletions(-)
 create mode 100644 backend/api/internal/logic/delivery/user_error_test.go
 create mode 100644 docs/�作日志_��点��用户�称显示_20260831.md
 create mode 100644 docs/�作日志_��点用户����示_20260831.md
 create mode 100644 docs/�作日志_��点订���空列表修�_20260831.md
 create mode 100644 docs/项目文档_��点��用户�称显示_v1.0.md
 create mode 100644 docs/项目文档_��点用户����示_v1.0.md
 create mode 100644 docs/项目文档_��点订���空列表修�_v1.0.md

diff --git a/backend/api/internal/logic/delivery/order.go b/backend/api/internal/logic/delivery/order.go
index 9e62fb5..9a4c993 100644
--- a/backend/api/internal/logic/delivery/order.go
+++ b/backend/api/internal/logic/delivery/order.go
@@ -1,5 +1,5 @@
 // 功能�述：实现��点范围内的�����气瓶和��订�接�。
-// 版本：v1.4.0。
+// 版本：v1.4.1。
 package delivery
 
 import (
@@ -74,7 +74,8 @@ func ListContract(ctx *gin.Context) {
 		infra.Response.Error(ctx, err)
 		return
 	}
-	var list []platformgasorder.ContractPartyDisplay
+	// 空结果也�始化为空切片，确�公开�应�� JSON 数组而�是 null。
+	list := make([]platformgasorder.ContractPartyDisplay, 0)
 	if err := query.Order("gasorder_contract.created_at desc").Offset((page - 1) * size).Limit(size).Scan(&list).Error; err != nil {
 		infra.Response.Error(ctx, err)
 		return
diff --git a/backend/api/internal/logic/delivery/order_contract_attachment_test.go b/backend/api/internal/logic/delivery/order_contract_attachment_test.go
index 74f5f2a..0a1330f 100644
--- a/backend/api/internal/logic/delivery/order_contract_attachment_test.go
+++ b/backend/api/internal/logic/delivery/order_contract_attachment_test.go
@@ -1,5 +1,5 @@
 // 功能�述：验�����附件列表脱�与公开状�投影。
-// 版本：v1.0.0。
+// 版本：v1.1.0。
 package delivery
 
 import (
@@ -44,3 +44,22 @@ func TestProtectDeliveryContractListResponse(t *testing.T) {
 		t.Fatal("无附件的��必须返回 has_attachment=false")
 	}
 }
+
+// TestProtectDeliveryContractListEmptyResponse 验�没有�用��时�返回空数组。
+func TestProtectDeliveryContractListEmptyResponse(t *testing.T) {
+	gin.SetMode(gin.TestMode)
+	ctx, _ := gin.CreateTestContext(httptest.NewRecorder())
+	ctx.Request = httptest.NewRequest("GET", "/gasorder_contract?candidate=order", nil)
+	contracts := make([]models.GasorderContract, 0)
+	response, err := common.PublicResourceResponse(contracts)
+	if err != nil {
+		t.Fatalf("构造空��公开�应失败: %v", err)
+	}
+	protected, err := protectDeliveryContractListResponse(ctx, response, contracts)
+	if err != nil {
+		t.Fatalf("空��列表�应返回结构错误: %v", err)
+	}
+	if protected == nil || len(protected) != 0 {
+		t.Fatalf("空��列表必须返回� nil 空数组，实际值: %#v", protected)
+	}
+}
diff --git a/backend/api/internal/logic/delivery/user.go b/backend/api/internal/logic/delivery/user.go
index 87d4c7f..2134beb 100644
--- a/backend/api/internal/logic/delivery/user.go
+++ b/backend/api/internal/logic/delivery/user.go
@@ -1,5 +1,5 @@
 // 功能�述：实现��点范围内的用户��务关系和收货地�管�。
-// 版本：v1.1.0。
+// 版本：v1.2.0。
 package delivery
 
 import (
@@ -12,9 +12,25 @@ import (
 	"git.apinb.com/heqiapp/platforms/backend/api/internal/logic/upload"
 	"git.apinb.com/heqiapp/platforms/backend/api/internal/models"
 	"github.com/gin-gonic/gin"
+	"github.com/jackc/pgx/v5/pgconn"
 	"gorm.io/gorm"
 )
 
+const deliveryUserUsernameConstraint = "idx_user_account_username"
+
+var errDeliveryUserUsernameExists = errors.New("用户�已存在，请更�用户�")
+
+// deliveryUserCreateError 仅转���点新建用户时的用户�唯一约�冲�。
+// �数：err 为用户和�务关系事务返回的错误。
+// 返回值：用户�冲�返回中文�示，其他错误��原样。
+func deliveryUserCreateError(err error) error {
+	var postgresError *pgconn.PgError
+	if errors.As(err, &postgresError) && postgresError.Code == "23505" && postgresError.ConstraintName == deliveryUserUsernameConstraint {
+		return errDeliveryUserUsernameExists
+	}
+	return err
+}
+
 func userQuery(pointID uint64) *gorm.DB {
 	return common.ActiveRecords(db().Model(&models.UserAccount{})).
 		Joins("JOIN user_service_relation ON user_service_relation.user_account_id = user_account.id AND user_service_relation.status <> ?",
@@ -116,7 +132,7 @@ func CreateUser(ctx *gin.Context) {
 		relation.UserAccountID = user.ID
 		return tx.Create(&relation).Error
 	}); err != nil {
-		infra.Response.Error(ctx, err)
+		infra.Response.Error(ctx, deliveryUserCreateError(err))
 		return
 	}
 	common.RespondCreatedResource(ctx, user)
diff --git a/backend/api/internal/logic/delivery/user_error_test.go b/backend/api/internal/logic/delivery/user_error_test.go
new file mode 100644
index 0000000..8d1b672
--- /dev/null
+++ b/backend/api/internal/logic/delivery/user_error_test.go
@@ -0,0 +1,33 @@
+// 功能�述：验���点新建用户的用户�冲��示转�。
+// 版本：v1.0.0。
+package delivery
+
+import (
+	"errors"
+	"fmt"
+	"testing"
+
+	"github.com/jackc/pgx/v5/pgconn"
+)
+
+// TestDeliveryUserCreateErrorUsernameConflict 验�用户�唯一约�冲�返回指定中文�示。
+// �数：t 为 Go 测试上下文。
+// 返回值：无。
+func TestDeliveryUserCreateErrorUsernameConflict(t *testing.T) {
+	databaseError := &pgconn.PgError{Code: "23505", ConstraintName: deliveryUserUsernameConstraint}
+	wrapped := fmt.Errorf("create delivery user: %w", databaseError)
+
+	if actual := deliveryUserCreateError(wrapped).Error(); actual != "用户�已存在，请更�用户�" {
+		t.Fatalf("用户�冲��示�正确，实际为 %q", actual)
+	}
+}
+
+// TestDeliveryUserCreateErrorKeepsOtherErrors 验�其他错误�被本次局部映射改�。
+// �数：t 为 Go 测试上下文。
+// 返回值：无。
+func TestDeliveryUserCreateErrorKeepsOtherErrors(t *testing.T) {
+	original := errors.New("other error")
+	if actual := deliveryUserCreateError(original); !errors.Is(actual, original) {
+		t.Fatalf("其他错误应��原样，实际为 %v", actual)
+	}
+}
diff --git a/docs/�作日志_��点��用户�称显示_20260831.md b/docs/�作日志_��点��用户�称显示_20260831.md
new file mode 100644
index 0000000..db8383b
--- /dev/null
+++ b/docs/�作日志_��点��用户�称显示_20260831.md
@@ -0,0 +1,29 @@
+# �作日志：��点��用户�称显示
+
+�作时间：2026-08-31
+�作类型：修改
+影�模�：��点��列表
+
+## �作�状�
+
+“用户账户�列直接显示系统唯一标识片段，与气站管�端的用户�称展示�一致。
+
+## 具体�作
+
+1. 关系列表字段优先读��务端派生业务�称。
+2. �用�称�关�详情和唯一标识�制的组�展示。
+3. 增加��契约检查，防止回退为裸唯一标识。
+
+## �作�状�
+
+��点��列表按气站端样�显示用户业务�称，并�留完整唯一标识的�制能力。
+
+## 验�结果
+
+- `npm.cmd run type:check`：通过。
+- `npm.cmd run resource-pages:check`：通过，详情 17�新建 9�编辑 5。
+- `npm.cmd run build`：通过，2648 个模�完�生产构建。
+
+## 风险评估
+
+仅调整�端关系列表字段渲染，�交字段��端�应和��范围��改�。
diff --git a/docs/�作日志_��点用户����示_20260831.md b/docs/�作日志_��点用户����示_20260831.md
new file mode 100644
index 0000000..6c89771
--- /dev/null
+++ b/docs/�作日志_��点用户����示_20260831.md
@@ -0,0 +1,29 @@
+# �作日志：��点用户����示
+
+�作时间：2026-08-31
+�作类型：修改
+影�模�：��点用户管�—新建用户
+
+## �作�状�
+
+��用户�直接�页�返回 PostgreSQL 唯一约�错误� SQLSTATE。
+
+## 具体�作
+
+1. 识别用户�约� `idx_user_account_username` 的 `23505` 冲�。
+2. 将该冲�转�为“用户�已存在，请更�用户��。
+3. 其他数�库错误��原有处�，��扩大本次�更范围。
+
+## �作�状�
+
+��创建��用户时页�显示明确中文�示，��显示该约�的数�库英文错误。
+
+## 验�结果
+
+- `go test ./api/internal/logic/delivery`：通过。
+- 已覆盖包装�的 PostgreSQL `23505` 用户�约�冲�。
+- 已验�其他错误��原样。
+
+## 风险评估
+
+仅改�一个已知唯一约�冲�的�示文本，�影��功创建路径与其他错误类型。
diff --git a/docs/�作日志_��点订���空列表修�_20260831.md b/docs/�作日志_��点订���空列表修�_20260831.md
new file mode 100644
index 0000000..0515f71
--- /dev/null
+++ b/docs/�作日志_��点订���空列表修�_20260831.md
@@ -0,0 +1,30 @@
+# �作日志：��点订���空列表修�
+
+�作时间：2026-08-31
+�作类型：修改
+影�模�：��点订�创建�����候选列表
+
+## �作�状�
+
+没有�履约��时，��查询结果为 nil 切片，公开�应�列化� `null`，��被列表结构校验拒�。
+
+## 具体�作
+
+1. 将��查询接收容器�始化为空切片。
+2. 增加零���的回归测试，�求返回� nil 空数组。
+3. ��接�路径�筛选�件和�应字段��。
+
+## �作�状�
+
+无�用��时接�正常返回 `total: 0`�`list: []`，页��显示无�用���示。
+
+## 验�结果
+
+- `go test ./api/internal/logic/delivery`：通过。
+- 新增空��列表用例，确认公开�应为� nil 空数组。
+- �端已�新构建并��，12426 端�监�正常。
+- �览器会�的原登录令牌已失效并跳转登录页，登录�页�验�待执行。
+
+## 风险评估
+
+�更仅影�零�记录的�列化形�；有数�列表和��筛选逻辑��，兼容风险低。
diff --git a/docs/项目文档_��点��用户�称显示_v1.0.md b/docs/项目文档_��点��用户�称显示_v1.0.md
new file mode 100644
index 0000000..f16cf42
--- /dev/null
+++ b/docs/项目文档_��点��用户�称显示_v1.0.md
@@ -0,0 +1,24 @@
+# 项目文档：��点��用户�称显示 v1.0
+
+## 项目概述
+
+��点��列表的“用户账户�列与气站管�端��一致，以用户业务�称为主展示，��把系统唯一标识作为主文本。
+
+## 核心文件说明
+
+- `frontend/delivery_admin/src/views/shared/ResourceListPage.vue`：渲染�务端返回的 `user_account_display_name`，并�留关�详情入�和唯一标识�制能力。
+- `frontend/delivery_admin/src/views/shared/RelationNameText.vue`：支��点击的关系�称展示。
+- `frontend/delivery_admin/scripts/check-resource-pages.mjs`：增加关系�称展示的��契约检查。
+
+## 行为�化
+
+- 修改�：��列表显示用户账户唯一标识片段。
+- 修改�：��列表显示用户业务�称，例如 `ccc`�`xc`�`cyy`；�称�进入用户详情，�边按钮��制完整唯一标识。
+
+## 接�兼容性
+
+�用现有��列表�应中的 `user_account_display_name`，�修改�端接�和数�库。
+
+## 测试方法
+
+在 `frontend/delivery_admin` 目录执行类型检查�资�页�契约检查和生产构建。
diff --git a/docs/项目文档_��点用户����示_v1.0.md b/docs/项目文档_��点用户����示_v1.0.md
new file mode 100644
index 0000000..d7c6066
--- /dev/null
+++ b/docs/项目文档_��点用户����示_v1.0.md
@@ -0,0 +1,22 @@
+# 项目文档：��点用户����示 v1.0
+
+## 项目概述
+
+��点管�端新建用户时，将用户�唯一约�冲�转�为��解的中文�示。
+
+## 核心文件说明
+
+- `backend/api/internal/logic/delivery/user.go`：识别 `idx_user_account_username` 唯一约�冲�并返回“用户�已存在，请更�用户��。
+- `backend/api/internal/logic/delivery/user_error_test.go`：验�已知冲��示与其他错误��原样。
+
+## �更范围
+
+仅修改��点管�端新建用户的��用户��示，�修改数�库约��用户创建�程�字段校验或其他错误处�。
+
+## 测试方法
+
+在 `backend` 目录执行：
+
+```text
+go test ./api/internal/logic/delivery
+```
diff --git a/docs/项目文档_��点订���空列表修�_v1.0.md b/docs/项目文档_��点订���空列表修�_v1.0.md
new file mode 100644
index 0000000..33cbd56
--- /dev/null
+++ b/docs/项目文档_��点订���空列表修�_v1.0.md
@@ -0,0 +1,27 @@
+# 项目文档：��点订���空列表修� v1.0
+
+## 项目概述
+
+修���点管�端创建��订�时，当�没有�履约��时错误�示“����列表�应结构无效�的问题。
+
+## 核心文件说明
+
+- `backend/api/internal/logic/delivery/order.go`：查询����候选项；空结果�始化为� nil 空切片，��接�输出 `list: []`。
+- `backend/api/internal/logic/delivery/order_contract_attachment_test.go`：覆盖��空列表公开�应的回归测试。
+
+## 行为�化
+
+- 修��：零���被�列化为 `null`，�端�应结构校验失败。
+- 修��：零���返回空数组，�端正常显示“暂无�下�的生效���。
+
+## 接�兼容性
+
+接�地�和字段����，仅将异常的 `list: null` 规范为 `list: []`，兼容现有调用方。
+
+## 测试方法
+
+在 `backend` 目录执行：
+
+```text
+go test ./api/internal/logic/delivery
+```
diff --git a/frontend/delivery_admin/scripts/check-resource-pages.mjs b/frontend/delivery_admin/scripts/check-resource-pages.mjs
index 7397f4f..5e0fda4 100644
--- a/frontend/delivery_admin/scripts/check-resource-pages.mjs
+++ b/frontend/delivery_admin/scripts/check-resource-pages.mjs
@@ -74,6 +74,9 @@ const listPage = read('src/views/shared/ResourceListPage.vue');
 assert(!listPage.includes('title="ID"'), '标准列表�暴露数�库自增 ID');
 assert(listPage.includes('ProtectedAvatarThumbnail'), '账户列表尚未接入�控头�缩略图');
 assert(listPage.includes('avatarLoader.reset()'), '列表刷新未清�头�缓存和请求');
+assert(listPage.includes('field.listRelationNameOnly && fieldValue(field, record)'), '关系列表字段尚未按气站端显示业务�称');
+assert(listPage.includes('relationListName(field, record)'), '关系列表字段缺少�务端派生�称读�');
+assert(listPage.includes('@open="openRelation(field, record)"'), '关系列表�称缺少关�详情入�');
 const avatarLoader = read('src/views/shared/protected-list-avatar-loader.ts');
 assert(avatarLoader.includes('MAX_CONCURRENT_REQUESTS = 6'), '头�请求并�上�未与 5173 对�');
 assert(avatarLoader.includes("new Set(['staff_account', 'user_account'])"), '头�列表资�白���正确');
diff --git a/frontend/delivery_admin/src/views/shared/RelationNameText.vue b/frontend/delivery_admin/src/views/shared/RelationNameText.vue
index 084c55b..7926282 100644
--- a/frontend/delivery_admin/src/views/shared/RelationNameText.vue
+++ b/frontend/delivery_admin/src/views/shared/RelationNameText.vue
@@ -1,8 +1,14 @@
-<!-- 功能�述：以业务�称展示关�记录，并�留唯一标识的查看与�制能力。版本：v1.0.0。 -->
+<!-- 功能�述：以关系�称为主展示，支�进入关�详情并�制完整唯一标识。版本：v1.1.0。 -->
 <template>
   <div class="relation-name-text">
     <a-tooltip :content="`${identityLabel}：${identity}`">
-      <span class="relation-name">{{ displayName }}</span>
+      <button
+        v-if="clickable"
+        class="relation-name relation-link"
+        type="button"
+        @click.stop="emit('open')"
+      >{{ displayName }}</button>
+      <span v-else class="relation-name">{{ displayName }}</span>
     </a-tooltip>
     <a-tooltip :content="`�制${identityLabel}`">
       <button class="copy-button" type="button" :aria-label="`�制${identityLabel} ${identity}`" @click.stop="copyIdentity">
@@ -17,14 +23,20 @@ import { Message } from '@arco-design/web-vue';
 import { IconCopy } from '@arco-design/web-vue/es/icon';
 import { computed } from 'vue';
 
-const props = defineProps<{ name: string; identity: string; identityLabel: string }>();
+const props = defineProps<{
+  name: string;
+  identity: string;
+  identityLabel?: string;
+  clickable?: boolean;
+}>();
+const emit = defineEmits<{ open: [] }>();
 const displayName = computed(() => props.name || props.identity);
 
 /** �制完整唯一标识，并给出明确的�作�馈。 */
 async function copyIdentity() {
   try {
     await navigator.clipboard.writeText(props.identity);
-    Message.success(`${props.identityLabel}已�制`);
+    Message.success(`${props.identityLabel ?? '唯一标识'}已�制`);
   } catch {
     Message.error('�制失败，请从悬浮�示中�制');
   }
@@ -34,6 +46,7 @@ async function copyIdentity() {
 <style scoped>
 .relation-name-text { display: flex; gap: 6px; align-items: center; min-width: 0; }
 .relation-name { min-width: 0; overflow: hidden; color: var(--color-text-1); text-overflow: ellipsis; white-space: nowrap; }
+.relation-link { padding: 0; color: rgb(var(--primary-6)); font: inherit; text-align: left; background: transparent; border: 0; cursor: pointer; }
 .copy-button { display: inline-flex; flex: 0 0 auto; align-items: center; justify-content: center; width: 24px; height: 24px; padding: 0; color: rgb(var(--primary-6)); font-size: 14px; background: transparent; border: 0; border-radius: 4px; cursor: pointer; }
 .copy-button:hover, .copy-button:focus-visible { background: var(--color-fill-2); outline: none; }
 </style>
diff --git a/frontend/delivery_admin/src/views/shared/ResourceListPage.vue b/frontend/delivery_admin/src/views/shared/ResourceListPage.vue
index cb4be5c..27f9c73 100644
--- a/frontend/delivery_admin/src/views/shared/ResourceListPage.vue
+++ b/frontend/delivery_admin/src/views/shared/ResourceListPage.vue
@@ -1,4 +1,4 @@
-<!-- 功能�述：展示��点标准资�列表并导航到独立记录页。版本：v1.2.0。 -->
+<!-- 功能�述：展示��点标准资�列表并导航到独立记录页。版本：v1.3.0。 -->
 <template>
   <a-card :title="listTitle" :bordered="false">
     <template v-if="isCredentialList" #extra>
@@ -56,8 +56,8 @@
           :title="field.listLabel ?? field.label"
           :width="columnWidth(field)"
           :align="isProtectedListAvatarField(definition.name, field.key) ? 'center' : 'left'"
-          :ellipsis="!isProtectedListAvatarField(definition.name, field.key)"
-          :tooltip="!isProtectedListAvatarField(definition.name, field.key)"
+          :ellipsis="!isProtectedListAvatarField(definition.name, field.key) && !field.listRelationNameOnly"
+          :tooltip="!isProtectedListAvatarField(definition.name, field.key) && !field.listRelationNameOnly"
         >
           <template #cell="{ record }">
             <ProtectedAvatarThumbnail
@@ -68,6 +68,14 @@
               :refresh-key="avatarRefreshKey"
               :loader="avatarLoader"
             />
+            <RelationNameText
+              v-else-if="field.listRelationNameOnly && fieldValue(field, record)"
+              :name="relationListName(field, record)"
+              :identity="fieldValue(field, record)"
+              :identity-label="field.listLabel ?? field.label"
+              :clickable="Boolean(field.relation)"
+              @open="openRelation(field, record)"
+            />
             <a-button
               v-else-if="field.type === 'contract-file' && record.has_attachment"
               size="mini"
@@ -147,6 +155,7 @@ import type { ResourceRow } from '@/api/resource-record-form';
 import { resourceFieldLabel, type ResourceField, type ResourceUiDefinition } from '@/api/resources';
 import IdentityText from '@/components/IdentityText.vue';
 import ProtectedAvatarThumbnail from './ProtectedAvatarThumbnail.vue';
+import RelationNameText from './RelationNameText.vue';
 import {
   createProtectedListAvatarLoader,
   isProtectedListAvatarField,
@@ -216,6 +225,7 @@ async function ensureCredentialContext() {
 /** 返回列表列宽。 */
 function columnWidth(field: ResourceField) {
   if (isProtectedListAvatarField(props.definition.name, field.key)) return 72;
+  if (field.listRelationNameOnly) return 240;
   if (field.type === 'contract-file') return 120;
   if (field.type === 'datetime' || field.type === 'date') return 180;
   if (field.type === 'money') return 160;
@@ -249,6 +259,28 @@ function fieldValue(field: ResourceField, row: ResourceRow) {
   return String(row[field.key] ?? row[`${field.key}_masked`] ?? '');
 }
 
+/** 优先读��务端在当���范围内返回的关�业务�称。 */
+function relationListName(field: ResourceField, row: ResourceRow) {
+  const displayKey = field.key.endsWith('_identity')
+    ? `${field.key.slice(0, -9)}_display_name`
+    : '';
+  return displayKey ? String(row[displayKey] ?? '').trim() : '';
+}
+
+/** 打开关系字段对应的独立详情页。 */
+function openRelation(field: ResourceField, row: ResourceRow) {
+  if (!field.relation) return;
+  const target = router.getRoutes().find(
+    (item) => item.meta.resource === field.relation && item.meta.recordMode === 'detail',
+  );
+  if (!target?.name) return;
+  return router.push({
+    name: target.name,
+    params: { identity: fieldValue(field, row) },
+    query: { return_to: route.fullPath },
+  });
+}
+
 /** 优先使用�端�控派生字段展示列表摘�，空值使用字段业务文案。 */
 function displayListField(field: ResourceField, row: ResourceRow) {
   if (field.listDisplayKey) {