From 4b51d31e9f073f1b055acb6b88aabb7569ec4f00 Mon Sep 17 00:00:00 2001
From: wc24 <wc24@qq.com>
Date: Mon, 29 Jun 2026 16:42:11 +0800
Subject: [PATCH] =?UTF-8?q?feat(tab):=20=E6=8B=86=E5=BC=80=E5=B1=95?=
 =?UTF-8?q?=E7=A4=BA=E4=B8=8E=E5=BA=8F=E5=88=97=E5=8C=96=20=E2=80=94=20fie?=
 =?UTF-8?q?ld.format(=E5=B1=95=E7=A4=BA)=20vs=20stringify/parse(=E5=8F=AF?=
 =?UTF-8?q?=E9=80=86=E5=BE=80=E8=BF=94)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

v0.6.3 用同一个 stringify 同时扛表格展示和 export 序列化,二者诉求冲突:
展示要好看可有损,export 要可逆完整。现拆为:
- field.format → _label 展示文本(给人看,可有损),默认 JSON.stringify
- field.stringify/parse → export/import 可逆对(机器往返),默认 JSON
export 改用 stringify(可逆)而非 _label,import 的 parse 能还原。
---
 package.json                    |  2 +-
 src/IShrimpType.ts              |  6 ++++--
 src/Shrimp/ShrimpTableModule.ts | 12 +++++++-----
 3 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/package.json b/package.json
index 6f97f5a..2099c04 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "shrimp-server",
-    "version": "0.6.3",
+    "version": "0.6.4",
     "description": "Shrimp 框架后端 — 声明式字段驱动的 Node.js 管理后台框架(Express + Mongoose + JWT)",
     "main": "dist/main/index.js",
     "types": "dist/main/index.d.ts",
diff --git a/src/IShrimpType.ts b/src/IShrimpType.ts
index c9c0c4b..b39a766 100644
--- a/src/IShrimpType.ts
+++ b/src/IShrimpType.ts
@@ -278,9 +278,11 @@ export interface IFieldConfig {
     rules?: IFieldRule[]          // 通用验证规则（前后端共用）
     /** tab 类型专用：每个 type 对应的子字段配置 */
     tabs?: { key: any; label: ILabel; fields: IFieldConfig[] }[]
-    /** tab 类型专用：自定义序列化(export 列 / `${key}_label` 用)，默认 JSON.stringify */
+    /** tab 类型专用：展示文本(表格列 `${key}_label`)，给人看、可有损好看，默认 JSON.stringify */
+    format?: (value: any) => string
+    /** tab 类型专用：export 序列化，须与 parse 可逆(机器往返)，默认 JSON.stringify */
     stringify?: (value: any) => string
-    /** tab 类型专用：自定义反序列化(import 还原对象)，默认 JSON.parse */
+    /** tab 类型专用：import 反序列化，须与 stringify 可逆，默认 JSON.parse */
     parse?: (text: string) => any
 }
 
diff --git a/src/Shrimp/ShrimpTableModule.ts b/src/Shrimp/ShrimpTableModule.ts
index 8d727fa..9c50537 100644
--- a/src/Shrimp/ShrimpTableModule.ts
+++ b/src/Shrimp/ShrimpTableModule.ts
@@ -60,8 +60,8 @@ export const defaultTypeHandlers: Record<string, IFieldTypeHandler> = {
             }
             return value
         },
-        // 本体原样下发对象(不再 stringify)；展示文本走 _label
-        resLabel: (value, field) => (field.stringify ?? JSON.stringify)(value),
+        // 本体原样下发对象(不再 stringify)；展示文本走 _label，用 format(给人看,可有损)
+        resLabel: (value, field) => (field.format ?? JSON.stringify)(value),
     },
 }
 
@@ -395,13 +395,15 @@ export class ShrimpTableModule<T, P extends ITableCrudProto<T> = ITableCrudProto
         delete shrimpQuery.limit
         const result = await this.dataSource.list(shrimpQuery)
         result.list = await this.prepareResponseItems(result.list)
-        // 导出是"给人看"的边界：把带 resLabel 的结构化字段(如 tab)用其字符串文本替换对象本体，
-        // 列保持可读，且能被 import 的 reqFilter(parse)原样还原；去掉额外的 _label 列。
+        // 导出是机器往返的边界：结构化字段(如 tab)用可逆的 stringify 序列化(默认 JSON)，
+        // import 端的 reqFilter(parse) 能原样还原；展示用的 _label 不进导出，去掉。
         const labelFields = this.fields.filter(f => this.getTypeHandler(f)?.resLabel)
         return result.list.map(item => {
             const row = this.filterHidden(item)
             for (const f of labelFields) {
-                if (row[`${f.key}_label`] !== undefined) row[f.key] = row[`${f.key}_label`]
+                if (row[f.key] !== undefined && typeof row[f.key] === "object") {
+                    row[f.key] = (f.stringify ?? JSON.stringify)(row[f.key])
+                }
                 delete row[`${f.key}_label`]
             }
             return row