@tbox.cn/app-module-member 0.9.3 → 0.9.5

package/dist/{chunk-ALVM7SOF.js → chunk-VU73BWYZ.js}

@@ -163,6 +163,7 @@ var samples = [
     label: "\u5361\u9762\xB7\u5361\u56FE\u7F3A\u5931",
     note: "presentation \u5728\u4F46 cardImageUrl \u7F3A\u7701\u2014\u2014\u9000\u5230\u6E10\u53D8\u515C\u5E95\u5E95\u7EB9\uFF0C\u53E0\u5B57\u6392\u5E03\u5E94\u4E0D\u53D8",
     group: "\u5361\u9762\u7D20\u6750\u5206\u652F",
+    hidden: true,
     data: {
       userId: "u_1001",
       cardRef: "card:u_1001",
@@ -178,6 +179,7 @@ var samples = [
     label: "\u5361\u9762\xB7\u5916\u94FE\u52A0\u8F7D\u5931\u8D25",
     note: "\u7EBF\u4E0A\u5361\u56FE 404 / \u65AD\u7F51\u7684\u5B9E\u51B5\u2014\u2014ImageWithFallback \u5360\u4F4D\u4E0D\u5E94\u628A\u5361\u9762\u6491\u53D8\u5F62",
     group: "\u5361\u9762\u7D20\u6750\u5206\u652F",
+    hidden: true,
     data: {
       userId: "u_1001",
       cardRef: "card:u_1001",
@@ -194,6 +196,7 @@ var samples = [
     label: "\u5361\u9762\xB7\u8FDB\u5EA6\u957F\u6587\u6848",
     note: "progress.message \u8D85 24 \u5B57\u89E6\u53D1 --scroll \u8DD1\u9A6C\u706F\uFF1Bpercent=0 \u65F6\u8FDB\u5EA6\u6761\u5E94\u53EF\u89C1\u8F68\u9053",
     group: "\u5361\u9762\u7D20\u6750\u5206\u652F",
+    hidden: true,
     data: {
       userId: "u_1001",
       cardRef: "card:u_1001",
@@ -215,6 +218,7 @@ var samples = [
     label: "\u5361\u9762\xB7\u65E0\u8FDB\u5EA6\u65E0\u6743\u76CA",
     note: "progress \u4E0E benefits \u540C\u65F6\u7F3A\u7701\u2014\u2014\u53EA\u5269\u5361\u9762 + \u504F\u597D\u5F15\u5BFC\uFF0C\u68C0\u67E5\u5E95\u90E8\u6536\u53E3",
     group: "\u5361\u9762\u7D20\u6750\u5206\u652F",
+    hidden: true,
     data: {
       userId: "u_1001",
       cardRef: "card:u_1001",
@@ -229,6 +233,7 @@ var samples = [
     label: "\u5361\u9762\xB7\u6743\u76CA\u56FE\u6807\u5931\u8D25",
     note: "iconUrl \u52A0\u8F7D\u5931\u8D25 \u2192 \u6309\u6743\u76CA\u540D\u5339\u914D\u7684\u515C\u5E95\u56FE\u6807\uFF08\u505C\u8F66/\u79EF\u5206/\u6D3B\u52A8/\u5176\u5B83\u56DB\u6761\u5206\u652F\uFF09",
     group: "\u5361\u9762\u7D20\u6750\u5206\u652F",
+    hidden: true,
     data: {
       userId: "u_1001",
       cardRef: "card:u_1001",
@@ -278,7 +283,8 @@ var samples = [
       progress: PROGRESS_SHORT,
       benefits: benefitsOf("gold")
     },
-    isHistory: true
+    isHistory: true,
+    hidden: true
   }
 ];
 
@@ -335,7 +341,9 @@ var meta3 = {
     items: [{ usageRecordRef: "r1", title: "\u6D88\u8D39\u5956\u52B1", amount: "+100", usedAt: "2026-08-13T00:00:00Z" }],
     total: 1
   },
-  schemaVersion: 1
+  schemaVersion: 1,
+  // 永久型不出卡：积分流水仅作文本事实（queryPoints SKILL 9-03），不构造积分流水卡
+  hidden: true
 };
 var meta_default3 = meta3;
 

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   resolveMemberEnrollmentPort,
   resolveMemberProfilePort,
   serverModule
-} from "./chunk-ALVM7SOF.js";
+} from "./chunk-VU73BWYZ.js";
 import {
   clientModule
 } from "./chunk-GMHJMLRV.js";

package/dist/server/index.d.ts

@@ -103,19 +103,19 @@ declare const memberCards: {
             labelRef: zod.ZodString;
             name: zod.ZodString;
         }, "strip", zod.ZodTypeAny, {
-            labelRef: string;
             name: string;
-        }, {
             labelRef: string;
+        }, {
             name: string;
+            labelRef: string;
         }>, "many">;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        authState: "authenticated" | "unauthenticated";
         state: "unknown" | "active" | "not_enrolled" | "closed";
+        authState: "authenticated" | "unauthenticated";
         labels: {
-            labelRef: string;
             name: string;
+            labelRef: string;
         }[];
         displayName?: string | undefined;
         avatarUrl?: string | undefined;
@@ -124,11 +124,11 @@ declare const memberCards: {
         registeredAt?: string | undefined;
     }, {
         userId: string;
-        authState: "authenticated" | "unauthenticated";
         state: "unknown" | "active" | "not_enrolled" | "closed";
+        authState: "authenticated" | "unauthenticated";
         labels: {
-            labelRef: string;
             name: string;
+            labelRef: string;
         }[];
         displayName?: string | undefined;
         avatarUrl?: string | undefined;
@@ -185,13 +185,13 @@ declare const memberCards: {
                 text: zod.ZodOptional<zod.ZodString>;
             }, "strip", zod.ZodTypeAny, {
                 kind: "toast" | "miniapp" | "dialog";
-                title?: string | undefined;
                 url?: string | undefined;
+                title?: string | undefined;
                 text?: string | undefined;
             }, {
                 kind: "toast" | "miniapp" | "dialog";
-                title?: string | undefined;
                 url?: string | undefined;
+                title?: string | undefined;
                 text?: string | undefined;
             }>>;
         }, "strip", zod.ZodTypeAny, {
@@ -200,8 +200,8 @@ declare const memberCards: {
             description?: string | undefined;
             action?: {
                 kind: "toast" | "miniapp" | "dialog";
-                title?: string | undefined;
                 url?: string | undefined;
+                title?: string | undefined;
                 text?: string | undefined;
             } | undefined;
             iconUrl?: string | undefined;
@@ -211,8 +211,8 @@ declare const memberCards: {
             description?: string | undefined;
             action?: {
                 kind: "toast" | "miniapp" | "dialog";
-                title?: string | undefined;
                 url?: string | undefined;
+                title?: string | undefined;
                 text?: string | undefined;
             } | undefined;
             iconUrl?: string | undefined;
@@ -228,8 +228,8 @@ declare const memberCards: {
             query: string;
         }>, "many">>;
     }, "strip", zod.ZodTypeAny, {
-        userId: string;
         status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+        userId: string;
         cardRef: string;
         cardDisplay: string;
         availablePoints: number;
@@ -254,8 +254,8 @@ declare const memberCards: {
             description?: string | undefined;
             action?: {
                 kind: "toast" | "miniapp" | "dialog";
-                title?: string | undefined;
                 url?: string | undefined;
+                title?: string | undefined;
                 text?: string | undefined;
             } | undefined;
             iconUrl?: string | undefined;
@@ -265,8 +265,8 @@ declare const memberCards: {
             query: string;
         }[] | undefined;
     }, {
-        userId: string;
         status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+        userId: string;
         cardRef: string;
         cardDisplay: string;
         availablePoints: number;
@@ -291,8 +291,8 @@ declare const memberCards: {
             description?: string | undefined;
             action?: {
                 kind: "toast" | "miniapp" | "dialog";
-                title?: string | undefined;
                 url?: string | undefined;
+                title?: string | undefined;
                 text?: string | undefined;
             } | undefined;
             iconUrl?: string | undefined;
@@ -313,42 +313,42 @@ declare const memberCards: {
             usedAt: zod.ZodOptional<zod.ZodString>;
             description: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
-            usageRecordRef: string;
             title: string;
+            usageRecordRef: string;
             amount: string;
-            usedAt?: string | undefined;
             description?: string | undefined;
+            usedAt?: string | undefined;
         }, {
-            usageRecordRef: string;
             title: string;
+            usageRecordRef: string;
             amount: string;
-            usedAt?: string | undefined;
             description?: string | undefined;
+            usedAt?: string | undefined;
         }>, "many">;
         total: zod.ZodNumber;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        balance: number;
+        total: number;
         items: {
-            usageRecordRef: string;
             title: string;
+            usageRecordRef: string;
             amount: string;
-            usedAt?: string | undefined;
             description?: string | undefined;
+            usedAt?: string | undefined;
         }[];
-        total: number;
+        balance: number;
         membershipLabel?: string | undefined;
     }, {
         userId: string;
-        balance: number;
+        total: number;
         items: {
-            usageRecordRef: string;
             title: string;
+            usageRecordRef: string;
             amount: string;
-            usedAt?: string | undefined;
             description?: string | undefined;
+            usedAt?: string | undefined;
         }[];
-        total: number;
+        balance: number;
         membershipLabel?: string | undefined;
     }>>;
     readonly 'member-enrollment-form': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
@@ -390,14 +390,14 @@ declare const memberCards: {
             required: zod.ZodBoolean;
             url: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
-            title: string;
             required: boolean;
+            title: string;
             version: string;
             consentId: string;
             url?: string | undefined;
         }, {
-            title: string;
             required: boolean;
+            title: string;
             version: string;
             consentId: string;
             url?: string | undefined;
@@ -415,7 +415,6 @@ declare const memberCards: {
         manualNotice: zod.ZodOptional<zod.ZodString>;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        state: "unknown" | "active" | "not_enrolled" | "closed";
         authorization: {
             status: "unavailable" | "required" | "authorized";
             mobileMasked?: string | undefined;
@@ -430,10 +429,11 @@ declare const memberCards: {
             prefill?: string | undefined;
             placeholder?: string | undefined;
         }[];
+        state: "unknown" | "active" | "not_enrolled" | "closed";
         formVersion: string;
         consents: {
-            title: string;
             required: boolean;
+            title: string;
             version: string;
             consentId: string;
             url?: string | undefined;
@@ -441,7 +441,6 @@ declare const memberCards: {
         manualNotice?: string | undefined;
     }, {
         userId: string;
-        state: "unknown" | "active" | "not_enrolled" | "closed";
         authorization: {
             status: "unavailable" | "required" | "authorized";
             mobileMasked?: string | undefined;
@@ -456,10 +455,11 @@ declare const memberCards: {
             prefill?: string | undefined;
             placeholder?: string | undefined;
         }[];
+        state: "unknown" | "active" | "not_enrolled" | "closed";
         formVersion: string;
         consents: {
-            title: string;
             required: boolean;
+            title: string;
             version: string;
             consentId: string;
             url?: string | undefined;
@@ -474,15 +474,15 @@ declare const memberCards: {
         message: zod.ZodOptional<zod.ZodString>;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
-        memberRef?: string | undefined;
+        state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
         message?: string | undefined;
+        memberRef?: string | undefined;
         attemptRef?: string | undefined;
     }, {
         userId: string;
-        state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
-        memberRef?: string | undefined;
+        state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
         message?: string | undefined;
+        memberRef?: string | undefined;
         attemptRef?: string | undefined;
     }>>;
     readonly 'member-enrollment-cta': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
@@ -495,16 +495,16 @@ declare const memberCards: {
         perks: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        authState: "authenticated";
         state: "not_enrolled" | "closed";
+        authState: "authenticated";
         title?: string | undefined;
         subtitle?: string | undefined;
         enrollUrl?: string | undefined;
         perks?: string[] | undefined;
     }, {
         userId: string;
-        authState: "authenticated";
         state: "not_enrolled" | "closed";
+        authState: "authenticated";
         title?: string | undefined;
         subtitle?: string | undefined;
         enrollUrl?: string | undefined;
@@ -541,19 +541,19 @@ declare const serverModule: {
                 labelRef: zod.ZodString;
                 name: zod.ZodString;
             }, "strip", zod.ZodTypeAny, {
-                labelRef: string;
                 name: string;
-            }, {
                 labelRef: string;
+            }, {
                 name: string;
+                labelRef: string;
             }>, "many">;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            authState: "authenticated" | "unauthenticated";
             state: "unknown" | "active" | "not_enrolled" | "closed";
+            authState: "authenticated" | "unauthenticated";
             labels: {
-                labelRef: string;
                 name: string;
+                labelRef: string;
             }[];
             displayName?: string | undefined;
             avatarUrl?: string | undefined;
@@ -562,11 +562,11 @@ declare const serverModule: {
             registeredAt?: string | undefined;
         }, {
             userId: string;
-            authState: "authenticated" | "unauthenticated";
             state: "unknown" | "active" | "not_enrolled" | "closed";
+            authState: "authenticated" | "unauthenticated";
             labels: {
-                labelRef: string;
                 name: string;
+                labelRef: string;
             }[];
             displayName?: string | undefined;
             avatarUrl?: string | undefined;
@@ -623,13 +623,13 @@ declare const serverModule: {
                     text: zod.ZodOptional<zod.ZodString>;
                 }, "strip", zod.ZodTypeAny, {
                     kind: "toast" | "miniapp" | "dialog";
-                    title?: string | undefined;
                     url?: string | undefined;
+                    title?: string | undefined;
                     text?: string | undefined;
                 }, {
                     kind: "toast" | "miniapp" | "dialog";
-                    title?: string | undefined;
                     url?: string | undefined;
+                    title?: string | undefined;
                     text?: string | undefined;
                 }>>;
             }, "strip", zod.ZodTypeAny, {
@@ -638,8 +638,8 @@ declare const serverModule: {
                 description?: string | undefined;
                 action?: {
                     kind: "toast" | "miniapp" | "dialog";
-                    title?: string | undefined;
                     url?: string | undefined;
+                    title?: string | undefined;
                     text?: string | undefined;
                 } | undefined;
                 iconUrl?: string | undefined;
@@ -649,8 +649,8 @@ declare const serverModule: {
                 description?: string | undefined;
                 action?: {
                     kind: "toast" | "miniapp" | "dialog";
-                    title?: string | undefined;
                     url?: string | undefined;
+                    title?: string | undefined;
                     text?: string | undefined;
                 } | undefined;
                 iconUrl?: string | undefined;
@@ -666,8 +666,8 @@ declare const serverModule: {
                 query: string;
             }>, "many">>;
         }, "strip", zod.ZodTypeAny, {
-            userId: string;
             status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+            userId: string;
             cardRef: string;
             cardDisplay: string;
             availablePoints: number;
@@ -692,8 +692,8 @@ declare const serverModule: {
                 description?: string | undefined;
                 action?: {
                     kind: "toast" | "miniapp" | "dialog";
-                    title?: string | undefined;
                     url?: string | undefined;
+                    title?: string | undefined;
                     text?: string | undefined;
                 } | undefined;
                 iconUrl?: string | undefined;
@@ -703,8 +703,8 @@ declare const serverModule: {
                 query: string;
             }[] | undefined;
         }, {
-            userId: string;
             status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+            userId: string;
             cardRef: string;
             cardDisplay: string;
             availablePoints: number;
@@ -729,8 +729,8 @@ declare const serverModule: {
                 description?: string | undefined;
                 action?: {
                     kind: "toast" | "miniapp" | "dialog";
-                    title?: string | undefined;
                     url?: string | undefined;
+                    title?: string | undefined;
                     text?: string | undefined;
                 } | undefined;
                 iconUrl?: string | undefined;
@@ -751,42 +751,42 @@ declare const serverModule: {
                 usedAt: zod.ZodOptional<zod.ZodString>;
                 description: zod.ZodOptional<zod.ZodString>;
             }, "strip", zod.ZodTypeAny, {
-                usageRecordRef: string;
                 title: string;
+                usageRecordRef: string;
                 amount: string;
-                usedAt?: string | undefined;
                 description?: string | undefined;
+                usedAt?: string | undefined;
             }, {
-                usageRecordRef: string;
                 title: string;
+                usageRecordRef: string;
                 amount: string;
-                usedAt?: string | undefined;
                 description?: string | undefined;
+                usedAt?: string | undefined;
             }>, "many">;
             total: zod.ZodNumber;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            balance: number;
+            total: number;
             items: {
-                usageRecordRef: string;
                 title: string;
+                usageRecordRef: string;
                 amount: string;
-                usedAt?: string | undefined;
                 description?: string | undefined;
+                usedAt?: string | undefined;
             }[];
-            total: number;
+            balance: number;
             membershipLabel?: string | undefined;
         }, {
             userId: string;
-            balance: number;
+            total: number;
             items: {
-                usageRecordRef: string;
                 title: string;
+                usageRecordRef: string;
                 amount: string;
-                usedAt?: string | undefined;
                 description?: string | undefined;
+                usedAt?: string | undefined;
             }[];
-            total: number;
+            balance: number;
             membershipLabel?: string | undefined;
         }>>;
         readonly 'member-enrollment-form': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
@@ -828,14 +828,14 @@ declare const serverModule: {
                 required: zod.ZodBoolean;
                 url: zod.ZodOptional<zod.ZodString>;
             }, "strip", zod.ZodTypeAny, {
-                title: string;
                 required: boolean;
+                title: string;
                 version: string;
                 consentId: string;
                 url?: string | undefined;
             }, {
-                title: string;
                 required: boolean;
+                title: string;
                 version: string;
                 consentId: string;
                 url?: string | undefined;
@@ -853,7 +853,6 @@ declare const serverModule: {
             manualNotice: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            state: "unknown" | "active" | "not_enrolled" | "closed";
             authorization: {
                 status: "unavailable" | "required" | "authorized";
                 mobileMasked?: string | undefined;
@@ -868,10 +867,11 @@ declare const serverModule: {
                 prefill?: string | undefined;
                 placeholder?: string | undefined;
             }[];
+            state: "unknown" | "active" | "not_enrolled" | "closed";
             formVersion: string;
             consents: {
-                title: string;
                 required: boolean;
+                title: string;
                 version: string;
                 consentId: string;
                 url?: string | undefined;
@@ -879,7 +879,6 @@ declare const serverModule: {
             manualNotice?: string | undefined;
         }, {
             userId: string;
-            state: "unknown" | "active" | "not_enrolled" | "closed";
             authorization: {
                 status: "unavailable" | "required" | "authorized";
                 mobileMasked?: string | undefined;
@@ -894,10 +893,11 @@ declare const serverModule: {
                 prefill?: string | undefined;
                 placeholder?: string | undefined;
             }[];
+            state: "unknown" | "active" | "not_enrolled" | "closed";
             formVersion: string;
             consents: {
-                title: string;
                 required: boolean;
+                title: string;
                 version: string;
                 consentId: string;
                 url?: string | undefined;
@@ -912,15 +912,15 @@ declare const serverModule: {
             message: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
-            memberRef?: string | undefined;
+            state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
             message?: string | undefined;
+            memberRef?: string | undefined;
             attemptRef?: string | undefined;
         }, {
             userId: string;
-            state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
-            memberRef?: string | undefined;
+            state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
             message?: string | undefined;
+            memberRef?: string | undefined;
             attemptRef?: string | undefined;
         }>>;
         readonly 'member-enrollment-cta': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
@@ -933,16 +933,16 @@ declare const serverModule: {
             perks: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            authState: "authenticated";
             state: "not_enrolled" | "closed";
+            authState: "authenticated";
             title?: string | undefined;
             subtitle?: string | undefined;
             enrollUrl?: string | undefined;
             perks?: string[] | undefined;
         }, {
             userId: string;
-            authState: "authenticated";
             state: "not_enrolled" | "closed";
+            authState: "authenticated";
             title?: string | undefined;
             subtitle?: string | undefined;
             enrollUrl?: string | undefined;

package/dist/server/index.js

@@ -7,7 +7,7 @@ import {
   resolveMemberEnrollmentPort,
   resolveMemberProfilePort,
   serverModule
-} from "../chunk-ALVM7SOF.js";
+} from "../chunk-VU73BWYZ.js";
 export {
   InMemoryMemberService,
   memberCards,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-module-member",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "type": "module",
   "description": "商圈会员模块：会员账户、会员卡、积分流水与入会流程（codegen 源）。",
   "exports": {
@@ -18,10 +18,10 @@
     }
   },
   "dependencies": {
-    "@tbox.cn/app-contracts": "0.12.0",
-    "@tbox.cn/app-contracts-mall": "0.12.1",
-    "@tbox.cn/app-agent-sdk-client": "0.1.1",
-    "@tbox.cn/app-agent-sdk-server": "0.1.1"
+    "@tbox.cn/app-contracts": "0.12.3",
+    "@tbox.cn/app-contracts-mall": "0.12.3",
+    "@tbox.cn/app-agent-sdk-client": "0.1.3",
+    "@tbox.cn/app-agent-sdk-server": "0.1.4"
   },
   "peerDependencies": {
     "zod": "3.25.76",

package/src/server/cards/member-card-summary/samples.ts

@@ -15,6 +15,8 @@
  *   换行（低两档 14 项、高两档 15 项的数量差异照实铺），不是图标的图案还原度
  *  （真实图标由 provider 运行时下发；图案语义兜底归组件内 ImageWithFallback）；
  * - 卡图/图标的外链失败分支刻意保留 example.com 占位（该分支本身是合法预览态）；
+ * - 「卡面素材分支」组五格 hidden: true（2026-09-23 预览降噪裁决——真源保留，shape/schema
+ *   质量检查仍全量巡走；恢复展示 = 移除标记）；
  * - 白名单由 tests/samples.test.ts 断言收口：卡面 URL 仅允许 mdn.alipayobjects.com /
  *   example.com / data:image/svg+xml，厂商租户素材回潜即 fail。
  */
@@ -194,6 +196,7 @@ export const samples: CardSample<MemberCardSummaryCardData>[] = [
     label: '卡面·卡图缺失',
     note: 'presentation 在但 cardImageUrl 缺省——退到渐变兜底底纹，叠字排布应不变',
     group: '卡面素材分支',
+    hidden: true,
     data: {
       userId: 'u_1001', cardRef: 'card:u_1001', cardDisplay: '金卡会员', status: 'active',
       availablePoints: 860,
@@ -205,6 +208,7 @@ export const samples: CardSample<MemberCardSummaryCardData>[] = [
     label: '卡面·外链加载失败',
     note: '线上卡图 404 / 断网的实况——ImageWithFallback 占位不应把卡面撑变形',
     group: '卡面素材分支',
+    hidden: true,
     data: {
       userId: 'u_1001', cardRef: 'card:u_1001', cardDisplay: '金卡会员', status: 'active',
       availablePoints: 860, cardImageUrl: 'https://assets.example.com/member/gold-card.png',
@@ -216,6 +220,7 @@ export const samples: CardSample<MemberCardSummaryCardData>[] = [
     label: '卡面·进度长文案',
     note: 'progress.message 超 24 字触发 --scroll 跑马灯；percent=0 时进度条应可见轨道',
     group: '卡面素材分支',
+    hidden: true,
     data: {
       userId: 'u_1001', cardRef: 'card:u_1001', cardDisplay: '金卡会员', status: 'active',
       availablePoints: 860, cardImageUrl: FACE.gold,
@@ -231,6 +236,7 @@ export const samples: CardSample<MemberCardSummaryCardData>[] = [
     label: '卡面·无进度无权益',
     note: 'progress 与 benefits 同时缺省——只剩卡面 + 偏好引导，检查底部收口',
     group: '卡面素材分支',
+    hidden: true,
     data: {
       userId: 'u_1001', cardRef: 'card:u_1001', cardDisplay: '悦享卡', status: 'active',
       availablePoints: 0, cardImageUrl: FACE.blue,
@@ -241,6 +247,7 @@ export const samples: CardSample<MemberCardSummaryCardData>[] = [
     label: '卡面·权益图标失败',
     note: 'iconUrl 加载失败 → 按权益名匹配的兜底图标（停车/积分/活动/其它四条分支）',
     group: '卡面素材分支',
+    hidden: true,
     data: {
       userId: 'u_1001', cardRef: 'card:u_1001', cardDisplay: '金卡会员', status: 'active',
       availablePoints: 860, cardImageUrl: FACE.gold,
@@ -277,5 +284,6 @@ export const samples: CardSample<MemberCardSummaryCardData>[] = [
       progress: PROGRESS_SHORT, benefits: benefitsOf('gold'),
     },
     isHistory: true,
+    hidden: true,
   },
 ];

package/src/server/cards/member-point-usage-list/meta.ts

@@ -14,6 +14,8 @@ const meta: CardMeta<typeof memberPointUsageListCardDataSchema> = {
     total: 1,
   },
   schemaVersion: 1,
+  // 永久型不出卡：积分流水仅作文本事实（queryPoints SKILL 9-03），不构造积分流水卡
+  hidden: true,
 };
 
 export default meta;

package/tests/samples.test.ts

@@ -27,6 +27,12 @@ describe('member samples 双断言（样本即契约）', () => {
     expect(meta.samples).toHaveLength(11);
   });
 
+  it('历史卡保留质量检查但不进入 Preview', () => {
+    const histories = (meta.samples ?? []).filter((sample) => sample.isHistory === true);
+    expect(histories).toHaveLength(1);
+    expect(histories.every((sample) => sample.hidden === true)).toBe(true);
+  });
+
   it('四档 variant 全覆盖 + 高低档权益数量差异照实（14/15）', () => {
     const variants = new Set(
       (meta.samples ?? [])