revert(tab): 撤回 v0.6.5 嵌套 relation 解析，回到 format 纯展示

populateTabRelations / format 第二参是 tab 专属特例,太狭隘(object/array 同类问题未覆盖),
通用复合解析另当专门事做。嵌套关联名(如商品名)的展示需求改放业务侧(模块重写 list/get)。
框架只保留: format(同步纯展示) + stringify/parse(可逆往返)。

package.json

@@ -1,6 +1,6 @@
 {
     "name": "shrimp-server",
-    "version": "0.6.3",
+    "version": "0.6.6",
     "description": "Shrimp 框架后端 — 声明式字段驱动的 Node.js 管理后台框架(Express + Mongoose + JWT)",
     "main": "dist/main/index.js",
     "types": "dist/main/index.d.ts",

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
 }
 

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